Bereitstellen von Communities

Voraussetzungen

Checkliste für die Installation

Für die AEM

Fähigkeit " Communities"

Neueste Versionen

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

AEM 6.5 Updates

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

Die neuesten Updates für AEM 6.5 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: https://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 verknüpfen:

    • Beispiel: https://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

connector-bundle

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. Von AEM 6.5 Communities unterstützte Scorm-Pakete:

So installieren Sie ein SCORM-Paket

  1. Installieren Sie das cq-social-scorm-package, Version 2.3.7 aus Package Share.
  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.

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 Schaltfläche Install 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 Install zu 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. https://localhost:4502/crx/packmgr/), um das Paket-Repository in AEM lokalen Repository hochzuladen.

Wenn Sie alternativ mit Package Share von der lokalen AEM Instanz aus auf das Paket zugreifen (z. B. https://localhost:4502/crx/packageshare/), wird die Schaltfläche Download in das 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.5-Plattform von früheren Versionen von AEM ist es wichtig, Upgrade auf AEM 6.5 zu lesen.

Lesen Sie zum Aktualisieren der Plattform Aktualisieren auf AEM Communities 6.5, 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 Primary Publisher konfiguriert, sodass alle Veröffentlichungsinstanzen in einer Veröffentlichungsfarm sich selbst als Primär identifizieren.AEM Communities Publisher Configuration

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

primary publisher

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

  • Anmelden mit Administratorrechten

  • 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

    • Navigieren Sie in der globalen Navigation zu 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)

default-agent-publish

Replizierungsagenten umkehren (Umkehren veröffentlichen)

reverse-Replication-agent

Tunnel-Dienst bei Autor

Wenn Sie die Umgebung zum Erstellen von Sites](/docs/experience-manager-65/communities/sites-console.html?lang=de), 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:

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 Folgendes tun:

  • 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,
      zum Beispiel

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • Die bundle.info-Datei identifiziert das Bundle
    • Navigieren Sie zum Datenordner,
      zum 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

    • Navigieren Sie zum Datenordner,
      zum 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:

Granite Crypto-Bundle aktualisieren

  • Rufen Sie in jeder Veröffentlichungsinstanz die Webkonsole auf

  • Suchen Sie nach Adobe Granite Crypto Support bundle (com.adobe.granite.crypto)

  • Wählen Sie Aktualisieren

    granite-crypto

  • 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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free