Portal importieren

Beachten Sie, dass Sie ein Portal nur mit dem Integrierten Portal Manager importieren können.

Sie können ein Portal, das Sie aus Intrexx exportiert haben, in Intrexx importieren. Auf diese Weise können Sie beispielsweise ein Portal von einer Intrexx-Instanz auf eine andere Intrexx-Instanz transferieren.

Das Importieren eines Portals und das Anlegen eines neuen Portals unterscheiden sich nur geringfügig. Wenn Sie ein Portal neu anlegen, wählen Sie bei der Portalvorlage "Standard" oder "Online" aus. Wenn Sie ein Portal importieren, wählen Sie bei der Portalvorlage "Eigene" aus. Dort werden die von Ihnen zuvor exportierten Portale angezeigt bzw. Sie können in Verzeichnisse wechseln, in denen Sie zuvor exportierte Portale gespeichert haben.

Beachten Sie, dass Sie sich zunächst mit einem (bestehenden) Portal verbinden müssen, damit Sie ein Portal importieren können.

Weitere Informationen

Import eines Portals starten

Verbinden Sie sich mit einem (bestehenden) Portal.
Wählen Sie das Modul "Start" aus, falls dies nicht bereits der Fall ist.
Klicken Sie auf "Portal > Portal importieren".

Das Dialogfenster "Portal erzeugen - Allgemeine Einstellungen" wird angezeigt.

Allgemeine Einstellungen

Portalname

Tragen Sie hier einen eindeutigen Namen für das Portal ein.
Beim Anlegen des Portals verwendet Intrexx den hier erfassten Namen für das Portalverzeichnis auf dem Intrexx-Portalserver. Im Portalverzeichnis werden portalspezifische Dateien abgelegt.
Der Portalname entspricht nicht der URL, mit der Sie das Portal im Browser aufrufen. Die URL legen Sie im Frontend-Webserver fest. (Vergleichen Sie hierzu Website im IIS hinzufügen.)

Portalverzeichnis

Alle Dateien eines Portals finden Sie auf dem Intrexx Portal Server im Portalverzeichnis. Wenn Sie den Portalnamen eintragen, wird der Name für das Unterverzeichnis automatisch aus dem Portalnamen gebildet.

Portal Logverzeichnis

Hier wird das Verzeichnis angegeben, in dem alle Log-Dateien des Portals abgelegt werden. Auch hier wird, wenn Sie den Portalnamen eintragen, der Name für das Unterverzeichnis automatisch gebildet.

Portalvorlage

Nachdem Sie auf "Weiter" geklickt haben, gelangen Sie in den Dialog "Portalvorlage".

Wechseln Sie auf die Registerkarte "Eigene", falls diese noch nicht ausgewählt ist.

Die von Ihnen zuvor exportierten Portale werden angezeigt.

Standardmäßig sind diese unter <intrexx-installationsverzeichnis>\export abgelegt.

Über das -Icon können Sie in andere Verzeichnisse wechseln.

Klicken Sie auf das Portal, das Sie importieren möchten.

Datenbankserver

Nachdem Sie auf "Weiter" geklickt haben, gelangen Sie in den Dialog "Datenbankserver".

Wählen Sie hier den Datenbankserver für Ihr Portal aus.

Für den Datenbankserver Oracle müssen Sie die Datenbanktreiber direkt beim Hersteller beziehen. Kopieren Sie Ihren Treiber in das Installationsverzeichnis "/lib" und führen Sie anschließend einen Neustart des Portaldienstes aus.

Die folgenden Dialoge, in denen die Verbindung zum Datenbankserver eingerichtet wird, variieren je nach Datenbanktyp.
In den folgenden Schritten dieser Anleitung wird PostgreSQL als Beispiel für einen Datenbankserver gewählt.
Nachdem Sie auf "Weiter" geklickt haben, gelangen Sie in den Dialog "PostgreSQL - Verbindungsdaten".

