Distribuzione di Communities

Prerequisiti

Elenco di controllo installazione

Per la piattaforma AEM

Per la funzionalità Community

Ultime versioni

AEM 6.4 Communities GA include il pacchetto Community. Per informazioni sugli aggiornamenti di AEM 6.4 Communities, consultare le AEM 6.4 Note sulla versione.

Aggiornamenti di AEM 6.4

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

Per gli ultimi aggiornamenti a AEM 6.4, verificare Adobe Experience Manager 6.4 Cumulative Fix Pack and Service Pack.

Cronologia versioni

Come AEM 6.4 e oltre, funzionalità AEM Communities e hotfix fanno parte pacchetti di correzioni e Service Pack cumulativi AEM Communities. Non esistono pertanto pacchetti di caratteristiche distinti.

Driver JDBC per MySQL

Due funzionalità Community utilizzano un database MySQL:

  • Per enablement: registrazione delle attività SCORM e degli studenti
  • Per DSRP: memorizzazione di contenuto generato dall'utente (UGC)

Il connettore MySQL deve essere ottenuto e installato separatamente.

Le misure necessarie sono:

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

    • La versione deve essere >= 5.1.38

  2. Estrarre mysql-Connector-java-<versione>-bin.jar (bundle) dall'archivio

  3. Utilizzate 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
    • Verificare che il driver JDBC di Oracle Corporation per MySQLcom.mysql.jdbc sia attivo e avviarlo in caso contrario (o controllare i registri)

  4. Se l'installazione avviene su una distribuzione esistente dopo la configurazione di JDBC, eseguire un nuovo riferimento JDBC al nuovo connettore salvando nuovamente la configurazione JDBC dalla console Web:

    • Ad esempio, http://localhost:4502/system/console/configMgr
    • Individua configurazione Day Commons JDBC Connections Pool
    • Seleziona per aprire
    • Seleziona Save

  5. Ripetere i passaggi 3 e 4 per tutte le istanze di creazione e pubblicazione

Ulteriori informazioni sull'installazione dei bundle sono disponibili nella pagina Console Web.

Esempio: Bundle del connettore MySQL installato

chlimage_1-410

Pacchetto SCORM

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

Il motore AEM Communities SCORM è richiesto per la funzione enablement. I pacchetti scorm supportati versione AEM Communities 6.4 sono:

Per una nuova installazione del motore SCORM, utilizzare 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 per la prima volta un pacchetto SCORM

  1. Installare il pacchetto cq-social-scorm-package, versione 2.2.2.
  2. Scaricate /libs/social/config/scorm/database_scormengine_data.sql dall'istanza cq ed eseguitelo in server mysql per creare uno schema scormEngineDB aggiornato.
  3. Aggiungete /content/communities/scorm/RecordResults nella proprietà Paths esclusi nel filtro CSRF da https://<hostname>;:<port>/system/console/configMgr agli 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.

NOTA

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. Installare il pacchetto cq-social-scorm-package, versione 2.2.2.

  3. Scaricate il pacchetto da /libs/social/config/scorm/ScormEngine.zip ed estraete lo stesso.

  4. Andate alla cartella Installer della directory estratta.

  5. Aggiornate SystemDatabaseConnectionString con il scorm db connection url nel file EngineInstall.xml.

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

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

  7. Monitorare il file engine_upgrade.log per qualsiasi tipo di errore e stato di aggiornamento dello schema.

  8. Aggiungere /content/communities/scorm/RecordResults nella proprietà Paths esclusi nel filtro CSRF da https://<hostname>:<port>/system/console/configMgr agli editori.

Registrazione SCORM

Durante l'installazione, tutte le attività di abilitazione vengono registrate in modo dettagliato nella console del sistema.

Se necessario, il livello di registro può essere impostato su WARN per il pacchetto RusticiSoftware.*.

Per utilizzare i file di registro, vedere Uso dei record di controllo e dei file di registro.

AEM MLS avanzate

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 alla 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 del Adobe :

Per informazioni dettagliate e sull'installazione, visitare Configurazione solr per SRP.

Pacchetti visibili in Adobe AEM Cloud

I collegamenti ai pacchetti in questa pagina non richiedono alcuna istanza di AEM in esecuzione, in quanto devono creare pacchetti di condivisione su adobeaemcloud.com. Mentre i pacchetti sono visualizzabili, il pulsante Installconsente di installare i pacchetti in un sito ospitato Adobe. Se si desidera eseguire l'installazione in un'istanza AEM locale, la selezione di Installcauserà un errore.

Come eseguire l'installazione sull'istanza AEM locale

Per installare i pacchetti visibili in adobeaemcloud.com in un'istanza AEM locale, è necessario prima scaricare il pacchetto su un disco locale:

  • Selezionare la scheda Risorse
  • Selezionare download su disco

