Checking the status of remote components


As an administrator, check the status of the following remote components that are used for collecting data from your on-premise environment: Remote ETL Engine and Gateway Server

The Status page shows the following details for each component:

  • The current state of component, such as running, outdated, inactive, or not responding
  • The component host and display name
  • The time when the status check was last performed
  • The component version

If the Status page does not show any components, go to the Downloads page and install the required components. For details, see Downloading-the-product-components.

The status is color-coded and components are arranged according to the status. The components with the following statuses are shown at the top: Not responding, outdated, error, and warning

You can use the Status filter to display the components according to status. The component status check is performed at a scheduled interval. You are notified by email if the status change is detected for any of the components.

Review this information to know the component status, identify the components with issues, and update the components with outdated status. 

On the Status page, you can perform the following tasks:

Additionally, you can change the display name of a Remote ETL Engine and view the logs of the remote scheduler that manages the ETL tasks on the Remote ETL Engine.

Example scenario

Alan works in ACME Corporation. He is responsible for managing and administering the infrastructure capacity. 

He receives complaints that some of the on-premises ETLs are not reporting correct data. He also receives an email that the 2 Remote ETL Engines need to be updated to the latest version. He immediately checks the status page and observes that the 2 remote ETL Engines are in an outdated state. 

He clicks Update in the status box of these Remote ETL Engines. The Remote ETL Engines are updated to the latest version. Then, he runs the ETLs again that were not reporting correct data and observes that the issue is resolved.

To check the component status 

  1. Launch BMC Helix Continuous Optimization from the BMC Helix Portal.
  2. Select Administration > System > Status.
  3. Perform the following steps based on the status:

    Status

    Details

    Action required

    Running

    Indicates that the component status is ok. 

    None

    Outdated

    Indicates that a new version is available for remote components. To prevent data loss and issues, we recommend updating all the remote components to the latest version.

    Update the components to the latest version. For details, see Updating the Remote ETL Engine and Updating the Gateway Server.

    Inactive

    Indicates that a Remote ETL Engine is deactivated. In this status, you cannot schedule and run tasks on the Remote ETL Engine. You can use this status to define a maintenance window. For example, upgrading the operating system on the Remote ETL Engine, migrating to a new host, and so on. 

    None if some maintenance tasks are in progress on the Remote ETL Engine. You can activate the Remote ETL Engine again after these tasks are completed. For details, see Activating the Remote ETL Engine.

    Not responding

    Indicates that BMC Helix Continuous Optimization is not able to communicate with the component. When the component is not responding, you cannot schedule or run tasks from the GUI. You must troubleshoot and fix issues to change the component status to running.

    Troubleshoot issues with the component and check your network.

    Warning

    Indicates that the Remote ETL Engine is updated with some warnings.

    1. Review the deployment logs to troubleshoot issues.
    2. Update the Remote ETL Engine again.

    For details, see Updating the Remote ETL Engine.

    Error

    Indicates that the Remote ETL Engine update failed.

    1. Review the deployment logs to troubleshoot issues. 
    2. Update the Remote ETL Engine again.

    For details, see Updating the Remote ETL Engine

To update a Remote ETL Engine 

A Remote ETL Engine with any of the earlier versions might not work correctly with the latest version of BMC Helix Continuous Optimization. When the status of the Remote ETL Engine changes to outdated, update it to match the version of BMC Helix Continuous Optimization.  The following flow chart illustrates the update flow for the Remote ETL Engine.

ree_update_flow_23.1.png

Perform these steps:

  1. Launch BMC Helix Continuous Optimization from the BMC Helix Portal.
  2. Select Administration > System > Status.
  3. Click Update corresponding to the Remote ETL Engine that you want to update.
    A confirmation message about the start of update operation is displayed. The status of the Remote ETL Engine is changed to Updating. After the update is successful and the next status check is performed, the Remote ETL Engine status is changed to Running. You are also notified by email after the status is changed.
  4. If the status of the Remote ETL Engine shows as warning or error, perform these steps:
    1. Click Deployment logs.
    2. Review the logs to investigate and troubleshoot the deployment-related issues.
    3. Click ellipsis_icon.pngRetry update.

To deactivate and activate a Remote ETL Engine

You can deactivate a Remote ETL Engine to perform tasks such as system maintenance. The status check is not performed for the deactivated Remote ETL Engine. Activate the Remote ETL Engine again after you complete the tasks.

Perform these steps:

  1. Launch BMC Helix Continuous Optimization from the BMC Helix Portal.
  2. Select Administration > System > Status.
  3. Click ellipsis_icon.pngcorresponding to the Remote ETL Engine that you want to deactivate.
  4. Click Deactivate.
    The status is changed to inactive.
  5. To activate the Remote ETL Engine again, click Activate.

To update a Gateway Server 

When the status of the Gateway Server changes to outdated, update it to the latest version. 

Perform these steps:

  1. Launch BMC Helix Continuous Optimization from the BMC Helix Portal.
  2. Select Administration > System > Status.
  3. Click Download corresponding to the Gateway Server with outdated status.
  4. Download the Gateway Server installer and upgrade the Gateway Server. For instructions, see Upgrading-the-Gateway-Server.
    After the Gateway Server is updated, its status changes to running after the status check task is run. You are notified about the status change by email.

Where to go from here

Verify whether the on-premises ETLs and Continuous Optimization Agents are reporting correct data. For more information, see the following topics:

 

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