DokumentationAEM 6.4Communities-Anleitung

Bereitstellen von Communities deploying-communities

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • User
CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Voraussetzungen prerequisites

Checkliste für die Installation installation-checklist

Für AEM

Für Communities-Funktionen

Neueste Versionen latest-releases

AEM 6.4 Communities GA umfasst das Communities-Package. Informationen zu Updates auf AEM 6.4 Communities, siehe AEM 6.4 - Versionshinweise.

AEM 6.4 Updates aem-updates

Ab AEM 6.3 werden Aktualisierungen an Communities als Teil von AEM Cumulative Fix Packs und Service Packs bereitgestellt.

Die neuesten Updates zu AEM 6.4 finden Sie unter Adobe Experience Manager 6.4 Cumulative Fix Packs und Service Packs.

Versionsverlauf version-history

Wie AEM 6.4 und höher sind AEM Communities-Funktionen und Hotfixes Teil von AEM Communities Cumulative Fix Packs und Service Packs. Es gibt daher keine separaten Feature Packs.

JDBC-Treiber für MySQL jdbc-driver-for-mysql

Zwei Communities-Funktionen verwenden eine MySQL-Datenbank:

  • Für Aktivierung: Aufzeichnen von SCORM-Aktivitäten und -Lernenden
  • Für DSRP: Speichern benutzergenerierter Inhalte (UGC)

Der MySQL-Connector muss separat abgerufen und installiert werden.

Die erforderlichen Schritte sind:

  1. Laden Sie das ZIP-Archiv herunter von https://dev.mysql.com/downloads/connector/j/

    • Version muss >= 5.1.38 sein.

  2. Extrahieren Sie mysql-connector-java-<version>-bin.jar (Bundle) aus dem Archiv

  3. Verwenden Sie die Web-Konsole, um das Bundle zu installieren und zu starten:

    • Beispiel: http://localhost:4502/system/console/bundles
    • Klicken Sie auf Install/Update
    • Durchsuchen… , um das aus dem heruntergeladenen ZIP-Archiv extrahierte Bundle auszuwählen.
    • Vergewissern Sie sich, dass JDBC-Treiber der oracle Corporation für MySQLcom.mysql.jdbc aktiv ist, und starten Sie es, falls nicht (oder überprüfen Sie die Protokolle)

  4. Wenn Sie nach der Konfiguration von JDBC in einer vorhandenen Bereitstellung installieren, binden Sie JDBC erneut an den neuen Connector, indem Sie die JDBC-Konfiguration von der Web-Konsole aus erneut speichern:

    • Beispiel: http://localhost:4502/system/console/configMgr
    • Suchen Day Commons JDBC Connections Pool Konfiguration
    • Zum Öffnen auswählen
    • Klicken Sie auf Save

  5. Wiederholen Sie die Schritte 3 und 4 für alle Autoren- und Veröffentlichungsinstanzen.

Weitere Informationen zur Installation von Bundles finden Sie auf der Web-Konsole Seite.

Beispiel: MySQL Connector Bundle installiert example-installed-mysql-connector-bundle

chlimage_1-410

SCORM-Paket scorm-package

Das Shareable Content Object Reference Model (SCORM) ist eine Sammlung von Standards und Spezifikationen für E-Learning. SCORM definiert auch, wie Inhalte in eine übertragbare ZIP-Datei gepackt werden können.

Die AEM Communities SCORM-Engine ist für die Aktivierung Funktion. Von AEM Communities 6.4 unterstützte Scorm-Pakete sind:

Bei einer Neuinstallation des SCORM-Moduls enthält das Paket SCORM 2017.1 , cq -social- scorm -package, Version 2.2.2) verwendet werden. Damit Sie Lernressourcen spielen können, die von SCORM 2017 unterstützt werden.

So installieren Sie ein SCORM-Paket zum ersten Mal

  1. Installieren Sie die cq-social-scorm-package, Version 2.2.2.
  2. Download /libs/social/config/scorm/database_scormengine_data.sql aus der cq-Instanz und führen Sie sie auf dem mysql-Server aus, um ein aktualisiertes scormEngineDB-Schema zu erstellen.
  3. Hinzufügen /content/communities/scorm/RecordResults in der Eigenschaft "Excluded Paths"im CSRF-Filter von https://<hostname>;:<port>/system/console/configMgr auf Herausgebern.

