Administer > Service Request Catalog Customization > Using the Migration Tool

Using the Migration Tool

The Service Request Catalog Migration Tool is a dedicated tool to preserve your Service Request Catalog customizations as you migrate to Service Manager.

What does the Migration Tool do?

Some files in Service Request Catalog are open for customization. Without the Migration Tool, you must migrate any customizations manually to complete the migration process. Doing this manually exposes the process to potential mistakes. The Migration Tool copies the customized files to the new Service Request Catalog release directly and merges certain customized files into the Service Request Catalog9.61 release.

Migration Tool usage

$TOOL_HOME refers to the folder to which you extracted this tool.

$SOURCE_SRC refers to the folder in which the older version of Service Request Catalog is deployed and which contains the customizations you wish to migrate.

$TARGET_SRC refers to the folder in which you are deploying the new version of Service Request Catalog.

Linux usage:

To use the migration tool in a Linux operating system, follow these steps:

  1. Grant execution permission for migrateSRC.sh. To do this, navigate to $TOOL_HOME and then run the following command:

    chmod u+x bin/migrateSRC.sh

  2. Launch the Migration Tool by running the following command:

    bin/migrateSRC.sh $SOURCE_SRC $TARGET_SRC

  3. Follow the onscreen instructions to migrate the specific migrations you wish to move to the new version of Service Request Catalog.

Windows usage:

To use the migration tool in a Windows operating system, follow these steps:

  1. Double-click the migrateSRC.bat file in the $TOOL_HOME\bin\ directory.
  2. Follow the onscreen instructions to migrate the specific migrations you wish to move to the new version of Service Request Catalog.

Note Currently, you can use this tool to migrate from Service Request Catalog 1.40, or Service Request Catalog 9.32 or Service Request Catalog 9.33, or Service Request Catalog 9.34, or Service Request Catalog 9.35, or Service Request Catalog 9.40, to Service Request Catalog9.61.