check_config

The Control-M/Server check_config utility does the following:

  • Reviews key product size properties and settings and notifies you whether they are set to valid values that are suitable for the size of your production environment. These values must be at or above the recommended minimum value.

  • Enables you to adjust these key product values and comply with the recommendations.
  • Enables you to revert any changes made to product values.

Running the check_config Utility

This procedure describes how to run the check_config utility, which checks and adjusts product size configuration.

Begin

  1. Do one of the following:

    • Linux: Log in to a Control-M/Server account.

    • Windows: Open a command prompt window where Control-M/Server is installed.

  2. Run the following command:

    • Linux: $HOME/ctm_server/health_check/utilities/check_config/check_config.sh [<utility parameters>]

    • Windows: "<Server_Home>\ctm_server\health_check\utilities\check_config\check_config.bat" [<utility parameters>]

    For more information, see check_config Parameters.

    The utility generates a report that details multiple verifications and tells you whether each verification passed. Current values are juxtaposed with the minimum expected values.

  • To avoid false alerts, total available RAM measurements often appear higher than the actual physical RAM.

  • BMC Software intends to provide meaningful and accurate recommendations, but does not guarantee that the information is relevant or appropriate to your computing environment. Be aware that the results of the tests are based on specific job attributes that might not reflect your specific scenario.

check_config Parameters

The following table describes the check_config command parameters.

Parameter

Description

-a <action>

Defines one of the following actions to perform:

  • Check: Checks for problems in product size configuration.

  • Fix: Adjusts problematic values of properties and settings.

  • Revert: Reverts the last fix that was performed.

Default: Check

--silent

Disables the prompt for user confirmation during Fix and Revert actions.

Default: Not disabled.

-p <product>

Determines one of the following product components for the action:

  • CTMS: Control-M/Server

  • EM: Control-M/EM

Default: Automatically detected.

-s <size>

Determines the Control-M/Server database size, as follows:

  • Small: Less than 1,000 jobs per day

  • Medium: 1,001–10,000 jobs per day

  • Large: More than 10,000 jobs per day

Default: Automatically detected.

For more information about these sizes, see Control-M/Server Production Size.

-st <status>

Determines the statuses of checked settings to include in the generated report:

  • All: All checked properties and settings, whether or not they passed the checks.

  • True: Properties and settings that passed the checks.

  • False: Properties and settings that failed the checks.

Default: False

-l <debug level>

Determines the configuration check debug level, as follows:

  • DEBUG

  • INFO

  • WARNING

  • ERROR

  • CRITICAL

Default: INFO

-h

Displays the check_config usage.