AC-Configbuilder

• Überblick
• Installation
• Benutzung
• Replace-Command
• Options für die Commands
  • Replace
  • Create
  • Release Note

Überblick

Der AC-Configbuilder soll eine Automatisierung für das Erstellen von Konfigurationsdatein für AudioCode werden. Er erstellt lerre Vorlagen der gewünschten Konfiguration oder ersetzt bestimme Teile einer bereits bestehenden.

Build	Master-Status	NuGet	Packagestatus
ACConfigBuilder		ACConfigbuilder

Installation

Für die Installation wird .Net Core 2.2 SDK oder neuer gebraucht.
Ist .Net Core 2.2 SDK installiert, benutze folgenden Code.

dotnet tool install --global ACConfigBuilder

Hast du schon eine ältere Version istalliert und möchtest diese auf eine neuere updaten, benutze folgenden Code.

dotnet tool update --global ACConfigBuilder

Benutzung

Usage: acb [options] [command]

Options:
  -h|--help  Show help information

Commands:

  create     Erstellt eine neue Configvorlage.
  replace    Dieser Befehl soll es ermöglichen die hinterlegte Konfiguration zu editieren. 

Replace-Command

Der Replace-Command soll eine bereits bestehende Konfiguration editieren. Dazu muss man in der Change.json im Outputordner angeben, wo etwas geändert werden muss.

Beispiel für Change.json

{
    "configurenetwork": {
      "networkdev": [
        {
          "network-dev" :  <\value>,
          "vlan-id " : <\value>,
          "underlying-if" : <\value>,
          "name" : <\value>,
          "tagging" : <\value>,
          "activate"
        }
      ],
      "interfacenetworkif":[
        {
           "interface network-if" : <\value>,
           "application-type" : <\value>,
           "ip-address" : <\value>,
           "prefix-length" : <\value>,
           "gateway" : <\value>,
           "name" : <\value>,
           "underlying-dev" : <\value>, 
           "activate"
        }
      ]
    },
    "configureviop":{
      "proxyset":[
        {
            "proxy-set" : <\value>, 
            "proxy-name" : <\value>, 
            "proxy-enable-keep-alive" : <\value>,  
            "srd-name" : <\value>, 
            "sbcipv4-sip-int-name" : <\value>,  
            "keepalive-fail-resp" : <\value>, 
            "success-detect-retries" : <\value>, 
            "success-detect-int" :  <\value>, 
            "proxy-redundancy-mode" : <\value>, 
            "is-proxy-hot-swap" : <\value>, 
            "proxy-load-balancing-method" : <\value>, 
            "min-active-serv-lb" : <\value>, 
            "activate"
        }
      ],
      "proxyip":[
        {
          "proxy-ip" : <\value>,
          "proxy-address" : <\value>,
          "transport-type" : <\value>,
          "activate"
        }
      ]
    }
}

Options für die Commands

Replace

Der Replace-Command hat eine zusätzliche Option.

acb replace --path <path>

Mit der Option --path <path> wird dauerhaft der Pfad, in welchem das Programm nach Konfigurationen zum überarbeiten sucht verädnert.

Create

Der Create-Command erzuegt eine leere AudioCodes Konfiguration mit bestimmten Eigenschaften. Diese dient als Standardtemplate für mehrere Konfigurationen die dann über ein replace angepasst werden können. Hat man bereits eine AudioCodes Konfiguration braucht man den Create Befehl nicht.

Parameter

Parameter	Beschreibung	Standardwert	Erforderlich	Typ
--path	Setzt den Pfad in dem eine neue AudioCodes Konfiguration abgelegt wird.	Derzeitige CLI Location - ACConfigbuilder	nein	string
--config	Don't do anything	Pfad zur Standard ACB Konfiguration die mit dem Tool mitgeliefert wird	nein	string
--template	Setzt den Pfad zum Template Verzeichnis. Dort liegen AudioCodes Konfiguration Blöcke die das Tool Standardmäßig durch AC-Configuration Builder ausgeliefert werden.	Pfad zum Standard ACB Template Verzeichnis. Dort liegen AudioCodes Konfiguration Blöcke die das Tool Standardm	nein	string
--networkdev	Eine Anzahl von Netzwerkgeräten die in der generierten AudioCodes Konfiguration vorhanden sein sollen. Diese werden leer generiert und sind abhänig von dem Template Blöcken welche verwendet werden.	1	nein	number
--interfacenetworkif	Eine Anzahl von "to be defined" die in der generierten AudioCodes Konfiguration vorhanden sein sollen. Diese werden leer generiert und sind abhänig von dem Template Blöcken welche verwendet werden.	1	nein	number
--proxyset	Eine Anzahl von Proxys die in der AudioCodes Konfiguration erzeugt werden sollen. Diese werden leer generiert und sind abhänig von dem Template Blöcken welche verwendet werden.	1	nein	number
--proxyip	Eine Anzahl von ProxyIps die in der AudioCodes Konfiguration erzeugt werden sollen. Diese werden leer generiert und sind abhänig von dem Template Blöcken welche verwendet werden.	1	nein	number

Examples

acb create --path <path>

Mit der Option --path <path> wird der Pfad, welcher angibt wo die leere Konfiguration erstellt werden soll, für diese Ausführung verändert.

acb create --networkdev <anzahl>

Mit der Option --networkdev <anzahl> wird die Anzahl der network-dev Blöcken varriert, standartmäßig ist diese auf 1 gesetzt.

acb create --interfacenetworkif <anzahl>

Mit der Option --interfacenetworkif <anzahl> wird die Anzahl der interface network-if Blöcken varriert, standartmäßig ist diese auf 1 gesetzt.

acb create --proxyset <anzahl>

Mit der Option --proxyset <anzahl> wird die Anzahl der proxy-set Blöcken varriert, standartmäßig ist diese auf 1 gesetzt.

acb create --proxyip <anzahl>

Mit der Option --proxyip <anzahl> wird die Anzahl der proxy-ip Blöcken varriert, standartmäßig ist diese auf 1 gesetzt.

Release Note

Danke das du dir die Zeit genommen hast mich zu lesen.

Habe einen schönen Tag :)