Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > Übersicht tags
Unbeaufsichtigte Installation unter Linux
Die unbeaufsichtigte Installation von agorum core unter Linux ermöglicht eine vollautomatische Installation ohne Benutzerinteraktion. Dies ist besonders nützlich für die Bereitstellung mehrerer Instanzen oder für automatisierte Deployment-Prozesse.
Empfehlung: Führen Sie zunächst den Installer einmal interaktiv aus. Dabei wird automatisch eine passende install_config.properties-Datei erstellt, die Sie als Vorlage für weitere unbeaufsichtigte Installationen verwenden können. Dies stellt sicher, dass alle Parameter korrekt gesetzt sind.
Ohne Module
Vorbereitung
- Erstellen oder passen Sie die Datei install_config.properties an (siehe Detaillierte Konfigurationsparameter weiter unten).
- Stellen Sie sicher, dass der Zielserver die Systemvoraussetzungen erfüllt.
- Bereiten Sie das Installationspaket setup-agorum-core-server-linux-pro-xxxx.bin vor.
Durchführung
- Übertragen Sie das Installationspaket setup-agorum-core-server-linux-pro-xxxx.bin und die install_config.properties auf den Zielserver in folgendes Verzeichnis:
/opt/agorum
- Führen Sie dort folgende Kommandos aus:
cd /opt/agorum export AUTOCONFIG=/opt/agorum/install_config.properties /bin/bash setup-agorum-core-server-linux-pro-xxxx.bin unattended /opt/agorum/agorumcore/scripts/agorumcore start /opt/agorum/agorumcore/scripts/agorumcore stop
Hinweis: Der initiale Start und Stopp des Systems ist notwendig, um die Ersteinrichtung abzuschließen.
Mit Module
Vorbereitung
- Installieren Sie manuell eine agorum core Instanz der gewünschten Zielversion.
- Aktivieren Sie die benötigten Zusatzmodule über das agorum core support tool.
- Exportieren Sie mit der Kontextmenü-Aktion MetaDB Export den folgenden MetaDB-Pfad als XML:
MAIN_MODULE_MANAGEMENT/roi/control/modules
Ergebnis: Eine XML-Datei mit einer Strukturdarstellung der MetaDB-Einträge wird erstellt und heruntergeladen. - Erstellen oder passen Sie die Datei install_config.properties an (siehe Detaillierte Konfigurationsparameter weiter unten).
Durchführung
- Übertragen Sie das Installationspaket setup-agorum-core-server-linux-pro-xxxx.bin, die install_config.properties und die XML-Datei mit den exportierten Modulinformationen (z. B. modules.xml) auf den Zielserver in folgendes Verzeichnis:
/opt/agorum
- Führen Sie dort folgende Kommandos aus:
cd /opt/agorum export AUTOCONFIG=/opt/agorum/install_config.properties /bin/bash setup-agorum-core-server-linux-pro-xxxx.bin unattended cp modules.xml /opt/agorum/agorumcore/jboss/server/default/deploy/roi.ear/autoupdate/parseXMLs /opt/agorum/agorumcore/scripts/agorumcore start /opt/agorum/agorumcore/scripts/agorumcore stop
Hinweis: Der initiale Start und Stopp des Systems ist notwendig, um die Ersteinrichtung abzuschließen.
Detaillierte Konfigurationsparameter
Die Datei install_config.properties steuert alle Aspekte der unbeaufsichtigten Installation. Im Folgenden werden alle verfügbaren Parameter nach Kategorien gruppiert beschrieben.
Grundlegende Einstellungen
| Parameter | Beschreibung | Beispielwert |
|---|---|---|
config.roiPassword |
Passwort für den Hauptadministrator roi Wichtig: Verwenden Sie ein sicheres Passwort! |
agorum |
config.installDir |
Installationsverzeichnis für agorum core | /opt/agorum/agorumcore |
config.language |
Standardsprache für das System und neue Benutzer Mögliche Werte: de oder en |
de |
config.charset |
Zeichenkodierung für die JVM. Sie sollten immer 'UTF-8' verwenden. | UTF-8 |
config.javaLang |
Spracheinstellung für die JVM Mögliche Werte: de_DE oder en_US |
de_DE |
config.makeDemo |
Demo-Struktur anlegen (y/n)
Hinweis: Dieser Parameter muss bei der Installation gesetzt werden. Die Demo-Struktur wird immer installiert. Sie können die Demo-Struktur bei Bedarf über das Plugin agorum core demo delete deinstallieren. |
n |
config.demoPassword |
Passwort für den Demo-Benutzer | agorum |
Datenbank-Konfiguration
agorum core unterstützt verschiedene Datenbanksysteme. Wählen Sie die entsprechende Konfiguration für Ihr Datenbanksystem.
MySQL/MariaDB (von agorum core installiert)
Diese Konfiguration wird verwendet, wenn agorum core die MariaDB-Datenbank (empfohlen) oder die MySQL-Datenbank selbst installieren und verwalten soll.
| Parameter | Beschreibung | Beispielwert |
|---|---|---|
config.whichDB |
Datenbanktyp | mysql |
config.db_mysql |
Kennzeichnung, dass die Datenbank von agorum core installiert wird | true |
config.dbPassword |
Passwort für den Datenbankzugriff | Password |
config.dbHost |
Datenbank-Hostname | localhost |
config.dbUser |
Datenbankbenutzer | root |
config.dbSchema |
Datenbankname/Schema | roi |
config.dbPort |
Datenbankport | 3306 |
config.dbDriver |
JDBC-Treibername | mysql |
config.dbConnString |
Individuelle Connection-String (normalerweise nicht benötigt) | null |
MySQL/MariaDB (extern/vom Kunden installiert)
Diese Konfiguration wird verwendet, wenn Sie MySQL oder MariaDB selbst installiert haben und agorum core diese externe Datenbank verwenden soll.
| Parameter | Beschreibung | Beispielwert |
|---|---|---|
config.whichDB |
Datenbanktyp | mysql |
config.db_custom_mysql |
Kennzeichnung für externe MySQL/MariaDB-Datenbank | true |
config.dbPassword |
Passwort für den Datenbankzugriff | Password |
config.dbHost |
IP-Adresse oder Hostname der Datenbank | 192.168.1.100 |
config.dbUser |
Datenbankbenutzer mit ausreichenden Rechten | agorumuser |
config.dbSchema |
Datenbankname/Schema | roi |
config.dbPort |
Datenbankport | 3306 |
config.dbDriver |
JDBC-Treibername | mysql |
config.dbConnString |
Individuelle Connection-String (normalerweise nicht benötigt) | null |
Microsoft SQL Server
Diese Konfiguration wird verwendet, wenn Sie MS SQL Server selbst installiert haben und agorum core diese externe Datenbank verwenden soll.
Achtung: Für die Verwendung von MS SQL Server benötigen Sie agorum core pro und zusätzlich eine Lizenz für den MSSQL-Treiber für agorum core.
| Parameter | Beschreibung | Beispielwert |
|---|---|---|
config.whichDB |
Datenbanktyp | mssql |
config.db_custom_mssql |
Kennzeichnung für SQL Server | true |
config.dbPassword |
Passwort für den Datenbankzugriff | Password |
config.dbHost |
IP-Adresse oder Hostname der Datenbank | 192.168.1.100 |
config.dbUser |
Datenbankbenutzer | sa |
config.dbSchema |
Datenbankname/Schema | roi |
config.dbPort |
Datenbankport | 1433 |
config.dbDriver |
JDBC-Treibername | sqlserver |
config.dbConnString |
Individuelle Connection-String (normalerweise nicht benötigt) | null |
Oracle Database
Diese Konfiguration wird verwendet, wenn Sie die Oracle Datenbank selbst installiert haben und agorum core diese externe Datenbank verwenden soll.
Achtung: Für die Verwendung der Oracle Datenbank benötigen Sie agorum core pro und zusätzlich eine Lizenz für den Oracle-Treiber für agorum core.
| Parameter | Beschreibung | Beispielwert |
|---|---|---|
config.whichDB |
Datenbanktyp | oracle |
config.db_custom_oracle |
Kennzeichnung für Oracle Database | true |
config.dbPassword |
Passwort für den Datenbankzugriff | Password |
config.dbHost |
IP-Adresse oder Hostname der Datenbank | 192.168.1.100 |
config.dbUser |
Datenbankbenutzer | agorum |
config.dbSchema |
Datenbankname/Schema (je nach DB-Einrichtung) Wichtig: Achten Sie auf UTF-8-Encoding der Datenbank! |
orclutf8 |
config.dbPort |
Datenbankport | 1521 |
config.dbDriver |
JDBC-Treibername | oracle |
config.dbConnString |
Individuelle Connection-String (normalerweise nicht benötigt) | null |
PostgreSQL
Diese Konfiguration wird verwendet, wenn agorum core die PostgreSQL-Datenbank selbst installieren und verwalten soll.
| Parameter | Beschreibung | Beispielwert |
|---|---|---|
config.whichDB |
Datenbanktyp | postgres |
config.dbDriver |
JDBC-Treibername | postgresql |
config.dbPort |
Datenbankport | 5432 |
| Alle weiteren Parameter analog zu MySQL/MariaDB | ||
Speicher-Einstellungen für MySQL/MariaDB
Diese Einstellungen gelten nur, wenn die Datenbank von agorum core selbst installiert wird (config.db_mysql=true).
| Parameter | Beschreibung | Beispielwert | Empfehlung |
|---|---|---|---|
config.innoDbBufferPoolSize |
InnoDB Buffer Pool Größe in MB Wichtigster Performance-Parameter für MySQL/MariaDB |
800 |
50-70% des verfügbaren RAM (nach Abzug von JVM-Speicher) |
config.innoDbLogFileSize |
Größe der InnoDB Log-Dateien in MB | 200 |
25% des Buffer Pool Size |
config.innoDbLogBufferSize |
Größe des InnoDB Log-Buffers in MB | 100 |
8-16 MB für normale Systeme |
JVM-Speicher-Einstellungen
| Parameter | Beschreibung | Beispielwert | Empfehlung |
|---|---|---|---|
config.xMS |
Initialer Heap-Speicher der JVM in MB | 8192 |
Sollten identisch sein Kleine Systeme (<20 User): 2048-4096 MB Mittlere Systeme (20-100 User): 4096-8192 MB Große Systeme (>100 User): 8192-16384 MB |
config.xMX |
Maximaler Heap-Speicher der JVM in MB | 8192 |
|
config.jMSHighMemoryMark |
Hohe Speichergrenze für JMS in MB | 8192 |
Sollten mit xMS/xMX übereinstimmen |
config.jMSMaxMemoryMark |
Maximale Speichergrenze für JMS in MB | 8192 |
Netzwerk und Port-Konfiguration
Öffentliche Ports
| Parameter | Beschreibung | Standardwert |
|---|---|---|
config.ipAddress |
IP-Adresse für WebUI und Services (außer CIFS/SMB)0.0.0.0 = alle NetzwerkinterfacesSpezifische IP = nur dieses Interface |
0.0.0.0 |
config.cifsIpAddress |
IP-Adresse für CIFS/SMB-Binding0.0.0.0 = alle Netzwerkinterfaces |
0.0.0.0 |
config.httpPort |
HTTP-Port für die WebUI und REST-Services | 80 |
config.httpsPort |
HTTPS-Port für die WebUI und REST-Services | 443 |
config.imapPort |
IMAP-Port für E-Mail-Zugriff | 143 |
config.imapsPort |
IMAPS-Port (verschlüsselt) für E-Mail-Zugriff | 993 |
config.ftpPort |
FTP-Port für Dateizugriff | 21 |
config.smtpServerPort |
SMTP-Server-Port für den Empfang von E-Mails direkt in agorum core | 25 |
Interne JBoss-Ports
Achtung: Diese Ports sollten nicht geändert werden!
| Parameter | Beschreibung | Standardwert |
|---|---|---|
config.agorumSessionUnlockPort |
Port für Session-Unlock-Mechanismus | 17676 |
config.jbossRMIPort |
JBoss RMI-Port | 31098 |
config.jbossJNPPort |
JBoss JNP-Port (JNDI Naming Service) | 31099 |
config.jbossRMIObjectPort |
JBoss RMI Object Port | 34444 |
config.jbossPooledInvokerPort |
JBoss Pooled Invoker Port | 34445 |
config.jbossWebServicePort |
JBoss Web Service Port | 38083 |
config.jbossUIL2Port |
JBoss UIL2 Port (JMS) | 38093 |
Netzwerk-Modus
| Parameter | Beschreibung | Standardwert |
|---|---|---|
config.oneNic |
Legacy-Modus: Nur ein Netzwerkinterface verwenden Empfehlung: Auf true belassen |
true |
Mail-Relay-Konfiguration
| Parameter | Beschreibung | Beispielwert |
|---|---|---|
config.smtpServer |
SMTP-Relay-Server für ausgehende E-Mails Kann später im Support-Tool angepasst werden |
localhost odermail.example.com |
config.smtpPort |
Port des SMTP-Relay-Servers | 25 oder 587 |
config.smtpUser |
Benutzername für SMTP-Authentifizierung (leer lassen, wenn keine Authentifizierung erforderlich) |
user@example.com |
config.smtpPassword |
Passwort für SMTP-Authentifizierung (leer lassen, wenn keine Authentifizierung erforderlich) |
password |
config.mailDomain |
Standard-E-Mail-Domain für Benutzer Wird verwendet für Benutzer ohne eigene E-Mail-Adresse und für roi Format: username@mailDomain |
agorumcore.com |
Dokumentenkonvertierung
| Parameter | Beschreibung | Beispielwert |
|---|---|---|
config.ooffice |
Befehl oder Pfad zu LibreOffice/OpenOffice für Dokumentenkonvertierung Standard ist soffice (wenn im PATH verfügbar) |
sofficeoder /usr/bin/soffice |
config.oooPort |
Port für die LibreOffice/OpenOffice-Kommunikation | 8100 |
Optionale und Legacy-Einstellungen
| Parameter | Beschreibung | Standardwert |
|---|---|---|
config.backupPath |
Legacy: Verzeichnis für MySQL-Backups Wird für das Script roi_mysql_backup verwendetDiese Art von Backup ist veraltet und wird nicht mehr empfohlen |
/opt/agorum/agorumcore/backup |
config.auditVersion |
Version des Audit-Systems1 = alte Audit-Version 2 = neue Audit-Version (empfohlen)Wird normalerweise weggelassen (Standard ist 2) |
2 |
Beispiel: Vollständige install_config.properties
Nachfolgend ein vollständiges Beispiel für eine install_config.properties-Datei mit MySQL/MariaDB (von agorum core installiert) für ein mittleres System:
# === Grundlegende Einstellungen === config.roiPassword=SicheresPa$$w0rt123 config.installDir=/opt/agorum/agorumcore config.language=de config.charset=UTF-8 config.javaLang=de_DE config.makeDemo=n config.demoPassword=agorum # === Datenbank-Konfiguration (MySQL/MariaDB - von agorum installiert) === config.whichDB=mysql config.db_mysql=true config.dbPassword=DbPa$$word456 config.dbHost=localhost config.dbUser=root config.dbSchema=roi config.dbPort=3306 config.dbDriver=mysql config.dbConnString=null # === MySQL/MariaDB Speicher-Einstellungen === config.innoDbBufferPoolSize=2048 config.innoDbLogFileSize=512 config.innoDbLogBufferSize=16 # === JVM-Speicher-Einstellungen === config.xMS=4096 config.xMX=4096 config.jMSHighMemoryMark=4096 config.jMSMaxMemoryMark=4096 # === Netzwerk und öffentliche Ports === config.ipAddress=0.0.0.0 config.cifsIpAddress=0.0.0.0 config.oneNic=true config.httpPort=80 config.httpsPort=443 config.imapPort=143 config.imapsPort=993 config.ftpPort=21 config.smtpServerPort=25 # === Interne JBoss-Ports (nicht ändern!) === config.agorumSessionUnlockPort=17676 config.jbossRMIPort=31098 config.jbossJNPPort=31099 config.jbossRMIObjectPort=34444 config.jbossPooledInvokerPort=34445 config.jbossWebServicePort=38083 config.jbossUIL2Port=38093 # === E-Mail-Konfiguration === config.smtpServer=mail.example.com config.smtpPort=587 config.smtpUser=agorum@example.com config.smtpPassword=SmtpPa$$word789 config.mailDomain=example.com # === Dokumentenkonvertierung === config.ooffice=soffice config.oooPort=8100 # === Optionale Einstellungen === config.backupPath=/opt/agorum/agorumcore/backup