ONE Installer - Single-Box-Installation

Der ONE Installerermöglicht eine schnelle Single-Box-Installation von Automic Automation, die Sie nur für Machbarkeitsnachweise, für Testzwecke und für Nicht-Produktionsumgebungen verwenden können.

Wichtig! Verwenden Sie den ONE Installer nicht in einer Produktionsumgebung.

Diese Seite beinhaltet Folgendes:

Übersicht

Der ONE Installer richtet ein Automation Engine-System ein, lädt Initialdaten in die AE-Datenbank, installiert die grundlegenden Aktionspackages und erstellt einen Client und einen Benutzer. Außerdem wird eine Logdatei im Stammordner erstellt (z. B. C:\Automic\install.log).

Die Installation enthält die folgenden Komponenten:

  • Automation Engine (5xWP/2xCP/1xJWP)

  • ServiceManager

  • ServiceManager - Dialogprogramm (nur Windows)

  • Automic Web Interface

  • Analytics

  • Dienstprogramme

  • Package Manager

  • Lokaler OS-Agent

  • RA Web Service REST Agent, RA Web Service SOAP Agent, RA FTP Agent, und RA JMS Agent

  • CAPKI, das die für Informationssicherheitsdienste erforderlichen Funktionen bereitstellt, wie z. B. die TLS/SSL-Implementierung des ServiceManagers. Weitere Informationen finden Sie unter CAPKI - Sicherung des ServiceManagers.

Zusätzliche Action Packs und Rapid Automation-Lösungen werden installiert, wenn sie im Package enthalten sind. Der Inhalt eines Packages wird von CA Automic bestimmt und kann je nach Version variieren.

Sie können Ports für Kommunikation (CP) und Arbeitsprozesse (WP) konfigurieren. Der ONE Installer öffnet und startet Ports für zwei Kommunikationsprozesse (CPs) und fünf Arbeitsprozesse (WPs). Alle weiteren Prozesse müssen manuell gestartet werden.

Der ONE Installer richtet ein Automation Engine-Grundsystem ein. Für hochredundante oder komplexere Installationen verwenden Sie bitte den manuellen Installationsprozess. Weitere Informationen finden Sie unter Voraussetzungen und Installationstypen.

Empfehlungen und Überlegungen

  • Es wird empfohlen, eine separate VM für die DB zu verwenden oder dem SQL Server eine bestimmte Menge an Speicher zuzuweisen. Weitere Informationen finden Sie in der Dokumentation zu MS SQL Server.

  • Auf dem Installationsgerät sind mindestens 8 GB erforderlich.

  • Empfehlungen zur Einrichtung des ONE Installer finden Sie im Abschnitt Automic Automation Systemanforderungen und Dimensionierung.

  • Windows:

    • Stellen Sie sicher, dass Sie vor der Installation keinen Windows-Dienst für den ServiceManager registriert haben.

    • Sie benötigen administrative Rechte zur Ausführung des Installers.

  • UNIX:

    • Sie müssen den Installer mit Root-Rechten ausführen.

    • Es wird nicht empfohlen, den Installer von Netzwerkfreigaben mit NFS aus auszuführen.

  • Die Installation richtet den ServiceManager so ein, dass er beim Systemstart automatisch als Windows Service- oder Linux-Daemon-Script gestartet wird. Alle anderen Serverprozesse werden dann vom ServiceManager automatisch gestartet. Es ist möglich, dass nicht alle Prozesse beim Booten gestartet werden können.

    Beispiel:

    AWI kann nicht starten, weil ein anderer Prozess den erforderlichen Port 8080 bereits reserviert hat, was dazu führt, dass das AWI nicht verfügbar ist. Um zu überprüfen, ob alle Prozesse gestartet werden können, führen Sie einen der folgenden Schritte aus:

    • Starten Sie den Dialog ServiceManager und überprüfen Sie, ob Prozesse rot dargestellt sind.

    • Öffnen Sie die ServiceManager-Logdatei und suchen Sie nach Fehlern.

      Die Protokolldatei des Service Managers befindet sich im ServiceManager-Verzeichnis ./temp.

Systemanforderungen

Unterstützte Betriebssysteme und Datenbanken

