Installing your Talend Data Quality Portal - 6.4

Talend Real-time Big Data Platform Installation Guide for Linux

English (United States)
Talend Real-Time Big Data Platform
Talend Activity Monitoring Console
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend Data Preparation
Talend Data Stewardship
Talend DQ Portal
Talend ESB
Talend Identity Management
Talend Installer
Talend JobServer
Talend Log Server
Talend Project Audit
Talend Repository Manager
Talend Runtime
Talend SAP RFC Server
Talend Studio
Installation and Upgrade


  • 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 24, "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 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 script and follow the instructions.


    If you answer yes to the last question of the 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





    MS SQL Server

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



    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. Delete [%VALIDATION_QUERY%].

  7. 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 (

  2. Go to the <TomcatPath>/bin directory and launch the, 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.