PostgreSQL - Verbindungsdaten

Datenbankname

Hier kann der Name der Datenbank bearbeitet werden.

Portnummer

Geben sie hier den Kommunikationsport der Datenbank an.

SSL

Wählen Sie hier aus, ob die Verbindung mit dem Datenbankserver unverschlüsselt oder verschlüsselt erfolgen soll.
Sie können während der Portalanlage zunächst "kein SSL" auswählen und bei Bedarf später eine verschlüsselte Verbindung zum Datenbankserver einrichten.
Wenn Sie eine verschlüsselte Verbindung einrichten und den Wert "SSL mit Zertifikatsvalidierung" auswählen, müssen Sie vor dem Anlegen des Portals das Zertifikat an der entsprechenden Stelle beim Datenbankserver hinterlegen.
Nach dem Anlegen des Portals muss bei einer verschlüsselten Verbindung zum Datenbankserver das Zertifikat auch im Intrexx Portal Server hinterlegt werden.

Geben Sie hier den Namen des Datenbank-Benutzers ein.

Passwort

Geben Sie hier das Passwort des Datenbank-Benutzers ein.

Verbindungsdatenbank

Wenn Sie keine neue Datenbank anlegen möchten, dann können Sie hier eine bereits existierende Datenbank auswählen.

CockroachDB-Modus

Falls Sie CockroachDB einsetzen, können Sie hier den CockroachDB-Modus aktivieren.

PostgreSQL - Datenbankangaben

Neue Datenbank anlegen

Mit dieser Option wird eine neue Datenbank angelegt.

Bestehende leere Datenbank verwenden

Mit dieser Option wird eine bestehende Datenbank verwendet.

Datenbankname

Hier kann der Name der Datenbank bearbeitet werden.

Encoding

Wählen Sie hier das Ihrer Spracheinstellung entsprechende Encoding (Zeichensatz) der neuen Datenbank. Die Voreinstellung (UNICODE - UTF 8) kann in der Regel beibehalten werden.

Frontend Webserver (Reverse-Proxy / Load Balancer)

In diesem Dialog legen Sie fest, welchen Frontend Webserver (Reverse Proxy) Sie für die Kommunikation zwischen dem Intrexx Portal Server und dem Browser verwenden.

Detaillierte Informationen zum Einsatz von Frontend Webservern finden Sie in Abschnitt Frontend Webserver (Reverse Proxy) verwenden.

Internet Information Service (IIS)

Für Internet Information Service (IIS) bietet Intrexx eine Konfiguration über eine grafische Oberfläche an.

Verwenden Sie den IIS, wenn Sie in einer Windows-Umgebung arbeiten.

Detaillierte Informationen zum Internet Information Service (IIS) finden Sie in Abschnitt Windows - IIS (Internet Information Service) einrichten.

Beachten Sie, dass Sie beim Einsatz eines Frontend Webservers einen Eintrag in Ihrem DNS-Server (A- oder AAAA-Record) vornehmen müssen. Detaillierte Informationen hierzu finden Sie in Abschnitt Hostnamen im DNS hinterlegen.

NGINX

Für NGINX bietet Intrexx eine Konfiguration über eine grafische Oberfläche an.

Verwenden Sie den NGINX, wenn Sie in einer Linux-Umgebung arbeiten.

Detaillierte Informationen zu NGINX finden Sie in Abschnitt Linux -NGINX einrichten.

Kein Frontend Webserver

Wählen Sie diese Option, um ein Portal ohne Webend Frontserver (Reverse Proxy) zu konfigurieren.

Beachten Sie, dass diese Option nur für Test- und Entwicklungsportale vorgesehen ist.
Detaillierte Informationen zu dieser Option finden Sie in Abschnitt Kein Frontend Webserver.

Feldbeschreibungen

Embedded Tomcat Port

Hier wird der Port für den Embedded Tomcat angezeigt. (Bei einer Neuinstallation ist dies der Port 1337.)

