# Install - inRiver PMC

## Prerequisites

There is a number of things that must be in place before you can start the configuration of the translation connector. The installation and set-up should always be carried out by a competent Solution Integrator or suitably qualified person.

* An agreement and a Freeway account must be set up, and you need the log in credentials
* You must have a list of possible source- and target languages verified
* The translation process and decided upon the services
* Get a list of mappings between the PIM languages and the Translation languages.

Technical

* An inRiver PMC environment

## Step 1. Uploading the deployment package

Navigate to

* inRiver Control Center
* Select customer and environment
* Navigate
  * Connect → Packages
* Drag and drop the deployment package to the 'Select file to upload' box and press 'Upload'

![](/files/-LADvKvgY62LgfYfvlmv)

## Step 2. Setting up the language configuration file

The language configuration file needs to be set up

**Note:** The language configuration file format has changed - [Language Configuration  <br>](/inriver-translation-connector/language-configuration.md)

## Step 3. Adding the extensions

Navigate to

* inRiver Control Center
* Select customer and environment
* Navigate
  * Connect → Extensions
* Adding the following extensions by clicking "Add Extension"
* **Note:** If there is no intention to use the automatic Translation Job sender, then `AutomatedTranslationSenderExtension` does not need to be installed.

| **Extension Id**   | **LionbridgeAutomatedTranslationSender**                                               |
| ------------------ | -------------------------------------------------------------------------------------- |
| **Package**        | LionbridgeTranslator.zip                                                               |
| **Assembly Name**  | Lionbridge.inRiver.Extension.Translation.dll                                           |
| **Assembly Type**  | Lionbridge.inRiver.Extension.Translation.Extension.AutomatedTranslationSenderExtension |
| **Extension Type** | ScheduledExtension                                                                     |

| **Extension Id**   | **LionbridgeBaseTranslationFunctionality**                                                    |
| ------------------ | --------------------------------------------------------------------------------------------- |
| **Package**        | LionbridgeTranslator.zip                                                                      |
| **Assembly Name**  | Lionbridge.inRiver.Extension.Translation.dll                                                  |
| **Assembly Type**  | Lionbridge.inRiver.Extension.Translation.Extension.LionbridgeTranslationEntityUpdateExtension |
| **Extension Type** | EntityListener                                                                                |

| **Extension Id**   | **LionbridgeFreewayUpdater**                                                                |
| ------------------ | ------------------------------------------------------------------------------------------- |
| **Package**        | LionbridgeTranslator.zip                                                                    |
| **Assembly Name**  | Lionbridge.inRiver.Extension.Translation.dll                                                |
| **Assembly Type**  | Lionbridge.inRiver.Extension.Translation.Extension.TranslationEntityPeriodicUpdateExtension |
| **Extension Type** | ScheduledExtension                                                                          |

![](/files/-LADvLDdLYcITjC9YVbc)

## Step 4. Configure the extensions

If you've just now completed the previous step, you can skip the **Navigation** step below, and continue to **Configure**.

#### Navigation

Navigate to

* inRiver Control Center
* Select customer and environment
* Navigate
  * Connect → Extensions

#### Configure

Click the Extension you want to configure

When running the configuration process for the first time after the Extension has been installed, you will need to click the "Get Default Settings" button on the top-right of the "Settings" section.

Here are some examples of settings for each extension

### LionbridgeAutomatedTranslationSender

**(example LionbridgeAutomatedTranslationSender Extension)**

![](/files/-LADvLM8FoJIQVvl-5GO)

