Moving NetOps Spectrum to a Different Partition on the Same Server (Uninstall/Reinstall/Restore Method)
search cancel

Moving NetOps Spectrum to a Different Partition on the Same Server (Uninstall/Reinstall/Restore Method)

book

Article ID: 418806

calendar_today

Updated On:

Products

Network Observability

Issue/Introduction

You need to relocate the NetOps Spectrum installation directory (often referred to as $SPECROOT) to a different disk partition or mount point on the same physical or virtual server. This might be due to disk space constraints, standardization of directory structures, or performance optimization.

Directly moving or copying Spectrum installation files between partitions is not a supported method and can lead to severe operational issues due to hard-coded paths and registry entries. The recommended and supported approach is to perform a full backup, uninstall the existing instance, reinstall to the new location, and then restore your data and customisations.

Environment

  • Product: NetOps Spectrum (all supported versions)
  • Operating Systems: Microsoft Windows Server, Linux.
  • Deployment: Standalone SpectroSERVER, Distributed SpectroSERVER (DSS), or OneClick Server.

Resolution

The process involves performing comprehensive backups, completely uninstalling the existing Spectrum instance, reinstalling it to the new partition, and then meticulously restoring the previously backed-up data and configurations.

Prerequisites

Before starting the move, ensure you have the following:

  1. Root/Administrator Access: Full administrative privileges on the server where Spectrum is installed.
  2. Sufficient Disk Space: The target partition must have enough free space to accommodate the entire Spectrum installation.
  3. Full Backups:
    • DDM Database Backup: Use mysqldump to back up the DDM database. This is critical.
      • Example (Linux): $SPECROOT/mysql/bin/mysqldump --opt --single-transaction --all-databases > /backup_location/ddm_backup.sql
      • Example (Windows): %SPECROOT%\mysql\bin\mysqldump.exe --opt --single-transaction --all-databases > C:\backup_location\ddm_backup.sql
    • Archive Manager Database Backup:
      • Example (Linux): $SPECROOT/bin/ArchiveMgr.pl --backup --file /backup_location/archmgr_backup.gz
      • Example (Windows): %SPECROOT%\bin\ArchiveMgr.pl --backup --file C:\backup_location\archmgr_backup.gz
    • Custom Files/Directories: Copy these directories and files from $SPECROOT to a safe backup location outside of the $SPECROOT hierarchy:
      • $SPECROOT/custom (contains custom models, attributes, scripts, etc.)
      • $SPECROOT/landscape (if applicable, though DDM restore usually covers this)
      • $SPECROOT/SS/.vnmrc (important for SpectroSERVER configuration)
      • $SPECROOT/tomcat/webapps/spectrum/WEB-INF/spring/ (for custom OneClick configurations)
      • $SPECROOT/Notifier (if customized)
      • Any other specific custom configurations or scripts you have implemented.
    • Full $SPECROOT Archive: As a fallback, create a compressed archive (e.g., .zip, .tar.gz) of the entire $SPECROOT directory.
  4. Spectrum Installer: The exact version of the CA NetOps Spectrum installer that is currently installed. If patches have been applied, have those patch installers ready as well.
  5. Product License Key: Have your Spectrum license key readily available, as re-installation might require re-licensing.
  6. Downtime Window: Moving Spectrum will require significant downtime for all Spectrum services. Plan accordingly.
  7. Current $SPECROOT Path: Know the exact current installation path.
  8. Target Path: Determine the exact new installation path on the different partition (e.g., D:\CA\Spectrum on Windows or /data/CA/Spectrum on Linux).

Downtime

This procedure requires all NetOps Spectrum services to be stopped for an extended period, resulting in complete downtime for Spectrum monitoring and management.

Migration Steps

Step 1: Planning and Pre-Checks

  1. Identify Current Paths: Note down the current $SPECROOT directory.
  2. Identify Target Path: Determine the desired new path (e.g., D:\CA\Spectrum or /data/CA/Spectrum). This target directory should be empty or non-existent.
  3. Verify Installer: Ensure you have the correct Spectrum installer for your exact current version.
  4. Record Configuration: Document any specific ports, integration settings (e.g., with NetOps Portal, NFA), or other non-default configurations that you might need to re-enter during installation or re-configure later.

Step 2: Perform Pre-Move Backups

Execute all backup procedures described in the "Prerequisites" section. Do not proceed without verified backups.

Step 3: Stop All NetOps Spectrum Services

Stop all Spectrum-related services in the correct order.

  • Windows:
    1. Stop CA Spectrum OneClick Web Server.
    2. Stop CA Spectrum Archive Manager.
    3. Stop CA Spectrum SpectroSERVER.
    4. Stop CA Spectrum MySQL (DDM).
  • Linux:
    1. cd $SPECROOT/bin
    2. ./stopTomcat.sh
    3. ./stop_archive_mgr.sh
    4. ./stopSS.sh
    5. ./stopdb.sh
      Verify all processes are stopped using ps -ef | grep $SPECROOT.

Step 4: Uninstall CA NetOps Spectrum

Use the official uninstaller to completely remove Spectrum from the old partition.

  • Windows:
    1. Go to Control Panel > Programs and Features.
    2. Select "CA NetOps Spectrum" and click Uninstall. Follow the prompts.
    3. After uninstallation, manually check if the old $SPECROOT directory or any Spectrum-related registry entries (e.g., HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Concord Communications or CA Technologies) still exist. Delete them if found and confirmed to be related to Spectrum.
  • Linux:
    1. Navigate to $SPECROOT/_uninst/ (or similar directory within your old $SPECROOT).
    2. Run the uninstaller: ./uninstall or ./uninstall.bin (depending on the version).
    3. After uninstallation, manually check if the old $SPECROOT directory has been completely removed. Delete any leftover files or directories.

Step 5: Install NetOps Spectrum to the New Partition

Run the Spectrum installer for your exact version.

  1. Launch Installer: Execute the installer (e.g., install.exe on Windows, ./install.bin on Linux).
  2. Specify New Path: During the installation wizard, when prompted for the installation directory, specify the new target path on the desired partition (e.g., D:\CA\Spectrum or /data/CA/Spectrum).
  3. Database Configuration: If the installer asks whether to initialize a new database or use an existing one, choose to initialize a new one (as we will restore over it) or select "Restore existing database" if that option specifically uses a backup file. Do not point it to the old database files if they still exist.
  4. Complete Installation: Finish the installation process. Do not start any Spectrum services yet after installation is complete, unless the installer does so automatically (you would then stop them immediately).

Step 6: Restore Configuration and Data

Now, restore your backed-up data to the newly installed Spectrum instance.

  1. Stop New Spectrum MySQL Service: If it was started after installation, ensure the MySQL (DDM) service is stopped.
    • Windows: Stop "CA Spectrum MySQL (DDM)" service.
    • Linux: cd $NEW_SPECROOT/bin; ./stopdb.sh
  2. Restore DDM Database:
    • Navigate to the new MySQL bin directory: cd $NEW_SPECROOT/mysql/bin.
    • Execute the mysql command to restore your backup.
    • Example (Linux): Start MySQL server temporarily, then ./mysql -u root < /path/to/ddm_backup.sql (Enter your MySQL root password). Then stop MySQL.
    • Example (Windows): Start MySQL server temporarily, then mysql.exe -u root -p < C:\backup_location\ddm_backup.sql.
  3. Restore Archive Manager Database:
    • cd $NEW_SPECROOT/bin
    • ./ArchiveMgr.pl --restore --file /path/to/archmgr_backup.gz
  4. Restore Custom Files:
    • Copy the custom/ directory from your backup location to $NEW_SPECROOT/custom, overwriting the newly installed (likely empty) custom directory.
    • Copy any other specific custom files (e.g., vnmrc, custom OneClick files) to their respective locations within the new $NEW_SPECROOT directory. Be cautious not to overwrite newly generated configuration files unless you specifically intended to restore an older version.
  5. Re-apply Patches/Hotfixes (if applicable): If you had any patches or hotfixes applied to your previous Spectrum installation, re-apply them now to the new installation.

Step 7: Start NetOps Spectrum Services

Start the Spectrum services in the correct order.

  • Windows:
    1. Start CA Spectrum MySQL (DDM). Wait until it's fully started.
    2. Start CA Spectrum Archive Manager.
    3. Start CA Spectrum SpectroSERVER.
    4. Start CA Spectrum OneClick Web Server.
  • Linux:
    1. cd $NEW_SPECROOT/bin
    2. ./startdb.sh
    3. ./start_archive_mgr.sh
    4. ./startSS.sh
    5. ./startTomcat.sh
      Monitor logs for successful startup messages.

Step 8: Verification

After all services have started, perform thorough verification:

  1. Check Service Status: Ensure all Spectrum services are running correctly.
  2. Review Logs: Check the following logs for any errors or warnings:
    • $NEW_SPECROOT/SS/stdout.log
    • $NEW_SPECROOT/mysql/mysqld.log
    • $NEW_SPECROOT/ArchiveMgr/ARCHMGR.OUT
    • $NEW_SPECROOT/tomcat/logs/catalina.out (or stdout.log)
  3. OneClick Login: Log in to the OneClick web console and verify:
    • Topology is displayed correctly.
    • Alarms and Events are flowing.
    • Historical data (from Archive Manager) is accessible.
    • Reports are generated correctly.
  4. SpectroSERVER Functionality:
    • Verify device models are present.
    • Test device polling and alarm generation.
    • If using DSS, verify connectivity between primary and secondary SpectroSERVERs.
  5. Test Integrations: If Spectrum integrates with other products (e.g., NetOps Portal, NFA), verify those integrations are working correctly.
Powered by Wolken Software