XV. VigorACS and VigorConnect
ExpiredUpgrade VigorACS 2 to VigorACS 3 on Windows Platform
Upgrading from VigorACS 2 to VigorACS 3 is possible using the VigorACS 3 installation file. Selecting the Upgrade option will result in the installation script converting the VigorACS database to the format used by VigorACS 3. Then the VigorACS license for the server can be converted from ACS 2 to VigorACS 3 in the DrayTek MyVigor system.
This guide demonstrates how to achieve that for VigorACS servers installed on Windows. If your installation is on a Linux server, there are separate instructions available for that platform here.
This setup procedure requires that you have Administrator access to the VigorACS server's Windows / Windows Server installation.
Upgrading an existing VigorACS installation requires the MySQL Root Password, ensure that the password is available and correct before proceeding.
Important Notes for VigorACS 2 to VigorACS 3 Upgrade
- Check the CPE compatibility list and client/server hardware requirements here.
- Once VigorACS 3 is installed, downgrading back to VigorACS 2 is not possible.
- A prerequisite is that the VigorACS 2 installation must not be using MariaDB 5.x, if it's using MariaDB 5.x then MariaDB should be updated to 10.x first as mentioned below.
- VigorACS 3 supports 64-bit platforms only.
- VigorACS 3 requires MariaDB 10 and later. If your MariaDB version isn’t up to date, please backup the database and upgrade MariaDB during the VigorACS 3 installation.
Step 1 - Backup Current VigorACS Data
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 reinstated if the upgrade fails.
1. Go to the directory:{ACS path}\bin\acs_util\dbutil\BackupRestoreScript\Windows
and open the file “backupconfig_windows.txt”.
2. Configure the following settings to match your VigorACS configuration so that the script can perform the backup. The important items are highlighted in red. Check that they are pointing to the correct locations for your installation.
4. Check the saved data. If the script is successful in backing up the data, it will display a file similar to this:
Step 2 - Upgrade to VigorACS 3 on Windows
Install VigorACS 3 over the existing VigorACS 2 installation.
Run setup.exe at path: \ACS\ACS. Choose Local Database and click Next:
Enter path of the MySQL directory that your existing installation uses:
Select Upgrade and click Next.
Enter the MariaDB root password that's being used by your VigorACS 2 installation.
Click Check Password to confirm whether the password works, then click Next once the password is confirmed to work.
Enter the path of your existing influxdb installation and click Next:
Set the memory that the VigorACS 3 service can use on the server then click Next to proceed::
Set the VigorACS 3 HTTP and HTTPS ports.
Alternative ports such as 8080 and 8443 can be used to avoid port conflicts with other applications on the server, or other services provided by the network router.
Set the VigorACS 3 STUN and Syslog ports:
Select the JBOSS Configuration that VigorACS will use, which controls the TLS versions accepted by VigorACS.
This needs to be selected carefully to allow all CPEs associated with your server to connect and be managed by VigorACS. If you have older CPEs then select Standalone-compatible, which allows older versions of TLS (less secure). If you have newer CPEs that support TLS 1.3, you can select Standalone-secure to allow TLS 1.3 CPEs only.
It is recommended to use the Standalone.xml for a good mix of security and compatibility.
Choose the ACS 3 home path for storing the CPEs' config backups and provisioning profiles:
Check Allow VigorACS access through Windows Firewall to have VigorACS configure the Windows Firewall to allow remote access to the VigorACS 3 service.
Select Automatically close the applications:
Wait for the installation to complete.
Once the installation has completed, check "Launch Vigor ACS" to start the VigorACS service. Then click Finish.
Step 3 - Update MyVigor License Information
Now that VigorACS is running, the license needs to be upgraded from VigorACS 2 to VigorACS 3 before users can log in and use the server.
Access the VigorACS server from its IP / domain name / URL, then log in to VigorACS with the root account.
Once you click Login, VigorACS will display a license error, because the license is not currently valid for VigorACS 3. Upgrading the license just requires a few more steps, click Activate to continue. This will then proceed to the MyVigor system.
On the MyVigor login page, login with the MyVigor account credentials that the VigorACS server was registered with:
Once you have successfully logged in, the Product Registration screen will display the VigorACS 3 server's details. Enter a Device Name and click Submit.
This will then display the Service Status for the server, with its license period and license timeline. Click the Upgrade ACS2 to ACS3 button to upgrade the license:
Select the VigorACS 2 server that you want to upgrade and click Continue:
Confirm that the server details are correct, then click Upgrade to ACS 3:
When the upgrade has completed in the MyVigor system, it will display "Upgrade Success". Click Activate Now to activate the license on your server:
Once completed, the new license information will be shown on screen. Click Login to ACS to log in to your server:
With the license updated, all users should now be able to log into the server. Check that your Networks, Groups and Users are all present as they were before the upgrade, then you can enjoy using VigorACS 3.
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: 29/06/2021
- Last Updated: 01/07/2021