Verschlüsselung (HTTPS)

Aktivieren Sie dieses Kontrollkästchen, wenn Sie eine verschlüsselte Verbindung zwischen Intrexx bzw. dem Embedded Tomcat und dem Browser herstellen möchten.

Selfsigned-Zertifikat für "localhost"

Wählen Sie diese Option, wenn die Kommunikation zwischen dem Embedded Tomcat und dem Browser mit einem selbstsigniertem Zertifikat verschlüsselt werden soll (bei Test- oder Entwicklungsportalen).

Intrexx erzeugt in diesem Fall automatisch ein selbstsigniertes Zertifikat und verwendet es für die verschlüsselte Verbindung.

Zertifikatsdatei

Über das -Icon können Sie die Zertifikatsdatei suchen.

Zertifikatstyp

Wählen Sie hier den Typ des Zertifikatsspeichers (Keystore) aus, in dem Sie die Zertifikatsdatei gespeichert haben.

Schlüsselspeicher-Passwort

Hinterlegen Sie hier das Passwort für den Schlüsselspeicher (Keystore), in dem Sie die Zertifikatsdatei hinterlegt haben.

Zertifikatsschlüssel-Passwort

Hinterlegen Sie hier den Schlüssel für die Zertifikatsdatei.

Hinweis Häufig sind Schlüsselspeicher-Passwort und Zertifikatsschlüssel-Passwort identisch.

Basis-URL des Portals

Hier wird die Basis-URL des Portals angezeigt. Der erste Teil besteht aus der Angabe des Protokolls. Beachten Sie, dass hier https angegeben ist. Der zweite Teil besteht aus der Angabe des Hostnamens. Beachten Sie, dass ein abschließender Slash (/) angegeben ist. Die korrekte Angabe ist zwingend erforderlich, damit Ihr Portal im Browser aufgerufen werden kann.

In diesem Dialog können Sie ein CSR (Certificate Signing Request) erzeugen. Detaillierte Informationen hierzu finden Sie in Abschnitt CSR (Certificate Signing Request) beim Verzicht auf einen Frontend Webserver erzeugen.

Manuelle Einrichtung

Sie haben die Möglichkeit, die Kommunikation zwischen dem Intrexx Portal Manager bzw. dem Embedded Tomcat und dem Browser manuell einzurichten. Sie verzichten damit auf die dialoggestütze Einrichtung, wie Sie bei den Typen "Internet Information Service (IIS)", "NGINX" und "Kein Frontend Webserver" zur Verfügung steht.

Weitere technische Spezifikationen zur manuellen Einrichtung finden Sie in den folgenden Dateien. Diese werden mit Intrexx ausgeliefert.

<portalverzeichnis>\tomcat\conf\server-https-default.xml
<portalverzeichnis>\tomcat\conf\server-http-default.xml
<portalverzeichnis>\external\htmlroot\WEB-INF\web.xml
<intrexx-installationsverzeichnis>\samples\web-tls-configuration\nginx\portal-internet.conf
<intrexx-installationsverzeichnis>\samples\web-tls-configuration\nginx\portal-remote.conf
<intrexx-installationsverzeichnis>\samples\web-tls-configuration\nginx\portal-intranet.conf

Setzen Sie sich bitte mit dem Intrexx Support Center in Verbindung, falls Sie weitere Informationen benötigen.

In den folgenden Schritten dieser Anleitung wird Internet Information Service (IIS) als Beispiel für einen Frontend Webserver gewählt.
Nachdem Sie auf "Weiter" geklickt haben, gelangen Sie in den Dialog "Frontend Webserver: Internet Information Service (IIS)".

Frontend Webserver: Internet Information Service (IIS)

IIS Website

Wählen Sie hier die Webseite aus, die Sie im IIS für das Portal angelegt haben.

Embedded Tomcat Port

Hier wird der Port angezeigt, den Sie in der Vorgängerversion von Intrexx verwendet hatten. Diesen Port können Sie belassen.

