Upgrading

Upgrade product to the current version.
casp1030
Special Considerations
  • This release supports direct upgrades only from CA Spectrum r10.2 and 10.2.x. CA Spectrum users who are on 10.0 or 10.1.x releases are advised to upgrade to the intermediary major release such as 10.2.0 and then directly upgrade to 10.3. to ensure a stable upgrade and migration process devoid of any loss of data or failure of any functionality.
  • We recommend that you upgrade from CA Spectrum 10.1.x versions to a supported version of Spectrum by 
    December 2018
    , to avoid 'gold key' expiration issues. For more information and guidance contact CA Support
  • Spectrum 10.0 is now end of support, we recommend that you upgrade to 10.2 or 10.2.x before upgrading to 10.3.
  • If you are on Spectrum r9.2.x or older, upgrade to r9.4 before upgrading to 10.3.
Following is a diagram of the upgrade path for each release: 
Upgrade Diagram.JPG
Upgrade to 10.3! 
CA Spectrum continues to delight its customers with new features and quality improvements. With the newly introduced release of 10.3, our customers can now benefit from the following features:
  • CA Spectrum Dockerization
  • CA Spectrum and CA Digital Operational Intelligence Integration
  • Multi-tenant-SRM with Jaspersoft®
  • DDMDB Performance Improvements
  • Filtering Interfaces
  • Support for DHCP
  • Enhanced CDP & LLDP Discoveries
  • Co-existence of CA VNA and CA UIM Integration for VMWare® Entities
  • CA Spectrum-CA UIM Integration Enhancements
  • Modeling Gateway Enhancements
  • Syslog Monitoring Enhancements
  • Monitoring Profile Enhancements
  • API Performance enhancement
  • SCOM 2016 Support
  • Platform and third-party product updates
  • Device Certification Updates
Find out how this release differs from the version you are currently on by referring to the release comparison chart.
Platform Support
  • Spectrum 10.3 is supported on Windows 2016. Installation of any component of Spectrum (OneClick, SpectroSERVER, SDC) is supported on this platform and functions as usual.
  • Spectrum 10.3 does not support the following platforms:
    • Solaris
    • BOXI
    • Windows 2008 and
    • RHEL 5.x platforms
Installation on these platforms fails and returns an error. Ensure that you upgrade to the recommended platforms. 
Integration Compatibility Matrix
To know more about version compatibility of other integrated products with Spectrum 10.3, see the compatibility matrix chart. 
FAQs
Q: In a distributed SS (DSS) environment, what is the supported and best practice for upgrading servers?
A:
 Upgrade the Primary MLS (main location server) SpectroSERVER first, followed by the Primary OneClick server, followed by the remaining Primary SpectroSERVERs. It is important that you start the primary MLS first, before starting the other primary SpectroSERVERs. This allows all of the cross landscape and "MOM" (manager of managers) functions to process and complete. Once the primary MLS is running and active, you can start the rest of the primaries.  Upgrade the Secondary SpectroSERVERs last (including all SpectroSERVER and non primary OneClick servers). Once all SpectroSERVERs have been upgraded, be sure to stop and restart all CA Spectrum OneClick tomcat processes 
again
 to update the tomcat cache with the updated SS info. Not doing this will cause OneClick issues, such as landscapes not showing in the client.
Note: In a DSS setup, if you stop a primary SS to test your failover scenario without performing a successful database synchronization (via online backup) first, you may see the landscapes disappear in OneClick. To make sure this does not happen, manually start the online backup and allow the database synchronization to occur. Once complete, you can then test your failover scenario.
Upgrade from 10.2 and 10.2.x to 10.3
Best Practices
Pre-Upgrade Tasks
Before you upgrade to the latest version of CA Spectrum, ensure you:
  1. Are familiar with the best practices that are mentioned above.
  2. Stop all running applications other than CA Spectrum.
  3. Stop the following CA Spectrum applications:
    • Shut down all OneClick clients by logging off all users from OneClick in the Client Details web page in the OneClick home page.
      : For more information about shutting down OneClick clients, see OneClick Administration.
    • Stop the SpectroSERVER and the Archive Manager by clicking Stop SpectroSERVER in the CA Spectrum Control Panel and then close the CA Spectrum Control Panel. Or you can stop the SpectroSERVER and Archive Manager from command line by running the "<$SPECROOT>/bin/stopSS.pl" as Spectrum Owner at the command prompt.
    • Stop all VnmSh connections.  For more information about stopping VnmSh connections, see Command Line Interface.
    • Close all Bash shells.
    • Ensure the 'Java' folder is not opened (under <$SPECROOT>) during the upgrade.
  4. If you have installed Spectrum Report Manager, verify that free disk space on the system is at least twice the size of the largest MYD file under 
    $SPECROOT
    /mysql/data/reporting.
  5. Do not install third-party software that uses MySQL because the results can be unpredictable.
