Upgrading the Remote ETL Engine

Upgrade the Remote ETL Engine silently, by using a sample response file with default settings that is included in the Remote ETL Engine upgrade image. In the upgrade process, BMC Helix Continuous Optimization detects the existing version of the Remote ETL Engine and saves all the existing settings for the upgrade process. You can either retain the default values or change them and save the file.

Related topics

Upgrading-the-Gateway-Server

Upgrading-the-Continuous-Optimization-Agent

To upgrade the Remote ETL Engine

  1. Log in as a root user to the computer where you want to upgrade the Remote ETL Engine, and create a temporary directory.
    Ensure that the temporary directory is different from the installation directory to avoid any file sharing conflict. 
    Example: HO_temp.
  2. From the Administration > System > Downloads page, download the Remote ETL installer.
  1. Extract the downloaded file (HO_RemoteETL_<version number>_Linux.tar.gz) to the temporary directory. 

  2. 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.

  3. 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.
  4. At the shell prompt, change to the directory where you extracted the downloaded files.
  5. Example: HO_temp/HO/Disk1.
  6. Navigate to the directory where you extracted the downloaded files and locate the sample response file.
    Example: HO_temp/HO/Disk1/silentInstallTemplates/HO_ADDITIONAL_SERVER_REMOTE_EE.txt.
  7. Edit the HO_ADDITIONAL_SERVER_REMOTE_EE.txt file in a text editor.

  8. In the -J AUTH_TOKEN property, paste the token that you copied in Step 4, modify other properties of the file according to your preferences as listed below, and then 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

  9. Open a shell prompt and navigate to the directory that contains the installation files.
    Example: /HO/Disk1

  10. 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 successful installation is displayed.

To verify the upgrade

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

Where to go from here

Upgrading-the-Gateway-Server

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*