Upgrade Best Practices Fault-Tolerant Deployments

Upgrades in a fault-tolerant environment are supported. However, take care to follow the recommendations in this topic and in the related procedure. All of your Primary and Secondary sss must be upgraded within a small window of a few hours.
casp10
Upgrade Best Practices Fault-Tolerant Deployments
Upgrades in a fault-tolerant environment are supported. However, take care to follow the recommendations in this topic and in the related procedure. All of your Primary and Secondary 
SpectroSERVER
s must be upgraded within a small window of a few hours.
You can directly upgrade to 10.0 from 9.3.x and 9.4.x. Refer to Upgrading From Earlier Versions for more information.
Before conducting any upgrades, verify that all 
CA Spectrum
 components are up-to-date with current service packs. Also consult the list of the communication ports and protocols that 
CA Spectrum
 uses. Your security parameters may require you to temporarily disable these ports and protocols during the upgrade. For more information about firewall ports and protocols, see .
First upgrade the OneClick Web Servers, after that upgrade the primary 
SpectroSERVER
s, and finally upgrade the secondary
SpectroSERVER
s.
Upgrade in a Fault-Tolerant Environment
The following procedure describes an upgrade in a fault-tolerant environment. Use the same procedure for a single-server or DSS upgrade. Upgrade the OneClick Web Servers first, and then upgrade primary
SpectroSERVER
s. Upgrade Secondary
SpectroSERVER
s at last.
Typical upgrades occur between contiguous releases (from 9.3.x and 9.4.x to 10.0). If you are on 9.2.x, come to 9.3.x or 9.4.x to directly upgrade to 10.0.
Alarms may display incorrectly in OneClick until the upgrade process is complete, including any post-upgrade steps that may be required. Avoid using
CA Spectrum
for management until you have completed all steps.
Follow these steps:
  1. Disable automatic online backups on the Primary 
    SpectroSERVER
    s by taking the following steps:
    1. Highlight the VNM model in the Universe Topology view.
    2. In the Component Detail panel, select the Information tab.
    3. Locate and expand the Online Database Backup subview.
    4. Set Automatic Backups to “Disabled”.
  2. Perform a manual online backup on every Primary 
    SpectroSERVER
     to preserve the current database. Take the following steps:
    1. In the Online Database Backup subview, click Begin Backup Now.
    2. Verify that the online backup has succeeded.
    We recommend differentiating the databases by version number. Set the “Prefix for Backup File Name” parameter from the default of “db_” to something like “db_
    version
    _” or another value that identifies the version.
  3. Edit the .vnmrc file to increase the 'maximum event records' parameter on all Secondary 
    SpectroSERVER
    s. For example, change the following parameter:
    max_event_records=20000
    to the following value:
    max_event_records=200000
    The new value prevents event loss during the upgrade.
  4. Restart all Secondary 
    SpectroSERVER
    s so that the change takes effect:
    1. Launch a Spectrum Control Panel.
    2. Click Stop 
      SpectroSERVER
      .
    3. Once the Status changes to “INACTIVE,” click Start 
      SpectroSERVER
      .
    4. Verify that the Status changes to “RUNNING”.
  5. Instruct all OneClick users who are logged into the OneClick Web Servers to close their clients.
  6. Stop each of the Primary 
    SpectroSERVER
    s:
    1. Launch a Spectrum Control Panel
    2. Click Stop 
      SpectroSERVER
      .
    3. You are prompted to verify the action to stop the 
      SpectroSERVER
       and Archive Manger.
    4. Verify that the Status changes to “INACTIVE”.
    5. Exit the Spectrum Control Panel.
  7. On the OneClick clients, verify that the 
    SpectroSERVER
    s have failed over to the Secondary 
    SpectroSERVER
    s. 
    The landscape icons in the Explorer hierarchy panel change from green to yellow 
    Yellow borders appear around the Contents and Component Detail panels.
  8. Stop all OneClick Web Servers using the following command:
    $SPECROOT/tomcat/bin/stopTomcat.sh
  9. Follow the upgrade path mentioned in Upgrading from Earlier Versions to upgrade to 
    CA Spectrum
    10.0.
  10. Upgrade all OneClick web servers to 10.0.
  11. Upgrade all of the Primary 
    SpectroSERVER
    s to 10.0, and verify that the installations complete successfully.
    Wait for every installation to complete before continuing to the next step.
  12. Manually start the Archive Manager on every Primary 
    SpectroSERVER
    :
    1. Launch a Spectrum Control Panel.
    2. Select Control, and click Start Archive Manager.
    Starting the Archive Manager ensures that the events that are being stored locally on the Secondary
    SpectroSERVER
    are sent over to the Primary Archive Manager.
  13. Wait for all events on the Secondary 
    SpectroSERVER
    s to be sent over to the Primary Archive Manager. To verify their status, take the following steps:
    1. In the OneClick client, highlight the VNM model for each 
      SpectroSERVER
       in the Universe Topology view.
    2. In the Component Detail panel, select the Information tab.
    3. Locate and expand the 
      SpectroSERVER
       Control subview.
    4. Locate and expand the Event Log Information subview.
    5. Wait for the total of Locally Stored Events to reach zero (0).
  14. Start the 
    SpectroSERVER
     on the Primary MLS:
    1. Launch a Spectrum Control Panel on the Primary MLS.
    2. Click Start 
      SpectroSERVER
      .
    3. Verify that the Status changes to “RUNNING”.
  15. Start the remaining Primary 
    SpectroSERVER
    s.
  16. Stop each of the secondary
    SpectroSERVER
    s.
  17. Upgrade to 10.0 on all of the Secondary 
    SpectroSERVER
    s, and verify that the installations complete successfully.
    Wait for every installation to complete before continuing to the next step.
  18. Start the 
    SpectroSERVER
     on every Secondary 
    SpectroSERVER
    :
    1. Launch a Spectrum Control Panel on the 
      SpectroSERVER
      .
    2. Click Start 
      SpectroSERVER
      .
    3. Verify that the Status changes to “RUNNING”.
  19. Verify that the clients open successfully and that the Connection Status all of the Primary 
    SpectroSERVER
    s are up and green.
  20. Perform a manual online backup on every Primary 
    SpectroSERVER
     to preserve the current database. Take the following steps:
    1. In the Online Database Backup subview, click Begin Backup Now.
    2. Verify that the online backup has succeeded.
    3. Resynchronize the Primary 
      SpectroSERVER
       database with the Secondary 
      SpectroSERVER
      .
    We recommend differentiating the databases by version number. Set the “Prefix for Backup File Name” parameter from the default of “db_” to something like “db_
    version
    _” or another value that identifies the version.
    To continue management activities during the upgrade process, do not upgrade all of the OneClick web servers at one time. Retain few OneClick web servers, so that you can monitor your infrastructure using the secondary 
    SpectroSERVER
    s until all the primary 
    SpectroSERVER
    s are upgraded. When all primary
    SpectroSERVER
    s are upgraded, you can upgrade the retained OneClick web servers.