Bereitstellen von Communities

Voraussetzungen

Checkliste für die Installation

Für die AEM

Fähigkeit " Communities"

Latest Releases

AEM 6.4 Communities GA beinhaltet Communities-Paket. Informationen zu Updates für AEM 6.4 Communitiesfinden Sie in den AEM 6.4 Versionshinweisen.

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.

Version History

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 überprüfen Sie ihn gegebenenfalls (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 Day Commons JDBC Connections Pool der 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 Aktivierungsfunktion erforderlich. Die auf AEM Communities 6.4 unterstützten Scorm-Pakete sind:

Für eine Neuinstallation der SCORM Engine sollte das Paket verwendet werden, das SCORM 2017.1 enthält (was cq -social- scorm -package, Version 2.2.2ist). 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 sie 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 Herausgebern https://<hostname>;:<port>/system/console/configMgr aus.

Bestehende SCORM-Installationen können auf cq-social-scorm-package, Version 2.2.2 (die SCORM 2017.1verwendet) aktualisiert werden, wenn für die erstellten Kursinhalte 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 herunter /libs/social/config/scorm/ScormEngine.zip und extrahieren Sie es.

  4. Wechseln Sie zum Ordner Installer des extrahierten Ordners.

  5. Aktualisieren Sie SystemDatabaseConnectionString mit Ihrer scorm db connection url 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 Aktualisierungsstatus des Schemas.

  8. hinzufügen /content/communities/scorm/RecordResults in der Eigenschaft " Ausgeschlossene Pfade "im CSRF-Filter von https://<hostname>:<port>/system/console/configMgr 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 auf Package Share lauten adobeaemcloud.com. Während die Pakete angezeigt werden können, ist die InstallSchaltfläche zum Installieren der Pakete auf einer Adobe gehosteten Site. Wenn Sie beabsichtigen, eine Installation auf einer lokalen AEM durchzuführen, Installführt die Auswahl zu einem Fehler.

Installation auf einer lokalen AEM-Instanz

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

  • Select the Assets tab
  • Select download to disk

Verwenden Sie auf der lokalen AEM Package Manager (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 DownloadSchaltfläche zum 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 Arbeiten 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, während 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 neben der Aktualisierung der Plattform auch Aktualisieren auf AEM Communities 6.4 , um mehr über Änderungen in Communities zu erfahren.

Konfigurationen

Primär Publisher

Wenn es sich bei der gewählten Bereitstellung um eine Veröffentlichungsfarmhandelt, muss eine AEM Instanz im Veröffentlichungsmodus als die Instanz primary publisher für Aktivitäten identifiziert werden, die nicht in allen Instanzen auftreten sollten, z. B. Funktionen, die auf Benachrichtigungen oder Adobe Analytics angewiesen sind.

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

Daher müssen Sie die Konfiguration für alle sekundären Veröffentlichungsinstanzen bearbeiten, um das Kontrollkästchen zu deaktivieren . Primary Publisher

chlimage_1-411

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

  • Anmelden mit Administratorberechtigungen

  • Access the web console

  • Suchen Sie die AEM Communities Publisher Configuration

  • Wählen Sie das Bearbeitungssymbol

  • Deaktivieren Sie das Kontrollkästchen Primär Publisher .

  • Wählen Sie Speichern aus

Replizierungsagenten beim Autor

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

Stellen Sie für den primären Herausgeber sicher, dass die Replication Agent-Konfiguration den Veröffentlichungsserver und den autorisierten Benutzer richtig identifiziert. Der standardmäßig autorisierte Benutzer hat admin, bereits 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 (auch Mitglied von Communities Administrators) hinzugefügt werden.

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: Werkzeuge > Bereitstellung > Replikation > Agenten beim 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. Select edit
      3. Select the Transport tab
      4. Wenn kein Anschluss vorhanden 4503ist, bearbeiten Sie den URI , um den richtigen Anschluss anzugeben.
      5. Falls kein Benutzer admin, bearbeiten Sie 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 (veröffentlichen)

chlimage_1-412

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

chlimage_1-413

Tunneldienst beim Autor

Wenn Sie mit der Autorenversion Websites erstellen, Site-Eigenschaften ändern oder Community-Mitglieder verwalten, müssen Sie auf in der Umgebung "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:

chlimage_1-414

Crypto-Schlüssel replizieren

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

    • Locate the com.adobe.granite.crypto.file bundle in the local file system

      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

    • Das Granite Crypto-Bundle muss aktualisiert werden, wenn die Zielgruppe AEM Instanz derzeit ausgeführt wird.

ACHTUNG

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 die Kundenunterstützung.

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 beim Autor 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:

Using CRXDE Lite:

chlimage_1-415

Granite Crypto-Bundle aktualisieren

chlimage_1-416

  • Nach einem Augenblick sollte ein Erfolgsdialogfeld 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 richtigen Servernamen zu verwenden, nicht localhostin der RedirectMatch.

httpd.conf-Beispiel

<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.

  • Visit Developing Communities to learn about the social component framework (SCF) and customizing Communities components and features.

  • Unter Authoring Communities-Komponenten erfahren Sie, wie Sie Communities-Komponenten erstellen und konfigurieren.

Auf dieser Seite