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-premises 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

Important

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.

Installing-remote-components-to-collect-on-premises-data

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

23.1_status_page.png

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 review the logs of the remote scheduler that manages ETL tasks on Remote ETL Engines.

Example scenarios

Update all Remote ETL Engines

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

After the recent monthly release of BMC Helix Continuous Optimization, he receives an email notification about the outdated status of Remote ETL Engines. He checks the status page and clicks Update all ETL Engines to update all of them. He knows that all the Remote ETL Engines run in production environments, and the on-premises ETLs that run on these ETL Engines collect data for business-critical applications. To automatically update these Remote ETL Engines in the future, he configures the Remote ETL Engine Updater task to schedule the periodic update.

Update a specific Remote ETL Engine

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 2 Remote ETL Engines need to be updated to the latest version. He immediately checks the Status page and observes that 2 remote ETL Engines are in an outdated state. Out of these Remote ETL Engines, one is used in a production environment and other in a test environment.

He clicks Update in the status box corresponding to the Remote ETL Engine that is used in the production environment. He confirms with his team that the update of other Remote ETL Engine that is in the test environment can wait. After the Remote ETL Engine in the production environment is updated, he runs the ETLs again that were not reporting correct data and observes that the issue is resolved.

To check the status of components

Launch BMC Helix Continuous Optimization from the BMC Helix Portal.
Select Administration > System > Status.

Perform the following steps based on the status:

Status	Details	Action required
Running	Indicates that the component 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.	Review the deployment logs to troubleshoot issues. Update the Remote ETL Engine again. For details, see Updating the Remote ETL Engine.
Error	Indicates that the Remote ETL Engine update failed.	Review the deployment logs to troubleshoot issues. Update the Remote ETL Engine again. For details, see Updating the Remote ETL Engine

To update a Remote ETL Engine

With every monthly release of BMC Helix Continuous Optimization, a new version of a Remote ETL Engine becomes available and the status of the Remote ETL Engines in your environment becomes outdated. We recommend updating the Remote ETL Engines to the latest version to use the new features and updates. You can update all or specific Remote ETL Engines or schedule to update all of them by configuring the Remote ETL Engine Updater task.

To update all or specific Remote ETL Engines

Important

If any errors occur during the REE update, check if watchdog.sh is scheduled by Crontab or another scheduling tool. If watchdog.sh is not scheduled, enable Crontab or schedule <BCO_HOME>/tools/watchdog.sh scheduler /bmc/hco/scheduler/log/scheduler.pid by using another scheduling tool.

Launch BMC Helix Continuous Optimization from the BMC Helix Portal.
Select Administration > System > Status.
Perform one of the following steps:
1. To update all Remote ETL Engines, click Update all ETL Engines.
  A confirmation message about the start of the update operation is displayed. The status of all the Remote ETL Engines is changed to Updating. After the update is successful and the next status check is performed, the status of all Remote ETL Engines is changed to Running. You are also notified by email after the status is changed.
2. To update a specific Remote ETL Engine, 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.
If the status of a 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 > Retry update.

To define a schedule to update all Remote ETL Engines

You can configure the Remote ETL Engine Updater task to schedule the update of all the Remote ETL Engines. This task runs as scheduled and it verifies whether the update can be performed based on the Remote ETL version. If no update is required, the task ends without performing any update.

The following video illustrates how to schedule the update:

Video attachment not found.

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:

Launch BMC Helix Continuous Optimization from the BMC Helix Portal.
Select Administration > System > Status.
Click corresponding to the Remote ETL Engine that you want to deactivate.
Click Deactivate.
The status is changed to inactive.
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.