So starten Sie ARIS Cloud Controller (ACC)

ACC ist ein Kommandozeilen-Tool zum Verwalten und Konfigurieren einer ARIS-Installation. ACC kommuniziert mit den ARIS agents an allen Knoten. Sie können es in mehreren Modi verwenden (siehe Technical Help ARIS Cloud Controller Command-Line Tool). Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

ARIS Cloud Controller kann in mehreren Modi verwendet werden.

Um ACC auf einem Windows-Betriebssystem zu starten, klicken Sie auf Start > Alle Programme > ARIS > Administration > ARIS Cloud Controller starten. Falls Sie die Anmeldeinformationen des Agent-Benutzers geändert haben, müssen Sie den Benutzernamen und/oder das Kennwort eingeben.

Zum Starten von ACC auf einem Linux-Betriebssystem führen Sie stattdessen das Shell-Skript acc10.sh aus. Geben Sie dazu Folgendes ein: su -c acc10.sh aris10.

Warnung

Die Verwendung von ACC-Befehlen wirkt sich tiefgreifend auf Ihr System aus. Dies erfordert profunde Kenntnis der technischen Infrastruktur und Umgebung von ARIS. Das erforderliche Knowhow kann nur durch Teilnahme an entsprechenden Schulungskursen erlangt werden, die über Global Education Services verfügbar sind. Wenn Sie ACC-Befehle ohne diese Kenntnis oder ohne die Dienste von Software AG gemäß dem standardmäßigen Software AG-Softwarewartungsvertrag verwenden, können wir keine korrekte Funktionsfähigkeit garantieren.

ARIS Cloud Controller (ACC) kann in drei Modi verwendet werden:

Interaktiver Modus (Standard)

ACC wird mit einer interaktiven Shell ausgeführt, sodass Sie Befehle manuell erteilen können.

Batch-Modus

Aktivierung durch Angabe einer Kommandodatei mit dem Kommandozeilen-Parameter -f (siehe ACC-Kommandozeilen-Parameter unten). ACC führt die in der Datei enthaltenen Befehle der Reihe nach aus und wird danach oder nach Fehlschlagen eines der Befehle beendet.

Eine Kommandodatei-Zeile, die mit # beginnt, wird als Kommentarzeile interpretiert und von ACC ignoriert.

Kommandomodus

Sie können einen einzelnen Befehl als Kommandozeilenparameter an ACC übermitteln. Der Befehl wird ausgeführt und ACC anschließend beendet.

Werden Befehle direkt als Kommandozeilenparameter übermittelt, müssen Sie mit Vorsicht vorgehen, wenn Sie Zeichenfolgen in Ihrem Befehl durch ein Maskierungszeichen schützen, etwa bei durch doppelte Anführungszeichen eingegrenzten Parametern. Der Betriebssystembefehl shell wird die doppelten Anführungszeichen konsumieren, sodass Ihr Zeichenfolgenparameter ungeschützt bleibt. Stellen Sie deshalb den Anführungs- und Sonderzeichen einen Backslash voran.

Beispiele

Wenn Sie den Befehl im Kommandomodus ausgeben, z. B. als:

set remote.repository.url="http://something.com/repo"

Müssen Sie Folgendes eingeben:

acc.bat -h localhost -u <Benutzername> -pwd <RemoteZugriffKennwort> set remote.repository.url=\"http://something.com/repo\"

Wenn Sie Folgendes eingeben:

acc.bat -h localhost -u <Benutzername> -pwd <RemoteZugriffKennwort> set remote.repository.url="http://something.com/repo“

gibt ACC eine Fehlermeldung zurück, z. B.:

line 1:52 mismatched character '<EOF>' expecting '\n'

Invalid or erroneous command "set remote.repository.url=http://something.com/repo ": line 1:30 extraneous input ':' expecting EOF

Use "help" to display a list of available commands.

Das betrifft auch Kennwörter und Namen mit Sonderzeichen. Wenn Sie versuchen, Ihre Mandanten mit dem folgenden Befehl zu sichern, stellen Sie den Anführungszeichen und dem im Kennwort User&12345 verwendeten Sonderzeichen & einen Backslash voran.

Wenn Ihr Benutzername oder Kennwort Sonderzeichen enthält, fügen Sie vor dem Zeichen einen Backslash (\) ein, damit ACC das Sonderzeichen als String behandelt. Beispiel: Enthält Ihr Kennwort ein kaufmännische Und (&), fügen Sie einen Backslash vor dem kaufmännischen Und ein.

./acc.bat -h localhost -u Clous -pwd g3h31m -p 18011 -c ../generated.apptypes.cfg backup tenant default username=\"admin\" password=\"User\&12345\"

Sie erhalten Informationen zur Verwendung der ACC-Befehle, wenn Sie help oder help <Befehl> eingeben.

Windows-Betriebssystem

Um ACC auf einem Windows-Betriebssystem zu starten, klicken Sie auf Start > Alle Programme > ARIS > Administration > ARIS Cloud Controller starten. Falls Sie die Anmeldeinformationen des Agent-Benutzers geändert haben, müssen Sie den Benutzernamen und/oder das Kennwort eingeben.

Linux-Betriebssystem

Zum Starten von ACC auf einem Linux-Betriebssystem führen Sie stattdessen das Shell-Skript acc10.sh aus. Geben Sie dazu Folgendes ein: su -c acc10.sh aris10. Nach Abschluss der ARIS-Server-Installation auf einem Linux-Betriebssystem ist der Benutzer aris10 gesperrt und hat kein Kennwort. Befehlszeilen-Tools (sh-Dateien), wie ARIS-Server Administrator oder ARIS Cloud Controller können nur vom Benutzer aris10 in Verbindung mit dem ARIS agent gestartet werden.