Bereitstellen von Communities

Voraussetzungen

Checkliste für die Installation

Für die AEM

Fähigkeit " Communities"

Neueste Versionen

AEM 6.4 Communities GA beinhaltet Communities-Paket. Informationen zu Aktualisierungen von AEM 6.4 Communities finden Sie unter AEM 6.4 Versionshinweise.

AEM 6.4 Updates

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

Die neuesten Updates für AEM 6.4 finden Sie unter Adobe Experience Manager 6.4 Cumulative Fix Packs and Service Packs.

Versionsverlauf

Wie bei AEM 6.4 und höher sind AEM Communities-Funktionen und Hotfixes Teil der AEM Communities-Pakete für kumulative Fixpacks und Service Packs. Es gibt daher keine separaten Feature Packs.

JDBC-Treiber für MySQL

Zwei Communities-Funktionen verwenden eine MySQL-Datenbank:

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

Der MySQL-Connector muss separat bezogen und installiert werden.

Die erforderlichen Schritte sind:

  1. ZIP-Archiv von https://dev.mysql.com/downloads/connector/j/ herunterladen

    • 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 Beginn:

    • Beispiel: http://localhost:4502/system/console/bundles
    • Wählen Sie nun eine der folgenden Optionen aus Install/Update
    • Durchsuchen… zum Auswählen des aus dem heruntergeladenen ZIP-Archiv extrahierten Bundles
    • Überprüfen Sie, ob der JDBC-Treiber der Oracle Corporation für MySQLcom.mysql.jdbc aktiv ist, und, falls nicht, Beginn (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 aus der Webkonsole erneut binden:

    • Beispiel: http://localhost:4502/system/console/configMgr
    • Suchen Sie nach Day Commons JDBC Connections Pool-Konfiguration
    • Zum Öffnen auswählen
    • Wählen Sie nun eine der folgenden Optionen aus Save
  5. Wiederholen Sie die Schritte 3 und 4 für alle Autoren- und Veröffentlichungsinstanzen.

Weitere Informationen zum Installieren von Bundles finden Sie auf der Seite Web-Konsole.

Beispiel: Installiertes MySQL Connector-Bundle

chlimage_1-410

SCORM-Paket

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

Die AEM Communities SCORM-Engine ist für die Funktion enable erforderlich. Die auf AEM Communities 6.4 unterstützten Scorm-Pakete sind:

Für eine neue Installation der SCORM-Engine sollte das Paket verwendet werden, das SCORM 2017.1 enthält (das cq -social- scorm -package, Version 2.2.2). 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 das cq-social-scorm-package, Version 2.2.2.
  2. Laden Sie /libs/social/config/scorm/database_scormengine_data.sql von der cq-Instanz herunter und führen Sie es auf dem mysql-Server aus, um ein aktualisiertes scormEngineDB-Schema zu erstellen.
  3. hinzufügen /content/communities/scorm/RecordResults in der Eigenschaft "Ausgeschlossene Pfade"im CSRF-Filter von https://<hostname>;:<port>/system/console/configMgr bei Herausgebern.

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

HINWEIS

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

So aktualisieren Sie die Version der SCORM-Engine

  1. Sichern Sie sich das ScormEngineDB-Schema.

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

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

  4. Wechseln Sie zum Ordner Installer des extrahierten Ordners.

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

  6. Führen Sie das Aktualisierungstool für das mysql-Schema im Installationsordner mit folgendem Befehl aus:

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

  7. Überwachen Sie die engine_upgrade.log-Datei auf alle Fehler- und Schema-Aktualisierungsstatus.

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

SCORM-Protokollierung

Nach der Installation wird die gesamte Aktivität zur Aktivierung ausführlich an die Systemkonsole protokolliert.

Bei Bedarf kann die Protokollebene für das RusticiSoftware.*-Paket auf WARN eingestellt werden.

Informationen zum Arbeiten mit Protokollen finden Sie unter Arbeiten mit Audit-Aufzeichnungen und Protokolldateien.

AEM Advanced MLS

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

Der erweiterte MLS-Download (auch "phasetwo"genannt) ist im Repository der Adobe verfügbar:

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 Paketfreigabe auf adobeaemcloud.com erfordern. Während die Pakete angezeigt werden können, dient die InstallSchaltfläche zum Installieren der Pakete auf einer Adobe gehosteten Site. Wenn Sie beabsichtigen, eine Installation auf einer lokalen AEM durchzuführen, führt die Auswahl von Installzu einem Fehler.

Installation auf einer lokalen AEM-Instanz

Um die in adobeaemcloud.com sichtbaren Pakete auf einer lokalen AEM zu installieren, muss das Paket zunächst auf eine lokale Festplatte heruntergeladen werden:

  • Wählen Sie die Registerkarte Assets
  • Wählen Sie Auf Datenträger herunterladen

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

Alternativ dazu wird beim Zugriff auf das Paket mit Package Share von der lokalen AEM Instanz aus (z. B. http://localhost:4502/crx/packageshare/) die Schaltfläche Downloadzum Paket-Repository der lokalen AEM Instanz heruntergeladen.

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

Weitere Informationen finden Sie unter So arbeiten Sie mit Paketen.

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

Der gemeinsame Speicher unterstützt die Moderation und Analyse von UGC in der Veröffentlichungs-Umgebung, wobei gleichzeitig die Replikation von UGC entfällt.

Aktualisieren

Bei der Aktualisierung auf die AEM 6.4-Plattform von früheren Versionen von AEM ist es wichtig, die Aktualisierung auf AEM 6.4 zu lesen.

Lesen Sie zum Aktualisieren der Plattform Aktualisieren auf AEM Communities 6.4, um mehr über Änderungen in Communities zu erfahren.

Konfigurationen

Primär Publisher

Wenn die gewählte Bereitstellung eine Veröffentlichungsfarm ist, muss eine AEM Veröffentlichungsinstanz für Aktivitäten, die nicht auf allen Instanzen auftreten sollten, als primary publisher identifiziert werden, z. B. für Funktionen, die auf Benachrichtigungen oder Adobe Analytics basieren.

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

Daher müssen Sie die Konfiguration für alle sekundären Veröffentlichungsinstanzen bearbeiten, um das KontrollkästchenPrimary Publisherzu deaktivieren.

chlimage_1-411

Für alle anderen (sekundären) Instanzen im Veröffentlichungsmodus:

  • Anmelden mit Administratorberechtigungen

  • Zugriff auf die Webkonsole

  • Suchen Sie nach AEM Communities Publisher Configuration

  • Wählen Sie das Bearbeitungssymbol

  • Deaktivieren Sie das Kontrollkästchen Primär Publisher

  • Wählen Sie Speichern aus

Replizierungsagenten bei Autor

Die Replikation wird für Site-Inhalte verwendet, die in der Veröffentlichungsgruppe erstellt wurden, wie z. B. Community-Gruppen, sowie für die Verwaltung von Mitgliedern und Mitgliedsgruppen aus der Autorenversion mithilfe des Tunneldienstes-Umgebung.

Stellen Sie für den primären Herausgeber sicher, dass Replication Agent Config den Veröffentlichungsserver und den autorisierten Benutzer richtig 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, müssen sie als Mitglied der Benutzergruppe administrators hinzugefügt werden (auch Mitglied von Communities Administrators).

Es gibt zwei Replizierungsagenten in der Authoring-Umgebung, für die die Transportkonfiguration korrekt konfiguriert werden muss.

  • Zugriff auf die Replikationskonsole beim Autor

    • Aus globaler Navigation: Tools > Bereitstellung > Replikation > Agenten bei Autor
  • Für beide Wirkstoffe gilt das gleiche Verfahren:

    • Standardagent (veröffentlichen)

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

      1. Agent auswählen
      2. Wählen Sie edit
      3. Wählen Sie die Registerkarte Transport
      4. Wenn kein Anschluss 4503 vorhanden ist, bearbeiten Sie den URI, um den richtigen Anschluss anzugeben.
      5. Wenn kein Benutzer admin, bearbeiten Sie die Benutzer und Kennwort, um ein Mitglied der administrators Benutzergruppe anzugeben.

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

Standardagent (publish)

chlimage_1-412

Replizierungsagenten umkehren (Umkehren veröffentlichen)

chlimage_1-413

Tunnel-Dienst bei Autor

Wenn Sie die Umgebung zum Erstellen von Sites](sites-console.md), zum Ändern von Site-Eigenschaften oder Verwalten von Community-Mitgliedern verwenden, müssen Sie auf in der Umgebung zum Veröffentlichen registrierte Mitglieder (Benutzer) zugreifen, nicht auf Benutzer, die beim Autor registriert sind.[

Der Tunneldienst bietet diesen Zugriff mithilfe des Replizierungsagenten beim Autor.

So aktivieren Sie den Tunneldienst:

  • Unter author

  • Anmelden mit Administratorrechten

  • Wenn der Herausgeber nicht localhost:4503 ist oder der Transportbenutzer nicht admin ist,

    Konfigurieren Sie dann den Replizierungsagenten

  • Zugriff auf die Webkonsole

  • Suchen Sie nach AEM Communities Publish Tunnel Service

  • Wählen Sie das Bearbeitungssymbol

  • Aktivieren Sie das Kontrollkästchen enable

  • Wählen Sie Speichern aus

chlimage_1-414

Crypto-Schlüsselreplizieren

Es gibt zwei Funktionen von AEM Communities, bei denen alle AEM Serverinstanzen dieselben Verschlüsselungsschlüssel verwenden müssen. Dazu gehören 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:

  • Greifen Sie auf die AEM Instanz zu, in der es sich normalerweise um eine Autoreninstanz handelt, die das zu kopierende Schlüsselmaterial enthält

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

      Beispiel:

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

      Beispiel:

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Kopieren Sie die Dateien für den hmac- und den primären Knoten

  • Für jede Zielgruppe AEM Instanz

    • In den Datenordner navigieren

      Beispiel:

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Einfügen der zuvor kopierten zwei Dateien

    • Es ist erforderlich, das Granite Crypto Bundle](#refresh-the-granite-crypto-bundle) zu aktualisieren, wenn die Zielgruppe AEM Instanz derzeit ausgeführt wird.[

VORSICHT

Wenn bereits eine andere Sicherheitsfunktion konfiguriert wurde, die auf den Verschlüsselungsschlüsseln basiert, könnte die Replizierung der Verschlüsselungsschlüssel die Konfiguration beschädigen. Wenden Sie sich zwecks Hilfe an den Kundendienst.

Repository-Replikation

Die Speicherung des Schlüsselmaterials im Repository kann, wie bei AEM 6.2 und früher, beibehalten werden, indem beim ersten Start jeder AEM Instanz (die das anfängliche Repository erstellt) die folgende Systemeigenschaft angegeben wird:

  • -Dcom.adobe.granite.crypto.file.disable=true
HINWEIS

Es ist wichtig zu überprüfen, ob der Replizierungsagenten unter author richtig konfiguriert ist.

Wenn das Schlüsselmaterial im Repository gespeichert ist, erfolgt die Replizierung des Verschlüsselungsschlüssels vom Autor zu anderen Instanzen wie folgt:

Verwenden von CRXDE Lite:

chlimage_1-415

Granite Crypto-Bundle aktualisieren

chlimage_1-416

  • Nach einem Augenblick sollte ein Dialogfeld Erfolg angezeigt werden:

    Operation completed successfully.

Apache HTTP Server

Wenn Sie den Apache HTTP-Server verwenden, stellen Sie sicher, dass Sie den richtigen Servernamen für alle relevanten Einträge verwenden.

Achten Sie insbesondere darauf, den korrekten Servernamen, nicht localhost, in RedirectMatch zu verwenden.

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

Informationen zum Verwenden eines Dispatchers finden Sie unter:

  • Unter Communities-Sites verwalten erfahren Sie mehr darüber, wie Sie Community-Sites erstellen, Community-Site-Vorlagen bearbeiten, Community-Inhalte moderieren, Mitglieder verwalten und Messaging-Systeme konfigurieren können.

  • Besuchen Sie Developing Communities, um mehr über das Social-Komponenten-Framework (SCF) zu erfahren und Communities-Komponenten und -Funktionen anzupassen.

  • Unter Komponenten für Authoring-Communities erfahren Sie, wie Sie mit Communities-Komponenten erstellen und konfigurieren.

Auf dieser Seite