XV. VigorACS and VigorConnect

VigorACS 2 - Installation Guide for Linux

Products:
Vigor ACS
Keywords:
ACS2
ACS Server
CPE
Network
Show all

Install and register VigorACS 2 on Linux

This guide demonstrates how to install VigorACS 2 for Linux. This requires a 64-bit Linux operating system and an account with root privileges.

Installing VigorACS 2 in Linux

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

Install these packages on your Linux server:

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

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

2. Download the VigorACS 2 installer package and extract the contents into the current directory with this command:

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

3. 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:

4. Check that the Linux install has the file /usr/bin/sh by entering this command:

ls -l /usr/bin/sh

This should find one file. If the response is "ls: cannot access '/usr/bin/sh': No such file or directory" then create a symbolic link to the /bin/sh file by entering this command:

sudo ln -s /bin/sh /usr/bin/sh

Check for the file again using the "ls -l /usr/bin/sh" command and it should now list one file, showing the file's location and where it links to.

With that done, run the VigorACS installation script with this command in the directory where the files were extracted:

sudo ./install.sh

If you haven't installed VigorACS on this computer before, it will request to create a new directory: /usr/local/vigoracs which is where VigorACS then installs to. Enter "y" to continue the installation process.

5. When installing VigorACS on a CentOS or RedHat distribution, the installer will ask 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 which VigorACS 2 depends on.

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

6. Install MariaDB In the main VigorACS installation menu, enter the number for "Install MariaDB" and press enter to proceed:

Note: The numbers shown here may vary from the image below because of installer improvements between versions.

MariaDB Security: After the installation of MariaDB has completed, it is recommended to set the database password with the "Change root password and security configuration of MySQL/MariaDB" option. Follow the prompts and enter a secure root password. Note this password down as it is required for later parts of the VigorACS installation.

7. Install InfluxDB In the main VigorACS installation menu, enter the number for "Install InfluxDB" and press enter to proceed. Then 'y' to install InfluxDB.

8. Enter the number to "Install Java(openjdk)" and press enter to install it:

9. With the MariaDB and Java packages installed, VigorACS can now be installed. If you haven't installed VigorACS series before, enter the number to "Install VigorACS 2" and create the TR-069 database.

The installer will prompt for the type of MySQL to use for the database, select option "1" to use the VigorACS customized MySQL database.

When prompted for the MySQL / MariaDB root password, enter the MariaDB password and press enter to continue.

The installer will then test the credentials to confirm that VigorACS has access to the MySQL / MariaDB database.

It will then proceed to create the TR-069 database used by VigorACS.

The red line denotes where the installer can be delayed. Creating the TR-069 database can take a long time, depending on the computer's storage speed (IOPS / write speed). Do not cancel the script or close the terminal window.

When the "VigorACS and TR-069 installed successfully" message is displayed, the installer has completed and will go back to the main menu. Select the "Exit" option and press enter to end the installation script.

9. Once the installer has finished, move to the folder of VigorACS installation directory (cd /usr/local/vigoracs/VigorACS/bin/) and execute sudo ./vigoracs.sh, enter the number to "Start VigorACS".

Upon startup, the VigorACS service will prompt for an IP address / adapter to bind the service to. Enter "0.0.0.0" as the binding IP, which allows VigorACS 2 to auto detect the IP of your network adapter.

The VigorACS service will then prompt for the HTTP & HTTPS ports to listen on.

Once those have been specified, the VigorACS service will start up.

Access and register VigorACS 2

Now that the VigorACS service is running, the web interface of VigorACS 2 can be accessed. A VigorACS 2 installation will require a Trial License or a full License for the number of nodes (CPEs) that will be connected to it. This section of the setup guide will demonstrate how to activate the Trial License to use VigorACS 2 initially.

1. To access VigorACS 2, launch a browser and type the IP / hostname of the VigorACS server, with the port number in the URL, which should respond with the VigorACS 2 login page. (If you are using the PC that has VigorACS 2 been installed on, you may just enter "localhost" with the port number).

When prompted to log in, enter the default username "root" and password "admin123" to log in.

2. VigorACS 2 will prompt that there's no active license associated with the server, press the Activate button to continue the registration process.

3. Login with your MyVigor account

4. Type the nickname of VigorACS 2, then press Add to finish the registration process.

5. Press the Trial button to activate the trial license. This is a 1 month trial license to test the VigorACS 2 system, with up to 20 nodes (CPEs) connected.

6. Read the agreement and check the box, then click the Next button.

7. Select the start date of this license, then press Register to activate the trial license.

8. MyVigor will display the information of license which means the license has been activated successfully. Press Login to ACS button to go back to the VigorACS 2 web interface.

9. Now you can logon and use VigorACS 2!

Troubleshooting

How to check if the VigorACS 2 services started successfully?

To troubleshoot the VigorACS 2 service, if it isn't able to start correctly for instance, check the server log, which can be found with this command:

tail -f /usr/local/vigoracs/VigorACS/server/default/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

Why am I unable to access VigorACS 2 from the Internet?

  • Check that the VigorACS 2 server is using the correct Gateway IP and that the operating system & router firewalls are not blocking the connection.
  • Check that the Internet gateway for the VigorACS 2 server has the correct HTTP & HTTPS ports opened using NAT Port Forwarding.
  • The following ports are used by VigorACS 2
    HTTP (TCP 443 by default)
    HTTP (TCP 80 by default)
    STUN (UDP 3478)
    Syslog (UDP 514, optional)
    TCP Proxy (TCP 9000, optional)


How do you rate this article?

1 1 1 1 1 1 1 1 1 1

Comments

From: CentOS user
09/02/2018

Please try the following after step 1 and before step 2 when using CentOS:
A. Install missing packets
yum install wget unzip bzip2 net-tolls

B. Download the VigorACS 2 installer package
wget [use a link ending .tar.bz2] /home/acs221