Installation und Konfiguration von AEM Forms auf OSGi

(Nur für AEM 6.1 Forms Feature Pack 1 auf IBM WebSphere mit Oracle RDBMK) Wenn Sie AEM 6.1 Forms Feature Pack 1 installieren und IBM WebSphere mit Oracle RDBMK verwenden, müssen Sie vor dem Start von AEM 6.1 NPR-7700 verwenden, um einige JAR-Dateien zu den AEM 6.1 Setup(JAR/WAR)-Dateien hinzuzufügen. Führen Sie die folgenden Schritte aus, um die JAR-Dateien zur SAEM 6.1 Setup(JAR/WAR)-Datei hinzuzufügen:

1. Öffnen Sie AEM Package Share und suchen Sie nach cq-6.1.0-hotfix-7700. Klicken Sie in den Suchergebnissen auf cq-6.1.0-hotfix-7700. Sie können auch den direkten Link NPR-7700 verwenden, um die Seite zum Herunterladen des Hotfix zu öffnen.
2. Öffnen Sie die Registerkarte Assets und klicken Sie auf Auf Festplatte herunterladen: cq-6.1.0-hotfix-7700-2.2. Akzeptieren Sie die Lizenzvereinbarung und speichern Sie das Archiv auf dem lokalen Computer.
3. Extrahieren Sie das heruntergeladene Archiv- und AEM 6.1 Setup(JAR/WAR)-Datei in separaten Ordnern. Extrahieren Sie beispielsweise den Hotfix in den Ordner npr7700 und AEM 6.1-Dateien in aem6.1setup.
   
4. (Wenn Sie eine .war-Datei verwenden, um AEM 6.1 bereitzustellen) Ersetzen Sie die folgende .jar-Dateien und fügen Sie diese zu extrahierten AEM 6.1-Dateien hinzu:
   • Ersetzen Sie die Datei [exracted-aem6.1-files]\cq-quickstart-6.1.0.war\WEB-INF\resources\install\0\jackrabbit-webdav-2.10.0.jar durch die Datei [exracted-hotfix-files]\jcr_root\libs\system\install\jackrabbit-webdav-2.10.1.jar .
     
   • Fügen Sie die Datei im Ordner [exracted-aem6.1-files]\cq-quickstart-6.1.0.war\WEB-INF\resources\install.crx3\15 hinzu oder ersetzen Sie diese durch die Datei im Ordner [exracted-hotfix-files]\jcr_root\libs\system\install.crx.
5. (Wenn Sie eine .jar-Datei verwenden, um AEM 6.1 bereitzustellen) Ersetzen Sie die folgende .jar-Dateien und fügen Sie diese zu extrahierten AEM 6.1-Dateien hinzu:
   • Ersetzen Sie die Datei [exracted-aem6.1-files]\cq-quickstart-6.1.0.jar\static\app\cq-quickstart-6.1.0-standalone-quickstart.jar\resources\install\0\jackrabbit-webdav-2.10.0.jar durch die Datei [exracted-hotfix-files]\jcr_root\libs\system\install\jackrabbit-webdav-2.10.1.jar .
     
   • Fügen Sie die Datei im Ordner [exracted-aem6.1-files]\cq-quickstart-6.1.0.jar\static\app\cq-quickstart-6.1.0-standalone-quickstart.jar\resources\install.crx3\15 hinzu oder ersetzen Sie diese durch die Datei im Ordner [exracted-hotfix-files]\jcr_root\libs\system\install.crx.
6. Speichern Sie die AEM 6.1 Setup(JAR/WAR)-Datei oder verpacken Sie diese erneut und starten Sie die AEM 6.1-Instanz.
7. Wiederholen Sie die obigen Schritte für die entsprechenden AEM 6.1-Veröffentlichungsinstanzen.

Melden Sie sich bei AEM als Administrator an und öffnen Sie Package Share. Melden Sie sich bei Package Share mit einer Adobe ID an. Eine Liste der Ordner und Pakete wird angezeigt.

Suchen Sie in Package Share nach Add-On-Pakete für AEM Forms und klicken Sie auf das Paket, das auf Ihr Betriebssystem zutrifft und dann auf Herunterladen. Lesen und akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf OK. Nachdem der Download abgeschlossen ist, wird das Wort Downloaded neben dem Paket angezeigt.

