This documentation supports the 9.0 version of BMC Remedy ITSM Deployment.

To view the latest version, select the version from the Product version menu.

BMC Atrium Core checks

This topic provides information about the checks performed by the BMC Remedy Configuration Check utility for BMC Atrium Configuration Management Database (BMC Atrium CMDB). It also describes the expected results of the checks and corrective actions to be taken if a check fails.

BMC recommends that you run all the pre-upgrade checks before you upgrade to a higher version. If you encounter any error or warning, address the issue as it may prevent a successful upgrade.

 

CMDB - Enum Attribute Customization Check 

Description

This check verifies whether any custom ID values were added to the selection type attributes (OSType , SystemType, ProcessorFamily). If a custom value is added to the list, it is considered as a customization.

Note: Before this check was introduced, customizations were included in the regular enum list. Now, they are included within the custom ID range. For more information on enum types, see Enum Type. BMC Atrium Core has reserved a range of enum IDs from 0 to 10,000 for these selection type attributes. All new custom values must be added with ID value starting from 10,001. 

Type

(Version 9.0 SP 1 or later) pre-upgrade check 

Check performed and expected result

If the above mentioned customization is detected, the custom values are moved to the custom ID range (10,001 onwards). Duplicate customizations are prefixed with an _ (underscore).

The details are logged in the CMDB Server Log. For example, <WARN  > <TID: 0000000360> <User: sa> /* Sun Jul 19 2015 23:13:19.318 */   Moving item Windows 10 from index 77 to index 10001 as _Windows 10.Similar Item added at 78.  

Corrective actionModify your script to accommodate the change in ID and notation.

 Go to top

 CMDB - Max-Num-Caches Check

DescriptionThis check verifies whether the value of Max-Num-Caches is other than 1 and whether the Development cache mode is ON.

If the parameter Max-Num-Caches:1 is enabled in the ar.cfg (or ar.conf) file and the Development cache mode is OFF, the installation of BMC Atrium Core 9.0 can fail. However, if you set the Development cache mode to ON, Max-Num-Caches:1 has not effect.

Type

(Version 9.0) pre-upgrade check, configuration check  

(Version 9.0 SP1) configuration check 

Check performed and expected result

If the parameter Max-Num-Caches:1 is enabled in the ar.cfg (or ar.conf) file and the Development cache mode is OFF, the check fails and displays the following error message:

Max-Num-caches set to 1. This may cause Atrium upgrade failure. Disable this parameter in ar.cfg/ar.conf file -OR- turn ON Development cache mode.

Corrective actionDisable the parameter Max-Num-Caches:1 in the ar.cfg (or ar.conf) file, or set the Development cache mode to ON.

Go to top

CMDB - Remedy Application Password Check

DescriptionThis check verifies whether the BMC Remedy Configuration Check utility can communicate with the BMC Remedy AR System server by using the password provided for members of the server group. This check validates whether a valid password is stored in the UDM:RAppPassword form.
Type

(Version 9.0) configuration check

Check performed and expected result

If no password is stored in the UDM:RAppPassword form or the stored password is incorrect, the check fails and displays the following error message:
The check could not verify the password for: 'Remedy Application Service' on '<hostname>' : <full error message>.

Corrective ActionUpdate the password on the UDM:RAppPassword form for the suggested server.

Go to top

CMDB - Schema Data Threshold Check

Description

This check validates forms for the data threshold limit for the records size.

Type

(Version 9.0) pre-upgrade check, configuration check

(Version 9.0 SP 1) configuration check 

Check performed and expected result

This check validates the following forms and their data threshold limits:

  • UDM:JobLog — 1000

  • RE:Job_Runs — 1000

  • RE:Job_Events — 10000

  • EIE:Log — 5000

  • EIE:Exchange_Runs — 1000

  • NE:JobRun — 1000

  • DSM:Log — 500

If the number of records in any of the forms exceeds the threshold limit, the check fails and displays the name of the form.

