Error: Invalid spaceKey on retrieving a related space config.

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:

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 MessageCause
Failed to connect to AR ServerThe sample form cannot connect to the Assignment Engine or the Approval Server
Sample form creation check failedSample form create operation fails
Sample field creation check failedSample field create operation fails
Sample entry creation check failedCreate entry operation on sample form fails
Sample entry modification check failedModify entry operation on sample form fails
Sample entry deletion check failedDelete entry operation on sample form fails
AR Server post installation check failedIf there is any problem communicating with the Assignment Engine or the Approval Server
Sample plugin call check failedCommunication 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 messageCause
Assignment Engine process is downAssignment Engine process is not running correctly
Assignment Engine is not functioning properlyAssignment Engine process on the sample form is not working
Assignment Engine post installation check failedProblem 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 messageCause
DSO process is down

DSO process is not running

AR Distributed Server license is not appliedDSO process is not running due to the absence of a DSO license
DSO process is commented in armonitor.cfg fileDSO 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 checkDefault distributed pool of DSO is configured in polling mode

DSO is not functioning properly

Error messageCause
Sample DSO Transfer operation check failedDSO transfer operation on the sample form, DSO-Sample:Source is not working correctly
Sample DSO Update operation check failedDSO update operation on the sample form, DSO-Sample:Source is not working correctly
Sample DSO Delete operation check failedDSO delete operation on the sample form, DSO-Sample:Source is not working correctly
DSO post installation check failedIf 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 MessageCause
Approval Server post installation check failedApproval Server is not working correctly or if any failure occurs during execution
Approval Server service is not runningApproval 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, BMC 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 MessageCause
Email Engine process is downEmail Engine process is down
Email Engine is not functioning properlyEmail Engine is not working correctly
Email Engine is not configuredEmail Engine is not configured
Email Engine is not configured for post install check executionMailbox polling interval is in minutes, the Email Engine postinstallation check is skipped
Email Engine post installation check failedIf 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 MessageCause
Migrator CLI run command failedMigrator license is not available on the target server
Migrator CLI run command failedSample::Enrollments sample form is not available on the target server
MigratorCli tmp log file not foundTemporary log file is not generated


Note

When the Migrator is working correctly, the Migrator post installation check passedmessage is displayed.
Was this page helpful? Yes No Submitting... Thank you

Comments