# Installing and uninstalling Remote Engine service (systemd)

Available in...

* Cloud API Services Platform
* Cloud Big Data
* Cloud Big Data Platform
* Cloud Data Fabric
* Cloud Data Integration
* Cloud Data Management Platform

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](https://help.qlik.com/talend/en-US/remote-engine-user-guide-linux/Cloud/gracefull-remote-engine-shutdown) 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.