Verwenden Sie die Kompatibilitätsmatrix, um relevante Informationen zu unterstützten Versionen zu finden, siehe compatibility matrix

Wichtig! Das Automation Engine-Dienstprogramm ist mit dem 12G OCI-Mandanten verknüpft. Wenn Sie eine andere Oracle-Mandanten-Version verwenden, müssen Sie einen SYM LINK für 12G wie ln -s libclntsh.so.xx.x libclntsh.so.12.1 erstellen, wobei xx.x Ihre Oracle-Mandanten-Version ist.

Empfehlungen zur Einrichtung von ONE Installer finden Sie unter Automic Automation Systemanforderungen und Dimensionierung.

Voraussetzungen

Folgende Voraussetzungen müssen erfüllt sein, bevor Sie den ONE Installer starten:

  • Sie können die Datenbank automatisch (PostgreSQL) oder manuell installieren. Voraussetzungen für eine manuelle Datenbankinstallation sind:

    • Installieren Sie den richtigen Datenbanktreiber für die Datenbank, die Sie auf demselben Host verwenden, auf dem auch der Installer für Oracle (Oracle Database Mandant), MS SQL (SQL Server Native Client 11) oder PostgreSQL (PostgreSQL 10.x) ausgeführt wird.

    • Laden Sie den JDBC-Treiber für die von Ihnen verwendete Datenbank (Oracle, MS SQL Server, PostgreSQL) herunter.

    • AE-Datenbanken und -Benutzer erstellen: Beachten Sie unbedingt, dass Sie eine neue, leere AE-Datenbank und einen neuen dedizierten Benutzer mit dbowner-Rechten benötigen. Weitere Informationen finden Sie unter Die AE-Datenbank einrichten.

    • In der Profilkonfiguration einer Oracle DB (SQLNET.ORA) geben Sie ezconnect in die Liste der Werte im Parameter NAMES.DIRECTORY_PATH ein.

  • Der AE verbindet sich über TCP/IP mit der Datenbank. Stellen Sie sicher, dass Ihr Server und Ihr Client eine TCP/IP-Verbindung aktiviert haben. Verwenden Sie für einen MS SQL Server den MS SQL Configuration Manager, um ihn zu konfigurieren.

  • Benutzername und Passwort eines lokalen Benutzerkontos.

  • Sie müssen eine kompatible JRE installiert haben. Wenn Sie möchten, können Sie auch ein kompatibles JDK verwenden. In diesem Fall wird empfohlen, Eclipse Adoptium zu verwenden.

    Sehen Sie in compatibility matrix nach, um festzustellen, welche Java-Versionen unterstützt werden. Weitere Informationen finden Sie unter Kompatibilitätsinformationen

    Hinweis: Die Event Engine und die Streaming-Plattform werden nur mit JRE oder JDK 8 installiert. Wenn Sie eine JRE- oder JDK-Version höher als 8 verwenden, werden Regel- und Webhook-Objekte deaktiviert, und Sie können sie nicht mit der Automation Engine verwenden .

Installation im beaufsichtigten Modus

