Installing Control Center and Related Tasks

Standard Procedure

1. Install Control Center.

   content_copy zoom_out_map

   export CC_BUILD=4.3.0.15 
   
   # Compute the SHA256 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_BUILD}.tar.gz
   
   # Unpack the tarball
   tar -xzf paa-control-center_${CC_BUILD}.tar.gz
   
   # Make sure packages are up to date
   sudo apt-get update
   
   # Start the installation
   sudo apt-get install ./paa-control-center_${CC_BUILD}/*.deb

   An error "Download is performed unsandboxed as root ..." may occur during this installation. This is a harmless warning which can be ignored.

2. Run the database migration.

   Note:

   This is a sensitive command, and care should be taken when executing it on a remote machine. In such a scenario it is strongly recommended that you use a program like screen (generally installed by default on popular Linux distributions) or tmux (run sudo apt-get install tmux to install) so that the migrate command will continue running even if the ssh session breaks.

   content_copy zoom_out_map

   sudo ncc migrate

   The ncc migrate command takes considerable time to execute (many minutes). It should print the following (details omitted below):

   content_copy zoom_out_map

   Migrating database...
   Operations to perform:
     <...>
   Synchronizing apps without migrations:
     <...>
   Running migrations:
     <...>
   Processing models <...>:
   <...>
   Migrating plugin service database...
   <...>
   Creating cache table...
   <...>
   Syncing test scripts...
   <Updating script ...>
   Pre-creating kafka topics...
   <...>

   When the migration has finished, restart all Paragon Active Assurance services:

   content_copy zoom_out_map

   sudo ncc services restart

3. Install the Test Agent repositories and plugins.

   The plugins are used by Test Agent Applications.

   content_copy zoom_out_map

   export TA_APPLIANCE_BUILD=4.3.0.16 
   export TA_APPLICATION_BUILD=4.3.0.16 
   export PLUGIN_BUILD=4.3.0.24 
             
   # Compute SHA256 checksums for the repositories and verify that they match the
   # SHA256 checksums provided on the download page
   sha256sum paa-test-agent_${TA_APPLIANCE_BUILD}_all.deb
   sha256sum paa-test-agent-application_${TA_APPLICATION_BUILD}_all.deb
   sha256sum paa-test-agent-plugins_${PLUGIN_BUILD}_all.deb
   
   # Start the installation
   sudo apt-get install ./paa-test-agent_${TA_APPLIANCE_BUILD}_all.deb
   sudo apt-get install ./paa-test-agent-application_${TA_APPLICATION_BUILD}_all.deb
   sudo apt-get install ./paa-test-agent-plugins_${PLUGIN_BUILD}_all.deb

   Note:

   A message similar to the following may appear during plugin installation. It can safely be ignored.

   content_copy zoom_out_map

   W: APT had planned for dpkg to do more than it reported back (0 vs 4).
   Affected packages: paa-test-agent-plugins:amd64

4. In the file /etc/netrounds/netrounds.conf, assign a URL to Control Center by setting SITE_URL appropriately. This URL is displayed for example in emails and reports.

   Restart all Paragon Active Assurance services for this change to take effect:

   content_copy zoom_out_map

   sudo ncc services restart

This concludes the installation of Control Center. Before you can log in to the system you also need to go through the chapter Getting Started with Paragon Active Assurance.

Installing ConfD

This installation is needed only if you want to use the NETCONF & YANG API to communicate with Control Center. For full details on this topic, see the document NETCONF & YANG API Orchestration Guide.

ConfD (a product from Tail-f) is used as an intermediary between the Paragon Active Assurance system and NETCONF. ConfD connects Paragon Active Assurance configuration and operational data to the NETCONF & YANG API.

ConfD must be installed after Control Center has been installed.

Proceed as follows:

1. Get the Paragon Active Assurance NETCONF & YANG tarball:

   content_copy zoom_out_map

   export CC_BUILD=4.3.0.15
   paa-netconf-yang_${CC_BUILD}.tar.gz

2. Compute the SHA256 checksum for the tar file and verify that it matches the SHA256 checksum provided on the download page:

   content_copy zoom_out_map

   sha256sum paa-netconf-yang_${CC_BUILD}.tar.gz

3. Unpack the tarball:

   content_copy zoom_out_map

   tar -xzf paa-netconf-yang_${CC_BUILD}.tar.gz

4. Install the paa-netconf-yang package:

   content_copy zoom_out_map

   sudo apt-get install ./paa-netconf-yang_${CC_BUILD}/*.deb

Some configuration is needed once you have set up your Paragon Active Assurance account; see the Getting Started page.