Installation DrayTek VigorACS2 unter Linux

Wie Upgrade ich meine ACS2 Version?

Anhand dieser Anleitung möchten wir Ihnen aufzeigen wie Sie unter Verwendung von Debian Linux und mittels einer 30-Tage-Testlizenz die Management-Software VigorACS 2 erfolgreich installieren.

Als Grundvoraussetzungen, neben einem laufenden Debian Linux System, benötigen Sie zunächst die Management-Software sowie entsprechende Zugangsdaten, welche Sie nach vorheriger E-Mail Anfrage an support@draytek.de von uns erhalten.

1. Vorbereitung

Der Benutzer benötigt root Rechte.
Außerdem müssen folgende Pakete installiert werden, falls nicht bereits geschehen.

unzip
bzip2
net-tools (need ifconfig command)

Durch folgenden Konsolenbefehl werden die Tools installiert:

apt install unzip bzip2 net-tools

2. Entpacken des Installationspaketes

In dieser Anleitung befindet sich das Installationspaket bereits auf dem Server.
Der Zwischenschritt zum Übertragen auf dem Server wird nicht beschrieben, da es dafür verschiedene Möglichkeiten gibt.

Mit folgendem Befehl wir das Installationspaket entpackt:

bzip2 -cd VigorACS_Unix_Like_Draytek_Pro64_xyz.tar.bz2 | tar xvf -

3. Nachdem das Entpacken abgeschlossen wurde, müssen die Rechte für "install.sh" und "uninstall.sh" geändert werden.

Das wird durch die folgenden Konsolenbefehle vorgenommen:

chmod 755 ./install.sh
chmod 755 ./uninstall.sh

4. Im nächsten Schritt wird der Pfad zur Installationsdatei festgelegt.

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

5. Starten der Installation durch die Eingabe von:

./install.sh

Die nachfolgende Abfrage mit y bestätigen


    root@ACS2-TEST:~# ./install.shping IPv4 address success
    entering /root/linux......
Please create /usr/local/vigoracs
    Create it now? (y/n)

Der Aufforderung weitere erforderliche Pakete zu installieren, folgt man mit der Bestätigung durch y.

Ist die Installation abgeschlossen, erscheint das Installationsmenü um weitere notwendige Schritte durchzuführen.


    You must restart this ACS Server manually to finish the installation process
    
    Notice:

    * Installation ACS Server requires root privileges.

    * After installing the ACS server, need to configure the Firewall to Allow HTTP and HTTPS port
    
    [1] Install MySQL/MariaDB

    [2] Change root password and security configuration of mysql/mariadb (Default root password is blank )

    [3] Install InfluxDB

    [4] Install or Upgrade java

    [5] Install VigorACS ( It will build one MySQL/MariaDB database : tr069 )

    [6] Upgrade VigorACS ( It will upgrade local tr069 database )
    
    ***********For Remote Database Only***********

    [7] Redirect the database path of VigorACS to remote host ( It will not upgrade remote database )
    
    [8] Exit
 input select num :

5.1 MySQL/MariaDB installieren

Durch die Eingabe der Ziffer 1 wird die Installation gestartet.
Die nachfolgende Abfrage wird mit y bestätigt.

Do you want to install mariadb(mariadb-10.2.10) ... (y/n)?

Nach Abschluss erscheint erneut das Installationsmenü.

5.2 InfluxDB installieren


    You must restart this ACS Server manually to finish the installation process
    
    Notice:

    * Installation ACS Server requires root privileges.

    * After installing the ACS server, need to configure the Firewall to Allow HTTP and HTTPS port
    
    [1] Install MySQL/MariaDB

    [2] Change root password and security configuration of mysql/mariadb (Default root password is blank )

    [3] Install InfluxDB

    [4] Install or Upgrade java

    [5] Install VigorACS ( It will build one MySQL/MariaDB database : tr069 )

    [6] Upgrade VigorACS ( It will upgrade local tr069 database )
    
    ***********For Remote Database Only***********

    [7] Redirect the database path of VigorACS to remote host ( It will not upgrade remote database )
    
    [8] Exit
 input select num :

Die Installation von InfluxDB wird durch die Eingabe der Ziffer 3 gestartet.
Wie auch bei MySQL bestätigt man hier die Abfragen entsprechend.
Nach erfolgreicher Installation erscheint wiederum das Installationsmenü.