| Setting                            | Value                                                                 | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| LionbridgeAuthServiceAddress       | urls will be supplied by Lionbridge Connector team at deployment.     | **Freeway Service Address** - The authentication service address provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                               |
| LionbridgeActionServiceAddress     | urls will be supplied by Lionbridge Connector team at deployment.     | **Freeway Service Address** - The action service address provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                       |
| LionbridgeUsername                 | username will be supplied by Lionbridge Connector team at deployment. | **Freeway account username** - The Freeway account username provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                    |
| LionbridgePassword                 | password will be supplied by Lionbridge Connector team at deployment. | **Freeway account password** - The Freeway account username provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                    |
| SendOnlyTranslatableData           | False                                                                 | **Boolean (True/False)** - Whether or not to send more than just the translatable data on an entity (Sends all field data on the entity)                                                                                                                                                                                                                                                                                                                                              |
| TranslateLocaleCvl                 | False                                                                 | **Boolean (True/False)** - Whether or not to send LocaleString CVL values for translation, that are in use by the entities that are being translated.                                                                                                                                                                                                                                                                                                                                 |
| TranslationConfiguration           | `<XML>`                                                               | **XML** - Translation Configuration, more information on how to configure this can be found [here](/inriver-translation-connector/translation-configuration.md).                                                                                                                                                                                                                                                                                                                      |
| CriteriaConfiguration              | `<XML>`                                                               | **XML** - Criteria Configuration (**Optional**), more information on how to configure this can be found [here](/inriver-translation-connector/criteria-configuration.md).                                                                                                                                                                                                                                                                                                             |
| TranslationFileEntityLimit         | 1000                                                                  | **Integer** - Max number of entities that can be added to each translation file sent to Lionbridge Freway before the file is split into multiple files                                                                                                                                                                                                                                                                                                                                |
| Username                           | pimuser1                                                              | **Username** - User that created the query that finds entities that should be translated                                                                                                                                                                                                                                                                                                                                                                                              |
| Query                              | Products                                                              | **Query name** - The name of the query that finds entities that should be translated                                                                                                                                                                                                                                                                                                                                                                                                  |
| IgnoreDateModifiedForLocaleStrings | False                                                                 | **Boolean (True/False)** - disable/enable a check whether the source language have a later modified date then the target language. (Default is False)                                                                                                                                                                                                                                                                                                                                 |
| IncludeMainPictureUrl              | False                                                                 | **Boolean (True/False) - Optional -** enable/disable a feature that includes a url to the main picture of a translated object to give translators additional context. (Default is False)                                                                                                                                                                                                                                                                                              |
| TranslationDateComparisonMode      | Newer                                                                 | <p><strong>Optional -</strong> Toggles which date comparison method should be used to determine if a field needs translation.</p><p>Possible values</p><ul><li><p><strong>NewerOrEqual</strong></p><ul><li>Source language value's last modified date is the same or more recent than the target language.</li></ul></li><li><p><strong>Newer</strong> - (default)</p><ul><li>Source language value's last modified date is more recent than the target language.</li></ul></li></ul> |

### LionbridgeBaseTranslationFunctionality

(example LionbridgeBaseTranslationFunctionality Extension)&#x20;

![](/files/-LADvLl0qxINDdF5ZGP9)

| Setting                            | Value                                                                 | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| LionbridgeAuthServiceAddress       | urls will be supplied by Lionbridge Connector team at deployment.     | **Freeway Service Address**. The authentication service address provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                |
| LionbridgeActionServiceAddress     | urls will be supplied by Lionbridge Connector team at deployment.     | **Freeway Service Address**. The action service address provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                        |
| LionbridgeUsername                 | username will be supplied by Lionbridge Connector team at deployment. | **Freeway account username**. The Freeway account username provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                     |
| LionbridgePassword                 | password will be supplied by Lionbridge Connector team at deployment. | **Freeway account password**. The Freeway account username provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                     |
| SendOnlyTranslatableData           | False                                                                 | **Boolean (True/False).** Whether or not to send more than just the translatable data on an entity (Sends all field data on the entity)                                                                                                                                                                                                                                                                                                                                               |
| TranslateLocaleCvl                 | False                                                                 | **Boolean (True/False).** Whether or not to send LocaleString CVL values for translation, that are in use by the entities that are being translated.                                                                                                                                                                                                                                                                                                                                  |
| TranslationConfiguration           | `<XML>`                                                               | **XML** - Translation Configuration, more information on how to configure this can be found [here](/inriver-translation-connector/translation-configuration.md).                                                                                                                                                                                                                                                                                                                      |
| CriteriaConfiguration              | `<XML>`                                                               | **XML** - Criteria Configuration (**Optional**), more information on how to configure this can be found [here](/inriver-translation-connector/criteria-configuration.md).                                                                                                                                                                                                                                                                                                             |
| IgnoreDateModifiedForLocaleStrings | False                                                                 | **Boolean (True/False)** - disable/enable a check whether the source language have a later modified date then the target language. (Default is False)                                                                                                                                                                                                                                                                                                                                 |
| IncludeMainPictureUrl              | False                                                                 | **Boolean (True/False) - Optional -** enable/disable a feature that includes a url to the main picture of a translated object to give translators additional context. (Default is False)                                                                                                                                                                                                                                                                                              |
| TranslationDateComparisonMode      | Newer                                                                 | <p><strong>Optional -</strong> Toggles which date comparison method should be used to determine if a field needs translation.</p><p>Possible values</p><ul><li><p><strong>NewerOrEqual</strong></p><ul><li>Source language value's last modified date is the same or more recent than the target language.</li></ul></li><li><p><strong>Newer</strong> - (default)</p><ul><li>Source language value's last modified date is more recent than the target language.</li></ul></li></ul> |

