Gemeenschappen inzetten deploying-communities

CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Vereisten prerequisites

Controlelijst voor installatie installation-checklist

Voor de AEM

Voor de Gemeenschappen

Laatste releases latest-releases

AEM 6.4 Communautaire algemene vergadering omvat het communautaire pakket. Informatie over updates van AEM 6.4 Gemeenschappen, raadpleegt u AEM 6.4 Opmerkingen bij de release.

AEM 6.4 Updates aem-updates

Vanaf AEM 6.3 worden updates aan de Gemeenschappen geleverd als onderdeel van AEM Cumulative Fix Packs en Service Packs.

Voor de meest recente updates van AEM 6.4 moet u controleren of Adobe Experience Manager 6.4 Cumulatief repareren van pakketten en servicepacks.

Versiehistorie version-history

Net als bij AEM 6.4 en hoger maken AEM Communities-functies en hotfixes deel uit van AEM Communities-pakketten voor cumulatieve probleemoplossingen en servicepacks. Er zijn dus geen aparte kenmerkpakketten.

JDBC-stuurprogramma voor MySQL jdbc-driver-for-mysql

Twee eigenschappen van Gemeenschappen gebruiken een gegevensbestand MySQL:

  • Voor inschakelen: SCORM-activiteiten en -studenten opnemen
  • Voor DSRP: door de gebruiker gegenereerde inhoud opslaan (UGC)

De MySQL-connector moet afzonderlijk worden opgehaald en geïnstalleerd.

De noodzakelijke stappen zijn:

  1. Download het ZIP-archief van https://dev.mysql.com/downloads/connector/j/

    • Versie moet >= 5.1.38 zijn
  2. mysql-connector-java- extraheren<version>-bin.jar (bundel) uit het archief

  3. Gebruik de webconsole om de bundel te installeren en te starten:

    • Bijvoorbeeld http://localhost:4502/system/console/bundles
    • Selecteer Install/Update
    • Bladeren… om de bundel te selecteren die uit het gedownloade ZIP-archief is geëxtraheerd
    • Controleren of JDBC-stuurprogramma van oracle Corporation voor MySQLcom.mysql.jdbc is actief en start deze als dit niet het geval is (of controleer de logboeken)
  4. Als het installeren op een bestaande plaatsing nadat JDBC is gevormd, dan opnieuw bindt JDBC aan de nieuwe schakelaar door de configuratie JDBC van de Webconsole op te slaan:

    • Bijvoorbeeld http://localhost:4502/system/console/configMgr
    • Zoeken Day Commons JDBC Connections Pool configuratie
    • Selecteren om te openen
    • Selecteer Save
  5. De stappen 3 en 4 op alle auteur herhalen en instanties publiceren

Meer informatie over het installeren van bundels vindt u op de Webconsole pagina.

Voorbeeld: MySQL-connectorbundel is geïnstalleerd example-installed-mysql-connector-bundle

chlimage_1-410

SCORM-pakket scorm-package

Shareable Content Object Reference Model (SCORM) is een verzameling standaarden en specificaties voor e-learning. SCORM definieert ook hoe inhoud kan worden verpakt in een overdraagbaar ZIP-bestand.

De AEM Communities SCORM-engine is vereist voor de inschakelen gebruiken. Scorepakketten die worden ondersteund in AEM Communities 6.4-versie zijn:

Voor een nieuwe installatie van de SCORM-engine, bevat het pakket SCORM 2017.1 (die cq -social- scorm -package, versie 2.2.2) moet worden gebruikt. zodat u de leermiddelen kunt spelen die door SCORM 2017 worden gesteund.

Een SCORM-pakket voor de eerste keer installeren

  1. Installeer de cq-social-scorm-package, versie 2.2.2.
  2. Downloaden /libs/social/config/scorm/database_scormengine_data.sql van cq instantie en voer het in mysql server uit om een bevorderd schema te creëren scormEngineDB.
  3. Toevoegen /content/communities/scorm/RecordResults in de eigenschap Uitgesloten paden in het CSRF-filter uit https://<hostname>;:<port>/system/console/configMgr op uitgevers.

Bestaande SCORM-installaties kunnen worden bijgewerkt naar cq-social-scorm-package, versie 2.2.2 (gebruikt SCORM 2017.1), als de geschreven cursusinhoud SCORM 2017.1 vereist.

NOTE
Voor de upgrade naar het SCORM 2017.1-pakket is migratie van de bestaande database vereist (zoals verder wordt uitgelegd).

Om versie van uw motor te bevorderen SCORM

  1. Maak een back-up van het schema ScormEngineDB.

  2. Installeer de cq-social-scorm-package, versie 2.2.2.

  3. Download het pakket van /libs/social/config/scorm/ScormEngine.zip en extraheren.

  4. Ga naar Installatieprogramma map van de uitgepakte directory.

  5. Bijwerken SystemDatabaseConnectionString met uw scorm db connection url in bestand EngineInstall.xml.

  6. Voer het mysql-schema-upgradeprogramma uit in de installatiemap met de opdracht:

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

  7. Monitor engine_upgrade.log bestand voor een fout of schema-upgrade.

  8. Toevoegen /content/communities/scorm/RecordResults in Excluded Paths eigenschap in CSRF-filter van https://<hostname>:<port>/system/console/configMgr op uitgevers.

