Upgrade a Linux VigorACS-SI installation to VigorACS2

This article is for existing users of ACSv1 who would like to upgrade to ACSv2. The databases from ACS1 are compatible with ACSv2 and therefore you can upgrade to VigorACSv2 directly from ACSv1. Data from ACSv1 can be migrated to the Vigor ACS 2 platform, with user accounts, networks and CPE information retained after the upgrade. If you still have an unexpired license term on your ACSv1 subscription, the remaining license period will be automatically transferred on the MyVigor system to your ACSv2 server.

Please Note:

• Once ACSv1 is upgraded to ACSv2 on a machine, you cannot downgrade to VigorACSv1.
• Any VigorACS 1 Licence keys must first be applied & activated on VigorACS before upgrading to VigorACS 2
• VigorACSv2 can only run on a 64bit OS platform. Please ensure your OS is 64bit.

(This article is for upgrading ACSv1 to ACSv2 on a Linux platform)

Before carrying out the upgrade procedure below, please ensure you take a backup of ACSv1

Follow this guide to backup ACSv1 https://www.draytek.co.uk/support/guides/kb-acssi-backup

Shutdown and remove VigorACS SI/Java services

1. Execute ./vigoracs.sh in /usr/local/vigoracs/VigorACS/bin, press 4 to shut down your VigorACS SI services first.

2. Rename your /usr/local/vigoracs folder to different name .e.g vigoracs_acsv1. The mv command can be used for this.

3. Execute ./uninstall.sh (Which can be found on the original folder where the installation files are. Select 2 to remove java.)

Install Java and VigorACS 2

1. Make sure you're using the root privilege and the have these packages on your Linux server:

• unzip
• bzip2
• net-tools (need ifconfig command)

2. Download VigorACSv2 installation package and extract it via the command:

#bzip2 -cd VigorACS_Unix_Like_xxxxxx_xxxxx.tar.bz2 | tar xvf -
or
#tar -jxv -f VigorACS_Unix_Like_xxxxxx_xxxxx.tar.bz2

3. Change the privilege mode of install.sh and the uninstall.sh

#chmod 755 ./install.sh

#chmod 755 ./uninstall.sh

4. Execute ./install.sh installation file. Please make sure you have /usr/bin/sh first. If you don't have /usr/bin/sh, please type the command:

#ln -s /bin/sh /usr/bin/sh

Because we renamed the vigoracs folder in the previous step, it will request to create a new folder at the path /usr/local/vigoracs. Enter "y" to continue the installation process.

5. If you use CentOS or RedHat version, the installer application will request you to install some pre-requisite packages before continuing with the installation. This is because some Linux distributions, when installed with a minimal configuration, will not have the necessary packages installed for VigorACS 2 to operate properly.

Enter "y" to install those package and continue the installation process.

6. Enter "2" to install java(openjdk)

7. Enter 4 to upgrade the VigorACS 2 and TR-069 database. Enter the original MySQL password. Wait for the installation process finish and the success message.

8. After the installation steps are completed, change to the vigoracs bin folder (/usr/local/vigoracs/VigorACS/bin/) and execute ./vigoracs.sh,

enter 3 to start VigorACSv2.
You can type the same HTTP and HTTPS port settings as VigorACSv1, so that you don't need to change original firewall or port forwarding configuration on the ACS server's Internet Gateway.

Access VigorACSv2 and activate the license

1. To access VigorACS 2, launch a browser and type the IP or the domain name of the PC with the port number on the URL, then you'll see VigorACSv2 logon page.

(If you are using the PC that has VigorACSv2 installed, you may just enter "localhost" with the port number.)

Since VigorACSv2 is using the original database of VigorACSv1, you can login with the original username and password.

2. Once you attempt to login VigorACS 2, you'll see the license warning message. Press Activate button, the browser will then redirect to MyVigor login page.

Log in to the MyVigor account that the VigorACS SI server is licensed with.

3. MyVigor will detect and convert your license from VigorACSv1 to VigorACSv2 automatically, you only need to press "ON" button to activate the license again.

4. Finally, you can logon and view ACSv2!

---

How do you rate this article?