Installing the Remote ETL Engine

Use the sample response file that is included in the Remote ETL Engine installation image to install the Remote ETL Engine silently. Modify the default settings in the sample file instead of creating a new file.

To install the Remote ETL Engine

In BMC Helix Portal, go to the BMC Helix Continuous Optimization tile and click Launch.
In BMC Helix Continuous Optimization, navigate to Administration > System > Downloads.
In the Remote ETL Engine tile, click Download.
Extract the downloaded files to the temporary directory, making sure that the temporary directory is different from the installation directory to avoid any file sharing conflict.
Create an API user in BMC Helix Portal. For details, see Setting up API users for programmatic access
Important
To use the API key in the Remote ETL Engine installation, you need to generate the key by using the Capacity ETL Client role.
Copy the tenant ID, access key, and secret key that is generated while creating the API user.

You will need to specify this key while configuring the authorization token in the options file.
No. The secret key is available for copying only when it is generated for the first time. Afterwards, it is saved in an encrypted form using the OpenBSD Bcrypt scheme. This encryption is irreversible. If you do not copy the secret key when it is generated or if you lose it, you must generate a new one.
At the shell prompt, change to the directory where you extracted the downloaded files.
Example: HOCO_temp/HO/Disk1.
Navigate to the directory where you extracted the downloaded files and locate the sample response file.
Example: HOCO_temp/HO/Disk1/silentInstallTemplates/HO_ADDITIONAL_SERVER_REMOTE_EE.txt.
Edit the HO_ADDITIONAL_SERVER_REMOTE_EE.txt file in a text editor.
In the Authorization token section, paste the tenant ID, access key, and secret key that you have copied in Step 6. Modify other properties of the file according to your preferences as listed below, and save the file.
Prefix tags for the silent installation properties:
- -P: Precedes the directory properties
- -A: Precedes the application features
- -J: Precedes the Java properties
Open a shell prompt and navigate to the directory that contains the installation files.
Example: /HO/Disk1
Launch the silent installer:
./setup.sh -i silent -DOPTIONS_FILE=<file path>/HO_ADDITIONAL_SERVER_REMOTE_EE.txt
If the path contains spaces, enclose the path and options file name in quotation marks.
After the installation is complete a confirmation message about a successful installation is displayed.

To verify the installation

Log in with the user credentials that you used for installation.
Example: cpit.
Navigate to the installation directory.
Example: /opt/bmc/HO.
Run the command: ./cpit status
Verify that the Scheduler service is running.

To troubleshoot the Remote ETL Engine installation

Issue	Cause	Resolution
404 Not found or 502 Bad gateway	The host name is not correctly configured.	Check the value of the URL_HOST property in the silent installation template (HO_ADDITIONAL_SERVER_REMOTE_EE.txt) file. The host name must be a fully qualified domain name of BMC Helix Portal in the format: vw-abc-dev01.bmc.com. Make sure that https:// is not included in the host name.
403 Forbidden	The API user does not have rights to call the Supervisor API.	Assign the Capacity ETL client role to the API user. For details, see Setting up roles and permissions.
401 Unauthorized	Invalid authentication details or the API key has expired.	Check the access key and secret key that you have used to configure the API user. Confirm that the API key is not expired. Make sure that the Capacity ETL Client role is assigned to the API user.

Where to go from here

Installing-the-Gateway-Server