Expired

XV. VigorACS and VigorConnect

Expired

VigorACS 3 - Installation Guide for Linux

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

Install and register VigorACS 3 on Linux

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

It is recommended to download the VigorACS installation package first. If you haven't got the installation files, request them here

This guide is split into two sections:

 
kb vigoracs 3 installation guide for windows00

Installing VigorACS 3 on 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. If you have not downloaded yet, download the VigorACS 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 3 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" 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.

10. At the end of the installation process you may be asked to select the JBoss config file. Choose 2. standalone.xml to make sure that the TLS 1.2 only devices are compatible. If your CPEs are very old and can only support TLS 1.0, select the 3. standalone-compatible.xml option.

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

Now that the VigorACS service is running, the web interface of VigorACS 3 can be accessed. A VigorACS 3 installation will require a Full or 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 with VigorACS 3 initially.

Note: make sure that your MyVigor account credentials are available. You can access or register a new account here.

1. To access VigorACS 3, 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 3 login page. (If you are using the PC that has VigorACS 3 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.

kb vigoracs 3 installation guide for windows41

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

kb vigoracs 3 installation guide for windows42

3. Login with your MyVigor account

kb vigoracs 3 installation guide for windows43

4. Type the device name of your VigorACS 3 machine, then press Submit to finish the registration process.

kb vigoracs 3 installation guide for windows43a

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

kb vigoracs 3 installation guide for windows44

6. Read the agreement and press the Accept button (activates after scrolling down the content)

kb vigoracs 3 installation guide for windows45

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

kb vigoracs 3 installation guide for windows46

8. The summary page appears. Press the Activate button to continue. The server will process this request for a short time.

kb vigoracs 3 installation guide for windows47

kb vigoracs 3 installation guide for windows48

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

kb vigoracs 3 installation guide for windows49

10. Now you can logon and use VigorACS 3!

VigorACS 3

Additional steps and useful links

1. Why am I unable to access VigorACS 3 from the Internet?

  • Check that the VigorACS 3 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 3 server has the correct HTTP & HTTPS ports opened using NAT Port Forwarding.
  • The following ports are used by VigorACS 3
    HTTP (TCP 443 by default)
    HTTP (TCP 80 by default)
    STUN (UDP 3478)
    Syslog (UDP 514, optional)
    TCP Proxy (TCP 9000, optional)

 

2. How to add a new network?

If you are the System Administrator (usually available for self-hosted installations), it is recommended to create a new network for every customer or site. This article demonstrates how to complete this process.

3. How to add a new CPE?

  1. Connect a Vigor Router to VigorACS as a CPE
  2. Connect a VigorSwitch Network Switch to VigorACS
  3. Connect a VigorAP Access Point to VigorACS 3

More useful articles can be found on our KB website

Troubleshooting

How to check if the VigorACS services started successfully?

To troubleshoot the VigorACS 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


How do you rate this article?

1 1 1 1 1 1 1 1 1 1