Installing MDM modules using the jar file

Talend Open Studio for ESB Installation and Upgrade Guide

EnrichVersion
6.1
EnrichProdName
Talend Open Studio for ESB
task
Installation and Upgrade

The jar file allows you to launch a cross-platform MDM-dedicated graphical installer to install the Tomcat server (optional) and deploy the MDM Server in simple click-next steps.

Using the jar file provided by Talend, you can install the MDM modules in three different modes:

  • A cross-platform graphical installer to help you install Tomcat (optional) and deploy the MDM Server in simple click-next steps. For further information, see Installing in GUI mode.

  • Otherwise, open your command-line and use the command: java -jar <jar name>.jar -console, and then follow the instructions to complete the installation of the MDM server and the stewardship console. For further information, see Installing in Command/Console mode.

  • You can also generate a script through selecting the corresponding button in the last panel of the graphical installer. Script generation requires running the graphical installer, but the generated script can be used from the command-line. The installation can be run by passing the installation script as a parameter to the installer. For further information, see Installing in Silent mode.

The sections below explain in detail these three installation modes.

Installing in GUI mode

Talend Studio and Talend MDM Web User Interface require that you install an MDM server.

Prerequisite(s):

  • JRE 1.8.0 or higher must be installed. You should also make sure that the JAVA_HOME environment variable is set to point to the JRE directory.

    For example, if the path is C:\Java\JREx.x.x\bin, you must set the JAVA_HOME environment variable to point to: C:\Java\JREx.x.x.

  • Make sure you have read and write access to the folder where the MDM server will be installed (C:\Talend for example).

  • (Linux only) A Windows Manager must be installed.

Warning

- It is highly recommended that the full path to the server installation directory is as short as possible and does not contain any space character.

- If you already have a suitable JRE installed in a path with a space, you need to put quotes around the path when setting the values for the environmental variable.

To install the MDM server using a .jar file, follow the procedures below.

Launching the installer

  1. Right-click the .jar file and select with your Java runtime environment to run the installer.

    A language selection pop-up opens.

  2. From the language selection pop-up, select an installation language from the list and click OK to close the pop-up and proceed to the next step.

  3. On the Talend MDM welcome page, click Next to proceed to the next step.

  4. Read the license agreement and select the accept option. Click Next to proceed to the next step.

  5. Read the license information and click Next to proceed to the next step.

Selecting the packs

  1. Select the check boxes of the packs you want to install, and then click Next to proceed to the next step.

    If you have a Tomcat application server already installed on your machine and you do not want to re-install it, clear the Tomcat check box.

    The check boxes of required packs are already selected and unavailable: Talend MDM Application.

  2. Once you have made your choice, click Next to proceed to the next step.

  3. Browse to where you want to install the selected packs, and then click Next to proceed to the next step.

    If you cleared the Tomcat check box, you also need to specify the directory where Tomcat is installed.

    A message is displayed to inform you that the target directory will be created.

  4. Click OK to close the message and proceed to the next step.

Selecting the MDM server ports configuration

  • From the Ports list, select the set of ports to be used by the MDM server, and then click Next. By default, ports-1 (8180) is selected.

Selecting and configuring the database

  1. Select the type of database you want to use from the Database Type drop-down list and then click Next to proceed to the next step.

  2. If you selected an RDBMS database, configure its connection parameters:

    When H2 Embedded is selected:

    1. Choose the database generation policy. You have a choice between creating a database for each container, or using a single database for all containers.

    2. Enter the User name and Password to use for connecting to the database.

  3. Click Next to proceed to the next step.

Specifying the location for the fulltext search index directory

  1. Browse to the directory where you want to store the database fulltext search index.

  2. Click Next to proceed to the next step.

    A message is displayed to inform you that the target directory will be created.

The installation settings you defined in the previous steps will be displayed in the wizard.

  1. Click Next to proceed to the next step and start the installation.

    Two progress bars indicate how much of the installation has been completed.

  2. When the progress bars indicate the end of the installation, click Next to have a confirmation message that the installation is completed successfully.

    Note

    Click Generate an automatic installation script to generate a script for MDM server installation.

    You can use this script to install the MDM server on any platform without using the graphical installer.

  3. Click Done to close the installer.

    The MDM server is installed.

To run the MDM server, execute startup.bat (Windows) or startup.sh (Linux) in the <TomcatPath>/bin folder.

To shut the MDM server down, press Ctrl + C in the console window, or run bin/shutdown.bat or bin/shutdown.sh.

Installing in Command/Console mode

You can install the MDM server in a non-GUI mode using the command-line.

Prerequisite(s):

  • JRE 1.8.0 or higher must be installed. You should also make sure that the JAVA_HOME environment variable is set to point to the JRE directory.

    For example, if the path is C:\Java\JREx.x.x\bin, you must set the JAVA_HOME environment variable to point to: C:\Java\JREx.x.x.

  • Make sure you have read and write access to the folder where the MDM server will be installed (C:\Talend for example).

  • (Only Linux) A windows manager must be installed.

    Warning

    - It is highly recommended that the full path to the server installation directory is as short as possible and does not contain any space character.

    - If you already have a suitable JRE installed in a path with a space, you simply need to put quotes around the path when setting the values for environmental variable.

To use the command-line capabilities to install the MDM server:

  1. Unzip the .jar server file provided by Talend.

  2. Open your console server depending on the platform you have.

  3. Enter the below command, and then press the Enter key on your keyboard to launch the installation procedure through this text-only interface.

    java -jar <jar name>.jar -console

  4. Follow the instructions to install the MDM server.

Installing in Silent mode

When installing the MDM server using the graphical installer as outlined in Installing in GUI mode, you can generate an installation script at the last step in the graphical installer. This script is an XML file that contains the installation configuration settings.

You can later use this generated script from your console to install the MDM server. The installation can be run by passing the installation script as a parameter to the installer as the following:

java -jar <jar name>.jar -<script name>