Troubleshooting the multi-tenancy update
The Multi-Tenancy utility is run as a part of the installer. Do not run the utility manually unless you encounter errors during the multitenancy update. Also, after performing delta data migration, you need to run the upgrade utility manually to apply multitenancy updates to the delta data.
If the multi-tenancy update utility encounters a condition that prevents it from finishing the updates to a form and its associated data, it moves the form to the Fail status. You can determine the cause of failure by reviewing either the or the on the BMC Remedy AR System server.
To run the Multi-Tenancy update utility manually
If you are upgrading from version 9.1 to a later version, you do not need to run the Multi-Tenancy utility. By default, the Tenancy Mode is set to Multi-Tenancy in the System Settings form.
- Open a command prompt window.
- Configure the JAVA_HOME environment variable to contain the full Java home path.
- Navigate to %INSTALL_DIR%\BMCRemedyITSMSuite\Utilities\BMCMultiTenancyUtility\artools.
Use one of the following strings for the %INSTALL_DIR%variable, according to the BMC Remedy IT Service Management (ITSM) application that you are upgrading:
- At the command prompt, type one of the following commands, and then press Enter:
- (Microsoft Windows)
- Select a mode in which to run, Mode 1 or Mode 2, and provide arguments:
- Mode 1, or
(1) Command— On the command line, type the command arguments that are listed in the following table.
Mode 2, or
(2) Interactive— The utility prompts you for the arguments one at a time.
Multi-tenancy update utility arguments
Argument Value type Decription
(Mandatory) BMC Remedy AR System administrator user name.
(Mandatory if your system uses a password) BMC Remedy AR System administrator password.
(Mandatory) Name of the server on which the AR System server is installed and the BMC Remedy ITSM applications are deployed.
Authentication string for user validation.
BMC Remedy AR System communication port number.
Remote Procedure Call (RPC) queue number for API private queue.
BMC Remedy AR System timeout values, in seconds
Note: If the multi-tenancy update utility times out because the server is busy, or if it takes a long time to respond after re-cacheing, you must increase the timeout values. For example, you would increase the value 120:400:1800, provided in the preceding example, to 300:600:2000.
The following illustrations provide an example of what the command line looks like for each mode:
Mode 1, or (1) Command
Mode 2, or (2) Interactive
- Mode 1, or
- When you finish providing the arguments, press Enter to start the utility.
To troubleshoot the multi-tenancy update
- On the BMC Remedy AR System server, .
- Open the Application Maintenance console.
- On the IT Home page, click the Application Administration Console link.
- Click on the Custom Configuration tab.
- Expand the Foundation list.
- Expand Advanced Options list.
- Click on Application Maintenance console.
- From the Maintenance Group list, select Multi-Tenancy.
- From the View By list, select All Products.
- Check the Status of each form.
- Successful status indicates that multitenancy update for a form is successful.
- Fail status indicates failure.
- Pending status indicates that the multi-tenancy update utility has not yet started to process the form.
See the following snapshot:
- Find the entry in the Application Maintenance console with the Fail status, as described in Investigating multi-tenancy update processing issues, then reset the status of the record to Pending. To do this:
- In the Application Maintenance console table, select the record with the Fail status.
Click Reset to Pending.
- On the Application Maintenance console, click Run to start the multi-tenancy update workflow on the record that you reset.
When the workflow finishes running against the selected record, the record returns to the Fail status and processing stops.
- Review the filter and SQL logs to find and then fix the cause of the failure.
After you fix the problem, repeat steps 3 through 5 until the update completes with a status of Successful.
- Search the SHARE:Application Properties form for any records showing the registration of field permission updates. For these records, the Property Name starts with
REGISTER_, for example,
REGISTER_AM_MT. If there are no records starting with
REGISTER_, delete all of the multi-tenancy registration records, including all records where:
Property Name begins with
REGISTER_and the Property Value is Successful ,
and Property Name is
REGISTER_DDM_COUNT_MTand the Property Value is an integer,
and Property Name is
REGISTER_DDM_DATE_MTand the Property Value shows a
current date, Property Name is _
OOTB_MT_AWARE_ENVand the Property Value is true.
- Turn off filter and SQL logging.
- Manually restart the multi-tenancy update utility.