Running the Configuration Check utility in GUI mode

This mode provides an interactive way through which you can set your configuration check preferences, select components and checks, run the checks, and view the result as an HTML Report. 

The following topics are provided:

• • Before you begin
  • To run the BMC Remedy Configuration Check utility in GUI mode
  • Where to go from here
  • Related Topics

Before you begin

• Some content is unavailable due to permissions.

• Extract the configcheckerversionNumber_buildNumber.zip file before running the utility. 
• Run the pre-upgrade checks by using the same version of Configuration Check utility as that of BMC Remedy AR System server to which you want to upgrade.

To run the BMC Remedy Configuration Check utility in GUI mode

1. Run the following file from the configchecker folder:
   • (Microsoft Windows) configchecker-ui.bat

   • (UNIX) configchecker-ui.sh

     Note

     For UNIX, provide executable permissions to configchecker-ui.sh. Use any X-Server utility (for example, MobaXterm) to start the configuration check GUI.

     The following window is displayed:
     

2. Complete the fields that require inputs.

   The [expand] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it. 

   The configuration is saved in the configchecker_config.xml file. If you change the configuration, the configuration file is saved as a new file, and subsequent changes are made to that file. (The original configuration file that is shipped with BMC Remedy AR System is backed up as a separate file.)

3. Click Next to open a window that displays all available checks based on the inputs that you provided in the previous window.

   Some of the inputs are displayed in read-only mode at the top of this window. The Summary tab displays the precheck name, the product for which the check will be run, and the status of the check.

   Note

    When you click Next, the AR Server, Temp Dir, and AR Install Dir fields are validated. If an error occurs, you must resolve it before going to the next window.

   The following window is displayed:
   

    

4. Select the required prechecks, and click Run to execute the selected checks.

   After the checks are executed:

   • If all checks pass, no messages are displayed on the Details tab.
   • If errors or warnings are present, they are displayed in detail on the Details tab. 
   • For failed checks, in the GUI mode a Hints column is displayed, containing information about errors that occur.

The detailed report generated after running the checks can be viewed in the HTML format by clicking the HTML Report button. The Configuration Check HTML Report displays the Pre Check Summary and Details tabs.  For details, see Viewing-configuration-check-reports.

Where to go from here

Viewing-configuration-check-reports

Viewing-configuration-check-log-files-and-changing-logging-level

Related Topics

Running-the-Configuration-Check-utility-in-interactive-command-line-mode

Running-the-Configuration-Check-utility-in-silent-mode