Installation Guides › Upgrade Guide › Manual Upgrades › Manually Upgrade the Identity Manager Server › Manually Export the Directories and Environments

Manually Export the Directories and Environments

As of CA Identity Manager r12, objects previously stored in the SiteMinder Policy Store need to be moved to a relational database object store. SiteMinder objects that are no longer used are not deleted after the migration, but you can manually delete them after the upgrade.

Use the Migration Tool (imsconfig.bat/imsconfig.sh) to export your Directory and Environment configurations. Then, use the Management Console to re-import the configurations into CA Identity Manager.

Important! Do not use the Export button under Environments in the Management Console when performing an upgrade. This button is for exporting CA Identity Manager r12 environments only.

Note: Be sure that your SiteMinder Policy Server is running before attempting to export a Directory or Environment.

To export a Directory and Environment

1. Navigate to the following directory:

   admin_tools\81to12Migration-tool\
   

2. Be sure that the IM_ROOT variable in the imsconfig script points to the correct location, as follows:
   • Windows: IM_ROOT=admin_tools\81to12Migration-tool\lib
   • Unix: IM_ROOT=admin_tools/81to12Migration-tool/lib

   where admin_tools is the location of the tools for CA Identity Manager r12.5 SP3.

3. Export a Directory by running the following command:

   imsconfig -h policy_server_hostname -a agent_name -s agent_shared_secret -u siteminder_super_user_name -p siteminder_super_user_password -d im_directory -x folder_name
   

   • policy_server_hostname

     Specifies the hostname of the system with the Policy Server installed.

   • agent_name

     Defines the agent.

   • agent_shared_secret

     Defines the agent's shared secret.

   • siteminder_super_user_name

     Defines the SiteMinder administrator.

   • siteminder_super_user_password

     Defines the SiteMinder administrator password.

   • im_directory

     Defines the name of the CA Identity Manager directory to export.

   • folder_name

     Defines the name of the folder where you'd like the Migration Tool to place the generated directory.xml file.

   The Directory configuration is exported into the standard directory.xml file.

4. Export an Environment by running the following command:

   imsconfig -h policy_server_hostname -a agent_name -s agent_shared_secret -u siteminder_super_user_name -p siteminder_super_user_password -e im_environment -m folder_name
   

   • policy_server_hostname

     Specifies the hostname of the system with the Policy Server installed.

   • agent_name

     Defines the agent.

   • agent_shared_secret

     Defines the agent's shared secret.

   • siteminder_super_user_name

     Defines the SiteMinder administrator.

   • siteminder_super_user_password

     Defines the SiteMinder administrator password.

   • im_environment

     The name of the CA Identity Manager environment to export.

   • folder_name

     The name of the folder where you'd like the r12 Migration Tool to place the generated ZIP file.

   The Environment configuration is exported into an environmentname_environment.zip file, which contains the following three environment settings XML files:

   • environmentname_environment_roles.xml—environment role definitions
   • environmentname_environment_settings.xml—environment settings not included with the role definitions
   • environmentname_environment.xml—general environment information