Upgrade Procedure from 10.2 or 10.2.x
Upgrading from a previous version of Spectrum to the latest one, can be complex, because each release promises higher quality with the latest technologies and services. Ensure that you go through the upgrade options that best suit your requirement.
1.You can perform either:
  • In Place Upgrade (With no fault-tolerant SpectroSERVERs configured in your deployment, a temporary fault-tolerant system is used during the upgrade. Once the temporary system is configured, the primary SpectroSERVER is disabled for an in-place upgrade. Meanwhile, the temporary, secondary SpectroSERVER system takes over core network management duties). 
  • Upgrade Models to ensure compatibility between SpectroSERVER database and a new version of CA Spectrum after upgrading.
2. Download CA Spectrum 10.3
a. Go to the support.ca.com site and from the Menu bar, select Download Management.
b. To select Spectrum as your product, type CA Spectrum – Core / SPECTROServer in the search bar.
Download Management.png
c. Now select, Spectrum Product> Release > Version for download. For example:
Download Management1.png
d. You must download and install the ”Akamai Net Session Interface” before obtaining the product zip file. To download the zip file, change the settings from FTP to Enhanced Download Manager. This option is found on the top right corner of the page under Change Download Preference.
e. For Windows, open the unzipped file setupnt.exe, downloaded the Spectrum file.
Post Upgrade Tasks  
  • Archive Manager Database (DDM Database) Tables Conversion: With the new Spectrum 10.3.0 release, it is recommended that you convert your Archive Manager database tables from MyISAM to InnoDB for better performance.
    It is recommended that you perform the Archive Manager tables conversion as a post upgrade task. While performing this post upgrade task, the Archive Manager stops, to convert the tables. The conversion time depends on the size of the tables. Do not start the Archive Manager when the executing the script.
    After conversion, the InnoDB tables occupy more space (approximately 30%-40%) compared to the MyISAM tables. MYSQL recommends InnoDB to be an efficient engine to work on large-scale tables. The InnoDB engine supports row level locking and auto crash recovery features, which are not supported by MyISAM.
    The InnoDB engine allows for performance improvements with Spectrum's MYSQL, however it has been observed that after converting the MYSQL DB from MyISAM to InnoDB, the MYSQL db grew 40 percent in disk space.
Steps for Archive Manager Table Conversion:
Prerequisite:
    1. Ensure that there is enough free disk space. The space that is required, is three times greater than the event table size. To convert the Archive Manager database tables from MyISAM to InnoDB, follow these steps:
Procedure:
 
    1. Open any bash-shell and navigate to $SPECROOT/SS/DDM/scripts. 
      • Before running the script, it is recommended to take a back-up of the Archive Manager database as a precaution against any potential loss of data.
      • If your DDM database contains less than 10 days of data, refer to the KB000115500 article for instructions
         
        to perform a successful data conversion.
    2. To convert the DDM database tables engine from MyISAM to InnoDB, run the following script: 
      convert_current_myisam_to_innodb.pl
    3. After the conversion of tables, you are prompted to start the Archive Manager. Enter 'Y' to start the Archive Manager.