Sie können auch die Links für den direkten Download im Abschnitt AEM Forms Add-On-Paket verwenden, um ein Paket manuell herunterzuladen.

Öffnen Sie den Paketmanager und klicken Sie auf Installieren. Die Standard-URL lautet http://[Server]:[Port]/crx/packmgr/index.jsp..

(Optional) Außer AEM 6.1 Forms Feature Pack-Pakete, enthält Package Share Pakete für die Dienste Central Migration Bridge und Senden an Drucker und Add-On-Pakete für Geometrixx Finance und Geometrixx.gov-Referenzseiten. Sie können diese Pakete wie gewünscht installieren.

Sie können AEM Package Share verwenden, um diese Pakete herunterzuladen und zu installieren. Im Abschnitt AEM Forms Add-On-Paket werden auch Links für direkte Downloads aufgelistet, um die Pakete manuell herunterzuladen.

(Optional) Wenn Sie von einer früheren Version auf AEM Forms aktualisiert und auch Correspondence Management installiert haben, verwenden Sie das Migrationsdienstprogramm, um die vorhandenen Correspondence Management-Elemente auf AEM 6.1 forms zu migrieren.

Sobald das Paket installiert ist, starten Sie nicht sofort den Server neu. Bevor Sie den AEM-Server neu starten, stellen Sie sicher, dass alle Bundles außer das Signatur-Bundle sich in einem aktiven Zustand befinden. Die Bundles sind unter http://[server]:[port]/system/console/ aufgeführt. Wenn alle Bundles nicht aktiv, warten Sie einige Minuten und überprüfen Sie den Status der Bundles.

Nachdem alle Bundles sich in einem aktiven Zustand befinden, starten Sie den AEM-Server neu.

Benennen Sie die AEM QuickStart-JAR-Datei in cq-publish-p<Port>.jar um und speichern Sie die JAR-Datei im Veröffentlichungsordner. Legen Sie den <Port> der Veröffentlichungsinstanz fest.  Führen Sie die JAR-Datei aus, um die JAR-Datei zu starten. Weitere Informationen finden Sie unter Installation von Autoren- und Veröffentlichungsinstanzen.

Starten Sie AEM QuickStart und installieren Sie AEM forms Add-On-Pakete wie oben unter Installieren von Add-On-Paketen für AEM forms beschrieben.

Greifen Sie auf die Tools-Benutzeroberfläche der Autoreninstanz unter http://[Hostname]:[Port]/miscadmin zu.

Wählen Sie im linken Fensterbereich „Replikation“ und dann „Agenten für Autor“ aus. Im rechten Fensterbereich sehen Sie verschiedene für die Instanz im Autorenmodus konfigurierte Agenten.

Wählen Sie im rechten Fensterbereich „Neu“ und klicken Sie auf „Neue Seite“. Das Dialogfeld zum Erstellen der Seite wird angezeigt.

Geben Sie den Titel und den Namen ein, und wählen Sie „Replizierungsagent“ aus.

Klicken Sie auf „Erstellen“, um einen neuen Agenten zu erstellen.

Doppelklicken Sie auf das neue Agentenelement, um das Konfigurationsfenster zu öffnen.

Klicken Sie auf „Bearbeiten“. Das Dialogfeld „Agenteneinstellungen“ wird geöffnet.

1. Gehen Sie auf der Registerkarte „Einstellungen“ wie folgt vor:
   1. Geben Sie eine Beschreibung ein.
   2. Aktivieren Sie „Aktiviert“.
   3. Legen Sie den Serialisierungstyp als „Standard“ fest.
   4. Legen Sie den Wert für „Wiederholungsverzögerung“ auf 60.000 fest. Lassen Sie die Agenten-Benutzer-ID leer.
   5. Legen Sie den Wert für Protokollierungsstufe auf „Info“ fest.
2. Gehen Sie auf der Registerkarte „Transport“ wie folgt vor:
   1. Geben Sie den erforderlichen URI für die Instanz im Veröffentlichungsmodus ein: http://[Hostname]:[Port]/bin/receive?sling:authRequestLogin=1.
   2. Legen Sie Benutzer und Kennwort fest. Standardmäßig lauten die Anmeldedaten: „admin/admin“.
3. Gehen Sie auf der Registerkarte „Erweitert“ wie folgt vor:
   1. Geben Sie im Abschnitt für die HTTP-Methode die POST-Methode ein.