### LionbridgeFreewayUpdater

**(example LionbridgeFreewayUpdater exension)**

![](/files/-LADvMFgO5zw9l9n5cvi)

| Setting                            | Value                                                                 | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| LionbridgeAuthServiceAddress       | urls will be supplied by Lionbridge Connector team at deployment.     | **Freeway Service Address**. The authentication service address provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                |
| LionbridgeActionServiceAddress     | urls will be supplied by Lionbridge Connector team at deployment.     | **Freeway Service Address**. The action service address provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                        |
| LionbridgeUsername                 | username will be supplied by Lionbridge Connector team at deployment. | **Freeway account username**. The Freeway account username provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                     |
| LionbridgePassword                 | password will be supplied by Lionbridge Connector team at deployment. | **Freeway account password**. The Freeway account username provided by Lionbridge                                                                                                                                                                                                                                                                                                                                                                                                     |
| SendOnlyTranslatableData           | False                                                                 | **Boolean (True/False).** Whether or not to send more than just the translatable data on an entity (Sends all field data on the entity)                                                                                                                                                                                                                                                                                                                                               |
| TranslateLocaleCvl                 | False                                                                 | **Boolean (True/False).** Whether or not to send LocaleString CVL values for translation, that are in use by the entities that are being translated.                                                                                                                                                                                                                                                                                                                                  |
| TranslationConfiguration           | `<XML>`                                                               | **XML** - Translation Configuration, more information on how to configure this can be found [here](/inriver-translation-connector/translation-configuration.md).                                                                                                                                                                                                                                                                                                                      |
| CriteriaConfiguration              | `<XML>`                                                               | **XML** - Criteria Configuration (**Optional**), more information on how to configure this can be found [here](/inriver-translation-connector/criteria-configuration.md).                                                                                                                                                                                                                                                                                                             |
| IgnoreDateModifiedForLocaleStrings | False                                                                 | **Boolean (True/False)** - disable/enable a check whether the source language have a later modified date then the target language. (Default is False)                                                                                                                                                                                                                                                                                                                                 |
| IncludeMainPictureUrl              | False                                                                 | **Boolean (True/False) - Optional -** enable/disable a feature that includes a url to the main picture of a translated object to give translators additional context. (Default is False)                                                                                                                                                                                                                                                                                              |
| TranslationDateComparisonMode      | Newer                                                                 | <p><strong>Optional -</strong> Toggles which date comparison method should be used to determine if a field needs translation.</p><p>Possible values</p><ul><li><p><strong>NewerOrEqual</strong></p><ul><li>Source language value's last modified date is the same or more recent than the target language.</li></ul></li><li><p><strong>Newer</strong> - (default)</p><ul><li>Source language value's last modified date is more recent than the target language.</li></ul></li></ul> |

## Step 5. Configure the inRiver Data Model

Details on how to configure the inRiver data model can be found in the following article.\
[Install - inRiver Data Model](/inriver-translation-connector/pmc-install-inriver-data-model-configuration.md)

## Step 6. Verification

Instructions on how to verify the configuration is correct can be achieved by creating a test translation, more details in the following article.\
[Testing the Lionbridge Translator](https://lionbridge.gitbook.io/inriver-translation-connector/using-the-lionbridge-connector-manual-workflow)

### Log

The Translation Extensions logs all actions in the logging interface in the inRiver Control Center.

* Check the log if you for example get a `Imported with errors`, status.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lionbridge.gitbook.io/inriver-translation-connector/install-inriver-pmc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.