Postinstallation checks


After the installation of BMC Remedy AR System and its components is complete, postinstallation checks are automatically run for the components that you have selected during the installation. Sample data is run as part of the postinstallation check to verify that the component is installed and is working correctly.

The status of the postinstallation checks is displayed on the Installation Summary screen as follows:

Installation Summary Screen.png

Viewing the postinstallation checks status in the AR System Maintenance Tool

You can also run the postinstallation checks through the BMC Remedy AR System Maintenance Tool using the Health Check tab. You can run these checks on the components selected during the installation any number of times after the installation is complete.

For more information, see Collecting-logs-diagnostics-and-performing-system-health-check-using-the-Maintenance-Tool.

BMC Remedy AR System server postinstallation check

The following items are checked after you install BMC Remedy AR System:

  • Verify whether connections to the database instance are successfully created.
  • Verify whether you are able to perform basic AR System operations such as create and set entries and create and set forms.
  • Verify whether the plug-ins are installed and you are able to connect to the plug-in server.

If the checks fail, the following error messages are displayed on the Health Check Summary window of the Maintenance Tool:

Error Message

Cause

Failed to connect to AR Server

The sample form cannot connect to the Assignment Engine or the Approval Server

Sample form creation check failed

Sample form create operation fails

Sample field creation check failed

Sample field create operation fails

Sample entry creation check failed

Create entry operation on sample form fails

Sample entry modification check failed

Modify entry operation on sample form fails

Sample entry deletion check failed

Delete entry operation on sample form fails

AR Server post installation check failed

If there is any problem communicating with the Assignment Engine or the Approval Server

Sample plugin call check failed

Communication to the plug-in server fails


Note

If all the BMC Remedy AR System postinstallation checks are successful, the AR Server post installation check passed message is displayed.

BMC Remedy Assignment Engine postinstallation check

After you install BMC Remedy AR System, a sample application is created for the Assignment Engine, which contains:

  • Forms — DAssignee, DRequest
  • Assignment Process — DProcess
  • Assignment Rule — select driver
  • Filter — DRequest_trigger_assignment

Note

The data created on the sample forms is deleted after the check is run successfully.

The sample application, that is, the forms, filter, process, and rules are created only once and re-used later. 

The Assignment Engine postinstallation check does the following to verify that the Assignment Engine is installed and is working correctly:

  • Verifies that the Assignment Engine process is running.
  • Creates a request in the DRequest sample form.
  • Verifies that the sample form is getting assigned to the sample assignee.

If the check fails, the following error messages are displayed on the Installation Summary screen of the installer or on the Health Check Summary screen of the Maintenance tool:

Error message

Cause

Assignment Engine process is down

Assignment Engine process is not running correctly

Assignment Engine is not functioning properly

Assignment Engine process on the sample form is not working

Assignment Engine post installation check failed

Problem communicating with the BMC Remedy AR System server


Note

If the Assignment Engine is working correctly, the Assignment Engine post installation check passed message is displayed.

BMC Remedy Distributed Server Option postinstallation check

After you install BMC Remedy AR System, a sample application is created to verify that the Distributed Server Option (DSO) is installed and is working correctly. This sample application contains:

  • Forms — DSO-Sample:Source, DSO-Sample:Destination
  • Distributed Mapping — DSO-Sample:Mapping
  • Filter — DSO-Sample: DSO Transfer

Note

The data created on the sample forms is deleted after the check is executed successfully. 

The sample application—that is, the forms, filter, process, and rules—are created only once and reused later. 

The DSO postinstallation check does the following to verify that the DSO is installed and is working correctly:

  • Verifies that the DSO process is running.
  • Creates a request in the sample form, DSO-Sample:Source.
  • Verifies that the sample form is transferred to the sample destination form, DSO-Sample:Destination.

If the check fails, the following error messages are displayed on the Health Check Summary screen of the Maintenance tool:

Error message

Cause

DSO process is down

DSO process is not running