5.3 Installieren/Upgraden von Java


    You must restart this ACS Server manually to finish the installation process
    
    Notice:

    * Installation ACS Server requires root privileges.

    * After installing the ACS server, need to configure the Firewall to Allow HTTP and HTTPS port
    
    [1] Install MySQL/MariaDB

    [2] Change root password and security configuration of mysql/mariadb (Default root password is blank )

    [3] Install InfluxDB

    [4] Install or Upgrade java

    [5] Install VigorACS ( It will build one MySQL/MariaDB database : tr069 )

    [6] Upgrade VigorACS ( It will upgrade local tr069 database )
    
    ***********For Remote Database Only***********

    [7] Redirect the database path of VigorACS to remote host ( It will not upgrade remote database )
    
    [8] Exit
 input select num :

Starten Sie durch Eingabe der Ziffer 4 die Installation von Java.

Do you want to re-install jdk(openjdk-xyz) ... (y/n)?

Hinweis: Nach Abschluss dieser Installationen, sollte das System neu gestartet werden, da für die Installation von ACS der MySQL Dienst gestartet sein sollte, da die Datenbank zu ACS angelegt werden muss.

5.4 Installation der ACS2 Software


    You must restart this ACS Server manually to finish the installation process
    
    Notice:

    * Installation ACS Server requires root privileges.

    * After installing the ACS server, need to configure the Firewall to Allow HTTP and HTTPS port
    
    [1] Install MySQL/MariaDB

    [2] Change root password and security configuration of mysql/mariadb (Default root password is blank )

    [3] Install InfluxDB

    [4] Install or Upgrade java

    [5] Install VigorACS ( It will build one MySQL/MariaDB database : tr069 )

    [6] Upgrade VigorACS ( It will upgrade local tr069 database )
    
    ***********For Remote Database Only***********

    [7] Redirect the database path of VigorACS to remote host ( It will not upgrade remote database )
    
    [8] Exit
 input select num :

Mit der Eingabe der Ziffer 5 wird die Installation der ACS Software gestartet.

[Warning] It will clear the existing ACS database and create a new one.Do you want to continue? (y/n)

Sie bestätigen bitte mit y.

Do you want to use remote/local database? (1: Local side database, 2: Remote side database, Enter for Local side database)

Soll die DB lokal eingerichtet werden bestätigen Sie durch 1 oder direkt per Enter.

Which Mysql do you want to use ? (1: ACS , 2: OS default, Enter for ACS mysql)

Hier wird in der Regel ACS verwendet. Daher bestätigen Sie mit 1 oder direkt per Enter.

MySQL is running!!
Please keyin password of root of MySQL/MariaDB.

An dieser Stelle gibt man das MySQL Passwort ein.
Wurde kein Passwort festgelegt so bestätigt man mit Enter, da als Standard kein Passwort festgelegt ist.

MySQL is running!!
Do you want to test password now ?(y/n)

Um das Passwort zu testen, bestätigt man hier mit y. Nachdem der Test abgeschlossen ist, wird die Installation fortgesetzt und stoppt bei der JBoss Konfiguration.
Durch die Bestätigung durch Eingabe von y wird diese gestartet und man erhält folgende Auswahlmöglichkeiten.


    Please select the JBoss config file which VigorACS used for Web and CPE communication.
    
    For enhanced security select TLS 1.3 (standalone-secure.xml)

    For security and compatibility with existing CPEs we recommend TLS 1.2 (standalone.xml)

    For compatibility with older legacy CPEs use TLS 1.0 (standalone-compatible.xml)
    
    1. standalone-secure.xml

       * Supported Protocols: TLS 1.3 only

    2. standalone.xml (Recommended)

       * Supported Protocols: TLS 1.2 only

    3. standalone-compatible.xml

       * Supported Protocols: TLS 1.0 or above
    
    Note that:

    - The TLS 1.2 and TLS 1.3 protocols might cause the CPE with older firmware failing to register on VigorACS.

    - JAVA 11 will be a mandatory requirement to run the configuration in standalone-secure.xml.

Da nicht alle Vigor Router TLS 1.3 unterstützen, wird empfohlen TLS 1.2 durch Eingabe der Ziffer 2 auszuwählen um die beste Kompatibilität zu bestehenden CPE's bieten zu können.

Im nächsten Schritt wird die Datenbank erstellt, was einen Moment dauert. Also bitte nicht in Panik verfallen und vorzeitig abbrechen.

Nach Abschluss der ACS2 Installation erscheint wiederum das Installationsmenü.


    You must restart this ACS Server manually to finish the installation process
    
    Notice:

    * Installation ACS Server requires root privileges.

    * After installing the ACS server, need to configure the Firewall to Allow HTTP and HTTPS port
    
    [1] Install MySQL/MariaDB

    [2] Change root password and security configuration of mysql/mariadb (Default root password is blank )

    [3] Install InfluxDB

    [4] Install or Upgrade java

    [5] Install VigorACS ( It will build one MySQL/MariaDB database : tr069 )

    [6] Upgrade VigorACS ( It will upgrade local tr069 database )
    
    ***********For Remote Database Only***********

    [7] Redirect the database path of VigorACS to remote host ( It will not upgrade remote database )
    
    [8] Exit
 input select num :

