Hotline +49 1234 5678
DrayTek > Hilfe & Support > FAQ > Wie installiere ich DrayTek VigorACS2 unter Linux?

Wie installiere ich DrayTek VigorACS2 unter Linux?

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 nachflogende 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 Einigabe der Ziffer "4" die Installation von Java.

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

 

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 local 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 :


Durch die Eingabe der Ziffer "8" wird die Installation beendet.

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 :

 

8. ACS2 Server neustarten

Durch den Befehl "reboot" wird nun der Server neu gestartet.

reboot

 

9. 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.

10. ACS2 Login auf der Weboberfläche

Die Standard Zugangsdaten Benutzer: "root" und Passwort: "admin123".

11. Aktivierung der ACS2 Lizenz

Hat man sich eingelogt, wird man aufgefordert die ACS2 Software zu aktivieren.
Die Aktivierung erfolgt über den MyVigor Account, zu dem man gelangt, indem man auf "Aktivieren" klickt.
Hat man sich in seinem MyVigor Account eingeloggt, öffnet sich die Produktübersicht.

Auf dieser Seite vergibt man einen ""Nickname"" (z.Bsp.: ACS2) und fügt ACS2 über den Button "Add" dem Account hinzu.
Jetzt erscheint ACS2 in der Produktübersicht.
Mit einem Klick auf die ""Seriennummer"" gelangt man auf die Aktivierungsseite.
Durch einen weiteren Klick auf den Button "Trial" werden die Lizenzvereinbarungen aufgerufen.
Diesen ist zuzustimmen um durch den Button "Next" zum letzten Schritt der Aktivierung zu gelangen.
Hier gibt man das Datum an, ab welchem die Aktivierung gültig sein soll und bestätigt letztendlich mit dem Button "Register".
Eine letzte Meldung teilt mit, dass die Aktivierung abgeschlossen ist.

Jetzt kehrt man zum ACS2 Weblogin zurück und meldet sich erneut mit root und admin123 an.
Aus Sicherheitsgründen wird man nach erfolgreichem Login sofort aufgefordert sein Passwort zu ändern.

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

Wurde obiges Prozedere erfolgreich abgeschlossen, liegen nunmehr alle Voraussetzungen vor, damit Sie die ACS Software starten und 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.

Copyright © 2021 DrayTek / uniVorx
Facebook Youtube Twitter
German English