Migrating › How to Migrate

How to Migrate

You migrate CA Service Catalog products and components from one system to another for several reasons. Examples include upgrades, test-to-production moves, best practices, governance, security, or resource-related reasons. To migrate from one system to another, for example, from test to production, perform these tasks:

1. Restore the MDB database backup of the test system into your production system. You backed up this system while performing the prerequisite tasks.

   During this process, select the option for overwriting the existing MDB database.

   For instructions to restore the database, see your DBMS documentation.

2. Unregister the CA EEM application used by the production system, as follows:
   1. Log in to the Global Application of CA EEM as the EiamAdmin user
   2. Select Configure, Applications, Service Catalog application.

      If your systems use a different name than Service Catalog for the CA Service Catalog application name, use that name instead.

   3. Click the UnRegister button.
3. Back up the CA EEM data on the CA Service Catalog computer in your test system, as follows.

   If you have multiple CA Service Catalog computers, perform this step on the first (formerly primary) CA Service Catalog computer. You run this command once, regardless of how many CA Service Catalog computers your system has.

   1. Open the CA Service Catalog command prompt by clicking Start, Programs, CA, Service Catalog, Service Catalog Command Prompt.
   2. Run the following command at the command prompt:

      ant backup-eem-app 
      

      This action generates a file named eem-backup.xml in the USM_HOME directory.

      USM_HOME is the documentation convention that specifies the local CA Service Catalog installation directory. For 32-bit computers, the default path name is C:\Program Files\CA\Service Catalog. For 64-bit computers, the default path name is C:\Program Files (x86)\CA\Service Catalog for 32-bit installations or C:\Program Files\CA\Service Catalog for 64-bit installations.

4. Copy the following files from the CA Service Catalog computer in the test system to the CA Service Catalog computer in the production system.

   If you have multiple CA Service Catalog computers, perform this step on the first (formerly primary) CA Service Catalog computer in each system. You copy these files once, regardless of how many CA Service Catalog computers your system has.

   • USM_HOME\seeddata.properties
   • USM_HOME\filestore folder

     This folder may exist on a different computer than the current computer. To verify its location, select Administration, Configuration, Filestore Information. If no filestore location is specified, you do not need to copy this folder now. However, as a best practice, soon after the migration, set up a single location for shared files.

   • USM_HOME\eem-backup.xml
5. Run the following commands–in the order shown–on all CA Service Catalog computers in the production system.

   Important! Follow these steps: on each computer, one computer at a time, until you have run them on all CA Service Catalog computers. For example: first, Follow these steps: on computer1; next, Follow these steps: on computer2; third, Follow these steps: computer3; and so on.

   1. Update the password of the database user to help ensure that CA Service Catalog continues to run efficiently throughout your environment.

      Verify that the password you specify adheres to your organizational standards.

   2. Update the host name, port, instance, or service name for the database, as needed.

      CA Service Catalog components use these settings to communicate with each other and the database.

      Important! The database host name that you specify must be different than the one used in the test system. Updating the other settings is optional.

   3. Run the ant restore-eem-app command.

      This command restores the CA EEM database from the test system to the production system, using the eem-backup.xml that you copied earlier.

   4. Run the ant update-usm-host command.

      This command enables you to change the host name and port number for a computer running CA Service Catalog.

      Important! All host names for CA Service Catalog and CA Workflow on the production system must be different from the ones in the test system. Updating the other settings is optional.

      For details about this command, see How to Update the Host Name and Port Number for CA Service Catalog.

6. Start all CA Service Catalog services on all computers in the production system: CA Service Accounting and CA Service Catalog.
7. Log in to CA Service Catalog in the production system and select Administration, Configuration, and update the configuration sections for the following:

   Important! If your post-migration environment does not include any option in the list, update the configuration settings accordingly to remove the integration! Similarly, if your post-migration environment does include any of these options, do the following: Verify that the host names, port numbers, and other configuration data are correct for your post-migration environment. Remember that setting up a filestore location is a best practice, as mentioned earlier.

   • Filestore
   • CA Service Desk Manager integration
   • CA CMDB integration
8. Test by verifying that the same users, services, requests, and so forth that existed in the test system also exist in the production system.

You have migrated CA Service Catalog.