Corrective actionManually reduce the number of records in the forms so that the number in each form is lower than the threshold limit.

Go to top

CMDB - System Information

DescriptionThis check validates the configuration of the system on which BMC Atrium CMDB is installed.
Type

(version 9.0) pre-upgrade check, configuration check 

(Version 9.0 SP 1) configuration check 

Check performed and expected result

This check displays the following information:

  • System configuration information such as OS, architecture, and OS version
  • BMC Remedy AR System database type, version, and character set
Corrective actionBecause this check provides information message, no corrective action is required.

Go to top

CMDB Class Overlay Check

Description

This check verifies whether any overlays are created for BMC Atrium CMDB forms.

Note: BMC Atrium CMDB does not support overlay forms.

Type(version 9.0 or later) pre-upgrade check, configuration check
Check performed and expected result

If overlays are created for BMC Atrium CMDB forms, the check fails and displays the details of the overlays.

Corrective actionDelete the overlays from the form before upgrading.

Go to top

CMDB Metadata Check

Description

This check verifies whether BMC Atrium CMDB metadata has any pending metadata operation, using the CDMChecker utility.

Type(Version 9.0 or later) pre-upgrade check, configuration check
Check performed and expected result
  • If a pending metadata operation fails, the log file information is displayed. The log file is AtriumCoreInstallDir/Logs/pending_entries.log
  • If a specific functional failure occurs, a reference to a knowledge article is displayed.

Note:
If the BMC Remedy Configuration Check utility does not find the CDMChecker utility under the cmdb/server/bin directory, it displays an error.

Corrective actionPerform corrective actions according to the log file information or knowledge article information.

Go to top

CMDB OOTB Index Check

Description

This check verifies whether any out-of-the-box (OOTB) indexes are missing.

Note: By default, BMC Atrium CMDB creates OOTB indexes on forms.

Type

(Version 9.0) configuration check

(Version 9.0 SP1) pre-upgrade check 

Check performed and expected resultIf any OOTB index is missing, the check fails and displays the following error message:
Index <index name> is not present.
Corrective actionCreate the missing index manually.

Go to top

Is CMDB Running Check

Description(Version 9.0 or later) This check verifies whether the BMC Atrium CMDB engine is running prior to upgrade.
Type(Version 9.0 or later) pre-upgrade check; configuration check
Check performed and expected result
  • If the BMC Atrium CMDB engine is running, the check is successful.
  • If the BMC Atrium CMDB engine is not running, the check fails and displays an error message.
Corrective actionsEnsure that the BMC Atrium CMDB engine is running before upgrading.

Go to top

Plug-in port configuration Check

DescriptionThis check verifies whether the plug-in port number and host name match with the plug-in server configuration information.
Type

(Version 9.0) configuration check

(Version 9.0 SP 1) pre-upgrade check, configuration check 

Check performed and expected result
  • If the plug-in port specified in the ar.cfg (or ar.conf) file matches the port specified in the pluginsvr_config.xml file, the check is successful.
    If the ports do not match, the check fails and displays the following error:
    Plug in port is not configured correctly, values in ar.cfg and pluginsvr_config.xml do not match
  • For all the plug-ins configured in the pluginsvr_config.xml file, the check validates whether the files specified in the <filename> and <pathelement> parameters actually exist.
    If the files do not exist, the check fails and displays the following error:
    File <filename> configured for Plug-in: <plugin name> does not exists, check pluginsvr_config.xml.
  • For all plug-ins configured in the pluginsvr_config.xml file, the check validates whether a corresponding entry is present in the ar.cfg (or ar.conf) file:
    • If a corresponding entry exists, the check validates whether the port in the pluginsvr_config.xml file matches the port in the ar.cfg (or ar.conf) file.
    • If a corresponding entry does not exist in the pluginsvr_config.xml file and the ar.cfg (or ar.conf) file, but the port numbers do not match, the check fails and displays the following error message:
      Plug in port is not configured correctly, for Plug-in: <plugin name> in Server-Plugin-Alias entry ar.cfg.
    • If corresponding entries do not exist in the pluginsvr_config.xml file and the ar.cfg (or ar.conf) file, the check fails and displays the following error message:
      Configuration for plug-in: <plugin name> is missing in ar.cfg.
  • The check validates if any duplicate entries exist in the pluginsvr_config.xml for a single plug-in. If duplicates exist, the check displays a warning message.