Nell'istanza AEM locale, utilizzate il gestore pacchetti (ad esempio http://localhost:4502/crx/packmgr/) per caricare nell'archivio AEM pacchetto locale.

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

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

Per ulteriori informazioni, vedere Come utilizzare i pacchetti.

In AEM Communities, uno store comune viene utilizzato per memorizzare il contenuto generato dall'utente (UGC) ed è spesso denominato provider di risorse di storage (SRP). La distribuzione consigliata si basa sulla scelta di un'opzione SRP per lo store comune.

Lo store comune supporta la moderazione e l'analisi di UGC nell'ambiente di pubblicazione, eliminando al contempo la necessità di replica di UGC.

  • Archivio contenuti community: illustra le opzioni di storage SRP per le comunità AEM

  • Topologie consigliate: illustra la topologia da utilizzare in base al caso di utilizzo e alla scelta SRP

Aggiornamento

Quando eseguite l'aggiornamento alla piattaforma AEM 6.4 dalle versioni precedenti di AEM, è importante leggere Aggiornamento alla AEM 6.4.

Oltre ad aggiornare la piattaforma, leggere Aggiornamento ad AEM Communities 6.4 per informazioni sulle modifiche apportate a Communities.

Configurazioni

Editore principale

Se la distribuzione scelta è una farm di pubblicazione, 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 funzioni che si basano su notifiche o Adobe Analytics.

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

Pertanto, è necessario modificare la configurazione in tutte le istanze di pubblicazione secondarie per deselezionare la casella di controllo Primary Publisher.

chlimage_1-411

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

Agenti di replica sull'autore

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

Per l'editore principale, assicurarsi che Replication Agent Config identifichi correttamente il server di pubblicazione e l'utente autorizzato. L'utente autorizzato predefinito, admin, dispone già delle autorizzazioni appropriate (è un membro di Communities Administrators).

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

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

  • Accedere alla console Replica durante l’authoring

    • Dalla navigazione globale: Strumenti > Distribuzione > Replica > Agenti sull'autore

  • Seguire la stessa procedura per entrambi gli agenti:

    • Agente predefinito (pubblicazione)

    • Agente replica inversa (pubblicazione invertita)

      1. Selezionare l'agente
      2. Selezionare edit
      3. Selezionare la scheda Trasporto
      4. Se non è presente la porta 4503, modificare l' URI per specificare la porta corretta
      5. Se non l'utente admin, modificare i valori User e Password per specificare un membro del gruppo di utenti administrators

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

Agente predefinito (pubblicazione)

chlimage_1-412

Agente replica inversa (pubblicazione inversa)

chlimage_1-413

Servizio Tunnel sull'autore

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

Il servizio tunnel fornisce questo accesso tramite l'agente di replica in fase di creazione.

Per abilitare il servizio tunnel:

chlimage_1-414

Replicare la chiave di crittografia

Esistono due funzionalità di AEM Communities che richiedono che tutte AEM istanze del server utilizzino le stesse chiavi di crittografia. Si tratta di Analytics e ASRP.

A partire dal AEM 6.3, il materiale chiave è memorizzato nel file system e non più nella directory archivio.

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

  • Accedere all'istanza AEM, in genere un'istanza di creazione, che contiene il materiale chiave da copiare

    • Individuare il pacchetto com.adobe.granite.crypto.file nel file system locale

      Esempio,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • Il file bundle.info identificherà il bundle

    • Accedere alla cartella dei dati

      Esempio,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data

    • Copiare i file hmac e i file dei nodi principali

  • Per ogni istanza di AEM di destinazione

    • Accedere alla cartella dei dati

      Esempio,

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data

    • Incolla i 2 file precedentemente copiati

    • È necessario aggiornare il bundle Granite Crypto se l'istanza AEM di destinazione è in esecuzione

ATTENZIONE

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

Replica archivio

È 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
NOTA

È importante verificare che l'agente di replica in author sia configurato correttamente.

Con il materiale chiave memorizzato nella directory archivio, la procedura per replicare la chiave di crittografia dall’autore ad altre istanze è la seguente:

Utilizzando CRXDE Lite:

chlimage_1-415

Aggiornare il pacchetto Granite Crypto

chlimage_1-416

  • Dopo un momento, viene visualizzata una finestra di dialogo Success:

    Operation completed successfully.

Server Apache HTTP

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

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

httpd.conf, esempio

<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

Se utilizzi un dispatcher, vedi:

  • Per informazioni su come creare un sito community, configurare i modelli di sito community, moderare i contenuti della community, gestire i membri e configurare i messaggi, visitate Administering Communities Sites.

  • Visitate Developing Communities per informazioni sul framework dei componenti social network (SCF) e sulla personalizzazione dei componenti e delle funzioni di Communities.

  • Per informazioni su come creare e configurare i componenti di Communities, visita Componenti di authoring.

In questa pagina