XV. VigorACS and VigorConnect

Step 1 - Check account access and install necessary applications

Make sure your Linux user account has root privileges. The "sudo" prefix will be used to identify commands that require root privileges.

Ensure these packages are installed on your Linux VigorACS server:

• unzip (Necessary before running installation script)
• bzip2 (Necessary before running installation script)
• net-tools (Included in the installation script)
• vim (Included in the installation script)
• libaio1/libaio-devel (MariaDB 10 dependencies. Included in the installation script)
• epel-release/cabextract/xorg-x11-font-utils/fontconfig (fonts package is necessary if you have a minimum install of the linux distribution. Included in the installation script)
• libcap (required for packet capture from VigorACS 2.4.0 onwards. Included in the installation script)

NOTE: The installation script for the standard Linux distributions should include most of the required dependencies, but if you are using a not-so-common distribution or a hardended install, you might need to install the dependencies manually.

Ubuntu & Debian variants: sudo apt install unzip bzip2 net-tools

OpenSUSE: sudo zypper install unzip bzip2 net-tools

RedHat: sudo yum install unzip bzip2 net-tools

Step 3 - Set Install Script Permissions

Change the privileges of install.sh and uninstall.sh scripts to make them executable with these two commands:

$ chmod 755 ./install.sh
$ chmod 755 ./uninstall.sh

Then list the directory contents using the "ls -l" command, executable files are displayed in green:

$ ls -l

Step 5 - Manually Backup Current VigorACS Installation (Optional)

If any problems occur during the installation or if there is an issue with the later version of VigorACS, taking a backup can be essential for restoring VigorACS.
If using a Virtual Machine, an alternative could be to take a Snapshot of the current virtual machine status, which can be rolled back to if the upgrade fails.

Step 5.1 - Backup existing VigorACS installation

Backing up the existing installation with all of its current directory contents, allows it to be restored quickly if required.

Check the VigorACS directory size: $ du -sh /usr/local/vigoracs/VigorACS

Create a copy of the current VigorACS installation to the home directory. Replace "2xx" with the currently installed version of VigorACS, i.e. "VigorACS_253_Backup":
$ sudo cp -rp /usr/local/vigoracs/VigorACS ~/VigorACS_2xx_Backup

Step 5.2 - Backup Files Repository data

Backup the Files Repository data, which contains Config Backups, Firmware files and other files used by VigorACS. Replace "xxx" with your ACS version i.e. "EMS_253": $ sudo cp -rp /srv/EMS /srv/EMS_xxx

Step 5.3 - Backup VigorACS SQL data

VigorACS includes a script that will take a snapshot of the current VigorACS database contents and store them in a compressed file. It requires the "backupconfig.txt" configuration file to be configured with the MySQL db root password to operate. The password is cleared when VigorACS is updated.

Go to the backup script's directory:
$ cd /usr/local/vigoracs/VigorACS/bin/acs_util/dbutil/BackupRestoreScript/Linux/

Edit the config file to include the DB root password - this file is reset during the upgrade procedure. Move the cursor around with the arrow keys and press Ctrl+X to save & exit:
$ sudo nano backupconfig.txt

Run the backup script:
$ sudo ./automysqlbackup.sh

To check that the backup has completed successfully, check the directory that the backup has saved to.
This should contain an .sql.gz file created at the current time:
$ sudo ls -lah /root/temp/mysqlbackups/now/tr069

Step 7 - Install / Update InfluxDB

• If upgrading from VigorACS before 2.4.0: Install InfluxDB to allow VigorACS to record graph data & statistics information. Select option "3" to install then follow the instructions to convert data into the format required for InfluxDB
• If upgrading from VigorACS after 2.4.0: You can check whether an update is required by selecting the option.

Step 9 - Upgrade VigorACS

Select option "6" to begin the VigorACS upgrade. Select the options for your VigorACS & MySQL configuration and enter the MySQL DB root password when prompted:

Test the password. If the password is incorrect, press Ctrl+C to end the installation script immediately. Verify the password and retry the install script.

Once the VigorACS installer has successfully accessed the database, it will proceed with the upgrade.

After installing files, the installer will prompt to change the jBoss configuration, which controls the TLS ciphers that VigorACS will allow to connect to the server. The selection depends on router support - only select "standalone-compatible.xml" if there are older CPEs connecting to the VigorACS server that do not support TLS 1.2.

Otherwise, select the recommended "standalone.xml" (recommended) setting to allow only TLS 1.2 and later.

There can be a delay when the script displays "Start to upgrade tr069 db...".

Wait for this to complete, the installer will then display "Upgrade tr069 table Successfully..." and finish the installation.

Exit the installer script once the upgrade has completed successfully.

Step 11 - Check VigorACS

Access the VigorACS server from its URL, log in to VigorACS.

In VigorACS 3; to find the version number, click the information icon and the Version number will be displayed in the About VigorACS menu: