Skip to main content Skip to complementary content

Installing and uninstalling Remote Engine service (systemd)

Talend Remote Engine is based on Apache Karaf. Karaf Service Wrapper makes it possible to install the Remote Engine as a Linux service.

Procedure

  1. Stop the engine if it is running.
    If your engine is running tasks, you can follow this procedure to gracefully shut down Talend Remote Engine.
  2. Open a terminal instance.
  3. Browse to the bin folder of the Talend Remote Engine installation directory and run the following command to create OS service wrapper files for the talend-remote-engine service. 
    ./shell wrapper:install -n talend-remote-engine
    The following files are created in the <RemoteEngineInstallationDirectory>/bin folder:
    • talend-remote-engine-wrapper
    • talend-remote-engine-service
    • talend-remote-engine.service

    The talend-remote-engine-wrapper.conf file is created in the <RemoteEngineInstallationDirectory>/etc folder. In this wrapper configuration file, you can customize the JVM properties for the engine service.

  4. Copy the talend-remote-engine.service file to /etc/systemd/system and reload the system.

    Example

    cp /app/Talend-RemoteEngine-V2.9.0/bin/talend-remote-engine.service /etc/systemd/system/
systemctl daemon-reload
  5. Register the service. 
    systemctl enable /etc/systemd/system/talend-remote-engine.service
    Troubleshooting:
    If the systemctl enable command fails with the error Failed to enable unit: Cannot alias ..., follow these steps:
    1. Open the /etc/systemd/system/talend-remote-engine.service file in a text editor.
    2. Locate the line starting with Alias= and remove it.
    3. Save the changes.
    4. Execute the systemctl daemon-reload command.
    5. After reloading the daemon, the systemctl enable command should work as expected to register the Talend Remote Engine service for automatic startup at boot.
  6. When you need to uninstall the service, do the following:
    1. Stop the engine if it is running.
    2. Run the following command to uninstall the Talend Remote Engine service: 
      systemctl disable /etc/systemd/system/talend-remote-engine.service

      When using the systemctl command, the service is disabled at system boot.

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