SCORM-registratie scorm-logging

Zoals geïnstalleerd, wordt al enablement activiteit uitgebreid geregistreerd aan de systeemconsole.

Indien gewenst, kan het logboekniveau aan WARN voor RusticiSoftware.* pakket.

Voor het werken met logboeken, zie Werken met auditrecords en logbestanden.

Geavanceerde MLS AEM aem-advanced-mls

Voor de inzameling SRP (MSRP of DSRP) om geavanceerde meertalige onderzoek (MLS) te steunen, worden nieuwe stop-ins Solr vereist naast een douaneschema en de configuratie Solr. Alle vereiste items worden verpakt in een ZIP-bestand dat kan worden gedownload.

De geavanceerde MLS-download (ook wel 'phasetwo' genoemd) is beschikbaar in de gegevensopslagruimte van de Adobe:

  • AEM-SOLR-MLS-fasetwo

    Ga voor het geavanceerde MLS-pakket naar Geavanceerde MLS AEM in de op te stellen sectie van de documentatie.

    • Versie 1.2.40, 6 april 2016
    • Download AEM-SOLR-MLS-phasetwo-1.2.40.zip

Ga voor meer informatie en installatie-informatie naar Solr-configuratie voor SRP.

Pakketten zichtbaar in Adobe AEM Cloud

Voor de koppelingen naar pakketten op deze pagina is geen actieve versie van AEM vereist, aangezien deze zijn bestemd voor het verpakken van delen op adobeaemcloud.com. Als de pakketten kunnen worden weergegeven, worden de Install-knop is voor het installeren van de pakketten op een door Adobe gehoste site. Als u van plan bent op een lokale AEM te installeren, selecteert u Installresulteert in een fout.

Installeren op lokale AEM

De pakketten installeren die zichtbaar zijn in adobeaemcloud.com op een lokale AEM moet het pakket eerst naar een lokale schijf worden gedownload:

  • Selecteer Assets tab
  • Selecteer download to disk

