This documentation applies to the 8.1 version of Remedy ITSM Deployment, which is in "End of Version Support." You will not be able to leave comments.

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

Preupgrade checks and configuration checks

The following topics are provided:

Overview of the BMC Remedy Configuration Check utility

Use the Configuration Check utility to perform the following type of checks:

  • Pre-upgrade checks, before you upgrade any or all components in the BMC Remedy IT Service Management (ITSM) Suite environment
  • General configuration checks on your system, before you install any or all components in the BMC Remedy ITSM Suite environment

You can perform pre-upgrade checks and configuration checks on the following components:

  • BMC Remedy Action Request (AR) System
  • BMC Atrium Core
  • BMC Remedy ITSM
  • BMC Service Request Management
  • BMC Service Level Management
  • BMC Remedy ITSM Preconfigured Stack Installer
  • Unified Data Management

The output of the BMC Remedy Configuration Check utility is a consolidated report that contains the details of the following information:

SectionDescription
 Summary


Name of the check
Components on which the checks are performed.

Type of check (pre-upgrade or configuration check)

Status of the check
Error or warningsError message for the checks that failed

Hints for the checks that failed

Additional information like actual value and expected value on the checks that failed

 

You can view the configuration check report from the GUI, from the command line interface, or by opening the HTML report file (\result\configchecheckerOutput.html) in a browser.

Performing pre-upgrade checks and configuration checks

The following table lists the tasks for using the BMC Remedy Configuration Check utility to perform pre-upgrade and configuration checks.

StepActionAdditional information
1.

Obtain the BMC Remedy Configuration Check utility

The configcheckerversionNumber_buildNumber.zip file is bundled with the BMC Remedy AR System installer. For information about how to obtain the files that you need for installation, see Downloading the installation files in the BMC Remedy AR System documentation.

Note: Ensure that the value of JAVA_HOME is set correctly. Use Java 1.6 or later.

2.

(Optional) Set the configuration check preferences

Before you run the BMC Remedy Configuration Check utility, you can optionally set the following preferences:

  • BMC Remedy AR System version — By default, the BMC Remedy Configuration Check utility is configured to run a check for BMC Remedy AR System 8.1 installation or upgrade. If you want to run the configuration check for prior versions, you can change the target release. For more information, see setting the target release.
  • Report mode — By default, the BMC Remedy Configuration Check utility generates a report in warn mode. You can set the report mode to info, warn (default), or error, as per your preferences. For more information, see the information about setting the report mode.
3.Run the Configuration Check utility

You can run the BMC Remedy Configuration Check utility in one of the following modes:

Important:

  • Run the utility locally on a computer on which BMC Remedy AR System is installed. Do not run the utility remotely.
  •  For the BMC Atrium Core checks, the Configuration Check utility has a dependency on the CDMChecker utility. For the checks to generate correct results, ensure that you take the following actions:
    • Run the BMC Remedy Configuration Check utility on the machine on which BMC Atrium Core is installed. Do not run the utility on a remote machine.
    • Deploy CDMChecker 8.1.02 or Hotfix provided in version 8.1.01, as documented here.
4.View the log files

When you run the BMC Remedy Configuration Check utility, a log file is generated and placed in ./configchecker/Logs. Logs can be generated at the Info (default) or Debug level.

For more information, see Viewing configuration check log files and changing logging level.

5.View the configuration check reports

After you run the BMC Remedy Configuration Check utility, it generates a consolidated HTML report from the configuration check result file (configcheckResult.xml). The utility generates a single report for all the components in the BMC Remedy ITSM suite environment that were selected for performing the check. 

For more information about locating and understanding the configuration check report, see Viewing configuration check reports.
6.

Understand the configuration checks and results

You can run the configuration checks for the various components in the BMC Remedy ITSM Suite environment. The following topics list the pre-upgrade and configuration checks, their expected results, and the corrective actions:

Configuration checks on a single server and in a server group environment

How you run the BMC Remedy Configuration Check utility depends on your environment:

  • Single Server environment — If your environment uses a single BMC Remedy AR System server, run the BMC Remedy Configuration Check utility directly on the AR System server that you use for your data load jobs. Do not run the Configuration Check utility remotely.
  • Server Group environment — For this type of environment, run the BMC Remedy Configuration Check utility from the server in the group on which escalations are enabled. The utility runs against all of the servers.

    Note

    • If you configured a default Carte server, you need to address only the error or warning messages that the BMC Remedy Configuration Check utility issues for the Carte server. You can safely ignore the messages issued for the other AR System servers in the group.
    • If you configured a default Carte server and are running load balancing in your environment, you must also pay attention to any error or warning messages related to the Pentaho plug-in that the BMC Remedy Configuration Check utility issues for all of the AR System servers in the group.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments