Upgrade Procedure
If you are upgrading from any version before 2.29, please make sure you use the special upgrade procedure described in the document Special Instructions for Upgrade from Control Center Versions Prior to 2.29.
If you are upgrading from 2.34, please make sure you use the special upgrade procedure described in the document Upgrading Netrounds Control Center from Version 2.34.
Below are general instructions for upgrading Control Center. Note that for specific releases, additional actions may be required; separate instructions are then given in each case in what follows.
Be sure to refer to the current Paragon Active Assurance Installation Guide.
-
Disable the
apache2andnetrounds-callexecuterservices completely:sudo systemctl disable apache2 sudo systemctl disable netrounds-callexecuter
-
Stop all Paragon Active Assurance services:
sudo systemctl stop "netrounds-*" apache2 openvpn@netrounds
-
Make backups according to the Lifecycle Management Guide, chapter Backing Up Product Data, starting with the section "Backing Up the PostgreSQL Database".
-
Verify the integrity of the tarball containing the new Control Center version:
# Compute the checksum for the tar file and verify that it is equal to the SHA256 # checksum provided on the download page sha256sum paa-control-center_${CC_VERSION}.tar.gz -
Unpack the Control Center tarball:
export CC_VERSION=<enter version number here> tar -xzf paa-control-center_${CC_VERSION}.tar.gz -
Install new Control Center packages:
sudo apt-get update sudo apt-get install ./paa-control-center_${CC_VERSION}/*.debWhen asked how to proceed with the configuration files, choose to keep the old files.
Note:New optional and updated settings may be available in the example configuration files provided in the packages. Feel free to review these and add new options as appropriate for your installation. It is not mandatory to change any existing files to keep the current functionality.
-
Run the database migration:
sudo ncc migrate
Note:This command takes considerable time to execute.
-
Install the new Test Agent repository:
TA_APPLIANCE_VERSION=<enter version number here> TA_APPLICATION_VERSION=<enter version number here> # Compute the checksums for the Test Agent files and verify that each one is # equal to the SHA256 checksum provided on the download page sha256sum paa-test-agent_${TA_APPLIANCE_VERSION}_all.deb sha256sum paa-test-agent-application_${TA_APPLICATION_VERSION}_all.tar.gz # Start the installation sudo apt-get install ./paa-test-agent_${TA_APPLIANCE_VERSION}_all.deb sudo cp paa-test-agent-application_${TA_APPLICATION_VERSION}.tar.gz \ /usr/lib/python2.7/dist-packages/netrounds/static/test_agent/ -
Enable the
apache2,kafka, andnetrounds-callexecuterservices:sudo systemctl enable apache2 sudo systemctl enable kafka sudo systemctl enable netrounds-callexecuter
-
Start all Paragon Active Assurance services.
Note:You must do this to get the services up and running again after the upgrade:
sudo systemctl start --all "netrounds-*" apache2 kafka openvpn@netrounds
-
To activate the new configuration, you also need to run:
sudo systemctl reload apache2