Starting the multi-tenancy update utility manually
You will use this procedure only in the following situations:
- You made customizations to the multi-tenancy model.
- You selected to bypass the multi-tenancy update during the main installation (after the installer prompted you because your environment has more than 20 million records).
- You encountered errors during an earlier run of the multi-tenancy update and need to restart the update.
- You performed a delta data migration (DDM) and need to apply the multi-tenancy updates to the delta data.
To start the multi-tenancy update utility manually
- 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.