Distribuzione di Communities deploying-communities

CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Prerequisiti prerequisites

Elenco di controllo dell'installazione installation-checklist

Per piattaforma AEM

Per Funzionalità community

Versioni più recenti latest-releases

AEM 6.4 Communities GA include il pacchetto Community. Per informazioni sugli aggiornamenti a AEM 6.4 Community, fai riferimento a Note sulla versione di AEM 6.4.

Aggiornamenti di AEM 6.4 aem-updates

A partire dalla AEM 6.3, gli aggiornamenti alle Community vengono forniti come parte di AEM Cumulative Fix Pack e Service Pack.

Per gli ultimi aggiornamenti a AEM 6.4, assicurati di controllare Adobe Experience Manager 6.4 Cumulative Fix Pack e Service Pack.

Cronologia delle versioni version-history

Come in AEM 6.4 e versioni successive, le funzioni e gli hotfix di AEM Communities fanno parte dei pacchetti correzioni cumulativi e dei Service Pack di AEM Communities. Non esistono pertanto pacchetti di funzioni separati.

Driver JDBC per MySQL jdbc-driver-for-mysql

Due funzionalità di Communities utilizzano un database MySQL:

  • Per abilitazione: registrazione di attività SCORM e studenti
  • Per DSRP: archiviazione di contenuti generati dall’utente (UGC)

Il connettore MySQL deve essere ottenuto e installato separatamente.

Le misure necessarie sono:

  1. Scarica l'archivio ZIP da https://dev.mysql.com/downloads/connector/j/

    • La versione deve essere >= 5.1.38
  2. Estrai mysql-connector-java-<version>-bin.jar (bundle) dall'archivio

  3. Usa la console web per installare e avviare il bundle:

    • Ad esempio, http://localhost:4502/system/console/bundles
    • Seleziona Install/Update
    • Sfoglia… per selezionare il bundle estratto dall'archivio ZIP scaricato
    • Controlla che Driver JDBC di Oracle Corporation per MySQLcom.mysql.jdbc è attivo e avvialo in caso contrario (o controlla i registri)
  4. Se esegui l’installazione su un’implementazione esistente dopo la configurazione di JDBC, esegui un rebind JDBC al nuovo connettore, salvando nuovamente la configurazione JDBC dalla console Web:

    • Ad esempio, http://localhost:4502/system/console/configMgr
    • Individua Day Commons JDBC Connections Pool configurazione
    • Seleziona per aprire
    • Seleziona Save
  5. Ripeti i passaggi 3 e 4 su tutte le istanze di authoring e pubblicazione

Ulteriori informazioni sull'installazione dei bundle sono disponibili sul Console web pagina.

Esempio: Bundle del connettore MySQL installato example-installed-mysql-connector-bundle

chlimage_1-410

Pacchetto SCORM scorm-package

SCORM (Shared Content Object Reference Model) è una raccolta di standard e specifiche per l'e-learning. SCORM definisce anche come il contenuto può essere confezionato in un file ZIP trasferibile.

Il motore AEM Communities SCORM è richiesto per abilitazione funzionalità. I pacchetti Scorm supportati nella versione AEM Communities 6.4 sono:

Per una nuova installazione del motore SCORM, il pacchetto contenente SCORM 2017.1 (che è cq -social- scorm -package, versione 2.2.2). In modo da poter utilizzare le risorse di apprendimento supportate da SCORM 2017.

Per installare un pacchetto SCORM per la prima volta

  1. Installa il cq-social-scorm-package, versione 2.2.2.
  2. Scarica /libs/social/config/scorm/database_scormengine_data.sql dall'istanza cq e eseguiscila in mysql server per creare uno schema scormEngineDB aggiornato.
  3. Aggiungi /content/communities/scorm/RecordResults in Proprietà Percorsi esclusi nel filtro CSRF da https://<hostname>;:<port>/system/console/configMgr sugli editori.

Le installazioni SCORM esistenti possono essere aggiornate a cq-social-scorm-package, versione 2.2.2 (che utilizza SCORM 2017.1), se il contenuto del corso creato richiede SCORM 2017.1.

NOTE
L'aggiornamento al pacchetto SCORM 2017.1 richiede la migrazione del database esistente (come spiegato più avanti).

Per aggiornare la versione del motore SCORM

  1. Esegui il backup dello schema ScormEngineDB.

  2. Installa il cq-social-scorm-package, versione 2.2.2.

  3. Scarica il pacchetto da /libs/social/config/scorm/ScormEngine.zip ed estrarne lo stesso.

  4. Vai a Installazione della directory estratta.

  5. Aggiorna SystemDatabaseConnectionString con il tuo scorm db connection url in file EngineInstall.xml.

  6. Esegui lo strumento di aggiornamento dello schema mysql nella cartella Installer con il comando:

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

  7. Monitor engine_upgrade.log per qualsiasi tipo di errore e stato di aggiornamento dello schema.

  8. Aggiungi /content/communities/scorm/RecordResults in Percorsi esclusi proprietà nel filtro CSRF da https://<hostname>:<port>/system/console/configMgr sugli editori.