Bestehende SCORM-Installationen können auf cq-social-scorm-package, Version 2.2.2 , die SCORM 2017.1), wenn für den erstellten Kursinhalt SCORM 2017.1 erforderlich ist.

NOTE
Die Aktualisierung auf das SCORM 2017.1-Paket erfordert die Migration der vorhandenen Datenbank (wie weiter erläutert).

Aktualisierung der Version Ihrer SCORM-Engine

  1. Erstellen Sie eine Sicherungskopie des ScormEngineDB-Schemas.

  2. Installieren Sie die cq-social-scorm-package, Version 2.2.2.

  3. Laden Sie das Paket herunter von /libs/social/config/scorm/ScormEngine.zip und extrahieren Sie dasselbe.

  4. Navigieren Sie zu Installationsprogramm Ordner des extrahierten Ordners.

  5. Aktualisieren SystemDatabaseConnectionString mit scorm db connection url in Datei EngineInstall.xml.

  6. Führen Sie das mysql-Schema-Upgrade-Tool im Installationsordner mit dem Befehl aus:

    java -Dlogback.configurationFile=logback.xml -cp "lib/*" RusticiSoftware.ScormContentPlayer.Logic.Upgrade.ConsoleApp EngineInstall.xml

  7. Überwachen engine_upgrade.log -Datei für jeden Fehler- und Schema-Upgrade-Status.

  8. Hinzufügen /content/communities/scorm/RecordResults in Ausgeschlossene Pfade Eigenschaft in CSRF-Filter von https://<hostname>:<port>/system/console/configMgr auf Herausgebern.

SCORM-Protokollierung scorm-logging

Wie installiert, werden alle Aktivierungsaktivitäten ausführlich in der Systemkonsole protokolliert.

Bei Bedarf kann die Protokollebene für die RusticiSoftware.* Paket.

Informationen zum Arbeiten mit Protokollen finden Sie unter Arbeiten mit Auditdatensätzen und Protokolldateien.

AEM erweiterte MLS aem-advanced-mls

Damit die SRP-Sammlung (MSRP oder DSRP) erweiterte mehrsprachige Suche (MLS) unterstützen kann, sind zusätzlich zu einem benutzerdefinierten Schema und einer Solr-Konfiguration neue Solr-Plug-ins erforderlich. Alle erforderlichen Elemente werden in einer herunterladbaren ZIP-Datei zusammengefasst.

Der erweiterte MLS-Download (auch als "Phasetwo"bezeichnet) ist im Adobe-Repository verfügbar:

  • AEM-SOLR-MLS-phasetwo

    Informationen zum Abrufen des erweiterten MLS-Pakets finden Sie unter AEM erweiterte MLS im Abschnitt "Bereitstellung"der Dokumentation.

    • Version 1.2.40, 6. April 2016
    • AEM-SOLR-MLS-phasetwo-1.2.40.zip herunterladen

Weitere Informationen und Installationsinformationen finden Sie unter Solr-Konfiguration für SRP.

In Adobe AEM Cloud sichtbare Pakete

Die Links zu Paketen auf dieser Seite erfordern keine laufende Instanz von AEM, da sie für die Paketfreigabe auf adobeaemcloud.com. Während die Pakete sichtbar sind, wird die Install-Schaltfläche ist für die Installation der Pakete auf einer Adobe gehosteten Site. Wenn Sie eine Installation auf einer lokalen AEM durchführen möchten, wählen Sie Installführt zu einem Fehler.

Installieren auf einer lokalen AEM-Instanz

So installieren Sie die Pakete, die in adobeaemcloud.com auf einer lokalen AEM-Instanz muss das Paket zuerst auf eine lokale Festplatte heruntergeladen werden:

  • Wählen Sie die Assets tab
  • Auswählen Herunterladen auf Festplatte