In diesem Modus wird der ONE Installer Setup Wizard verwendet. Befolgen Sie die Anweisungen des Assistenten unter Berücksichtigung der hier aufgeführten Probleme:

  1. Laden Sie die gelieferten Dateien herunter und entpacken Sie sie in ein lokales Verzeichnis Ihrer Wahl und starten Sie die Installation mit Hilfe von install.exe für Windows oder install.sh für UNIX.

    Der Installer prüft, ob die Voraussetzungen erfüllt sind und versucht, Abweichungen zu beheben, falls er sie feststellt.

  2. Wählen Sie Ihr Java-Stammverzeichnis aus.

    Wenn die JRE- oder JDK-Version niedriger als die unterstützte Java-Version ist, gibt das System eine Fehlermeldung zurück. Dasselbe gilt, wenn das von Ihnen ausgewählte Verzeichnis keine JRE- oder JDK-Installation enthält.

  3. Wählen Sie aus, ob Sie die Datenbank automatisch (PostgreSQL) oder manuell installieren möchten.

    Der Installer prüft, ob die erforderlichen Datenbanktreiber vorhanden sind.

  4. Wenn eine manuelle Installation ausgewählt wurde, verweisen Sie den Installer auf den JDBC-Treiber Ihrer Datenbank.

    Wenn Sie die neueste Version herunterladen möchten, verwenden Sie den angegebenen Download-Link.

  5. Der ONE Installer prüft auf ungenutzte Ports im System in den Systemanforderungen aufgeführten Portbereichen und konfiguriert diese.

  6. Geben Sie die Verbindungswerte für die Datenbank entweder im einfachen oder im erweiterten Modus ein.

    Unabhängig vom verwendeten Modus ist es möglich, die Verbindung mit der Schaltfläche Verbindung testen zu testen. Andernfalls testet der ONE Installer die Verbindung automatisch, wenn Sie auf Weiter klicken.

    • Wenn Sie den einfachen Modus verwenden, wird der Verbindungs-String automatisch aus den Informationen zur Datenbankverbindung (z. B. Host, Port) generiert.

    • Im erweiterten Modus können Sie den Verbindungs-String manuell festlegen. Optional können Sie auch einen separaten JDBC-Verbindungs-String für das JWP festlegen.

  7. Wählen Sie den Installationspfad (Standard ist C:\Automic).

    Wichtig! Verwenden Sie bei der Definition von Pfaden keine Leerzeichen.

  8. Bestätigen Sie die Lizenzinformationen der zu installierenden externen Software (z. B. Java).

  9. Geben Sie die Client-Daten für den ersten Client ein, den der ONE Installer erstellt. Wählen Sie eine Client-Nummer zwischen 0001 und 9999 (0000 ist für den System-Client reserviert), einen Benutzernamen, die Abteilung und ein Passwort.

  10. Geben Sie die Anmeldeinformationen ein, mit denen der Agent Jobs auf der Maschine ausführen soll, auf der der ONE Installer läuft und die Automation Engine installiert werden soll.

    Wichtig! Stellen Sie sicher, dass Sie die korrekten Benutzerdaten eingeben, da diese Informationen in diesem Schritt nicht überprüft werden.

  11. Wenn Sie einen bereits vorhandenen benutzerdefinierten Keystore verwenden möchten, aktivieren Sie das entsprechende Kontrollkästchen. Andernfalls wird ein Keystore unter Verwendung eines selbstsigniertes Zertifikats erstellt. Sie können auch einen Schlüsselalias und ein Passwort sowie ein Keystore-Passwort definieren. Wenn Sie einen bereits vorhandenen Keystore verwenden oder die Keystore-Parameter nicht definieren, werden die Standardwerte verwendet. Weitere Informationen finden Sie hier: .

Nach erfolgreicher Installation wird die AWI-Anmeldeseite in Ihrem Standard-Internetbrowser geöffnet. Melden Sie sich mit den Benutzerdaten an, die Sie bei der Installation angegeben haben.

Installation im unbeaufsichtigten Modus

Um das ONE Installer im unbeaufsichtigten Modus zu verwenden, starten Sie die Installation und verwenden Sie eine Konfigurationsdatei mit der Erweiterung .varfile. Rufen Sie es mit dem folgenden Argument in dem Verzeichnis auf, in das Sie die Dateien extrahiert haben:

Windows: install.exe –q –varfile <path-to-varfile> -dir <path-to-installation-directory>

UNIX: install.sh –q –varfile <path-to-varfile> -dir <path-to-installation-directory>

Hinweise:

  • Sie können einen beliebigen Namen für die Datei .varfile wählen.

  • Die Definition eines Installationsverzeichnispfades ist optional.

  • Die Portkonfiguration im unbeaufsichtigten Modus funktioniert nur mit unbenutzten Ports im System. Wenn die Ports nicht im oben genannten Bereich konfiguriert werden können, bricht der ONE Installer die Installation ab und schreibt eine Fehlermeldung in die Installations-Logdatei.

  • Um sicherzustellen, dass Ihre Ports in der Datei .varfile korrekt angegeben wurden, überprüfen Sie die Installations-Logdatei auf die aktuell verwendeten Ports.

  • Wenn Ihr Java-Stammverzeichnis eine JRE- oder JDK-Version enthält, die niedriger als die unterstützte Java-Version ist, zeichnet das System eine Fehlermeldung auf. Dasselbe gilt, wenn das von Ihnen ausgewählte Verzeichnis keine JRE- oder JDK-Installation enthält.