Registrazione SCORM scorm-logging

Come installato, tutte le attività di abilitazione vengono registrate in modo dettagliato nella console di sistema.

Se lo desideri, puoi impostare il livello di log su WARN per RusticiSoftware.* pacchetto.

Per lavorare con i registri, consulta Utilizzo dei record di controllo e dei file di registro.

MLS avanzate AEM aem-advanced-mls

Per la raccolta SRP (MSRP o DSRP) per supportare la ricerca multilingue avanzata (MLS), sono necessari nuovi plug-in Solr oltre a uno schema personalizzato e una configurazione Solr. Tutti gli elementi richiesti vengono assemblati in un file zip scaricabile.

Il download avanzato di MLS (noto anche come 'phasetwo') è disponibile dall'archivio Adobe:

  • Fasetwo AEM-SOLR-MLS

    Per ottenere il pacchetto MLS avanzato, vedi MLS avanzate AEM nella sezione implementazione della documentazione.

    • Versione 1.2.40, 6 aprile 2016
    • Scarica AEM-SOLR-MLS-phasetwo-1.2.40.zip

Per informazioni dettagliate e sull'installazione, visita Configurazione Solr per SRP

Pacchetti visibili in Adobe AEM Cloud

I collegamenti ai pacchetti in questa pagina non richiedono alcuna istanza in esecuzione di AEM in quanto devono condividere i pacchetti in adobeaemcloud.com. Mentre i pacchetti sono visualizzabili, la InstallIl pulsante è per installare i pacchetti in un sito ospitato da Adobe. Se si desidera eseguire l'installazione in un'istanza AEM locale, selezionare Installgenererà un errore.

Come eseguire l'installazione su un'istanza AEM locale

Per installare i pacchetti visibili in adobeaemcloud.com in un'istanza AEM locale, il pacchetto deve prima essere scaricato su un disco locale:

  • Seleziona la Risorse scheda
  • Seleziona scaricare su disco