Verwenden Sie auf der lokalen AEM-Instanz den Package Manager (z. B. http://localhost:4502/crx/packmgr/), um in das lokale AEM-Package-Repository hochzuladen.

Alternativ können Sie über Package Share über die lokale AEM-Instanz auf das Paket zugreifen (z. B. http://localhost:4502/crx/packageshare/), die Download-Schaltfläche in das Package-Repository der lokalen AEM-Instanz heruntergeladen.

Sobald Sie sich im Package-Repository der lokalen AEM-Instanz befinden, installieren Sie das Package mit Package Manager.

Weitere Informationen finden Sie unter Arbeiten mit Paketen.

Empfohlene Bereitstellungen recommended-deployments

In AEM Communities wird ein gemeinsamer Speicher zum Speichern benutzergenerierter Inhalte verwendet, die häufig als Storage Resource Provider (SRP). Die empfohlene Implementierung konzentriert sich auf die Auswahl einer SRP-Option für den gemeinsamen Speicher.

Der gemeinsame Speicher unterstützt die Moderation von und die Analyse von benutzergenerierten Inhalten in der Veröffentlichungsumgebung, während die Notwendigkeit für Replikation von UGC.

Upgrade upgrading

Wenn Sie von früheren Versionen von AEM auf die AEM 6.4-Plattform aktualisieren, ist es wichtig, die Informationen unter Upgrade auf AEM 6.4 zu lesen.

Lesen Sie neben der Aktualisierung der Plattform auch Upgrade auf AEM Communities 6.4 , um mehr über Communities-Änderungen zu erfahren.

Konfigurationen configurations

Primärer Herausgeber primary-publisher

Wenn es sich bei der ausgewählten Bereitstellung um eine Veröffentlichungsfarm, muss eine AEM Veröffentlichungsinstanz als primary publisher für Aktivitäten, die nicht in allen Instanzen auftreten sollten, z. B. Funktionen, auf die Benachrichtigungen oder Adobe Analytics.

Standardmäßig wird die AEM Communities Publisher Configuration Die OSGi-Konfiguration wird mit der Primary Publisher -Kontrollkästchen aktiviert, sodass sich alle Veröffentlichungsinstanzen in einer Veröffentlichungsfarm selbst als primär identifizieren.

Daher ist es notwendig, Bearbeiten Sie die Konfiguration auf allen sekundären Veröffentlichungsinstanzen. , um die Primary Publisher aktivieren.

chlimage_1-411

Für alle anderen (sekundären) Veröffentlichungsinstanzen in einer Veröffentlichungsfarm:

Replikationsagenten auf der Autoreninstanz replication-agents-on-author

Die Replikation wird für Site-Inhalte verwendet, die in der Veröffentlichungsumgebung erstellt werden, z. B. Community-Gruppen, sowie für die Verwaltung von Mitgliedern und Mitgliedergruppen aus der Autorenumgebung mithilfe der Tunneldienst.

Stellen Sie für den primären Herausgeber sicher, dass die Konfiguration des Replikationsagenten den Veröffentlichungsserver und den autorisierten Benutzer korrekt identifiziert. Der standardmäßig autorisierte Benutzer admin, verfügt bereits über die entsprechenden Berechtigungen (ist Mitglied von Communities Administrators).

Damit andere Benutzer über die entsprechenden Berechtigungen verfügen können, müssen sie als Mitglied der administrators Benutzergruppe (ebenfalls Mitglied von Communities Administrators).

Es gibt zwei Replikationsagenten in der Autorenumgebung, für die die Transportkonfiguration korrekt konfiguriert werden muss.

  • Zugriff auf die Replikationskonsole auf der Autoreninstanz

    • Über die globale Navigation: Tools > Bereitstellung > Replikation > Agenten für Autor

  • Gehen Sie für beide Agenten genauso vor:

    • Standardagent (publish)

    • Agenten für Rückwärtsreplikation (Rückwärts veröffentlichen)

      1. Wählen Sie den Agenten aus
      2. Auswählen edit
      3. Wählen Sie die Verkehr tab
      4. Wenn nicht Port 4503, bearbeiten Sie die URI zum Angeben des richtigen Ports
      5. Wenn kein Benutzer admin, bearbeiten Sie die Benutzer und Passwort , um ein Mitglied der administrators Benutzergruppe

Die folgenden Abbildungen zeigen die Ergebnisse einer Änderung des Ports von 4503 auf 6103 durch:

Standardagent (publish) default-agent-publish

chlimage_1-412

Agenten für Rückwärtsreplikation (Rückwärts veröffentlichen) reverse-replication-agent-publish-reverse

chlimage_1-413

Tunnel-Dienst auf Autoreninstanz tunnel-service-on-author

Bei Verwendung der Autorenumgebung zu Erstellen von Sites, Ändern von Site-Eigenschaften oder Verwalten von Community-Mitgliedern, ist es erforderlich, auf Mitglieder (Benutzer) zuzugreifen, die in der Veröffentlichungsumgebung registriert sind, nicht auf Benutzer, die in der Autoreninstanz registriert sind.

Der Tunneldienst stellt diesen Zugriff mithilfe des Replikationsagenten auf der Autoreninstanz bereit.

So aktivieren Sie den Tunneldienst:

chlimage_1-414

Replizieren des Crypto-Schlüssels replicate-the-crypto-key

Es gibt zwei Funktionen von AEM Communities, für die alle AEM Serverinstanzen dieselben Verschlüsselungsschlüssel verwenden müssen. Diese Analytics und ASRP.

Ab AEM 6.3 wird das Schlüsselmaterial im Dateisystem und nicht mehr im Repository gespeichert.

Um das Schlüsselmaterial vom Autor in alle anderen Instanzen zu kopieren, müssen Sie Folgendes tun:

  • Greifen Sie auf die AEM-Instanz zu, normalerweise eine Autoreninstanz, die das zu kopierende Schlüsselmaterial enthält

    • Suchen Sie die com.adobe.granite.crypto.file Bundle im lokalen Dateisystem

      Beispiel:

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • Die bundle.info -Datei identifiziert das Bundle

    • Navigieren zum Datenordner

      Beispiel:

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data

    • Kopieren Sie die Dateien hmac und primary .

  • Für jede AEM-Instanz

    • Navigieren zum Datenordner

      Beispiel:

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data

    • Fügen Sie die beiden zuvor kopierten Dateien ein.

    • Es ist erforderlich, Aktualisieren des Granite Crypto-Bundles , wenn die Ziel-AEM-Instanz derzeit ausgeführt wird

CAUTION
Wenn bereits eine andere Sicherheitsfunktion konfiguriert wurde, die auf den Verschlüsselungsschlüsseln basiert, kann die Replikation der Verschlüsselungsschlüssel die Konfiguration beschädigen. Hilfe: Kundenunterstützung kontaktieren.

Repository-Replikation repository-replication

Das Schlüsselmaterial, das wie bei AEM 6.2 und früher im Repository gespeichert ist, kann beibehalten werden, indem beim ersten Start jeder AEM Instanz (durch die das anfängliche Repository erstellt wird) die folgende Systemeigenschaft angegeben wird:

  • -Dcom.adobe.granite.crypto.file.disable=true
NOTE
Es ist wichtig zu überprüfen, dass die Variable Replikationsagent auf Autoreninstanz korrekt konfiguriert ist.

Mit dem im Repository gespeicherten Schlüsselmaterial wird der Crypto-Schlüssel vom Autor auf andere Instanzen wie folgt repliziert:

Verwenden CRXDE Lite:

chlimage_1-415

Aktualisieren des Granite Crypto-Bundles refresh-the-granite-crypto-bundle

chlimage_1-416

  • Nach einem Moment Erfolg sollte angezeigt werden:

    Operation completed successfully.

Apache HTTP Server apache-http-server

Stellen Sie bei Verwendung des Apache HTTP-Servers sicher, dass Sie den richtigen Servernamen für alle relevanten Einträge verwenden.

Achten Sie insbesondere darauf, den richtigen Servernamen zu verwenden, nicht localhostin der RedirectMatch.

Beispiel für httpd.conf httpd-conf-sample

<IfModule alias_module>
     # XAMPP does not have a favicon; this prevents any 404 errors which may arise.
     Redirect 404 /favicon.ico
     <Location /favicon.ico>
         ErrorDocument 404 "No favicon"
     </Location>

    # Return from "Sign Out" generates response header directing you to "/", generating a 404 error
    # The RedirectMatch resolves it correctly when modified for the target Community Site:
    RedirectMatch ^/$ https://[server name]/content/sites/engage/en.html
 ...
 </IfModule>

Dispatcher dispatcher

Informationen zur Verwendung eines Dispatchers finden Sie unter:

Verwandte Communities - Dokumentation related-communities-documentation

  • Besuch Verwalten von Communities-Sites , um mehr über die Erstellung einer Community-Site, die Konfiguration von Community-Site-Vorlagen, die Moderation von Community-Inhalten, die Verwaltung von Mitgliedern und die Konfiguration von Messaging zu erfahren.

  • Besuch Entwickeln von Communities , um mehr über das Social-Komponenten-Framework (SCF) zu erfahren und Communities-Komponenten und -Funktionen anzupassen.

  • Besuch Erstellen von Communities-Komponenten , um zu erfahren, wie Sie Communities-Komponenten erstellen und konfigurieren.

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6