Hinweis Bei einer Neuinstallation ist hier ein freier Port, z.B. 1337, voreingestellt.

Basis-URL des Portals

Hier wird die Basis-URL des Portals angezeigt.
Die angezeigte Basis-URL ergibt sich standardmäßig aus den Angaben zum Binding der Website im Internet Information Service (IIS). Dabei handelt es sich um die Angaben zu "Typ" und "Hostname". (Vergleichen Sie hierzu Abschnitt Website im IIS hinzufügen.)

Die hier angezeigte Basis-URL wird nach der Anlage des Portals in das Feld "Basis-URL" in den Portaleigenschaften unter "Allgemein" übernommen.

Solr Suchserver

Jedes Portal verfügt über eine Suchfunktion. Diese wird technisch über den "Solr", den Such-Server von Apache, realisiert.

In diesem Dialog legen Sie fest, ob Sie die Solr-Standardeinstellungen übernehmen wollen oder eine individuelle Konfiguration vornehmen möchten.

Intrexx Version 12.0.0

Standardeinstellungen für durch Setup installierten Solr

Bei der Standardeinstellung wird der Solr-Suchserver im Standalone-Modus installiert. Der Solr-Suchserver wird auf dem selben Server installiert, auf dem auch der Intrexx Portal Server installiert ist. Für die Authentifizierung am Solr-Suchserver werden der Standard-Benutzer und das Standard-Passwort verwendet.

Wenn Sie nur eine Instanz des Solr-Suchservers einsetzen, also keine SolrCloud verwenden, können Sie üblicherweise die Standardeinstellung auswählen.

Individuelle Solr-Konfiguration

Wählen Sie diese Option, wenn Sie individuelle Einstellungen für den Solr-Suchserver vornehmen möchten. Dies gilt insbesondere, wenn Sie Änderungen bei der Authentifizierung am Solr-Suchserver durchführen möchten.

Detaillierte Informationen zur Individuelle Solr-Konfiguration finden Sie in Abschnitt Individuelle Solr-Konfiguration.

Intrexx Version 12.0.1

Ab Intrexx 12.0.1 haben Sie die Möglichkeit, OpenSearch bzw. Elasticsearch als "Preview-Feature" für die Portalsuche einzusetzen.

OpenSearch/ElasticSearch

Preview-Feature

Bitte beachten Sie, dass es sich bei diesem Feature um ein sogenanntes "Preview-Feature" handelt. Preview-Features können möglicherweise unvollständig sein oder Fehler aufweisen. Daher dürfen sie derzeit nur in Test- und Entwicklungsumgebungen eingesetzt werden, um sie entsprechend zu evaluieren.

Bevor Sie ein Preview-Feature nutzen, empfehlen wir dringend, eine Datensicherung durchzuführen. Die INTREXX GmbH übernimmt keinerlei Gewährleistung für die Funktionalität oder Zuverlässigkeit von Preview-Features. Die Verwendung von Preview-Features erfolgt daher auf eigenes Risiko des Nutzers.

Sie haben die Möglichkeit, OpenSearch bzw. Elasticsearch für die Portalsuche einzusetzen.

OpenSearch bzw. Elastiksearch sind nicht im Lieferumfang enthalten. Empfohlen wird eine eigene Installation mit dem Docker-Image von OpenSearch bzw. Elastiksearch.

Weitere Informationen hierzu finden Sie in folgenden Abschnitten:

Dateispeicherorte

Falls das Portal, das Sie gerade importieren, einen Dateispeicherort enthält, so werden hier der Aliasname und die Pfade im Importpaket bzw. im Zielsystem angezeigt.

In diesem Dialog können Sie weitere Einstellungen im Zusammenhang mit den Dateispeicherorten vornehmen () (Erweiterte Einstellungen).

Sie können ebenfalls die Dateispeicherorte bearbeiten () (Dateispeicherort bearbeiten).