Nell’istanza di AEM locale, utilizza il gestore dei pacchetti (ad esempio http://localhost:4502/crx/packmgr/), per caricare nell’archivio locale dei pacchetti AEM.

In alternativa, puoi accedere al pacchetto utilizzando la condivisione del pacchetto dall’istanza AEM locale (ad esempio, http://localhost:4502/crx/packageshare/), Downloadverrà scaricato nell’archivio dei pacchetti dell’istanza AEM locale.

Una volta nell'archivio dei pacchetti dell'istanza AEM locale, utilizza il gestore dei pacchetti per installare il pacchetto.

Per ulteriori informazioni, visita Come lavorare con i pacchetti.

Implementazioni consigliate recommended-deployments

In AEM Communities, un archivio comune viene utilizzato per memorizzare i contenuti generati dagli utenti (UGC) e viene spesso indicato come provider di risorse di archiviazione (SRP). La distribuzione consigliata si basa sulla scelta di un’opzione SRP per lo store comune.

L'archivio comune supporta la moderazione e l'analisi degli UGC nell'ambiente di pubblicazione, eliminando al contempo la necessità di replica dell'UGC.

Aggiornamento upgrading

Quando esegui l’aggiornamento alla piattaforma AEM 6.4 dalle versioni precedenti di AEM, è importante leggere Aggiornamento a AEM 6.4.

Oltre all’aggiornamento della piattaforma, consulta Aggiornamento ad AEM Communities 6.4 per informazioni sulle modifiche apportate a Communities.

Configurazioni configurations

Editore principale primary-publisher

Quando la distribuzione scelta è un pubblica azienda, quindi un'istanza di pubblicazione AEM deve essere identificata come primary publisher per le attività che non devono verificarsi su tutte le istanze, ad esempio le funzionalità che si basano su Notifiche o Adobe Analytics.

Per impostazione predefinita, la AEM Communities Publisher Configuration La configurazione OSGi è configurata con Primary Publisher selezionata, in modo che tutte le istanze di pubblicazione in una farm di pubblicazione si identifichino come principali.

È pertanto necessario modifica la configurazione in tutte le istanze di pubblicazione secondarie per deselezionare Primary Publisher casella di controllo.

chlimage_1-411

Per tutte le altre istanze di pubblicazione (secondarie) in una farm di pubblicazione:

Agenti di replica sull’autore replication-agents-on-author

La replica viene utilizzata per il contenuto del sito creato nell’ambiente di pubblicazione, ad esempio i gruppi della community, nonché per la gestione di membri e gruppi di membri dall’ambiente di authoring tramite l’ servizio tunnel.

Per l'editore principale, assicurati che Configurazione dell'agente di replica identifica correttamente il server di pubblicazione e l'utente autorizzato. Utente autorizzato predefinito, admin, dispone già delle autorizzazioni appropriate (è membro di Communities Administrators).

Affinché un altro utente disponga delle autorizzazioni appropriate, deve essere aggiunto come membro al administrators gruppo di utenti (anche membro di Communities Administrators).

Nell’ambiente di authoring sono disponibili due agenti di replica che richiedono la configurazione corretta del trasporto.

  • Accedere alla console Replica sull’autore

    • Dalla navigazione globale: Strumenti > Implementazione > Replica > Agenti sull’autore
  • Seguire la stessa procedura per entrambi gli agenti:

    • Agente predefinito (pubblicazione)

    • Agente di replica inversa (pubblicazione inversa)

      1. Seleziona l'agente
      2. Seleziona modifica
      3. Seleziona la Trasporti scheda
      4. Se non la porta 4503, modifica il URI per specificare la porta corretta
      5. Se non utente admin, modifica il Utente e Password per specificare un membro della administrators gruppo utenti

Le immagini seguenti mostrano i risultati della modifica della porta da 4503 a 6103:

Agente predefinito (pubblicazione) default-agent-publish

chlimage_1-412

Agente di replica inversa (pubblicazione inversa) reverse-replication-agent-publish-reverse

chlimage_1-413

Servizio tunnel su Autore tunnel-service-on-author

Quando si utilizza l’ambiente di authoring in creare siti, modificare le proprietà del sito o gestire membri della community, è necessario accedere ai membri (utenti) registrati nell’ambiente di pubblicazione, non agli utenti registrati sull’autore.

Il servizio tunnel fornisce questo accesso utilizzando l'agente di replica sull'autore.

Per attivare il servizio tunnel:

chlimage_1-414

Replicare la chiave Crypto replicate-the-crypto-key

Esistono due funzioni di AEM Communities che richiedono che tutte le istanze AEM server utilizzino le stesse chiavi di crittografia. Questi sono Analytics e ASRP.

A partire da AEM 6.3, il materiale chiave viene memorizzato nel file system e non più nel repository.

Per copiare il materiale chiave dall’autore a tutte le altre istanze, è necessario:

  • Accedi all'istanza AEM, in genere un'istanza dell'autore, che contiene il materiale chiave da copiare

    • Individua il com.adobe.granite.crypto.file nel file system locale

      Ad esempio:

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • La bundle.info il file identificherà il bundle
    • Passa alla cartella dati

      Ad esempio:

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Copia i file hmac e i file dei nodi principali

  • Per ogni istanza AEM target

    • Passa alla cartella dati

      Ad esempio:

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Incolla i 2 file precedentemente copiati

    • È necessario aggiorna il bundle Granite Crypto se l’istanza di AEM di destinazione è attualmente in esecuzione

CAUTION
Se è già stata configurata un’altra funzione di sicurezza basata sulle chiavi crittografiche, la replica delle chiavi crittografiche potrebbe danneggiare la configurazione. Per assistenza, contattare l'assistenza clienti.

Replica dell’archivio repository-replication

È possibile conservare il materiale chiave memorizzato nell'archivio, come nel caso di AEM 6.2 e versioni precedenti, specificando la seguente proprietà di sistema al primo avvio di ogni istanza AEM (che crea l'archivio iniziale):

  • -Dcom.adobe.granite.crypto.file.disable=true
NOTE
È importante verificare che la agente di replica sull'autore è configurato correttamente.

Con il materiale chiave memorizzato nell’archivio, il modo per replicare la chiave crittografica dall’autore ad altre istanze è il seguente:

Utilizzo CRXDE Lite:

chlimage_1-415

Aggiorna il bundle Crypto Granite refresh-the-granite-crypto-bundle

chlimage_1-416

  • Dopo un momento, un Completato viene visualizzata la finestra di dialogo:

    Operation completed successfully.

Server HTTP Apache apache-http-server

Se utilizzi il server HTTP Apache, assicurati di utilizzare il nome server corretto per tutte le voci pertinenti.

In particolare, fare attenzione a utilizzare il nome server corretto, non localhost, nella RedirectMatch.

campione 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

Se utilizzi un’istanza di Dispatcher, consulta:

Documentazione di Communities correlata related-communities-documentation

  • Visita Amministrazione di siti di Communities per informazioni sulla creazione di un sito community, sulla configurazione di modelli di sito community, sulla moderazione dei contenuti della community, sulla gestione dei membri e sulla configurazione della messaggistica.

  • Visita Sviluppo di Communities per informazioni sul framework dei componenti sociali (SCF) e sulla personalizzazione dei componenti e delle funzionalità di Communities.

  • Visita Authoring dei componenti di Communities per scoprire come creare e configurare i componenti di Communities.

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