Note:
The BMC Remedy Configuration Check utility considers that pluginsvr_config.xml is always present in the %ATRIUMCORE_HOME%\cmdb\plugins\shared\ directory.

Corrective actions
  • Ensure that the plug-in port specified in the ar.cfg (or ar.conf) file matches the plug-in port specified in the pluginsvr_config.xml file.
  • For all plug-ins configured in the pluginsvr_config.xml file, ensure that the files specified in the <filename> and <pathelement> parameters actually exist.
  • For all plug-ins configured in the pluginsvr_config.xml file, ensure that a corresponding entry is present in the ar.cfg (or ar.conf) file. Also, ensure that the port in the pluginsvr_config.xml file matches the port in the ar.cfg (or ar.conf) file.
  • Ensure that no duplicate entries exist in the pluginsvr_config.xml for a single plug-in.

Go to top

Recon Engine Private Queue Check

DescriptionThis check validates whether the Reconciliation Engine private queue is configured to use either port 390698 or port 390699.
TypeConfiguration check
Check performed and expected result
  • In the ar.cfg (or ar.conf) file, if the value of the Reconciliation Engine private queue is set to any port other than 390698 or 390699, the check fails and displays the following error message:
    Reconciliation Private Port <port number> is not set according to recommended values.
  • In the ar.cfg (or ar.conf) file, if the value of the Reconciliation Engine private queue is not set, the check fails and displays the following error message:
    Private port is not configured for Reconciliation Engine.
  • In the ar.cfg (or ar.conf) file, if the parameter for the Reconciliation Engine private queue is specified but the parameter for BMC Remedy AR System private queue is not specified, the check fails and displays the following error message:
    AR private port is not configured for RE-Private-Port <Port no>.
Corrective actions
  • In the ar.cfg (or ar.conf) file, set the value of Reconciliation Engine private queue to either 390698 or 390699.
  • In the ar.cfg (or ar.conf) file, specify the value of the AR System private queue.

Go to top

Related topics

BMC Remedy AR System checks

BMC Remedy ITSM checks

BMC Remedy ITSM Process Designer checks

BMC Service Level Management checks

BMC Service Request Management checks

Unified Data Management (UDM) checks

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Devendra Yadav

    *CMDB - Schema Data Threshold Check*

    RE:Job_Event does not exist in system, i thing it's RE:Job_Events

    Jul 15, 2015 04:44
  2. Sahil Pathania

    In Plug-in port configuration Check section,  the default port for arplugin is 9999 and cmdb plugin is 9559, but in ar.cofig it is Plugin-Port: 5000 which is specified while installation. health check says "Plug in port is not configured correctly, values in ar.cfg and pluginsvr_config.xml do not match."  we have two pluginserver_config  files for arplugin and cmdb plugin.

    Now  does everywhere port should be same ? does arplugin and cmdb plugin listen at different port? 

    Dec 01, 2015 03:28
    1. Amit Durgapal

      Hello Sahil,

       

      Thanks for writing to us!

      All plug-ins within a plug-in server are set to the the same port. arplugin and cmdb plug-in servers listen at different ports. The ar.cfg file lists the plug-in server and plug-in instance port details.  

      Regards,

      Amit

      Dec 01, 2015 04:53
    1. Devendra Yadav

      Please Ignore the error , it was defect in prechecker and fixed in newer releases.

      Dec 08, 2015 09:45