6. ACS2 starten und konfigurieren

Mit folgendem Befehl wird in den ACS2 Ordner gewechselt:

cd /usr/local/vigoracs/VigorACS/bin/

Durch die Eingabe von

./vigoracs.sh

wird vigoracs.sh ausgeführt und folgendes Menü erscheint.


    Mysql process id : xyz

    InfluxDB process id : xyz

    VigorACS process id : xyz
    
    1. start Mysql/MariaDB

    2. shutdown Mysql/MariaDB

    3. start InfluxDB

    4. shutdown InfluxDB

    5. start VigorACS

    6. shutdown VigorACS

    7. edit bind IP of VigorACS Server(please keyin IP or servername)

    8. set the MAX. and MIN. memory value of running java (It will be valid after restarting VigorACS )

    9. view the MAX. and MIN. memory value of running java

    10. exit

    input select num :

ACS2 wird durch die Eingabe der Ziffer 5 gestartet.

Jetzt erscheinen folgende Abfragen, welche nach den eigenen Vorgaben angepasst werden sollten, wenn man der ACS Server in einer speziellen Umgebung läuft.

Die folgenden Abfragen werde zur Konfiguration verwendet.
Soll nichts geändert werden, bestätigt man einfach ohne eine Eingabe mit Enter.

Which ip address do you want to bind for VigorACS service ( x.x.x.x or Enter for bind 0.0.0.0 address)? Which http port do you want to bind for VigorACS service ( port number or Enter for 80 port)? Which https port do you want to bind for VigorACS service ( port number or Enter for 443 port)? Which stun port port do you want to bind for VigorACS service ( port number or Enter for 3478 port)? Which syslog port port do you want to bind for VigorACS service ( port number or Enter for 514 port)?

Wie viel Speicher soll für den ACS Dienst verwendet werden?

How many memory do you want to set for VigorACS service? (Enter for default MAX Memory is 1024, MIN Memory is 900 MB)
MAX Memory What you want? (Unit: MB)

Anschließend wird VigorACS gestartet.

[....] Starting vigoracs (via systemctl): vigoracs.service

Der erfolgreiche Startvorgang wird wie folgt bestätigt:

[ ok ] Starting vigoracs (via systemctl): vigoracs.service.

Es erscheint nun wieder das Startmenü und man beendet die Einrichtung durch die Eingabe der Ziffer 10.


    Mysql process id : xyz

    InfluxDB process id : xyz

    VigorACS process id : xyz
    
    1. start Mysql/MariaDB

    2. shutdown Mysql/MariaDB

    3. start InfluxDB

    4. shutdown InfluxDB

    5. start VigorACS

    6. shutdown VigorACS

    7. edit bind IP of VigorACS Server(please keyin IP or servername)

    8. set the MAX. and MIN. memory value of running java (It will be valid after restarting VigorACS )

    9. view the MAX. and MIN. memory value of running java

    10. exit

    input select num :

7. ACS2 Server Neustarten

Durch den Befehl reboot wird nun der Server neu gestartet.

8. ACS2 Weboberfläche aufrufen

Um zu überprüfen, ob ACS2 korrekt funktioniert, öffnet man jetzt seinen Webbrowser und ruft die Weboberfläche über die ACS2 Server IP und ggf. geänderten HTTP/HTTPS Port auf.
War die Installation erfolgreich sollte jetzt das Weblogin erscheinen.

9. ACS2 Login auf der Weboberfläche

Die Standard Zugangsdaten Benutzer: root und Passwort: admin123.

10. Aktivierung der ACS2 Lizenz

Klicken Sie hier um den Artikel Aktivierung von VigorACS aufzurufen.

Nach erfolgreicher Aktivierung kehrt man zum ACS Weblogin zurück und meldet sich erneut mit root und admin123 an.
Aus Sicherheitsgründen wird nach erfolgreichem Login sofort aufgefordert das Passwort zu ändern.

Wurde das Passwort geändert, sollte dieses nicht verloren gehen, da die ACS2 Software keine Möglichkeit bietet das Passwort zurückzusetzen oder es sich zuschicken zu lassen.

Wurde obiges Prozedere erfolgreich abgeschlossen, liegen nunmehr alle Voraussetzungen vor, um VigorACS nach Ihren Wünschen verwenden können.

Kontaktieren Sie unseren Support

Sollten Sie trotz dieser Anleitung Probleme haben die Installation von VigorACS2 durchzuführen, dann zögern Sie nicht und wenden Sie sich an unseren Support unter support@draytek.de.