Agent Health Check
The Health Check utility (HCU) collects the environment information and logs, and puts them into a ZIP (Windows only) or TAR.Z (Linux only) file for troubleshooting purposes. This includes information about the Agent host such as the operating system version, patch level, kernel setting, memory consumption, list of running processes, operating system name, error logs, hardware configuration, and network configuration. This program is used at the request of Technical Support to determine the cause of a problem. The Health Check utility (HCU) creates a log file that specifies the processes that ran and the information that was written to the package file. The contents of the log file indicate what proprietary information is included in the package file.
The HCU utility writes log files to the following directories:
-
Log: <AGENT_HOME>/ctm/proclog/ctma_data_collector_<TIME_STAMP>_<OS_TYPE>_<HOSTNAME>_display.log
-
HCU Package:
-
Windows: <AGENT_HOME>/hcu_package/ctma_data_<TIME_STAMP>_<OS_TYPE>_<HOSTNAME>.zip
-
Linux: ctma_data_<TIME_STAMP>_<OS_TYPE>_<HOSTNAME>.tar.Z
-
Running the Agent Health Check Utility
This procedure describes how to run the Health Check utility with default parameters, which enables you to collect and package the data generally required by BMC Support.
Begin
-
Navigate to the following directory:
-
Windows: <Agent_Home>\exe
-
Linux: $CONTROLM/exe
-
-
Run the following command:
<Full_Pathname>ctma_data_collector
-
To view the entire list of actions performed by the utility, see the log file right after executing the utility.
C:\Program Files\BMC Software\Control-M SaaS Agent\Default\proclog\ctm_data_collector_20201103_110037_MSWin32_vw-tlv-ctm-dvl2_display.log
Agent Health Check Utility Parameters
The following table describes the Health Check utility parameters.
Parameter |
Description |
---|---|
Components |
(Optional) Products and applications that the utility can gather data. |
Category |
Determines the Control-M/Agent specific categories for the Health Check utility, as described in Health Check Utility Category Parameters. |
Profiles |
(Optional) Defines a predefined combination of Components and Categories, as described in Health Check Utility Profile Parameters. If you specify one or more Profiles, do not specify Components or Categories. |
-simulate |
(Optional) Simulates execution of a Health Check utility. This allows the user to verify that specified parameter values are appropriate. |
-days |
(Optional) Defines the maximum number of days in the past to gather the information. This option only affects log files relevant to BMC Software components. Default: 2 |
-max_size |
(Optional) Defines the maximum size (in MB) of the compressed file that is created by the Health Check utility. Default: 300 |
-trace |
(Optional) Runs a trace on the Health Check utility. This generates the following log file: ctm_data_collector_<YYYYMMDD>_<HHMMSS>_<PLATFORM_TYPE>_<HOSTNAME>.log |
-verbose |
(Optional) Creates an output of the utility processes. By default, only processed categories appear. |
-batch |
(Optional) Runs in batch mode without a confirmation request. |
-help, -h |
(Optional) Displays an explanation of how to use the utility. |
Health Check Utility Category Parameters
The following table describes Control-M/EM specific categories for the Health Check utility.
Category |
Description |
---|---|
INST_AG |
Defines the installation parameters for UNIX and Windows. If you run the Health Check utility with INST, it gathers relevant information only if the error occurs after the files are copied during the installation. If you specify the INST Category parameter, you must also specify one or more component parameters. If you specify the INST Category parameter, do not specify categories other than INST. UNIX:
Windows:
|
OS |
Defines the Operating System related physical resource, as follows:
|
BSS |
Defines the component backup, sysout and status directories. |
CNF |
Defines the following component configuration files:
|
LOG |
Defines the following component general diagnostic data collection:
|
UTL |
Defines the component utilities. This information includes sizes of the following tables:
|
MSR_AG |
Defines the component and environment measurements stored in the database, as follows:
|
Health Check Utility Profile Parameters
The following table describes the profile parameters, which are a predefined combination of Components and Categories.
Profile |
Description |
---|---|
ENV |
Collects environment data that includes information the OS Category. |
AG |
Collects Control-M/Agent data. This includes information from the following Categories:
|
EXD_BSS |
Excludes the collection of backup, sysout and status directories. Fewer directories provides a lighter option that shortens the amount of time that the Health Check utility needs to run. - ctma_data_collector -F EXD_BSS |
MSR |
Collects measurement data that includes information the MSR_AG Category. |
LOG_CFG |
Collects environment data and Control-M/Agent configuration data. This includes information from the following Categories:
|
ALL |
Collects data through all Control-M/Agent Profiles, as follows:
|