Distribuzione di Communities

Prerequisiti

Elenco di controllo dell'installazione

Per la piattaforma AEM

Per la funzionalità Community

Versioni più recenti

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

Aggiornamenti di AEM 6.4

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 versioni

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

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 il driver JDBC di Oracle Corporation per MySQLcom.mysql.jdbc sia 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 la configurazione Day Commons JDBC Connections Pool
    • 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 nella pagina Console web .

Esempio: Bundle del connettore MySQL installato

chlimage_1-410

Pacchetto SCORM

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 è necessario per la funzione enablement . I pacchetti Scorm supportati nella 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 un pacchetto SCORM per la prima volta

  1. Installa il pacchetto cq-social-scorm-package, versione 2.2.2.
  2. Scarica /libs/social/config/scorm/database_scormengine_data.sql dall'istanza cq ed eseguilo in mysql server per creare uno schema scormEngineDB aggiornato.
  3. Aggiungi /content/communities/scorm/RecordResults nella proprietà Percorsi 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. Installa il pacchetto cq-social-scorm-package, versione 2.2.2.

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

  4. Vai alla cartella Installer della directory estratta.

  5. Aggiorna SystemDatabaseConnectionString con il tuo scorm db connection url nel 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. Monitora il file engine_upgrade.log per qualsiasi tipo di errore e stato di aggiornamento dello schema.

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

Registrazione SCORM

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 il pacchetto RusticiSoftware.*.

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

MLS avanzate AEM

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 AEM MLS avanzate nella sezione di distribuzione 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 solare 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, il pulsante Installè per installare i pacchetti in un sito ospitato da Adobe. Se desideri eseguire l’installazione su un’istanza AEM locale, la selezione di Installgenera un errore.

Come eseguire l'installazione su un'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:

  • Seleziona la scheda Risorse
  • Seleziona scarica su disco

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

In alternativa, per accedere al pacchetto utilizzando la condivisione del pacchetto dall'istanza AEM locale (ad esempio, http://localhost:4502/crx/packageshare/), il pulsante 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.

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

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

  • Topologie consigliate: discute la topologia da utilizzare in base al caso d’uso e alla scelta dell’SRP

Aggiornamento

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

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

Configurazioni

Editore principale

Quando 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 funzionalità 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 su 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 i contenuti del sito creati nell'ambiente di pubblicazione, ad esempio i gruppi di community, nonché per la gestione di membri e gruppi di membri dall'ambiente di authoring tramite il servizio tunnel.

Per l'editore principale, assicurati che Replication Agent Config identifichi correttamente il server di pubblicazione e l'utente autorizzato. L'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 gruppo di utenti administrators (anche un 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 su 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 scheda Trasporto
      4. Se non è presente la porta 4503, modificare l' URI per specificare la porta corretta
      5. Se non l'utente admin, modifica Utente 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:

Agente predefinito (pubblicazione)

chlimage_1-412

Agente di replica inversa (pubblicazione inversa)

chlimage_1-413

Servizio tunnel su Autore

Quando si utilizza l'ambiente di authoring per creare siti, modificare 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

Esistono due funzioni di AEM Communities che richiedono che tutte le istanze AEM server utilizzino le stesse chiavi di crittografia. Si tratta di 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 bundle 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

    • Passa alla cartella dati

      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

      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 di AEM di destinazione è attualmente in esecuzione

ATTENZIONE

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

Replica dell’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 su author sia configurato correttamente.

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

Utilizzando CRXDE Lite:

chlimage_1-415

Aggiorna il bundle Crypto Granite

chlimage_1-416

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

    Operation completed successfully.

Server HTTP Apache

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

In particolare, fai attenzione a utilizzare il nome server corretto, non localhost, nel RedirectMatch.

campione httpd.conf

<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’istanza di Dispatcher, consulta:

  • Per informazioni su come creare un sito community, configurare modelli di sito community, moderare i contenuti della community, gestire i membri e configurare i messaggi, visita Amministrazione siti community .

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

  • Per informazioni su come eseguire l’authoring con e configurare i componenti di Communities, visita Authoring Communities Components .

In questa pagina