Importing the LDAP and basic user registries

You can restore the ldapRegistry.xml and basicRegistry.xml files on a new installation of Copy Services Manager from a backup of the files on the file system.

About this task

Restoring the registries requires access to the file system on which the Copy Services Manager server is running. The files can be copied over to restore the users that are already set up to use Copy Services Manager.

Complete these steps to import the LDAP and custom user registries:

Procedure

  1. Locate the files on your system.
    • On Windows systems:
      • The LDAP registry is at C:\program files\IBM\CSM\liberty\wlp\usr\servers\csmAuth\registries\ldapregistry.xml.
      • The basic user registry is at C:\program files\IBM\CSM\liberty\wlp\usr\servers\csmServer\registries\basicregistry.xml.
    • On z/OS systems:
      • The LDAP registry is at ${path_prefix}/opt/IBM/CSM/wlp/usr/servers/csmAuth/registries/ldapregistry.xml.
      • The basic user registry is at ${path_prefix}/opt/IBM/CSM/wlp/usr/servers/csmServer/registries/basicregistry.xml.
    • On UNIX systems:
      • The LDAP registry is at /opt/IBM/CSM/liberty/wlp/usr/servers/csmAuth/registries/ldapregistry.xml.
      • The basic user registry is at /opt/IBM/CSM/liberty/wlp/usr/servers/csmServer/registries/basicregistry.xml.
  2. Stop Copy Services Manager as described in Stopping the Copy Services Manager server.
  3. For UNIX and z/OS systems, issue the following commands to change the permissions of the registries directory:
    
     chgrp -R csm_id *.xml
     chmod -R u+rwx *.xml
     chmod -R g+rwx *.xml 
     chmod -R o+r *.xml
    Where csm_id is the Copy Services Manager user, or a user with authority to access Copy Services Manager. If you have a z/OS installation, that user is defined in the IWNRACF1 job. For more information about the IWNRACF1 job, see the IBM® Copy Services Manager Installation and Configuration Guide.Configuring the IWNRACF jobs.
  4. Restart Copy Services Manager on the active management server as described in Starting the Copy Services Manager server.