This documentation applies to the 8.1 version of Remedy ITSM Deployment, which is in "End of Version Support." You will not be able to leave comments.

To view the latest version, select the version from the Product version menu.

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

  1. Open a command prompt window.
  2. Configure the JAVA_HOME environment variable to contain the full Java home path.
  3. 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:
  4. At the command prompt, type one of the following commands, and then press Enter:
    • (UNIX)
    • (Microsoft Windows) mtutility.bat

  5. 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

      ArgumentValue typeDecription



      (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

      Format: MediumTime:LongTime:ExtraLongTime

      Example: 120:400:1800

      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

  6. When you finish providing the arguments, press Enter to start the utility.

Where to go from here

Check the status of the multi-tenancy update

Investigate the multi-tenancy update processing issues

Test the Data Fix

Postinstallation steps for multi-tenancy update

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.