AR Distributed Server license is not applied

DSO process is not running due to the absence of a DSO license

DSO process is commented in armonitor.cfg file

DSO process is not running because the DSO process entry is commented in the armonitor.cfg file

Default distributed pool is configured as polling thread, hence can not perform DSO post install check

Default distributed pool of DSO is configured in polling mode

DSO is not functioning properly

Error message

Cause

Sample DSO Transfer operation check failed

DSO transfer operation on the sample form, DSO-Sample:Source is not working correctly

Sample DSO Update operation check failed

DSO update operation on the sample form, DSO-Sample:Source is not working correctly

Sample DSO Delete operation check failed

DSO delete operation on the sample form, DSO-Sample:Source is not working correctly

DSO post installation check failed

If any of the above checks fail


Note

If all DSO operations on the sample forms are working correctly, the DSO post installation check passed message is displayed.

BMC Remedy Approval Server postinstallation check

After you install BMC Remedy AR System, the Approval Server postinstallation check does the following to verify that the Approval Server is installed and is working correctly:

  • Verifies that the Approval Server process is running.
  • Creates a sample data on the AP-Sample2:Get Agreement form.

Note

The data created on the sample forms is deleted after the check is executed successfully.

If the check fails, the following error messages are displayed on the Installation Summary screen of the installer or on the Health Check Summary screen of the Maintenance tool:

Error Message

Cause

Approval Server post installation check failed

Approval Server is not working correctly or if any failure occurs during execution

Approval Server service is not running

Approval Server process is down


Note

When the Approval Server is working correctly, the Approval Server post installation check passed message is displayed. 

For information about troubleshooting BMC Remedy Approval server installation issues, Troubleshooting-Remedy-Approval-Server-installation-and-upgrade-issues.

BMC Remedy Email Engine postinstallation check

After you install BMC Remedy AR System, the Email Engine postinstallation check does the following to verify that the Email Engine is installed and is working correctly:

  • Verifies that the Email Engine process is running.
  • Creates a sample data on the AR System Email Messages form.

Note

The data created on the sample forms is deleted after the check is executed successfully.

If the check fails, the following error messages are displayed on the Installation Summary screen of the installer or on the Health Check Summary screen of the Maintenance tool:

Error Message

Cause

Email Engine process is down

Email Engine process is down

Email Engine is not functioning properly

Email Engine is not working correctly

Email Engine is not configured

Email Engine is not configured

Email Engine is not configured for post install check execution

Mailbox polling interval is in minutes, the Email Engine postinstallation check is skipped

Email Engine post installation check failed

If any failure occurs during the working of the Email Engine


Note

When the Email Engine is working correctly, the Email Engine post installation check passed message is displayed. The Email Engine postinstallation check also verifies remote Email Engine installation.

BMC Remedy Migrator postinstallation check

After you install BMC Remedy AR System, the Migrator postinstallation check does the following to verify that the Migrator is installed and is working correctly:

  • Verifies that the Sample::Enrollments sample form is available on the BMC Remedy AR System server.
  • Collects the BMC Remedy AR System server logon credentials from the user to verify that the BMC Remedy AR System server is running.
  • Executes the Run MigratorCli command for migrating the sample form from the BMC Remedy AR System server to a temporary migrator file created in the directory where migratorcli.exe exists. A temporary log file is also generated here.

On successfully performing the preceding operations, the sample form is migrated from the migrator file back to the BMC Remedy AR System server.

Note

The data created on the sample forms is deleted after the check is run successfully.

If the check fails, the following error messages are displayed on the Installation Summary screen of the installer or on the Health Check Summary screen of the Maintenance tool:

Error Message

Cause

Migrator CLI run command failed

Migrator license is not available on the target server

Migrator CLI run command failed

Sample::Enrollments sample form is not available on the target server

MigratorCli tmp log file not found

Temporary log file is not generated


Note

When the Migrator is working correctly, the Migrator post installation check passedmessage is displayed.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*