XV. VigorACS and VigorConnect
ExpiredUpgrade VigorACS 3 server on Linux platform
This guide demonstrates how to upgrade an active VigorACS 3 installation that's running within a Linux-based operating system.
This procedure assumes access to Root Privileges on the Linux server. In the guide it's assumed that they are accessible via the "sudo" command. If 'sudo' is not installed on the system then alternatively use the eleveation process for your distribution such as su to use a user which has the neccesary permissions.
Upgrading an existing VigorACS installation requires the MySQL Root Password, ensure that the password is available and correct before proceeding.
The upgrade procedure keeps all existing data, license information and router logs. There are some additional, optional steps to go through before the upgrade to ensure that all VigorACS information is backed up prior to the upgrade, allowing for rolling back or recovering if required.
This guide requires that the VigorACS installation has been installed as demonstrated in this guide and that the server is operating normally, with an active VigorACS license (or trial license).
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 2 - Download VigorACS Installation File
Create a new directory to store the VigorACS installation files in. For example, VigorACS 3.0.5 can go into "acs305" of the user account's home directory. Navigate into the directory, download the VigorACS 3 installer package and extract the contents into the current directory.
Create a new directory in user account's Home directory:
/$ cd
~$ mkdir acs305
Navigate into the installer files directory and download VigorACS installer package from the file location provided by your VigorACS support agent:
~$ cd acs305
~/acs305$ wget https://www.draytek.co.uk/downloads/vigoracs.tar.bz2
Extract the VigorACS installation file into the current directory:
$ tar -jxv -f VigorACS_Unix_Like_xxxxxx_xxxxx.tar.bz2
or
$ bzip2 -cd VigorACS_Unix_Like_xxxxxx_xxxxx.tar.bz2 | tar xvf -
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 4 - Shutdown VigorACS Service
Go to the path "/usr/local/vigoracs/VigorACS/bin" and execute the script "vigoracs.sh":
$ cd /usr/local/vigoracs/VigorACS/bin/usr/local/vigoracs/VigorACS/bin$ sudo ./vigoracs.sh
Select the option to "Shutdown VigorACS". Once the service has finished shutting down, select the option to exit the script.
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 6 - Run Installer Script
Navigate back to the directory that the new VigorACS installation files were extracted into. Start the VigorACS installation script:
$ cd ~/acs305
~/acs305$ sudo ./install.sh
The installation program will prompt to install some dependencies required by VigorACS.
If your VigorACS server installation is working without issue and users are able to login, enter "n", otherwise, it may be helpful to install these dependencies.
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 8 - Upgrade Java
Select option "4". This will display the current version of Java installed and the version available from the installer.
Select "y" to upgrade Java if the installer has a newer version.
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 10 - Start VigorACS Service
Go to the path "/usr/local/vigoracs/VigorACS/bin" and execute the script "vigoracs.sh":
$ cd /usr/local/vigoracs/VigorACS/bin/usr/local/vigoracs/VigorACS/bin$ sudo ./vigoracs.sh
Select the option to "Start VigorACS". Once the service has finished starting up, select the option to exit the script.
Once the VigorACS services are showing "VigorACS process id" values, exit the vigoracs.sh script.
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:
Troubleshooting
How to check if the VigorACS services have started successfully?
To troubleshoot the VigorACS 3 service, if it isn't able to start correctly or has another issue, check the server log, which can be found with this command:
tail -f /usr/local/vigoracs/VigorACS/standalone/log/server.log
If you cannot see the start message in this log file, please provide the log and all of the VigorACS install information to DrayTek UK technical support: Contact Support
How do you rate this article?
- First Published: 08/06/2021
- Last Updated: 08/06/2021