DataStax OpsCenter Documentation

Upgrading OpsCenter

This section contains information about upgrading OpsCenter and OpsCenter agents. The following upgrade paths are available:

Before upgrading, check that the Cassandra or DataStax Enterprise version is compatible with the upgraded OpsCenter version:

OpsCenter Version Cassandra Version DataStax Enterprise Version
3.1 1.0, 1.1, 1.2 1.0, 2.0, 2.1, 2.2, 3.0.x
3.0 1.0, 1.1, 1.2 1.0, 2.0, 2.1, 2.2, 3.0
2.1.3 0.8, 1.0, 1.1, 1.2 1.0, 2.0, 2.1, 2.2
2.1 0.8, 1.0, 1.1 1.0, 2.0, 2.1, 2.2
2.0 0.8, 1.0, 1.1 1.0, 2.0
1.4.x 0.7, 0.8, 1.0, 1.1 1.0, 2.0

Upgrading package installations

Use the information in this section to upgrade to OpsCenter 3.0 from 2.1.x, 2.0, 1.4.x, or 1.3.x.

To upgrade to OpsCenter 3.0:

These steps describe installing the new OpsCenter package and restarting the opscenterd daemon.

  1. On the OpsCenter daemon host, run the appropriate command to update the packages:

    Debian/Ubuntu:

    # apt-get update
    

    RHEL/CentOS:

    # yum clean all
    
  2. Install the upgraded OpsCenter package:

    Debian/Ubuntu:

    # apt-get install opscenter
    

    RHEL/CentOS:

    # yum install opscenter
    
  3. If the package manager prompts you for options regarding opscenterd.conf, choose to keep your currently installed version.

  4. Restart the OpsCenter daemon.

    # service opscenterd restart
    

Upgrading tarball installations

  1. Download and extract the new tarball.

  2. Copy the following files and directories from the old tarball installation directory to the new one:

    conf/clusters/*
    conf/event-plugins/*
    conf/install_id
    conf/log4j.properties
    conf/opscenterd.conf
    conf/ssl.conf
    ssl/*
    
  3. Stop the opscenterd instance (if it is running) and start it from the new tarball installation directory.

  4. Upgrade the agents either through the UI or by manually installing from the new tarballs.

Upgrading OpsCenter agents

If OpsCenter agents require upgrading for the new release, you are prompted to do by a Fix link located near the top of the OpsCenter console:


../_images/agent_install_fix2.png

For information about installing the upgraded agents, see Installing OpsCenter agents.

From tarballs

If the agents will be upgraded manually with tarballs, copy the new agent.tar.gz to all nodes, extract it, and copy the following files from the old agent tarball directories to the new ones:

conf/*
ssl/*