Show Menu
ARGOMENTI×

Implementazione di Communities

Elenco di controllo dell'installazione

Per la piattaforma AEM
Per la funzionalità Community

Latest Releases

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

Aggiornamenti di AEM 6.4

A partire da AEM 6.3, gli aggiornamenti alle community vengono forniti come parte dei Service Pack e dei pacchetti AEM Cumulative Fix.
Per gli ultimi aggiornamenti ad AEM 6.4, verifica Adobe Experience Manager 6.4 Cumulative Fix Pack e Service Pack .

Cronologia versioni

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

Driver JDBC per MySQL

Due funzionalità Community utilizzano un database MySQL:
  • Per l' abilitazione : 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:
    • La versione deve essere >= 5.1.38
  1. Estrarre mysql-Connector-java-<versione>-bin.jar (bundle) dall'archivio
  2. 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)
  3. 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 Day Commons JDBC Connections Pool configurazione
    • Seleziona per aprire
    • Seleziona Save
  4. 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 Bundle Web.

Esempio: Bundle del connettore MySQL installato

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 SCORM AEM Communities è richiesto per la funzione di abilitazione . 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 per la prima volta un pacchetto SCORM

  1. Installate il pacchetto cq-social-scorm, versione 2.2.2 .
  2. Scaricate /libs/social/config/scorm/database_scormengine_data.sql dall'istanza cq ed eseguitela in server mysql per creare uno schema scormEngineDB aggiornato.
  3. Aggiungi /content/communities/scorm/RecordResults nella proprietà Percorsi esclusi nel filtro CSRF dagli https://<hostname>;:<port>/system/console/configMgr editori.
Le installazioni SCORM esistenti possono essere aggiornate al pacchetto cq-social-scorm, versione 2.2.2 (che utilizza SCORM 2017.1 ), se il contenuto del corso creato richiede SCORM 2017.1.
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. Installate il pacchetto cq-social-scorm, 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. Eseguire l'aggiornamento SystemDatabaseConnectionString con il file scorm db connection url in 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 engine_upgrade.log i file per qualsiasi tipo di errore e stato di aggiornamento dello schema.
  8. Aggiungi /content/communities/scorm/RecordResults nella proprietà Percorsi ​esclusi nel filtro CSRF https://<hostname>:<port>/system/console/configMgr dagli editori.

Registrazione SCORM

Durante l'installazione, tutte le attività di abilitazione vengono registrate in modo dettagliato nella console del sistema.
Se desiderato, il livello di registro può essere impostato su WARN per il RusticiSoftware.* pacchetto.
Per utilizzare i registri, vedere Uso dei record di controllo e dei file di registro.

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 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 di Adobe:
Per informazioni dettagliate e sull'installazione, visitare Configurazione Configurazione Solr per SRP solare per SRP.

Aggiornamento

Quando effettuate l’aggiornamento alla piattaforma AEM 6.4 dalle versioni precedenti di AEM, è importante leggere Aggiornamento ad AEM 6.4.
Oltre ad aggiornare la piattaforma, leggi Aggiornamento agli 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 in tutte le istanze, ad esempio per le funzioni che si basano su notifiche o su Adobe Analytics .
Per impostazione predefinita, la configurazione AEM Communities Publisher Configuration OSGi è configurata con la Primary Publisher casella di controllo 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 Primary Publisher casella di controllo.
Per tutte le altre istanze di pubblicazione (secondarie) in una farm di pubblicazione:
  • Accesso con privilegi di amministratore
  • Accedere alla console Web
  • Individua la variabile AEM Communities Publisher Configuration
  • Selezionate l’icona di modifica
  • Deselezionare la casella Editore ​principale
  • Seleziona Salva

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 tramite il servizio Servizio Tunnel sull'autore tunnel.
Per l'editore principale, accertatevi 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 administrators utenti (anche 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 per l&#39;autore
  • Seguire la stessa procedura per entrambi gli agenti:
    • Agente predefinito (pubblicazione)
    • Agente replica inversa (pubblicazione invertita)
      1. Selezionare l'agente
      2. Select edit
      3. Select the Transport tab
      4. Se non è una porta 4503 , modificate l' URI per specificare la porta corretta
      5. In caso contrario, modificate admin l’ utente e la password per specificare un membro del gruppo di administrators utenti
Le immagini seguenti mostrano i risultati della modifica della porta da 4503 a 6103 tramite:

Agente predefinito (pubblicazione)

Agente replica inversa (pubblicazione invertita)

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:

Replicare la chiave Crypto

Esistono due funzioni dei AEM Communities che richiedono che tutte le istanze del server AEM 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ù nell’archivio.
Per copiare il materiale chiave dall’autore a tutte le altre istanze, è necessario:
  • Accedete all’istanza di AEM, in genere un’istanza di creazione, che contiene il materiale chiave da copiare
    • Individuare il com.adobe.granite.crypto.file bundle nel file system locale
      Ad esempio,
      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • Il bundle.info file identificherà il bundle
    • Accedere alla cartella dei dati
      Ad esempio,
      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Copiare i file hmac e i file dei nodi principali
  • Per ogni istanza AEM di destinazione
    • Accedere alla cartella dei 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 AEM di destinazione è in esecuzione
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, contattate 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 di AEM (che crea l’archivio iniziale):
  • -Dcom.adobe.granite.crypto.file.disable=true
È importante verificare che l'agente di replica nell'istanza di creazione 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:
Utilizzo di CRXDE Lite :

Aggiornare il pacchetto Granite Crypto

  • Dopo un momento, dovrebbe comparire una finestra di dialogo Successo :
    Operation completed successfully.

Apache HTTP Server

Se utilizzate il server Apache HTTP, accertatevi di utilizzare il nome server corretto per tutte le voci pertinenti.
In particolare, fate attenzione a utilizzare il nome corretto del server, non localhost nel 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: