Installing the Remote ETL Engine

To install the Remote ETL Engine

1. In BMC Helix Portal, click the BMC Helix Continuous Optimization tile.
2. In BMC Helix Continuous Optimization, navigate to Administration > System > Downloads.
3. In the Remote ETL Installer tile, click Download.
4. Copy the installation files to the computer where you want to install the Remote ETL Engine.
5. 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.

6. Create an access key in BMC Helix Portal and assign the Capacity ETL Client role to it. For information about how to create the key, see Setting up access keys for programmatic access. 

7. To copy the key details (access key, secret key, and tenant ID) that are generated, click Copy all key details.

   The keys are copied in the following format: key details:<access key>::<secret key>,tenant id: <tenant ID>

   You will need to specify these keys while configuring the authorization token in the options file.

   No. If you do not copy the key details when it is generated or if you lose it, you must generate a new one. The keys are 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. 
   
   

8. At the shell prompt, change to the directory where you extracted the downloaded files and locate the sample response file.
   Example: BHCOtemp/BCO/Disk1/silentInstallTemplates/HO_ADDITIONAL_SERVER_REMOTE_EE.txt.
9. Edit the HO_ADDITIONAL_SERVER_REMOTE_EE.txt file in a text editor.
10. In the Authorization token section, paste the tenant ID, access key, and secret key that you have copied in Step 7.

11. 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
12. Open a shell prompt and navigate to the directory that contains the installation files. BMC recommends that you install the Remote ETL Engine as a root user. 
    Example: /BCO/Disk1

13. Launch the silent installer:

    ./setup.sh -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 install the Remote ETL Engine by using the Proxy server

If you want to install the Remote ETL Engine by using the proxy server, perform the following steps in addition to the steps listed in the To install the Remote ETL Enginesection:

1. Encrypt the password that will be used in the proxy settings by using the BCOEncoder.sh utility.
2. Run one of the following commands to encrypt the password.
   Copy the encrypted password. You will need to specify this password while configuring the proxy server connection in the options file.
   • ./BCOEncoder.sh encrypt -key <access key>
   • ./BCOEncoder.sh -encrypt -envvarname ENV_VAR_WITH_PWD -key <access key>
   • ./BCOEncoder.sh -encrypt -toencode <text to encode> -key <access key>

     Example

     ./BCOEncoder.sh -encrypt -toencode pa$$word -key U0262M32JQES27TJLGQFPLGF6PRBFO

      

3. Edit the HO_ADDITIONAL_SERVER_REMOTE_EE.txt file in a text editor.

4. Search for the # Proxy Server Connection section, and remove the '#' character from the properties to uncomment the properties.
   

   # Proxy Server Connection
   # Please note that password, in case it is required, it has to be encrypted
   # with BCOEncoder.sh utility
   ###############################################################################
   -J IS_PROXY_CONFIGURED=true
   -J REE_PROXY_HOST=
   -J REE_PROXY_PORT=
   -J IS_PROXY_AUTHENTICATION_REQUIRED=true
   -J REE_PROXY_USER=
   -J REE_PROXY_SECPWD=

5. Modify the properties according to your preferences as listed in the following table:
   
6. Paste the proxy server password in the REE_PROXY_SECPWD property that you have copied in Step 2. 
7. Save the file, navigate to the directory that contains the installation files, and launch the installer. 

(Optional) To test the proxy server connectivity from your Remote ETL Engine, use the curl command: 

Example: curl https://www.google.com -x <hostname>:<port> -U<username>:<password> -I

Sample output: HTTP/1.1 200 Connection established

To verify the installation

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

To troubleshoot the Remote ETL Engine installation

Where to go from here

Installing-the-Gateway-Server