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:
   • 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
     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

     Argument	Value type	Description
     -u	String	AR System administrator user name, mandatory
     -p	String	AR System administrator user name password, mandatory if your system uses a password
     -x	String	Name of AR System server on which the server is installed and the BMC Remedy ITSM applications are deployed, mandatory
     -a	String	Authentication string for user validation
     -t	Integer	AR System communication port number
     -r	Integer	RPC queue number for API private queue
     -timeout	String	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.