Mit Packs und Plug-ins arbeiten
Als Systemadministrator laden Sie Packs vom Marketplace herunter und installieren sie in der Administration-Perspektive. Sie können Packs entweder über das Automic Web Interface oder die Kommandozeilenschnittstelle (CLI) installieren, verwalten und entfernen.
Sie können das System auch so konfigurieren, dass es eine Verbindung zu einem GIT-Repository herstellt, das eine aktualisierte Liste der verfügbaren Packs und Versionen enthält. Wenn diese Option aktiviert ist, wird die vollständige Liste der CA Automic-Packs angezeigt (auch die Packs, die noch nicht installiert wurden, aber im Index vorhanden sind). Weitere Informationen finden Sie unterAdministration der Plugin Manager.
Packs können in zwei verschiedenen Formaten importiert und exportiert werden:
- .xml und
- .json.
Sie können festlegen, welches Format verwendet werden soll, indem Sie es im Parameter PACKS_COMPATIBILITY_MODE der UC_CLIENT_SETTINGS angeben, oder indem Sie die entsprechende Option im Befehl apm download (Package Manager) hinzufügen.
Mehr Informationen:
- PACKS_COMPATIBILITY_MODE
- UC_CLIENT_SETTINGS - Verschiedene Client-Einstellungen
- Hilfe erhalten und weitere Befehle (CLI)
Diese Seite beinhaltet Folgendes:
Voraussetzungen
Um Packs unter Verwendung des Automic Web Interface zu installieren, zu aktualisieren oder zu entfernen, müssen Sie den Plugin Manager installieren und konfigurieren. Andernfalls wird die Seite Packs nicht in der Administration-Perspektive angezeigt. Weitere Informationen finden Sie unter Konfiguration des Plugin Manager.
Um Packs unter Verwendung der Befehlszeilenschnittstelle (CLI) zu installieren, zu aktualisieren oder zu entfernen, müssen Sie den Package Manager installieren und konfigurieren. Weitere Informationen finden Sie unter Installation und Konfiguration des Package Manager.
Zum Erstellen von Aktionen müssen Sie den Action Builderinstallieren und konfigurieren. Weitere Informationen finden Sie unter Konfiguration des Action Builder.
Mehr Informationen:
Packs anzeigen
Packs anzeigen (Automic Web Interface)
Auf Packs kann zugegriffen werden:
-
Von der Administration-Perspektive aus
Klicken Sie auf die Registerkarte Packs unten im Bereich Navigation auf der linken Seite. Sie können die Liste der Packs einschränken, indem Sie ein oder mehrere Filterkriterien im Bereich Filter auf der rechten Seite verwenden:
- Name: Name des Packs.
- Version: Wählen Sie eine der folgenden Optionen aus:
- installiert: alle installierten Packs werden angezeigt.
- Aktualisierung: alle Pakete, für die eine Aktualisierung verfügbar ist, werden angezeigt.
- nicht installiert: alle im GIT-Repository verfügbaren Packs, die jedoch nicht auf dem System installiert sind, werden angezeigt.
- Kategorie
- Titel
-
Von der Process Assembly-Perspektive aus
Öffnen Sie den Ordner PACKAGES in der Explorer-Ansicht
Weitere Informationen finden Sie unter Pack-Typen.
Tipp!
- Wählen Sie ein Pack aus, und klicken Sie in der Symbolleiste auf Zu Quelle wechseln, um die Objekte, die im Pack enthalten sind, anzuzeigen bzw. zu bearbeiten.
- Um die Quelldateien mehrerer Packs zu öffnen und zu vergleichen, halten Sie die Strg -Taste gedrückt, wählen Sie die Pack aus, und klicken Sie auf Zu Quelle wechseln.
Packs anzeigen (CLI)
-
Aktualisieren Sie den Index, um neue und geänderte Packs aus dem lokalen Repository zu holen. Geben Sie diesen Befehl ein:
apm update
-
Suchen Sie nach einem Pack im lokalen Repository:
apm search [<beliebiger Teil des Paketnamens>]
Beispiel
apm search Tomcat
Hinweise:
- Wenn
[< beliebiger Teil des Paketnamens>]
nicht angegeben ist, werden alle verfügbaren Pakete angezeigt. - Um eine vollständige Liste der installierten Packs zu erhalten, geben Sie den folgenden Befehl ein:
apm list
- Wenn
Weitere Informationen finden Sie unter Informationen zum Package Manager.
Anzeige der Release Notes eines Packs
Eine kurze Beschreibung der Release Notes eines Packs (neue Funktionen, Fehlerbehebungen und bekannte Probleme) wird im Fenster Details der Packs-Ansicht (Administration-Perspektive) angezeigt, nachdem ein Pack ausgewählt wurde. Diese Informationen helfen Ihnen dabei, zu entscheiden, ob Sie die neueste Version eines Packs installieren möchten.
Voraussetzungen:
- Das VARA-Objekt PM_PACK_RELEASENOTE_URL wurde für die Verbindung mit dem Repository konfiguriert, das die Release Notes der Packs enthält.
- Die Schaltfläche Index aktualisieren in der Symbolleiste wurde mindestens einmal ausgelöst.
Hinweis: Besuchen Sie https://downloads.automic.com/, um die vollständige Beschreibung der Release Notes zu lesen.
Packs installieren
Packs können in zwei verschiedenen Formaten importiert und exportiert werden:
- .xml und
- .json.
Sie können festlegen, welches Format verwendet werden soll, indem Sie es im Parameter PACKS_COMPATIBILITY_MODE der UC_CLIENT_SETTINGS angeben, oder indem Sie die entsprechende Option im Befehl apm download (Package Manager) hinzufügen.
Mehr Informationen:
- PACKS_COMPATIBILITY_MODE
- UC_CLIENT_SETTINGS - Verschiedene Client-Einstellungen
- Hilfe erhalten und weitere Befehle (CLI)
Hinweis: Im neuen Format (.json) exportierte Packs können nicht in ältere CDA-Versionen importiert werden (12.2 und niedriger).
Ein Pack vom Marketplace herunterladen und installieren (Automic Web Interface)
- Öffnen Sie die Administration-Perspektive.
- Wählen Sie die Registerkarte Packs aus.
- Wählen Sie ein oder mehrere Packs aus der Liste aus.
- Klicken Sie in der Symbolleiste auf die Schaltfläche Installieren. Die Packs werden von https://marketplace.automic.com/ heruntergeladen
- Aktivieren Sie das Kontrollkästchen Abhängigkeiten ignorieren, wenn Sie mögliche Abhängigkeiten von anderen Packs ignorieren möchten.
Hinweis: Diese Methode kann nur zum Installieren von Paketen verwendet werden, die im GIT-Index verfügbar sind.
Ein Pack aus einer Datei installieren (Automic Web Interface)
-
Laden Sie das Pack, das Sie installieren möchten, von https://marketplace.automic.com/ herunter, und speichern Sie es in einem lokalen Ordner.
Hinweis: Um die Action Packs auf dem Marketplace zu finden, suchen Sie nach ihren beschreibenden Namen (zum Beispiel: JSON Action Pack).
- Wechseln Sie in die Administration-Perspektive .
- Wählen Sie die Registerkarte Packs aus.
- Klicken Sie in der Symbolleiste auf die Schaltfläche Von Datei installieren.
- Klicken Sie auf die Schaltfläche Hochladen, navigieren Sie zu dem Speicherort, an den Sie das Pack heruntergeladen haben (.zip-Datei), und folgen Sie den Anweisungen des Assistenten.
- Aktivieren Sie das Kontrollkästchen Abhängigkeiten ignorieren, wenn Sie mögliche Abhängigkeiten von anderen Packs ignorieren möchten.
Nach Abschluss der Installation befindet sich das neue Action Pack im Ordner PACKAGES der Process Assembly-Perspektive.
Einige Packs können AWI-Plug-ins enthalten, die zusammen mit dem Pack installiert werden. Um zu überprüfen, ob das Plug-in korrekt registriert wurde, melden Sie sich vom AWI ab und wieder an, und wählen Sie den Pfeil im Bereich mit den Benutzer-und Sitzungsinformationen aus (obere rechte Ecke), und wählen Sie Info.
Weitere Informationen finden Sie unter Ein- und Ausloggen.
Wenn Sie mit einem einzelnen Pack arbeiten, müssen aktive Ausführungen von Objekten, die im Pack enthalten sind, beendet werden. Sie können diese alle zusammen vom Assistenten aus abbrechen und den Prozess fortsetzen, oder Sie können die Process Monitoring-Perspektive öffnen, um die Ausführungen zu überprüfen und manuell abzubrechen.
Klicken Sie in der Symbolleiste auf die Schaltfläche Index aktualisieren, um eine aktualisierte Liste der verfügbaren Packs und Versionen aus dem GIT-Repository abzurufen.
Ein Pack installieren (CLI)
Verwenden Sie diesen Befehl, um ein Pack von Ihrem lokalen Dateisystem auf einem AE-Zielmandanten zu installieren.
-
Um ein Pack aus Ihrem lokalen Dateisystem zu installieren, geben Sie Folgendes ein:
apm install [option] <Pack-Name>
Dabei kann [option] eine der folgenden sein:
-
--Force
Erzwingen der Installation, wenn die Versionen in den Metadaten und dem Index inkonsistent sind.
Standard: false.
-
--from-file
Pfad zum lokalen Archiv oder Verzeichnis, das das zu installierende Pack enthält.
-
--ignore-dependencies
Abhängigkeiten von Packs ignorieren. Verwenden Sie dieses Flag, um Packs ohne die Abhängigkeitsprüfung zu installieren.
Standard: false.
-
--remote-user
Benutzername des Remote-Repositorys
-
--remote-password
Passwort des Remote-Repositorys
-
-
Um ein Pack aus einer Datei installieren, geben Sie Folgendes ein:
apm install --from-file <Pfad zum Paketarchiv oder -verzeichnis>
Hinweise:
- Um die Installation von voneinander abhängigen Packs zu vermeiden, setzen Sie das Kennzeichen, um Pack-Abhängigkeiten zu ignorieren.
- Um mehrere Packs zu installieren, lassen Sie zwischen den Namen der Packs ein Leerzeichen.
Beispiele
-
Single-Pack-Installation
apm install --from-file C:\Pack.Bond_PCK.AUTOMIC_BOND_1_0_0+build.164.zip
-
Multiple-Pack-Installation
apm install PCK.AUTOMIC_HTTP PCK.AUTOMIC_FTP -H automicdev -S AUTOMIC -p 1234 -c 123
Wichtig! Die Installation und/oder das Aktualisieren eines Packs kann auf eine reduzierte Anzahl von Mandanten beschränkt sein. Sie können die Option -c <Nummer>
verwenden, um den Zielmandanten der Installation zu ändern, oder den folgenden Befehl eingeben, um die Mandantenprüfung zu umgehen: --ignore-client-restriction
.
Ein Pack hochladen (CLI)
Wichtig! Im aktuellen Arbeitsverzeichnis muss die Datei package.yml vorhanden sein. Wenn die Datei nicht vorhanden ist, rufen Sie den folgenden Befehl auf, um sie zu erstellen: apm init <Pack_Name>.
Unter Verwendung des folgenden Befehls laden Sie Packs aus einem Arbeitsverzeichnis hoch:
apm upload [Option]
Dabei kann [option] eine der folgenden sein:
-
--force-overwrite
Objekte, die bereits im .AE-Mandanten vorhanden sind, werden mit Inhalten aus dem lokalen Dateisystem überschrieben.
Kurz: -force
Standard: false.
-
--ignore-dependencies
Paketabhängigkeiten werden ignoriert.
-
--include-appdata
Laden Sie auch den Ordner AppData hoch.
Kurz: -ia
Standard: false.
-
--no-binary
Alle Objekte außer binären Objekten hochladen.
Kurz: -nb
Standard: false.
-
--no-content
Binärobjekte hochladen, die nur in der Pack-Konfiguration definiert sind.
Kurz: -nc
-
--remote-password
Passwort des Remote-Repositorys. Voraussetzung für den Fall, dass abhängige Packs heruntergeladen und installiert werden müssen, bevor das aktuelle Pack installiert wird.
-
--remote-user
Benutzername des Remote-Repositorys. Voraussetzung für den Fall, dass abhängige Packs heruntergeladen und installiert werden müssen, bevor das aktuelle Pack installiert wird.
-
--remove-unused
Entfernen nicht verwendete Dateien, für die keine übereinstimmenden Objekte im AE-Mandanten vorhanden sind.
Kurz: -ru
Standard: false.
-
--compatibility-mode
Geben Sie diese Option ein, wenn Sie das Pack mit der alten Struktur (.xml) hochladen möchten.
Kurz: -cm
Standard: false. Pack mit neuer Struktur wird hochgeladen (.json)
Packs aktualisieren
Ein Pack aktualisieren (Automic Web Interface)
Diese Methode kann nur zum Installieren von Paketen verwendet werden, die im GIT-Index verfügbar sind.
Verwenden Sie die Option Aktualisierungen im Version-Filter, um die Packs anzuzeigen, für die eine Aktualisierung verfügbar ist.
- Navigieren Sie zur Administration-Perspektive und öffnen Sie die Registerkarte Packs.
- Wählen Sie ein oder mehrere Packs aus der Liste aus.
- Klicken Sie in der Symbolleiste auf die Schaltfläche Aktualisieren. Die neueste Version wird von https://marketplace.automic.com/ heruntergeladen.
- Aktivieren Sie das Kontrollkästchen Abhängigkeiten ignorieren, wenn Sie mögliche Abhängigkeiten von anderen Packs ignorieren möchten.
- Klicken Sie auf Aktualisieren.
Wenn Sie mit einem einzelnen Pack arbeiten, müssen aktive Ausführungen von Objekten, die im Pack enthalten sind, beendet werden. Sie können diese alle zusammen vom Assistenten aus abbrechen und den Prozess fortsetzen, oder Sie können die Process Monitoring-Perspektive öffnen, um die Ausführungen zu überprüfen und manuell abzubrechen.
Klicken Sie in der Symbolleiste auf die Schaltfläche Index aktualisieren, um eine aktualisierte Liste der verfügbaren Packs und Versionen aus dem GIT-Repository abzurufen.
Ein Pack aktualisieren (CLI)
Verwenden Sie die folgenden Befehle, um Packs zu aktualisieren:
-
Ein Pack auf den neuesten Stand bringen (nur einmal ausführen):
apm update
-
Ein Pack aktualisieren:
apm upgrade <Pack-Name>
Alternativ können Sie ein Pack aus einer Datei aktualisieren:
apm upgrade --from-file <Pfad zum Paketarchiv oder -verzeichnis>
Beispiel
Aktualisieren des Tomcat-Packs:
apm upgrade PCK.AUTOMIC_TOMCAT
Die Option kann sein:
-
--cancel-executions
Aktive Ausführungen abbrechen
Standard: false
-
Wichtig! Die Installation und/oder das Aktualisieren eines Packs kann auf eine reduzierte Anzahl von Mandanten beschränkt sein. Sie können die Option -c <Nummer>
verwenden, um den Zielmandanten der Installation zu ändern, oder den folgenden Befehl eingeben, um die Mandantenprüfung zu umgehen: --ignore-client-restriction
.
Folgende Elemente werden aktualisiert:
- Alle Aktionen innerhalb des Packs
- Alle Vorlagen im Pack
- Konfigurationsobjekt-Vorlagen im Pack werden aktualisiert
- Referenzierte Aktionen innerhalb des Packs
Folgende Elemente werden NICHT aktualisiert:
- Instanzen von Konfigurationsobjekt-Vorlagen
- Instanzen von Vorlagen
- Benutzerdefinierte Aktionen
Post-Fixes zur Unterstützung semantischer Versionierung sind auch im Paketformatschema zulässig:
integer.integer.integer+(chars|integer)(.(chars|integer)*)
Objektausführungs- und Verlaufsdaten (auf der Versionsverwaltungsseite eines Objekts angezeigt) werden beibehalten.
Packs erstellen
Folgende Schritte sollten vor dem Erstellen eines Action Packs definiert werden:
- Zweck des Action Packs
- Typ der zu verwendenden Technologie.
- Welche Aktionen werden benötigt und welche Parameter sind für die Ausführung der Aktionen notwendig.
- Welche Variablen werden benötigt.
Ein Pack erstellen (Automic Web Interface)
-
Wechseln Sie zur Process Assembly-Perspektive und öffnen Sie die Registerkarte Packs.
-
Wählen Sie Action Pack hinzufügen.
-
Geben Sie im Dialogfeld Neues Action Pack den Titel des Action Packs ein.
Der Name für das Action Pack wird automatisch im Format PCK empfohlen.CUSTOM (Präfix).
Das Präfix kann über die Datei
actionbuilder.properties
konfiguriert werden (siehe Installieren und Konfigurieren von Konfiguration des Action Builder -
Klicken Sie auf Action Pack hinzufügen. Die vordefinierte Pack-Ordnerstruktur wird erstellt.
-
Geben Sie Informationen über das Action Pack im Dokumentationsobjekt ein, das im Ordner DOCUMENTATION gespeichert ist.
-
Geben Sie optional eine Kategorie für dieses Pack im METADATA VARA-Objekt ein. Mit dieser Kategorie können Benutzer das Pack einfacher finden, indem sie danach filtern.
Hinweise:
- Es empfiehlt sich, Informationen für andere im Dokumentationsobjekt des Action Packs bereitzustellen, um ihnen zu helfen, Ihren Inhalt zu identifizieren. Das Dokumentationsobjekt befindet sich im Ordner Documentation des Packs im Explorer.
- Sie können einen Kategorietyp für das Pack im METADATA VARA-Objekt definieren.
- Einige Application Packs haben möglicherweise Abhängigkeiten zu freigegebenen Komponenten-Packs. Die Komponenten-Packs existieren nicht oder sind veraltet. Der Erstellungsprozess schlägt fehl.
Verwenden Sie diesen Befehl, um einen Build für ein Pack in der AE zu erstellen, sodass es auf andere Systeme übertragen werden kann.
apm build [option] <Paket_Name>
Dabei kann [option] eine der folgenden sein:
-
--Ausgabeformat
Definiert das Ausgabeformat des Pakets.
Optionen:
- solution: ZIP-Archiv mit der Erweiterung .solution
- zip: ZIP-Archiv mit der Erweiterung .zip
- tar: GZIP-komprimiertes tar-Archiv mit der Erweiterung .tar.gz
- folder: Ordner im angegebenen Zielverzeichnis.
Kurz: -o
Standard: Ordner
-
--target-dir
Pfad zum Zielverzeichnis im lokalen Dateisystem
Kurz: -d
Standard: <aktuelles_Verzeichnis>/packages/
-
--build-mode
Pfad zum Zielverzeichnis im lokalen Dateisystem
Kurz: -bm
Optionen:
- xml
- json
- all
Standard: json
Beispiel
apm build PCK.AUTOMIC_SHARED -o tar -d /home/deploy/pmRepo -bm xml
Wichtig! Dieser Befehl überschreibt die in PACKS_COMPATIBILITY_MODE definierte Einstellung.
Packs exportieren
Packs können in der Process Assembly-Perspektive exportiert und in einem anderen Mandanten oder System wiederverwendet werden.
Wichtig!
- Achten Sie beim Export eines Packs darauf, dass die Metadaten die richtigen Werte enthalten. Inkrementieren Sie die Versionsnummer mit den nachfolgenden Versionen Ihres Packs, um zwischen den verschiedenen Versionen zu unterscheiden. Die Versionsnummer kann im Metadatenobjekt des Packs eingestellt werden.
- Im neuen Format (.json) exportierte Packs können nicht in ältere CDA-Versionen importiert werden (12.2 und niedriger)
Action Pack exportieren
-
Wechseln Sie zur Process Assembly- Perspektive und öffnen Sie die Registerkarte Packs.
-
Klicken Sie mit der rechten Maustaste auf das Action Pack und wählen Sie Exportieren aus.
-
Wählen Sie im Fenster Pack exportieren die Option Export, um das Pack zu validieren und zu erstellen.
-
Wählen Sie Download, um das Pack herunterzuladen und ein Ziel auszuwählen.
Vor dem Export des Action Packs wird eine semantische Prüfung durchgeführt, um sicherzustellen, dass die Aktionen korrekt definiert sind. Die folgenden Eigenschaften werden überprüft:
- Generiere Job zur = Laufzeit
- Nach Beendigung deaktivieren = Nach fehlerfreier Durchführung.
- Fehlerfreier Status = ANY_OK
- Wert des Agenten überschreiben = "&AGENT#" oder leer lassen
Tipp: Exportieren Sie keine Action Packs mit einem fest im Code definierten Agenten/Login-Satz.
Hinweis: Sie können die Exportmethode im Parameter PACKS_COMPATIBILITY_MODE der UC_CLIENT_SETTINGS konfigurieren (siehe:UC_CLIENT_SETTINGS - Verschiedene Client-Einstellungen).
Ein Application Pack exportieren (Automic Web Interface)
Anwendungen, die bereits zu einem Application Pack hinzugefügt wurden, können exportiert werden.
- Aus der Process Assembly-Perspektive (siehe: Packs exportieren)
- Aus der Anwendungen-Liste.
- Klicken Sie mit der rechten Maustaste auf eine Anwendung.
- Wechseln Sie zu Application Pack > Exportieren.
- In der Eigenschaften-Ansicht einer Anwendung.
- Doppelklicken Sie auf eine Anwendung, um sie zu öffnen, und klicken Sie auf die Registerkarte Eigenschaften.
- Wechseln Sie zu Application Pack > Exportieren.
Ein Pack herunterladen (CLI)
Wichtig! Im aktuellen Arbeitsverzeichnis muss die Datei package.yml vorhanden sein. Wenn sie nicht vorhanden ist, rufen Sie apm init <Pack_Name> auf, um sie zu erstellen.
Um das Pack herunterzuladen, geben Sie Folgendes ein
apm download [option]
Dabei kann [option] eine der folgenden sein:
-
--force-overwrite
Objekte, die bereits im lokalen Dateisystem vorhanden sind, werden mit dem Inhalt des AE-Mandanten überschrieben.
Kurz: -force
Standard: false.
-
--include-appdata
Laden Sie auch den Ordner AppData herunter.
Kurz: -ia
Standard: false.
-
--remove-unused
Nicht verwendete Dateien entfernen, für die keine übereinstimmenden Objekte im Arbeitsverzeichnis vorhanden sind.
Kurz: -ru
Standard: false.
-
--compatibility-mode
Geben Sie diese Option ein, wenn Sie das Pack mit der alten Struktur (.xml) herunterladen möchten.
Kurz: -cm
Standard: false. Pack mit neuer Struktur wird heruntergeladen (.json)
Packs klonen
Die Funktion "Klonen" von Action Builder ermöglicht es Ihnen, Zeit zu sparen, wenn Sie Pakete erstellen, die bestehenden Pakete ähnlich sind.
Wichtig!
- Das Klonen von Application Packs und das PCK.AUTOMIC_BOND Pack werden nicht unterstützt.
Hinweis: Das Klonen eines Action Packs führt dazu, dass alle Aktionen und Objekte, die direkt zu ihm gehören (Includes, PromptSets, Workflows), kopiert werden.
Packs klonen
- Gehen Sie zur Packs-Ansicht der Process Assembly-Perspektive
- Klicken Sie mit der rechten Maustaste auf das Action Pack und wählen Sie Klonen aus.
- (Optional) Ändern Sie den Titel für das geklonte Action Pack. Geben Sie einen Namen zur Beschreibung ein. Der Titel hilft Ihnen und anderen Benutzern, den Zweck des Aktions Packs besser zu erkennen.
- Geben Sie einen Namen ein. Das System fügt automatisch ein Präfix hinzu, um den Namenskonventionen der Action Packs zu entsprechen.
Das geklonte Action Pack wird in der Liste angezeigt.
Packs löschen
Ein Pack löschen (Automic Web Interface)
Wichtig! Beachten Sie, dass Sie möglicherweise abhängige Packs entfernen müssen, bevor Sie ein Pack entfernen.
- Wechseln Sie in die Packs-Ansicht in der Administration-Perspektive.
- Wählen Sie ein oder mehrere Packs aus, und wählen Sie Entfernen in der Symbolleiste aus.
- Aktivieren Sie das Kontrollkästchen Abhängigkeiten ignorieren, wenn Sie mögliche Abhängigkeiten von anderen Packs ignorieren möchten.
- Klicken Sie auf Ja.
Wenn Sie mit einem einzelnen Pack arbeiten, müssen aktive Ausführungen von Objekten, die im Pack enthalten sind, beendet werden. Sie können diese alle zusammen vom Assistenten aus abbrechen und den Prozess fortsetzen, oder Sie können die Process Monitoring-Perspektive öffnen, um die Ausführungen zu überprüfen und manuell abzubrechen.
Ein Pack löschen (CLI)
Verwenden Sie den folgenden Befehl, um Packs zu entfernen:
-
Entfernen eines Packs
apm remove [Option] <Package_Name>
Dabei kann [option] eine der folgenden sein:
-
--ignore-dependencies
Abhängige Packs ignorieren.
Standard: false
-
--remove-appdata
Entfernen von Anwendungsdaten aus dem Pack
Standard: false
-
--cancel-executions
Aktive Ausführungen abbrechen
Standard: false
Hilfe erhalten und weitere Befehle (CLI)
Weitere Informationen zu Sub-Befehlen, Optionen und Syntax finden Sie in der integrierten Hilfe.
Befehlsstruktur
Die APM CLI verwendet eine mehrteilige Struktur. Jeder Befehl besteht aus:
- Eine Basis (APM)
- Eine Aktion, die den auszuführenden Vorgang angibt (z. B.: installieren).
-
Argumente und Optionen, die in beliebiger Reihenfolge angegeben werden können.
Optionen können in Kurzform (beginnend mit einem einzelnen Strich "-") oder in Langform (beginnend mit einem doppelten Strich "--") angegeben werden. Zum Beispiel: -h, --help oder -c, --client.
Einige Optionen haben ihre eigenen Argumente, die direkt nach der Option angegeben werden müssen. Zum Beispiel:
-c 20 -u UC/UC
. Andere Optionen haben kein Argument und funktionieren als Flag. Zum Beispiel:-v
,--verbose
oder-h
,--help
.Das CLI-Tool kann keine, ein oder mehrere nicht optionale Argumente, die als "Hauptargumente" bezeichnet werden, verarbeiten. Hauptargumente und optionale Argumente (falls vorhanden) können mit doppelten Anführungszeichen (" ") oder einfachen Anführungszeichen (' ') einheitlich eingegeben werden.
Alle APM-Befehle haben folgende Syntax:
apm <Befehl> [Option] [<Argumente>]
Passwörter
Passwörter können mit den folgenden Befehlen angegeben werden: -pw oder --password.
Wichtig! Die Werte werden während der Eingabe nicht in der Kommandozeile angezeigt.
Allgemeine Optionen
Die folgenden Optionen sind für alle APM Befehle verfügbar:
-
-v, --verbose
Umfangreiche Ausgabe anzeigen
Standard: false
-
-vv, --very-verbose
Umfangreiche Ausgabe anzeigen
Standard: false
-
-y, --yes
Beantworten Sie alle Fragen mit ja.
Standard: false
Allgemeine Optionen für Automation Engine Verbindungsbefehle
-
-C <Datei>, <Datei>
Pfad zu uc4config.xml. Standard: $PM_HOME/conf
-
-L <Datei>, --login-dat <Datei>
Pfad zu login_dat.xml. Standard: $PM_HOME/conf
-
-T <Vorlage>, --user-template <Vorlage>
Benutzervorlage, die verwendet wird, um eine Verbindung zur AE einzurichten
-
-S <System>, --system <System>
AE Systemname. Dieser Befehl überschreibt den Standardwert der Konfigurationsdatei.
-
-H <Host>, --host <Host>
AE Hostname oder IP-Adresse. Dieser Befehl überschreibt den Standardwert der Konfigurationsdatei.
-
-c <Mandant>, --client <Mandant>
AE Mandantennummer. Dieser Befehl überschreibt den Standardwert der Konfigurationsdatei.
-
-p <Port>, --port <Port>
AE Port. Dieser Befehl überschreibt den Standardwert der Konfigurationsdatei.
-
-u <Benutzer/Abteilung>, --user <Benutzer/Abteilung>
AE Benutzer/Abteilung Dieser Befehl überschreibt den Standardwert der Konfigurationsdatei.
-
-pw [Passwort], --password [Passwort]
AE-Passwort. Das Passwort ist möglicherweise nicht zwingend in der Kommandozeile erforderlich, das Tool fragt später danach.
-
-l <Sprache>, --language <Sprache>
AE language. Dieser Befehl überschreibt den Standardwert der Konfigurationsdatei.
-
-f <Ordner>, --folder <Ordner>
AE -Ordner, der alle installierten Packages enthält. Standard:
\PACKAGES
Hilfe zu einem Befehl abrufen
Weitere Informationen zu Befehlen erhalten Sie durch den Aufruf von apm <Befehl> -h
oder apm <Befehl> --help
.
Weitere Befehle finden
Um eine Liste der verfügbaren Befehle zu erhalten, rufen Sie apm -h
oder apm --help
auf.
Analyse und Anzeige aktueller Umgebungsprobleme
apm doctor check
Beheben Sie aktuelle Umgebungsprobleme, die vom Doctor Check Command erkannt wurden
apm doctor fix
Hinweis: Erweiterte Packs: Führen Sie diesen Befehl aus, wenn Sie nach fehlenden Hooks und VARA-Objekten von Basis-Packs suchen und diese aktualisieren möchten.
Inhalt des Packs anzeigen
apm show [option] <pack_name>
Dabei kann [Option] eine der folgenden sein:
-
--from-file
Pack aus lokaler Datei oder Verzeichnis lesen
-
--installed
Nur installiertes Pack anzeigen.
Standard: false
-
--local
Nur Packs im lokalen Cache anzeigen.
Standard: false
Siehe auch: