This documentation supports the 9.0 version of BMC Remedy ITSM Deployment.

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:
    • BMC_REMEDY_ITSM_SUITE_HOME
    • BMC_SERVICE_REQUEST_MANAGEMENT_HOME
    • BMC_SLM_HOME
  4. At the command prompt, type one of the following commands, and then press Enter:
    • (UNIX) mtutility.sh
    • (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

      -u

      String

      (Mandatory) BMC Remedy AR System administrator user name.

      -p

      String

      (Mandatory if your system uses a password) BMC Remedy  AR System administrator password.

      -x

      String

      (Mandatory) Name of the server on which the AR System server is installed and the BMC Remedy ITSM applications are deployed.

      -a

      String

      Authentication string for user validation.

      -t

      Integer

      BMC Remedy AR System communication port number.

      -r

      Integer

      Remote Procedure Call (RPC) queue number for API private queue.

      -timeout

      String

      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

Was this page helpful? Yes No Submitting... Thank you

Comments