4. Gehen Sie auf der Registerkarte „Auslöser“ wie folgt vor:
   1. Wählen Sie „Bei Empfang“ aus und klicken Sie auf „OK“.

Klicken Sie auf „OK“, um die Einstellungen zu speichern.

Klicken Sie im Fenster für die Agentenkonfiguration auf „Verbindung testen“. Eine erfolgreiche Verbindung gibt an, dass die Konfiguration ordnungsgemäß ausgeführt wurde.

Melden Sie sich bei der Tools-Benutzeroberfläche unter http://[Hostname]:[Port]/miscadmin an.

Wählen Sie im linken Fensterbereich „Replikation“ und dann „Agenten für Autor“ aus. Im rechten Fensterbereich sehen Sie verschiedene für die Instanz im Autorenmodus konfigurierte Agenten.

Wählen Sie im rechten Fensterbereich „Neu“ aus und klicken Sie auf „Neue Seite“. Das Dialogfeld zum Erstellen der Seite wird angezeigt.

Legen Sie den Titel und den Namen fest und wählen Sie dann „Agent für Rückwärtsreplikation“ aus.

Klicken Sie auf „Erstellen“, um einen neuen Agenten zu erstellen.

Doppelklicken Sie auf das neue Agentenelement, um das Konfigurationsfenster zu öffnen.

Klicken Sie auf „Bearbeiten“. Das Dialogfeld „Agenteneinstellungen“ wird geöffnet.

1. Gehen Sie auf der Registerkarte „Einstellungen“ wie folgt vor:
   1. Geben Sie eine Beschreibung ein.
   2. Aktivieren Sie „Aktiviert“.
   3. Legen Sie den Serialisierungstyp als „Standard“ fest.
   4. Legen Sie den Wert für „Wiederholungsverzögerung“ auf 60.000 fest. Lassen Sie die Agenten-Benutzer-ID leer.
   5. Legen Sie den Wert für Protokollierungsstufe auf „Info“ fest.
2. Gehen Sie auf der Registerkarte „Transport“ wie folgt vor:
   1. Geben Sie den erforderlichen URI für die Author-Instanz im Veröffentlichungsmodus ein: http://[Hostname]:[Port]/bin/receive?sling:authRequestLogin=1.
   2. Legen Sie Benutzer und Kennwort fest. Standardmäßig lauten die Anmeldedaten: „admin/admin“.
3. Gehen Sie auf der Registerkarte „Erweitert“ wie folgt vor:
   1. Geben Sie im Abschnitt für die HTTP-Methode die POST-Methode ein.
4. Gehen Sie auf der Registerkarte „Auslöser“ wie folgt vor:
   1. Wählen Sie „Bei Empfang“ aus und klicken Sie auf „OK“.

Das Registerkarten „Proxy“ und „Erweitert“ sind optional. Klicken Sie auf „OK“, um diese Konfiguration abzuschließen und zu speichern.

Warten Sie einige Sekunden, sodass die Seite aktualisiert wird. Klicken Sie auf der Seite auf den Link „Verbindung testen“, um zu überprüfen, ob die Konfiguration erfolgreich ist oder nicht.

Öffnen Sie die Datei „dispatcher.any“ für die Bearbeitung und navigieren Sie zum Filterabschnitt.

Fügen Sie dem Filterabschnitt den folgenden Filter hinzu:
/0025 { /type "allow" /glob "* /bin/xfaforms/submitaction*" } #, um die Sendung von AEM forms zu ermöglichen

Speichern und schließen Sie die Datei.

Öffnen Sie die Apache Felix-Konsole (Konfigurationen) unter:
http://[Server]:[Portnummer]/system/console/configMgr

Melden Sie sich als Administrator an und wählen Sie im Menü Konfigurationen die Option Apache Sling ReferrerFilter.

Geben Sie im Feld „Hosts zulassen“ den Hostnamen des Dispatchers ein, um ihn als Referrer zuzulassen, und klicken Sie auf Speichern. Das Format des Eintrags ist http://[Server]:[Port].

Beenden Sie den AEM-Server.

Öffnen Sie sling.properties unter [AEM-Installation]\crx-quickstart\conf\ zur Bearbeitung.

Fügen Sie die folgenden Eigenschaften der sling.properties-Datei hinzu.

Speichern und schließen Sie die Datei. Starten Sie den AEM-Server neu.