Gebruik pakketbeheer in de lokale AEM-instantie (bijvoorbeeld http://localhost:4502/crx/packmgr/), om te uploaden naar de lokale AEM.

U kunt het pakket ook openen met het pakket door het lokale AEM te delen (bijvoorbeeld http://localhost:4502/crx/packageshare/), de DownloadDe knop wordt gedownload naar de pakketdataopslag van de lokale AEM.

Eenmaal in de pakketopslagplaats van de lokale AEM-instantie, gebruikt u pakketbeheer om het pakket te installeren.

Ga voor meer informatie naar Werken met pakketten.

Aanbevolen implementaties recommended-deployments

In AEM Communities, wordt een gemeenschappelijke opslag gebruikt om gebruiker geproduceerde inhoud (UGC) op te slaan en vaak bedoeld als Storage Resource Provider (SRP). De geadviseerde plaatsingscentra bij het kiezen van een optie SRP voor de gemeenschappelijke opslag.

De gemeenschappelijke opslag steunt matiging van, en analyses op UGC in het publicatiemilieu terwijl het elimineren van de behoefte aan replicatie van UGC.

Bijwerken upgrading

Wanneer u een upgrade uitvoert naar het AEM 6.4-platform van eerdere versies van AEM, is het belangrijk om Upgrade naar AEM 6.4 te lezen.

Naast het upgraden van het platform, leest u Upgrade uitvoeren naar AEM Communities 6.4 voor meer informatie over wijzigingen in de Gemeenschappen.

Configuraties configurations

Primaire uitgever primary-publisher

Wanneer de gekozen implementatie een publicatiebedrijfmoet vervolgens één AEM publicatieexemplaar worden geïdentificeerd als de primary publisher voor activiteiten die niet in alle gevallen moeten plaatsvinden, zoals functies die meldingen of Adobe Analytics.

Standaard worden de AEM Communities Publisher Configuration De configuratie OSGi wordt gevormd met Primary Publisher checkbox controleerde, dusdanig dat alle publiceer instanties in een publicatielandbouwbedrijf zich als primair zouden identificeren.

Daarom moet bewerk de configuratie op alle secundaire publicatieinstanties om de controle van Primary Publisher selectievakje.

chlimage_1-411

Voor alle andere (secundaire) publiceer instanties in publiceer landbouwbedrijf:

Replicatieagents op auteur replication-agents-on-author

Replicatie wordt gebruikt voor site-inhoud die in de publicatieomgeving is gemaakt, zoals groepen uit de gebruikersgemeenschap, en voor het beheren van leden en lidgroepen vanuit de auteursomgeving met behulp van de tunneldienst.

Voor de primaire uitgever zorg ervoor Replication Agent Config geeft de publicatieserver en de geautoriseerde gebruiker correct aan. De standaard geoorloofde gebruiker, admin, beschikt al over de juiste machtigingen (is lid van Communities Administrators).

Als een andere gebruiker over de juiste machtigingen moet beschikken, moet hij of zij als lid aan de administrators gebruikersgroep (ook lid van Communities Administrators).

Er zijn twee replicatieagenten in het auteursmilieu die de vervoerconfiguratie nodig hebben correct worden gevormd.

  • De console van de Replicatie van de toegang op auteur

    • Vanuit globale navigatie: Tools > Deployment > Replication > Agents on author
  • Volg de zelfde procedure voor beide agenten:

    • Standaardagent (publiceren)

    • Reverse Replication Agent (publiceren reverse)

      1. Selecteer de agent
      2. Selecteer edit
      3. Selecteer Transport tab
      4. Indien niet poort 4503, bewerkt u de URI om de juiste poort op te geven
      5. Indien niet gebruiker admin, bewerkt u de User en Password om een lid van de administrators gebruikersgroep

In de volgende afbeeldingen ziet u de resultaten van het wijzigen van de poort van 4503 in 6103 door:

Standaardagent (publiceren) default-agent-publish

chlimage_1-412

Reverse Replication Agent (publiceren reverse) reverse-replication-agent-publish-reverse

chlimage_1-413

Tunnelservice op auteur tunnel-service-on-author

Wanneer u de ontwerpomgeving gebruikt voor sites maken, site-eigenschappen wijzigen of leden van de gemeenschap beheren, is het noodzakelijk om toegang te krijgen tot leden (gebruikers) die zijn geregistreerd in de publicatieomgeving, niet tot gebruikers die zijn geregistreerd bij de auteur.

De tunneldienst verleent deze toegang gebruikend de replicatieagent op auteur.

Om de tunneldienst toe te laten:

chlimage_1-414

De cryptosleutel dupliceren replicate-the-crypto-key

Er zijn twee eigenschappen van AEM Communities die alle AEM serverinstanties vereisen om de zelfde encryptiesleutels te gebruiken. Dit zijn Analyse en ASRP.

Vanaf AEM 6.3 wordt het sleutelmateriaal opgeslagen in het bestandssysteem en niet langer in de gegevensopslagruimte.

Om het belangrijkste materiaal van auteur aan alle andere instanties te kopiëren is het noodzakelijk:

  • Toegang krijgen tot de AEM instantie, doorgaans een instantie van de auteur, die het te kopiëren toetsmateriaal bevat

    • Zoek de com.adobe.granite.crypto.file bundelen in het lokale bestandssysteem

      Bijvoorbeeld,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • De bundle.info bestand zal de bundel identificeren
    • Navigeren in de gegevensmap

      Bijvoorbeeld,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Kopieer de hoofd- en primaire knoopdossiers

  • Voor elke AEM

    • Navigeren in de gegevensmap

      Bijvoorbeeld,

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Plak de twee eerder gekopieerde bestanden

    • Het is noodzakelijk De Granite Crypto-bundel vernieuwen als de AEM momenteel actief is

CAUTION
Als een andere veiligheidseigenschap reeds is gevormd die op de crypto sleutels gebaseerd is, dan het herhalen van de crypto sleutels kon de configuratie beschadigen. Voor hulp, contact opnemen met de klantenservice.

Replicatie opslagplaats repository-replication

Als het sleutelmateriaal in de bewaarplaats wordt opgeslagen, zoals het geval was voor AEM 6.2 en eerder, kan worden behouden door de volgende systeemeigenschap op te geven bij het eerste opstarten van elke AEM instantie (die de initiële opslagplaats creëert):

  • -Dcom.adobe.granite.crypto.file.disable=true
NOTE
Het is belangrijk te controleren of de replicatieagent bij auteur correct is geconfigureerd.

Met het belangrijkste materiaal dat in de bewaarplaats wordt opgeslagen, is de manier om de crypto sleutel van auteur aan andere instanties te herhalen als volgt:

Gebruiken CRXDE Lite:

chlimage_1-415

De graniet-cryptobundel vernieuwen refresh-the-granite-crypto-bundle

chlimage_1-416

  • Na een ogenblik Succes wordt weergegeven:

    Operation completed successfully.

Apache HTTP Server apache-http-server

Als u de Apache HTTP-server gebruikt, moet u ervoor zorgen dat u de juiste servernaam gebruikt voor alle relevante vermeldingen.

Wees vooral voorzichtig met het gebruik van de juiste servernaam, niet localhostin de RedirectMatch.

httpd.conf, voorbeeld 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

Als u een Dispatcher gebruikt, raadpleegt u:

Verwante documentatie van Gemeenschappen related-communities-documentation

  • Bezoek Communitysites beheren om over het creëren van een communautaire plaats te leren, vormend communautaire plaatssjablonen, het modereren van communautaire inhoud, het leiden van leden, en het vormen overseinen.

  • Bezoek Ontwikkelingsgemeenschappen voor meer informatie over het raamwerk voor sociale componenten (SCF) en het aanpassen van onderdelen en functies van Gemeenschappen.

  • Bezoek Componenten van Gemeenschappen ontwerpen om te leren om met te schrijven en de componenten van de Gemeenschappen te vormen.

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