Installing your Talend Data Quality Portal

Talend Data Management Platform Installation Guide for Linux

EnrichVersion
6.2
EnrichProdName
Talend Data Management Platform
task
Installation and Upgrade

Prerequisites:

  • If you use MySQL, the my.ini file of your MySQL server installation directory must be edited in order to increase the size of query packets processed by the server. For more details, please see Table 14, "Talend Data Quality Portal".

  • The talend_dq database exists and is correctly initialized: it contains tables such as the TDQ_PRODUCT table. The database can have another name set by the user in the Studio. Use the same name in the Portal configuration (in the server.xml file). See Editing the servertemplate file for more information.

  • The Talend-DQPortal-YYYYYYYY_YYYY-VA.B.C.zip file has been downloaded and unzipped.

  • The drivers (.jar files) corresponding to your Talend Data Quality Portal configuration database are downloaded.

Execute the script

  1. Go to the dqportal folder.

  2. Execute the install.sh script and follow the instructions.

    Warning

    If you answer yes to the last question of the install.sh script which is 'start tomcat?', the HSQL database is started automatically. However, the next time you want to start Talend Data Quality Portal, you will have to manually start the HSQL database first from the database folder of Tomcat.

Editing the servertemplate file

  1. Open the file dqportal/resources/hsql/servertemplate to edit it.

  2. Replace [%TOMCAT_IP%] and [%TOMCAT_PORT%] with the IP address of the Tomcat server and the appropriate Tomcat server port (as set by the user) respectively.

  3. Replace [%TDQ_DB_DRIVER_CLASS_NAME%] with

    • com.mysql.jdbc.Driver if you use MySQL, or

    • oracle.jdbc.OracleDriver if you use Oracle, or

    • net.sourceforge.jtds.jdbc.Driver if you use MS SQL Server, or

    • org.postgresql.Driver if you use PostgreSQL.

  4. Replace [%TDQ_DB_URL%] with the connection URL to the data mart database.

    Database Type

    Connection URL

    MySQL

    jdbc:mysql://$ip:$dmport/$datamart?characterEncoding=UTF8&useOldAliasMetadataBehavior=true

    Oracle

    jdbc:oracle:thin:@$ip:$dmport:$datamart

    MS SQL Server

    url="jdbc:jtds:sqlserver://$ip:$dmport/$datamart" validationQuery="select 1"

    PostgreSQL

    jdbc:postgresql://$ip:$dmport/$datamart

    Note that $ip, $dmport and $datamart in the connection URL need to be replaced with the IP address, port number, and name of the data mart database respectively. By default, the database created by the Studio is named talend_dq. Make sure you use the same database name in the connection URL and in the Studio. For further information about setting up a distant database from the studio, see Talend Studio User Guide.

  5. Replace [%TDQ_DB_USERNAME%] and [%TDQ_DB_PASSWORD%] with the username and password of the data mart database respectively.

  6. Copy the content of the servertemplate file inside the <GlobalNamingResources> part of the <TomcatPath>/conf/server.xml file, then save your edits before closing the file.

Changing the default port used by the embedded HSQL database (optional)

  1. Open the <TomcatPath>/database/startup.bat file to edit it.

  2. Add the following at the end of the line:

    -port <portNumber>

    where <portNumber> is to be replaced with the port number that will be actually used by the database.

  3. Open the <TomcatPath>/conf/server.xml file and update the port number accordingly.

Starting Tomcat

  1. Before starting Tomcat, start the HSQL database:

    Go to the <TomcatPath>/database directory and execute the startup script (startup.sh).

  2. Go to the <TomcatPath>/bin directory and launch the startup.sh, then log in to the Talend Data Quality Portal.

    For more information about how to log into the portal, please see the Talend Data Quality Portal User and Administrator Guide.