Distribuzione di Communities

Prerequisiti

Elenco di controllo dell'installazione

Per la piattaforma AEM

Per la funzionalità Community

Versioni più recenti

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

Aggiornamenti di AEM 6.5

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

Per gli ultimi aggiornamenti su AEM 6.5, consulta 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, https://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 effettui l’installazione su un’implementazione esistente dopo la configurazione di JDBC, fai di nuovo riferimento a JDBC nel nuovo connettore salvando nuovamente la configurazione JDBC dalla console web :

    • Ad esempio, https://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

connettore-bundle

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 . Pacchetti Scorm supportati su AEM 6.5 Communities:

Per installare un pacchetto SCORM

  1. Installa il cq-social-scorm-package, versione 2.3.7 da Package Share.
  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.

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 consente di installare i pacchetti in un sito ospitato da Adobe. Se si intende eseguire l'installazione su un'istanza AEM locale, la selezione di Install genererà 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 https://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, https://localhost:4502/crx/packageshare/), il pulsante Download verrà 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

Durante l'aggiornamento alla piattaforma AEM 6.5 dalle versioni precedenti di AEM, è importante leggere Aggiornamento a AEM 6.5.

Oltre ad aggiornare la piattaforma, leggi Aggiornamento ad AEM Communities 6.5 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.

editore principale

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, passa a Strumenti > Implementazione > Replica > Agenti sull'autore
  • Segui 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)

default-agent-publish

Agente di replica inversa (pubblicazione inversa)

agente di replica inversa

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:

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 dal 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,
      ad esempio,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • Il file bundle.info identificherà il bundle
    • Accedi 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

    • Accedi alla cartella dati,
      ad 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:

Aggiorna il bundle Crypto Granite

  • Su ogni istanza di pubblicazione, accedi alla Console web

  • Individua il bundle Adobe Granite Crypto Support (com.adobe.granite.crypto)

  • Seleziona Aggiorna

    cripto di granito

  • 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