How to Upgrade CA CSM › Prepare for Upgrade › Copy Options File Keywords

Copy Options File Keywords

You can copy keyword values from a previous version of CA CSM for easier and quicker customization.

Important! Verify that the keyword PreviousRelease.MSMPATH in the MSMSetupOptionsFile.properties options file is populated with the same value as the previous application installation path. This practice ensures that the migration jobs are automatically generated.

Follow these steps:

1. Go to the directory where the MSMSetup.sh setup utility resides.

   You can use one of the following methods to find the MSMPATH for the previous version:

   • The path that is specified in CA CSM Product Installed Path of the summary report for the previous version (MSMSummaryReport.txt) for CA CSM Product Installed Path
   • The path that is specified in the MSMPATH keyword in MSMSetup folder MSMSetupOptionsFile.properties options file for the previous version
2. Execute the utility.

   For example, use the following command to execute the utility from USS OMVS:

   sh MSMSetup.sh copyOPT PreviousRelease.MSMPATH
   

   PreviousRelease.MSMPATH

   Path where CA CSM target files for the previous version are located.

   Example: /u/users/msmserv/msm

   The utility looks for the previous version options file in the following location:

   PreviousRelease.MSMPATH/CEGPHFS/MSMSetupOptionsFile.properties.
   

   The utility copies all available values from the previous version options file to the current options file to fill in missing corresponding keywords.

   When the utility finishes, the modified MSMSetupOptionsFile.properties options file appears in edit mode. You can customize it to conform to the requirements of your site.

3. Review keyword values against the previous system version and user configuration settings in the previous version of CA CSM user interface.

   Verify that the keywords MVSHFSDsnPrefix and MountPath in the current version of the options file are the same as in the previous versions of the options file. During installation, if these parameters are not the same between CA CSM versions, the CA CSM installer displays an error message for the corresponding property, and exits the installation. All other system and user setting keywords can be modified during the migration.