Migrating on z/OS

Edit online

Migrate to Copy Services Manager on z/OS by running the installation setup file that is provided with your license.

Migrate to Copy Services Manager on z/OS

Edit online

Before you begin

If you are migrating from Tivoli® Storage Productivity Center for Replication to Copy Services Manager, first follow these steps:
  1. Open the rmserver.properties file and ensure that it can be viewed in an Interactive System Productivity Facility (ISPF) editor. You can locate this file at: <Production_root>/opt/Tivoli/RM/wlp/usr/servers/replicationServer/properties/rmserver.properties
    • If you can view the file in an ISPF editor, then no further action is needed. You can continue to the migration procedure.
    • If the file cannot be viewed, it is because Tivoli Storage Productivity Center for Replication used ASCII instead of EBCDIC encoding. Proceed to step 2.
  2. Download the file in binary format to your local desktop.
  3. Create a backup of the file on the z/OS system.
  4. Open the rmserver.properties file in a text editor.
  5. Edit the rmserver.properties file on z/OS in an ISPF editor, and delete all of the contents.
  6. Replace all of the contents by using copy and paste from the downloaded file.
  7. Save the file on the system.
  8. Continue to the migration procedure.
Note: Distributed systems use a basic registry to handle users that are defined to Copy Services Manager. This authentication is different on the mainframe platform because users authenticate through a SAF registry, which queries a RACF repository for authorization.
Dual registries is not supported by the Liberty platform, therefore, migration of users from a backup is not possible from distributed systems to mainframe. Users defined in the backup also require authorization in the RACF repository on the target system to be added into Copy Services Manager.
The migration target uses the CSM_USER parameter as the initial login user, which already requires a valid RACF authorization.
To add new users, see Granting access privileges for LDAP or RACF users or groups.

About this task

Migrate to Copy Services Manager on z/OS, see Installing on IBM Z.

The following value can be used in the IWNINSTL script for migrating from a TPC-R instance:
MIGRATION_FROM=path_prefix/opt/Tivoli/RM
The following value can be used in the IWNINSTL script for migrating from an existing Copy Services Manager location: 
MIGRATION_FROM=path_prefix/opt/IBM/CSM
The following value can be used in the IWNINSTL script for migrating from a database backup: 
MIGRATION_FROM=/tmp/csmBackup_<date_stamp>_<time_stamp>.zip
MIGRATION_FROM
Specifies the location of the Tivoli Storage Productivity Center for Replication installation or Copy Services Manager database backup to be used for the migration.
Note: This option must be set to a valid directory path to an installation or zip file, created by the Copy Services Manager backup process. The path also needs to be set with read access by the user that submits the IWNINSTL job.