This documentation applies to the 8.1 version of Remedy IT Service Management Suite, 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

This topic describes how to manually start the multi-tenancy update utility. You use this procedure only in the following situations:

  • You selected to bypass the multi-tenancy update during the main installation (after being prompted by the installer, because your environment has more than 20 million records).
  • You encountered errors during an earlier run of the mult-tenancy update and need to restart the update.
  • You have performed a delta data migration and need to apply the multi-tenancy updates to the delta data.

To start the 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 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
      Click the following image to expand it.
  5. Select a mode in which to run, Mode 1 or Mode 2, and provide the arguments.
    • Mode 1, or (1) Command — You type the command arguments that are listed in the following table on the command line.
    • Mode 2, or (2) Interactive — The utility prompts you for the arguments one at a time.
      Multi-tenancy update utility arguments


      Value type




      AR System administrator user name, mandatory



      AR System administrator user name password, mandatory if your system uses a password



      Name of AR System server on which the server is installed and the BMC Remedy ITSM applications are deployed, mandatory



      Authentication string for user validation



      AR System communication port number



      RPC queue number for API private queue



      AR System timeout values, in seconds
      Format = MediumTime:LongTime:ExtraLongTime
      Example: 120:400:1800
      Note: If the multi-tenancy update utility is timing out because the server is
      busy or if the utility is taking a long time to respond after recaching, you must
      increase the timeout values. For example, you would increase the values
      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
      Click the following image to expand it.

      Mode 2, or (2) Interactive
      Click the following image to expand it.
  6. When you finish providing the arguments, press Enter to start the utility.

For more information

To troubleshoot records that are in Fail or Pending status, see Troubleshooting the multi-tenancy update.
For general information, see Update to the multi-tenancy model.

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.