Run the Migration Utility to Move Data to the CDS

CA SiteMinder® Federation Standalone Installation and Upgrade Guide › Migrate to CA SiteMinder® Federation Standalone 12.52 › How to Migrate to 12.52 › 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:

Be sure that all r12.x smkeydatabases are synchronized.
Log in to an r12.x host system and go to the following location:
```
federation_install_dir\siteminder\config\properties
```
federation_install_dir

Specifies the CA SiteMinder® Federation Standalone installation path.
Copy the following file
```
smkeydatabase.properties
```
Log in to an 12.52 host system and complete the following steps:
1. Go to the following location:
```
federation_install_dir\siteminder\config\properties
```
2. Rename the 12.52 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 12.52 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 12.52 version.
  Windows Example
```
DBLocation=C:\CA\FederationStandalone\siteminder\smkeydatabase
```
  Solaris/Linux Example
```
DBLocation=export/fed/CA/FederationStandalone/siteminder/smkeydatabase
```
6. Save the r12.x properties file and close the 12.52 properties file.
7. Create the following directory at the root of the CA SiteMinder® Federation Standalone installation:
```
smkeydatabase
```
  Windows Example:
```
C:\Program Files\CA\FederationStandaloe\siteminder\smkeydatabase
```
  Solaris/Linux Example
```
export/fed/CA/FederationStandalone/siteminder/smkeydatabase
```
Return to the r12.x host system and copy the contents of the smkeydatabase directory.
Return to the 12.52 host system and complete the following steps:
1. Add the contents of the r12.x smkeydatabase directory to the 12.52 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.

More information:

Troubleshoot a Key Database Migration