• Migration Upgrade (Best Practice - Preserve Customized Support Files) 
• Upgrading Models to ensure compatibility between SpectroSERVER database and a new version of CA Spectrum after upgrading.
Other Upgrade Tasks
  • If you have configured OneClick to launch from Report Manager using SSL, configure this modification again.  For more information about this modification, see For more information about Upgrading CA Spectrum, see CA Spectrum Upgrade content
  • If any models display Minor (yellow) alarms with a probable cause of DIFFERENT TYPE MODEL, clear the alarms. To convert all eligible models, run the NewMM.pl script from the Spectrum\Install-Tools\PostInstall directory. For more information, see Troubleshooting the Post-Upgrade Installation Script.
Upgrade from 9.4, 10.0 and 10.1.x to 10.2
To initiate loading your Spectrum r9.2 Ssdb to r10.2, refer to the Loading CA Spectrum r9.2 SSdb models to r10.2 section. All events and catalog customizations (watches, model type default changes, changes done in MTE) information is lost. If you want to retain the custom configuration and data, upgrade to 9.4 first, and then proceed to install 10.2.
Best Practices
Pre-upgrade Task
Before you upgrade to this version of CA Spectrum, ensure you:
  1. Are familiar with the best practices that are mentioned above.
  2. Stop all running applications other than CA Spectrum.
  3. Stop the following CA Spectrum applications:
    1. Shut down all OneClick clients by logging off all users from OneClick in the Client Details web page in the OneClick home page.
       
      For more information about shutting down OneClick clients, see OneClick Administration.
    2. Stop the SpectroSERVER and the Archive Manager by clicking Stop SpectroSERVER in the CA Spectrum Control Panel and then close the CA Spectrum Control Panel. Or you can stop the SpectroSERVER and Archive Manager from command line by running the "<$SPECROOT>/bin/stopSS.pl" as Spectrum Owner at the command prompt.
    3. Stop all VnmSh connections.  For more information about stopping VnmSh connections, see command-line interface.
    4. Close all Bash shells.
    5. Ensure the 'Java' folder is not opened (under <$SPECROOT>) during the upgrade.
  4. If you have installed Spectrum Report Manager, verify that free disk space on the system is at least twice the size of the largest MYD file under 
    $SPECROOT
    /mysql/data/reporting. 
  5. Do not install third-party software that uses MySQL because the results can be unpredictable.
Upgrade Procedure from 9.4, 10.0 and 10.1.x
Upgrading from a previous version of Spectrum to the next version, can be complex, because each release promises higher quality and latest technologies and services. Ensure that you go through the upgrade options that best suit your requirement.
  1. You can perform
    either: 
    1. In Place Upgrade (With no fault-tolerant SpectroSERVERs configured in your deployment, a temporary fault-tolerant system is used during the upgrade. Once the temporary system is configured, the primary SpectroSERVER is disabled for an in-place upgrade. Meanwhile, the temporary, secondary SpectroSERVER system takes over core network management duties)
    2. Upgrade Models to ensure compatibility between SpectroSERVER database and a new version of CA Spectrum after upgrading
  2. Download CA Spectrum 10.2
    1. Go to the support.ca.com site and from the Menu bar, select Download Management. 
    2. To select Spectrum as your product, type CA Spectrum – Core / SPECTROServer in the search bar. 
      Download Management.png
    3. Now select, Spectrum Product> Release > Version for download. For example: 
      Download Management1.png
    4. You must download and install the ”Akamai Net Session Interface” before obtaining the product zip file. To download the zip file, change the settings from FTP to Enhanced Download Manager. This option is found on the top right corner of the page under Change Download Preference.
    5. For Windows, open the unzipped file setupnt.exe, downloaded the Spectrum file.
Post Upgrade tasks
  1. Migration Upgrade
    – (Best Practice - Preserve Customized Support Files)
  2. Upgrading Models
    to ensure compatibility between SpectroSERVER database and a new version of CA Spectrum after upgrading.
  3. If you have configured OneClick to launch from Report Manager using SSL, configure this modification again.  For more information about this modification, see OneClick Administration
    For more information about Upgrading CA Spectrum, see CA Spectrum Upgrade content
  4. If any models display Minor (yellow) alarms with a probable cause of DIFFERENT TYPE MODEL, clear the alarms. To convert all eligible models, run the NewMM.pl script from the Spectrum\Install-Tools\PostInstall directory. For more information, see Troubleshooting the Post-Upgrade Installation Script.