Beispiel

CLIENT=100
DB_INPUT_MODE=SIMPLE
DB_CODESET$Integer=0
DB_DATABASE=AE_DB
DB_HOST=mydbhostname
DB_PASSWORD=mydbpassowrd
DB_PORT=1521
DB_SERVER=1
DB_USER=mydbusername
DEPARTMENT=DEV
JAVA_HOME=C\:\\java\\java-11-openjdk
JDBC_DRIVER_JAR=C\:\\app\\oracle12c\\product\\12.1.0\\dbhome_1\\jdbc\\lib\\ojdbc7.jar
LOGIN_PASSWORD=Nexus01@adm
LOGIN_USER=Administrator
PASSWORD=123
USERNAME=AUT
PORTS_CP=2217,2218,2219,2220,2221
PORTS_WP=2270,2271,2272,2273,2274,2275,2276,2277,2278,2279
PORT_OS_AGENT=2300
PORT_SERVICE_MANAGER=8871
PORT_TOMCAT_HTTP=8080
PORT_IIS=80
PORT_ANALYTICS_BACKEND_PORT=8090
PORT_ANALYTICS_DATASTORE_PORT=5434

PORT_RULE_ENGINE=6123

PORT_RULE_ENGINE_WEB=8081

PORT_STREAMING_PLATFORM=9092

PORT_STREAMING_PLATFORM_COORDINATOR=2181

TLS_USING_CUSTOM_KEYSTORE$Boolean=true

TLS_KEYSTORE=keypair.p12

TLS_KEYSTORE_PASSWORD=password1

TLS_KEY_PASSWORD=password2

TLS_KEY_ALIAS=1

