Deploying Talend Administration Center on an application server

Talend Real-time Big Data Platform Installation Guide for Linux

EnrichVersion
6.3
EnrichProdName
Talend Real-Time Big Data Platform
task
Installation and Upgrade

The following sections show how to deploy the Talend Administration Center Web application on an application server; it can be an Apache Tomcat or a JBoss server application.

Note

In the rest of this documentation, <TomcatPath> points out the path where Tomcat has been installed.

Deploying Talend Administration Center on Tomcat

To install and deploy Talend Administration Center on Tomcat, proceed as follows:

  1. Install the Apache Tomcat application server and stop the Tomcat service if it is automatically started.

  2. Edit the following file:

    etc/default/tomcat8

  3. Uncomment the tomcat security setting and change the default setting, in order to read:

    TOMCAT8_SECURITY=no

  4. Unzip the package delivered by Talend: Talend-AdministrationCenter-YYYYYYYY_YYYY-VA.B.C.zip.

    This will give you access to the different components needed to benefit from all the Talend Administration Center functionalities:

    • org.talend.administrator.war, the archive containing the actual Talend Administration Center Web application.

    • Artifact-Repository-Nexus-VA.B.C.D.zip, the archive containing an artifact repository software, based on Sonatype Nexus, that will be used to handle software updates, DI artifacts, and also ESB artifacts, only if you subscribed to one of our ESB oriented solutions. For more information, see Introduction to the Talend products.

    • an endorsed folder containing a library necessary to use the ESB Conductor of Talend Administration Center, only if you subscribed to one of our ESB oriented solutions.

  5. Copy the Web application, org.talend.administrator.war, into the following directory of Tomcat:

    <TomcatPath>/webapps/

    Once you have copied this war file, you can either unzip it manually under the same directory, or let Tomcat unzip the web application at startup.

  6. If you subscribed to one of our ESB oriented solutions, to be able to use the Conductor module of Talend Administration Center, copy the endorsed folder provided into the root directory of Tomcat.

  7. Start Tomcat using the following command:

    sh <TomcatPath>/bin/startup.sh

Warning

The storage of log outputs is managed by Tomcat application server, by default, but you are also able to define your own path for storing the logs. From 4.0, you can configure the path directly from Talend Administration Center. For more information on manual configuration in prior versions, refer to Configuring the log storage mode.

If you wish to implement high availability to the task execution scheduling using Talend clustering feature, then read Setting up High Availability before starting Tomcat.

For reasons of right management, make sure you launch Tomcat using the same administrator account as for the CommandLine. For example: Create an account talend_admin for both Tomcat and CommandLine.

If you deploy a large number of applications on Tomcat, you should increase its memory to improve its performance. For more information on this process, see Increasing the memory of Tomcat.

If you encounter performance issues during Tomcat startup, it may be due to the use of symbolic links during SVN checkout. For more information on how to solve these issues, see Talend Help Center.

Deploying Talend Administration Center on JBoss

To install and deploy Talend Administration Center on JBoss, proceed as follows:

  1. Install the JBoss application server and stop the JBoss service if it is automatically started.

  2. Unzip the archive delivered by Talend.

  3. Move bcprov-jdk15on-1.51.jar from org.talend.administrator.war/WEB-INF/lib to <JBossPath>/modules/system/layers/base/org/bouncycastle/main.

  4. In <JBossPath>/modules/system/layers/base/org/bouncycastle/main/, create a module.xml file.

  5. Paste the following content:

    <?xml version="1.0" encoding="UTF-8"?>
    <module xmlns="urn:jboss:module:1.1" name="org.bouncycastle">
    <resources>
    <resource-root path="bcprov-jdk15on-1.51.jar"/>
    </resources>
    <dependencies>
    <module name="javax.api" slot="main" export="true"/>
    </dependencies>
    </module>
  6. In org.talend.administrator.war/WEB-INF, create a jboss-deployment-structure.xml file.

  7. Paste the following content:

    <jboss-deployment-structure>
    <deployment>
    <dependencies>
    <module name="org.bouncycastle" slot="main" export="true" />
    </dependencies>
    </deployment>
    </jboss-deployment-structure>
  8. Move the org.talend.administrator.war file to <JBossPath>/standalone/deployments.

  9. Start JBoss using the following command:

    sh <JBossPath>/bin/run.sh

Warning

The storage of log outputs is managed by Tomcat application server, by default, but you are also able to define your own path for storing the logs. You can configure the path directly from Talend Administration Center. For more information on manual configuration in prior versions, refer to Configuring the log storage mode.

For reasons of right management, make sure you launch JBoss using the same administrator account as for the Commandline. For example: Create an account talend_admin for both JBoss and CommandLine.

Deploying Talend Administration Center on Pivotal tc Server

To install and deploy Talend Administration Center on Pivotal tc Server, proceed as follows:

  1. Install Pivotal tc Server as explained in Pivotal documentation: http://tcserver.docs.pivotal.io/docs-tcserver/topics/install-getting-started.html.

  2. Create a Pivotal tc Server instance as explained in Pivotal documentation: http://tcserver.docs.pivotal.io/docs-tcserver/topics/postinstall-getting-started.html.

  3. Stop your Pivotal tc Server instance.

  4. Unzip the package delivered by Talend: Talend-AdministrationCenter-YYYYYYYY_YYYY-VA.B.C.zip.

  5. Copy the Web application, org.talend.administrator.war, into the webapps folder of your Pivotal tc Server instance, for example:

    /home/tcserver/pivotal-tc-server/myserver/webapps/

  6. Copy the .jar files contained in the endorsed folder to the lib folder of your Pivotal tc Server instance, for example:

    /home/tcserver/pivotal-tc-server/myserver/lib/

  7. Start your Pivotal tc Server instance to automatically deploy Talend Administration Center.

Increasing the memory of Pivotal tc Server

To increase the memory heap size of the server in order to make all the applications work properly, proceed as follows:

  1. Change directory to <PivotalPath>/bin where <PivotalPath> is the Pivotal tc Server installation directory, and edit the file setenv.sh.

  2. Add the following line:

    set JAVA_OPTS=%JAVA_OPTS% -XX:MaxMetaspaceSize=512m -Xmx1024m -Xms256m

    The Pivotal tc Server memory size is now increased and the server can hold several web applications.