Upgrading the PSM Server

This procedure describes how to upgrade the PSM server to Release 7.5.

• Obtain the PSM DVD or ISO image for Release 7.5.

Note: Before starting this procedure, consult the proNX Service Manager Release Notes for this release. The proNX Service Manager Release Notes contains important information relating to installing and upgrading software for this release, and may require you to take additional steps prior to or after executing this procedure.

Note: The proNX Service Manager Release Notes specifies the allowed upgrade paths for this release. Contact Juniper Networks Support when upgrading from releases that are not explicitly specified.

1. Log in to the PSM server.
2. Ensure the current PSM server version is one of the releases from which upgrade to this release is supported. For example:

   [user ~]# rpm -q ems9001
   ems9001-6.3-0.x86_64
   

3. Optionally, save any configuration that will be overwritten.
   1. If you have made any changes to the property values in the workers.xml file, save that file so that they do not get overwritten during the server upgrade.

      Locate the workers.xml file in directory /usr/local/ems9001/resources/serverConfigurations/ and copy it to a location where it will not be overwritten during the server upgrade, preferably onto another machine.

   2. If you have developed any custom server scripts, save those files so that they do not get overwritten during the server upgrade.

      Locate the scripts in the directory /usr/local/ems9001/conf/serverScripts and copy them to a location in which they will not be overwritten during the server upgrade, preferably onto another machine.

   3. Scheduled discoveries are also lost during the upgrade. If you have any scheduled discoveries, ensure you have the information to reschedule those discoveries so that you can restore them when you launch the new client.
4. Generate a backup of the existing PSM server database as follows:
   1. Stop the server by entering the following command:

      psm-stop
      

      The stop command is successful when the 'Ems-' processes all change to 'not monitored' state. Type <ctrl> c to exit the Linux watch command window.

   2. Export the PSM server database. For example:

      cd /tmp
      mysqldump -u<user> -p --databases ems emsquartz > dbbackup.sql

      The database backup file is stored in the /tmp directory.

      Note: If a problem occurs during the upgrade that prevents the database from being automatically imported, import the database manually after you have finished upgrading. For example: mysql –u<user> -p < dbbackup.sql For information on how to restore the database from a backup, see Restoring the PSM Server Database from a Backup .

5. Uninstall the current PSM server by entering the following command:

   rpm -e ems9001

6. Follow the steps in Installing the PSM Server to install the new PSM server.

   If you do not have any configuration you need to restore from 3, then you have completed the server installation. Otherwise, proceed to the next step.

7. If you have to restore changes to the property values in the workers.xml file, do the following:

   Reapply the changes from the old workers.xml file that you saved in 3. Do not simply overwrite the new file with the old ones, as there might be new properties defined in the new file that are required in the new software release. Instead, edit the file, identify the changes in the old file that you want to keep, and make those changes in the new workers.xml file. When you are done, save and close the new workers.xml file.

8. If you have to restore custom server scripts, copy the scripts back to the /usr/local/ems9001/conf/serverScripts directory.
9. To activate these changes, restart the PSM server.

   psm-restart

   The restart command successfully completes when the 'Ems-' processes all change to the running state. Type <ctrl> c to exit the Linux watch command window.

You have successfully upgraded the PSM server.