Erweiterte Einstellungen

Schritt-für-Schritt

Um erweiterte Einstellungen für Dateispeicherorte vorzunehmen, gehen Sie wie folgt vor:

Klicken Sie auf das - Icon "Erweiterte Einstellungen bearbeiten").

Sie gelangen in den Dialog "Erweiterte Einstellungen"(1).

Hier werden die Applikationen, Datengruppen und Datenfelder angezeigt, mit denen der Dateispeicherort verknüpft ist. In der Spalte "Aliasname" wird der Name angezeigt, unter dem der Dateispeicherort nach erfolgreichen Import im Modul "Integration" eingetragen wird. Außerdem finden Sie hier auch Angaben zum Importmodus.

Ist die Einstellung "System-Dateispeicherorte ausblenden" gesetzt, so werden nur die benutzerdefinierten Dateispeicherorte angezeigt.
Klicken Sie auf das - Icon.

Sie gelangen in den Dialog "Erweiterte Einstellungen"(2).

Hier sehen Sie das aktuell ausgewählte Datenfeld mit Applikation und Datengruppe, aus der es stammt. Wählen Sie unter "Aliasname" den gewünschten Dateispeicherort aus.

Unter "Importmodus" können Sie einstellen, wie der Import der Dateien erfolgen soll:
- Dateien importieren und eindeutig benennen (Standard)
- Dateien importieren und bestehende Dateien überschreiben
- Dateien importieren und bestehende Dateien beibehalten
- Keine Dateien importieren
Klicken Sie auf "Fertig stellen", um Änderungen zu übernehmen und den Dialog wieder zu schließen.

Dateispeicherort bearbeiten

Schritt-für-Schritt

Um einen Dateispeicherort zu bearbeiten, gehen Sie wie folgt vor:

Klicken Sie auf das - Icon.
Das Dialogfenster "Dateispeicherort" wird angezeigt.

Hier können Sie den Pfad des Dateispeicherortes im Zielsystem bearbeitet. Standardmäßig ist als Pfad das Portalverzeichnis "internal/files/${appGuid}" eingestellt.

Klicken Sie auf das - Icon ( "Pfad als Pfad im Zielsystem übernehmen"), um den Pfad aus dem Importpaket als Pfad im Zielverzeichnis zu übernehmen.

Klicken Sie auf das - Icon ("Pfad auswählen"), um ein Verzeichnis auszuwählen.

Klicken Sie auf das - Icon ("Standard-Pfad wiederherstellen"), um das Verzeichnis, das Intrexx standardmäßig für die Ablage von Dateien verwendet, einzutragen.
Klicken Sie auf "Fertigstellen".

Zusammenfassung

In diesem Dialog können Sie die von Ihnen gemachten Angaben noch einmal ändern. Klicken Sie hierfür auf die blau eingefärbten Überschriften.

Allgemeine Angaben

Öffnet einen Dialog, in dem Portalname und -verzeichnis bearbeitet werden können.

Webserver

Öffnet einen Dialog, in dem die Webserver-Einstellungen bearbeitet werden können.

Erweiterte Einstellungen

Öffnet einen Dialog, in dem Ports, Suchmaschine und weitere Einstellungen geändert werden können.

Portalvorlage

Öffnet einen Dialog, in dem die Portalvorlage und die Standard-Portalsprache geändert werden kann.

Nachdem Sie auf Portalvorlage geklickt haben, wird das Dialogfenster "Portalvorlage" angezeigt.

Klicken Sie auf "Weiter".

Das Dialogfenster "Sprache" wird angezeigt.

Hier können Sie die Standardsprache des Portals ändern.

Datenbank

Öffnet einen Dialog, in dem die Datenbank gewechselt werden kann.

Erweiterte Einstellungen

Öffnet einen Dialog, in dem Ports, Suchmaschine und weitere Einstellungen geändert werden können.

Sie haben ein Portal erfolgreich importiert.