Parameter

  • DB_INPUT_MODE

    Beschreibung: Legen Sie fest, ob einfache oder erweiterte Datenbankverbindungswerte für Automic Automation verwendet werden sollen.

    Zulässige Werte: SIMPLE oder ADVANCED

  • DB_SERVER_INSTALLATION

    Zulässige Werte:

    • AUTO: Der Datenbankserver wird automatisch installiert (PostgreSQL)

    • MANUAL: Der Datenbankserver muss manuell installiert werden

  • DB_SERVER

    Beschreibung: Typ des zu verwendenden Datenbankservers.

    Hinweis: Wird nur verwendet, wenn DB_SERVER_INSTALLATION auf MANUAL gesetzt ist.

    Zulässige Werte:

    • MSSQL: MS SQL Server

    • ORACLE: Oracle

    • POSTGRES: PostgreSQL

  • DB_HOST

    Beschreibung: Name oder Adresse des Datenbankservers, den die neue AE-Installation verwenden soll

  • DB_PORT

    Beschreibung: IP-Port, der für die Verbindung mit der AE-Datenbank verwendet wird

  • DB_DATABASE

    Beschreibung: Name der Datenbank (MS SQL) oder SID/Service-Name (Oracle), den die AE-Installation verwenden soll

  • DB_CODESET$Integer

    Beschreibung: Diese Einstellung wird nur für Installationen verwendet, die eine Oracle-Datenbank verwenden (DB_Server = 1).

    Zulässige Werte:

    • 0: UTF-8

    • 1: ISO-8859-15

  • DB_USER

    Beschreibung: Name des Datenbankbenutzers in der AE-Datenbank.

  • DB_PASSWORD

    Beschreibung: Passwort des Datenbankbenutzers in der AE-Datenbank

  • DB_ODBC

    Beschreibung: Verbindungs-String für ODBC-Verbindung von CP, WP und Dienstprogrammen

    Hinweis: Wird verwendet, wenn DB_INPUT_MODE auf ADVANCED gesetzt ist.

    Beispiel

    ODBCVAR=NNJNIORO,DSN=MY_TNS_NAME;UID=MY_USER;PWD=MY_PW;SP=NLS_LANGUAGE=AMERICAN,NLS_TERRITORY=AMERICA,CODESET=WE8MSWIN1252,NLS_LENGTH_SEMANTICS=CHAR

  • DB_JDBC

    Beschreibung: Verbindungs-String für die JDBC-Verbindung von JWP

    Hinweis: Wird verwendet, wenn DB_INPUT_MODE auf ADVANCED gesetzt ist.

    Beispiel

    jdbc:sqlserver://MY_HOST:MY_PORT;databaseName=MY_DATABASE;user=MY_USER;password=MY_PW

  • JAVA_HOME

    Beschreibung: Verweist auf den Speicherort Ihres Java-Installationsverzeichnisses.

    Beispiel

    Unix:

    JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64

    Windows:

    JAVA_HOME=C\:\\java\\java-11-openjdk

  • JDBC_DRIVER_JAR

    Beschreibung: Speicherort einer JDBC-Treiberdatei, die für die Verbindung zur AE-Datenbank verwendet werden soll.
    Diese Datei muss mit der Auswahl in DB_SERVER und der installierten Datenbank- und Java-Versionen übereinstimmen.

  • CLIENT

    Beschreibung: Client-Nummer des AE-Clients, die vom Installer erstellt wird

  • USERNAME

    Beschreibung: Benutzername des AE-Benutzers, der vom Installer erstellt wird

    Hinweis: Verwenden Sie für AE zulässige Zeichen.

  • DEPARTMENT

    Beschreibung: Abteilung des AE-Benutzers, die vom Installer erstellt wird

    Hinweis: Verwenden Sie für AE zulässige Zeichen.

  • PASSWORD

    Beschreibung: Passwort des AE-Benutzers, das vom Installer erstellt wird

  • LOGIN_USER

    Beschreibung: Benutzername für ein Login-Objekt, das vom OS-Agenten verwendet wird.

    Dies sollte mit einem Benutzerkonto auf Ihrem lokalen System übereinstimmen.

  • LOGIN_PASSWORD

    Beschreibung: Das Kennwort für das in LOGIN_USER angegebene Benutzerkonto

  • PORTS_CP

    Beschreibung: Gruppe von Ports, die von den CP-Prozessen verwendet werden.

    Es müssen genau 5 Ports bereitgestellt werden.

    Standardwerte: 2217,2218,2219,2220,2221

  • PORTS_WP

    Beschreibung: Gruppe von Ports, die von den WP-Prozessen verwendet werden.

    Es müssen genau 10 Ports bereitgestellt werden.

    Standardwerte: 2270,2271,2272,2273,2274,2275,2276,2277,2278,2279

  • PORT_OS_AGENT

    Beschreibung: Port für den Windows-/Linux-Agenten.

    Die Agenten nutzen diesen Port für FileTransfers und die Kommunikation mit UCUMELD.

    Standardwert: 2300

  • PORT_SERVICE_MANAGER

    Beschreibung: Port für den ServiceManager

    Dieser Port wird vom ServiceManager-Dialog zur Kommunikation mit dem ServiceManager verwendet.

    Standardwert: 8871

  • PORT_TOMCAT_HTTP

    Beschreibung: Tomcat-Port für die AWI-Installation

    Standardwert: 8080

  • POR_IIS

    Beschreibung: Die Microsoft Internet Information Services werden um eine neue Standortdefinition erweitert, die diesen Port verwendet

    Diese Seite wird dann von dem AWI genutzt, um mit CDA zu kommunizieren.

    Standardwert: 80

  • PORT_ANALYTICS_BACKEND_PORT

    Beschreibung: Analytics Backend

    Standardwert: 8090

  • PORT_ANALYTICS_DATASTORE_PORT

    Beschreibung: Port, der von der PostgreSQL-Installation verwendet wird, die mit Analytics installiert ist.

    Standardwert: 5434

  • PORT_RULE_ENGINE

    Beschreibung: Port, der von der Rule Engine-Installation verwendet wird, die mit ONE Installer installiert ist.

    Standardwert: 6123

  • PORT_RULE_ENGINE_WEB

    Beschreibung: Port, der von der Web-Schnittstelle der Installation der Rule Engine verwendet wird, die mit ONE Installer installiert ist.

    Standardwert: 8081

  • PORT_STREAMING_PLATFORM

    Beschreibung: Port, der von der Streaming-Plattform verwendet wird, die mit Telemetrie und der Rule Engine installiert ist.

    Standardwert: 9092

  • PORT_STREAMING_PLATFORM_COORDINATOR

    Beschreibung: Port, der vom Streaming-Plattform-Koordinationsservice verwendet wird

    Standardwert: 2181

  • TLS_KEY_ALIAS

    Beschreibung: Für den Schlüssel verwendeter Alias

    Standardwert: jetty

  • TLS_KEY_PASSWORD

    Beschreibung: Passwort für den Schlüssel

    Standardwert: changeit

  • TLS_KEYSTORE

    Beschreibung: Pfad zum Keystore

  • TLS_KEYSTORE_PASSWORD

    Beschreibung: Passwort für den Keystore

    Standardwert: changeit

  • TLS_USING_CUSTOM_KEYSTORE

    Beschreibung: Gibt an, ob ein benutzerdefinierter Keystore verwendet wird oder ob ein selbstsigniertes Zertifikat verwendet wird.

    Format: TLS_USING_CUSTOM_KEYSTORE$Boolean=

    Standardwert: false

