Installing Talend CommandLine in a standalone step (optional)

You have the possibility to install Talend CommandLine in a standalone step that does not require any existing project nor any POM generation step. This option allows you to prepare the environment for CI by installing Talend CommandLine, updating your license and applying a Talend Studio monthly update.

Note that the option that allows you to install Talend CommandLine individually is available from Talend CI Builder version 8.0.4 onwards (available from R2022-04).

Here is an example of command to install and update Talend CommandLine. This command can be executed before doing most of the CI steps like generating POM files of your project artifacts. If you have already installed Talend CommandLine, this command will perform a clean installation and remove the .metadata folder under your CI workspace directory before reinstalling it.

# To install Talend CommandLine, its license and a monthly update
mvn org.talend.ci:builder-maven-plugin:8.0.4:install 
<!-- This parameter is only supported and needed for users with Talend Studio 8.0.1 R2024-04 or lower 
-Dtalend.studio.p2.base=https://update.talend.com/Studio/8/base -->
-Dtalend.studio.p2.update=https://update.talend.com/Studio/8/updates/R2022-04 
-Dlicense.path=/home/talend/talend_studio/license

From Talend CI Builder version 8.0.8 onwards (available from R2022-08), if you need to rotate encryption keys, you can add the -Dstudio.encryption.keys.file parameter to specify the path to the encryption key configration file when installing Talend CommandLine. For more information, see Other Talend-related Maven parameters.

Here is an example of command to specify the encryption key file when installing Talend CommandLine.

# To specify the encryption key file when installing Talend CommandLine, its license and a monthly update
mvn org.talend.ci:builder-maven-plugin:8.0.8:install 
<!-- This parameter is only supported and needed for users with Talend Studio 8.0.1 R2024-04 or lower 
-Dtalend.studio.p2.base=https://update.talend.com/Studio/8/base -->
-Dtalend.studio.p2.update=https://update.talend.com/Studio/8/updates/R2022-08 
-Dlicense.path=/home/talend/talend_studio/license
-Dstudio.encryption.keys.file=/home/talend/key/studio.keys

While installing Talend CommandLine, you can set a time limit in milliseconds to indicate how long to wait for the connection to open before throwing an error. This will prevent the CI server from being blocked when the server does not receive a response soon enough.

Here is an example of command to install and update Talend CommandLine with the default 12000 milliseconds timeout.

# To install Talend CommandLine, its license and a monthly update with the default 12000 milliseconds timeout
mvn org.talend.ci:builder-maven-plugin:8.0.4:install 
<!-- This parameter is only supported and needed for users with Talend Studio 8.0.1 R2024-04 or lower 
-Dtalend.studio.p2.base=https://update.talend.com/Studio/8/base -->
-Dtalend.studio.p2.update=https://update.talend.com/Studio/8/updates/R2022-04 
-Dlicense.path=/home/talend/talend_studio/license 
-Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.retrieve.connectTimeout=12000 
-Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.retrieve.readTimeout=12000 
-Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.browse.connectTimeout=12000

After the standalone installation command is completed, Talend CommandLine is installed in your CI workspace directory. The following folders are created in the CI workspace:

.commandline_8
.p2Installer_8

Note: The Talend Studio installation directory contains separate platform-specific scripts that are not related to the Maven CI installation above:

commandline_upgrade.bat for Windows
commandline-linux_upgrade.sh for Linux

These scripts are part of the Talend Studio installation and are used to install the Talend Studio-based CommandLine tool. Running the corresponding script creates a commandline-workspace folder and a commandline.bat startup script in the Talend Studio installation directory.

For information about how to use the tool commands, see Talend CommandLine API.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here