Linux - Intrexx über die grafische Oberfläche installieren

Prüfen Sie vor der Installation von Intrexx, ob alle Voraussetzungen stimmen und die vorbereitenden Schritte ausgeführt sind.

Im Einzelnen finden Sie die entsprechende Hilfe hier:

Setup starten

Im Folgenden finden Sie eine Schritt-für-Schritt-Anleitung für die Installation von Intrexx.

Dabei wird davon ausgegangen, dass Sie die Option "Intrexx Portal Server Produktionsinstallation (Einzelserver)" wählen. Bei dieser Option installieren Sie Intrexx mit allen zur Verfügung stehenden Komponenten auf einem (virtuellen) Linux-Server.

Schritt-für-Schritt

Um die Installation von Intrexx durchzuführen, gehen Sie wie folgt vor:

  1. Wechseln Sie in das Verzeichnis der Installationsdateien.

  2. Starten Sie die Installation mit folgendem Befehl:

    sudo ./setup.sh

    Der Startdialog für die Installation wird angezeigt.

  3. Klicken Sie auf "Weiter".
    Die Bedingungen der Lizenzvereinbarung werden angezeigt.

  4. Lesen Sie die Lizenzvereinbarungen durch. Aktivieren Sie anschließend das Kontrollkästchen "Ich nehme alle Bedingungen der Lizenzvereinbarung an."

  5. Klicken Sie auf "Weiter".

    Sie gelangen in den Dialog, in dem Sie das Installationsverzeichnis angeben.

  6. Klicken Sie auf "Weiter".

    Sie gelangen in den Dialog, in dem Sie unterschiedliche Intrexx-Komponenten auswählen können.

    Intrexx Portal Server Produktionsinstallation (Einzelserver)

    Mit dieser Option wird eine für den Einzelserver-Produktiveinsatz optimierte Zusammenstellung von Komponenten installiert. Die Zusammenstellung enthält Portal Server, Portal Manager, Suchserver und verschiedene Datenbanktreiber.

    Intrexx Portal Server Produktionsinstallation (Verteilte Cloud/Cluster)

    Hier wird eine auf den Cloud- bzw. Clustereinsatz optimierte Zusammenstellung von Komponenten installiert. Die Zusammenstellung enthält Portal Server, Portal Manager, Cloudkomponenten, Suchserver und verschiedene Datenbanktreiber.

    Weitere Informationen zur Cloud-Installation finden Sie in Abschnitt Intrexx in der Cloud installieren

    Intrexx Portal Server Minimalinstallation

    Mit dieser Option wird eine für Ihre Plattform passende, reduzierte Zusammenstellung von Komponenten installiert. Die Zusammenstellung enthält Portal Server, Portal Manager, Suchserver und die wichtigsten Datenbanktreiber.

    Zusammenstellung vergleichen Welche Installations-Variante welche Komponenten enthält, können Sie sehen, wenn Sie auf "Zusammenstellung vergleichen" klicken.

    Der Portal Manager wird an dieser Stelle nicht zum Download angeboten, da er keine Installation erfordert.

    Den Portal Manager können Sie unter folgenden Links herunterladen:

    Windows

    		 Download

    Linux

    		 Download

    Mac

    		 Download

  7. Wählen Sie die Option "Intrexx Portal Server Produktionsinstallation (Einzelserver)" aus.

  8. Klicken Sie auf "Weiter".

    Sie gelangen in den Dialog mit der Zusammenfassung des Installationsablaufs.

    In diesem Dialog können Sie die zuvor gewählten Einstellungen noch einmal überprüfen und bei Bedarf ändern.

    Sie können auch Standardeinstellungen ändern, die Intrexx während der Installation vornimmt, ohne dass Sie explizit danach gefragt wurden. Dazu zählen u.a. die Installation als "intrexx-Benutzer", die Angabe des Instanznamens oder die Auswahl von Ports.

    Installationsverzeichnis

    Hier wird das zuvor angelegte Installationsverzeichnis angezeigt.

    Zu installierende Pakete

    Sie haben bereits im Dialogfenster "Wahl der Installation" ausgewählt, welche Intrexx-Komponenten Sie installieren möchten. An dieser Stelle können Sie noch einmal die zu installierenden Intrexx-Komponenten ansehen und bei Bedarf Änderungen vornehmen.Wenn Sie die Intrexx Administration API installieren möchten, dann müssen Sie das entsprechende Installationspaket hier auswählen.

    Erweiterte Einstellungen

    An dieser Stelle können Sie eine Reihe von Standard-Einstellungen ändern.

    intrexx-Benutzer-Installation - root-Installation

    Beachten Sie insbesondere, dass Sie hier zwischen der Installation als "root" und der Installation als einem anderen Linux-Benutzer auswählen können.

    Detaillierte Informationen zur Auswahl des passenden Daemon-Benutzerkontos finden Sie in folgendem Abschnitt Linux - Intrexx installieren.

    Steady Track - Silent Track

    Ebenso legen Sie hier fest, ob Sie dem Steady Track oder dem Silent Track folgen möchten.

    Erweiterte Einstellungen

    Diese Schritt bei der Installation ist für Sie relevant, falls Sie mehrere Instanzen von Intrexx auf dem Server installieren möchten.

    Erweiterte Einstellungen

    Standardinstanz

    Mit dieser Option wird die aktuelle Installation als Standardinstanz verwendet.

    Aktivieren Sie diese Option, wenn Sie nur eine Instanz von Intrexx installieren bzw. betreiben möchten (Standardinstanz).

    Instanz mit Namen

    Geben Sie der Intrexx-Instanz einen eigenen Namen, wenn Sie mehrere Intrexx-Instanzen installieren bzw. betreiben möchten. Über die unterschiedlichen Namen lassen sich die unterschiedlichen Intrexx-Instanzen unterscheiden. Gleichzeitig ermöglicht diese Option die Parallelinstallation von Intrexx.

    Java Runtime

    Mit Intrexx ausgeliefertes JDK

    Mit dieser Option wird das im Lieferumfang enthaltene JDK installiert.

    Auf diesem System bereits installiertes JDK

    Mit dieser Option kann ein bereits vorhandenes Java-Home-Verzeichnis eingetragen werden. Intrexx verwendet dann das dort enthaltene JDK. Das eingesetzte JDK muss mindestens JDK 21 kompatibel sein.

    Beachten Sie, dass das JDK mit Intrexx kompatibel sein muss. Wenn Sie sich unsicher in Bezug auf die Kompatibilität sind, dann kontaktieren Sie den Support von United Planet.

    Ausgewähltes JDK

    Zeigt die Version des aktuell ausgewählten JDKs an.

    Produkt-Aktualisierungen

    Release Track

    Hier können Sie den Release Track wählen, dem Sie folgen möchten.

    Ein Wechsel vom Silent Track zum Steady Track ist jederzeit möglich. Ein Wechsel vom Steady Track zum Silent Track ist ein Mal pro Jahr zu einem definierten Zeitpunkt möglich. In der Regel ist dies im März der Fall.

    Detaillierte Informationen zu Release Tracks finden Sie in folgendem Abschnitt Silent und Steady Track.

    Proxy Server für Update verwenden

    Wenn Sie in Ihrer Infrastruktur einen Proxy Server für die Verbindung zum Internet bzw. zum Intrexx Update Server eingerichtet haben, dann können Sie hier die entsprechenden Angaben vornehmen.

    Daemon-Benutzerkonto

    Für die Installation von Intrexx sind root-Rechte erforderlich.

    In diesem Dialog können Sie wählen, ob Sie die Installation direkt als "root" ausführen möchten oder mit einem Benutzer, der zur Sudoer-Gruppe gehört.

    Lokaler Administrator (root)

    Wählen Sie diese Option, wenn die Installation von Intrexx als "root" ausgeführt werden soll.

    Wenn Sie Intrexx in einer isolierten Umgebung installieren und betreiben können bzw. möchten, dann können Sie der "root-Installation" folgen. In isolierten Umgebungen stellt diese Verfahrensweise kein Sicherheitsrisiko dar.

    Als isolierte Umgebung kann eine VM dienen, auf der Sie ausschließlich Intrexx betreiben. Weiterhin können Sie Intrexx in einem Docker Container betreiben. Auch damit können Sie Sicherheitsrisiken im Zusammenhang mit root-Rechten ausschließen.

    Detaillierte Informationen zur Auswahl des passenden Daemon-Benutzerkontos finden Sie in Abschnitt Linux - Intrexx installieren.

    Anderes Benutzerkonto

    Wählen Sie diese Option, wenn Sie die Intrexx-Installation nicht mit "root" ausführen möchten.

    Standardmäßig schlägt die Installationsroutine vor, einen Benutzer "intrexx" automatisch anzulegen. Dieser Benutzer wird dann in die Sudoer-Gruppe aufgenommen und hat damit ausreichend Rechte, um Intrexx installieren zu können. Nach der Installation gehören diesem Benutzer alle Intrexx-Dateien. Zudem laufen unter diesem Benutzer der Supervisor-Dienst (Supervisor Daemon) und der Solr-Dienst.

    Sie können aus der Auswahlliste auch andere Benutzer auswählen.

    Intrexx-Benutzer vs. Linux-Benutzer

    Beachten Sie, dass es sich bei dem Benutzer, den Sie hier auswählen oder anlegen, nicht um einen Intrexx-Benutzer handelt. Vielmehr handelt es sich um den Linux-Benutzer, also einen Benutzer auf der Ebene des Betriebssystems. Die Intrexx-Oberfläche bietet Ihnen an dieser Stelle die Option, einen Benutzer für das Betriebssystem anzulegen.

    Detaillierte Informationen zur Auswahl des passenden Daemon-Benutzerkontos finden Sie in folgendem Abschnitt Linux - Intrexx installieren.

    Wenn nicht vorhanden, Konto anlegen.

    Sie können in der Auswahlliste "Anderes Benutzerkonto" einen Benutzernamen eingeben, der nicht in der Auswahlliste angezeigt wird.

    Wenn Sie dies tun, legt Intrexx einen neuen Linux-Benutzer an und fügt diesen der Sudoers-Gruppe hinzu.

    Im Anschluss werden Sie aufgefordert, ein Passwort für den neu angelegten Linux-Benutzer einzugeben. Nach diesem Passwort werden Sie später gefragt, wenn Sie in Intrexx etwas ausführen, für das auf Betriebssystemebene root-Rechte erforderlich sind.

    Neues Benutzerpasswort

    Administration API Konfiguration

    Die Registerkarte "Administration API Konfiguration" wird nur angezeigt, wenn Sie zuvor im Schritt " Zu installierende Pakete" das Paket "Intrexx Administration API" mitinstalliert haben.

    Detaillierte Informationen zur Intrexx Administration API finden Sie in Abschnitt Intrexx Administration API.

    Apache Solr Search Server

    Hier können Sie die Angaben zum Apache Solr-Suchserver ändern. Dies ist beispielsweise dann erforderlich, wenn Sie den Solr-Suchserver nicht auf dem selben Server installieren möchten, auf dem Sie Intrexx installiert haben.

    Authentifizierung am Solr Suchserver

    Der Intrexx Portal Server authentifiziert sich mit Benutzer und Passwort am Solr-Suchserver.

    Standardmäßig wird der Apache Solr-Suchserver zusammen mit Intrexx installiert. Er stellt die Suche-Funktonalität für Ihr Portal zur Verfügung.

    Im Standard wird der Apache Solr-Suchserver auf demselben Server wie Intrexx installiert. Daher ist als Host "127.0.0.1" (localhost) voreingestellt. Als Port wird 8983 vorgeschlagen.

    Sie haben aber auch die Möglichkeit, den Apache Solr-Suchserver auf einem anderen Server zu installieren. Dann müssen Sie die Angaben entsprechend anpassen.

    Der Intrexx Portal Server authentifiziert sich am Solr-Suchserver mit Benutzer und Passwort. Ändern Sie die Default-Authentifizierungsdaten.

    Weitere Informationen

    Individuelle Solr-Konfiguration

    Weitere Informationen

    https://solr.apache.org/resources.html

    https://solr.apache.org/guide/solr/latest/getting-started/tutorial-solrcloud.html

  9. Klicken Sie auf "Start".

  10. Der Installationsprozess beginnt.

  11. Nachdem die Installationsroutine durchlaufen wurde, wird die Schaltfläche "Fertigstellen" aktiv.

    Portal erzeugen

    Aktivieren Sie dieses Kontrollkästchen, um direkt nach der Installation ein Portal zu erzeugen.

    Wenn Sie das Kontrollkästchen aktiviert haben, wird nach dem Fertigstellen der Installation automatisch ein Dialog ("Portal Builder") gestartet, mit dem das Erzeugen eines Portals gestartet wird.

    Intrexx Portal Manager starten

    Aktivieren Sie dieses Kontrollkästchen, um direkt nach dem Fertigstellen der Installation den Intrexx Portal Manager zu starten.

    Sie können den Portal Manager nach der Installation auch über das Startmenü oder das automatisch erstellte Desktop Icon starten.

    Logfile ansehen

    Während der Installation wird von Intrexx ein Logfile erstellt, das die Installation protokolliert. Wenn Sie das Kontrollkästchen aktiviert haben, wird nach dem Fertigstellen der Installation automatisch das Logfile angezeigt.

  12. Klicken Sie auf "Fertigstellen".