Federation Manager Installation and Upgrade Guide › Migrate to Federation Manager r12.5 › How to Migrate to r12.5 › Migrate the Key Database to the Certificate Data Store › Run the Migration Utility to Move Data to the CDS

Run the Migration Utility to Move Data to the CDS

After you review the considerations for migrating the key database to the CDS, run the migration utility, named smmigratecds.

Follow these steps:

1. Be sure that all r12.x smkeydatabases are synchronized.
2. Log in to an r12.x host system and go to the following location:

   federation_mgr_home\siteminder\config\properties
   

   federation_mgr_home

   Specifies the Federation Manager installation path.

3. Copy the following file

   smkeydatabase.properties
   

4. Log in to an r12.5 host system and complete the following steps:
   1. Go to the following location:

      federation_mgr_home\siteminder\config\properties
      

   2. Rename the r12.5 version of the smkeydatabase properties file to the following value:

      newsmkeydatabase.properties
      

   3. Add the r12.x version of the properties file to the directory.
   4. Open the r12.5 and the r12.x properties file in a text editor.
   5. Edit the database location path in the r12.x version to match the path in the r12.5 version.

      Windows Example

      DBLocation=C:\CA\FederationManager\siteminder\smkeydatabase
      

      Solaris/Linux Example

      DBLocation=export/fedmgr/CA/FederationManager/siteminder/smkeydatabase
      

   6. Save the r12.x properties file and close the r12.5 properties file.
   7. Create the following directory at the root of the Federation Manager installation:

      smkeydatabase
      

      Windows Example:

      C:\Program Files\CA\FederationManager\siteminder\smkeydatabase
      

      Solaris/Linux Example

      export/fedmgr/CA/FederationManager/siteminder/smkeydatabase
      

5. Return to the r12.x host system and copy the contents of the smkeydatabase directory.
6. Return to the r12.5 host system and complete the following steps:
   1. Add the contents of the r12.x smkeydatabase directory to the r12.5 smkeydatabase directory you created.
   2. Migrate the smkeydatabase to the certificate data store by entering the following command:

      smmigratecds
      

   3. After a successful migration, remove the smkeydatabase properties file and the smkeydatabase directory.

The migration is complete.

If the key database migration fails, you can migrate to the CDS manually. Refer to the information on how to troubleshoot a key database migration.