Installation im Kommandozeilenmodus

Die Installationsschritte sind die gleichen wie im beaufsichtigten Modus. Sie müssen die erforderlichen Informationen eingeben oder Aktionen mit den angezeigten Befehlen oder Optionen bestätigen.

  1. Öffnen Sie ein Kommandozeilenfenster in dem Verzeichnis, in das Sie die Dateien entpackt haben, und verwenden Sie dann den Befehl start /wait install.exe -c für Windows oder install.sh -c für UNIX.

    Der Installer prüft, ob die Voraussetzungen erfüllt sind und versucht, Abweichungen zu beheben, falls er sie feststellt.

  2. Definieren Sie das Java-Stammverzeichnis.

    Wenn die JRE- oder JDK-Version niedriger als die unterstützte Java-Version ist, gibt das System eine Fehlermeldung zurück. Dasselbe gilt, wenn das von Ihnen ausgewählte Verzeichnis keine JRE- oder JDK-Installation enthält.

  3. Definieren Sie die Datenbank, die Sie installiert haben.

  4. Geben Sie den Pfad zum JDBC-Treiber Ihrer Datenbank ein.

  5. Geben Sie die Verbindungswerte für die Datenbank ein.

  6. Wählen Sie den Installationspfad (Standard ist C:\Automic).

    Wichtig! Verwenden Sie bei der Definition von Pfaden keine Leerzeichen.

  7. Bestätigen Sie die Lizenzinformationen für die zu installierende externe Software (Java).

  8. Geben Sie die Client-Daten für den ersten Client ein, den der ONE Installer erstellt. Wählen Sie eine Client-Nummer zwischen 0001 und 9999 (0000 ist für den System-Client reserviert), einen Benutzernamen, die Abteilung und ein Passwort.

  9. Geben Sie die Anmeldeinformationen des Agenten ein, um Jobs auf der Maschine auszuführen, auf der der ONE Installer läuft und die Automation Engine installiert werden soll.

    Hinweis: Stellen Sie sicher, dass Sie die korrekten Benutzerdaten eingeben, da diese Informationen in diesem Schritt nicht überprüft werden.

  10. Wenn Sie einen bereits vorhandenen benutzerdefinierten Keystore verwenden möchten, aktivieren Sie das entsprechende Kontrollkästchen. Andernfalls wird ein Keystore unter Verwendung eines selbstsigniertes Zertifikats erstellt. Sie können auch einen Schlüsselalias und ein Passwort sowie ein Keystore-Passwort definieren. Wenn Sie einen bereits vorhandenen Keystore verwenden oder die Keystore-Parameter nicht definieren, werden die Standardwerte verwendet. Weitere Informationen finden Sie hier: .

Nach erfolgreicher Installation wird die AWI-Anmeldeseite in Ihrem Standard-Internetbrowser geöffnet. Melden Sie sich mit den Benutzerdaten an, die Sie bei der Installation angegeben haben.

Siehe auch: