Show Menu
TEMAS×

Implementación de comunidades

Requisitos previos

Lista de comprobación de instalación

Para la plataforma AEM
Para la capacidad de Comunidades

Últimas versiones

AEM 6.4 Communities GA incluye el paquete Communities. Para obtener información sobre las actualizaciones de AEM 6.4 Communities , consulte las Notas de la versión de AEM 6.4.

Actualizaciones de AEM 6.4

A partir de AEM 6.3, las actualizaciones de Communities se entregan como parte de los paquetes de correcciones acumulativas de AEM y los paquetes de servicios.
Para obtener las últimas actualizaciones de AEM 6.4, asegúrese de comprobar los paquetes de correcciones acumulativas y los paquetes de servicios de Adobe Experience Manager 6.4 .

Historial de versiones

Al igual que en AEM 6.4 y versiones posteriores, las funciones y revisiones de AEM Communities forman parte de los paquetes de correcciones y los Service Packs acumulativos de AEM Communities. Por lo tanto, no hay paquetes de funciones independientes.

Controlador JDBC para MySQL

Dos funciones de Communities utilizan una base de datos MySQL:
  • Para la habilitación : grabación de actividades y alumnos de SCORM
  • Para DSRP : almacenamiento de contenido generado por el usuario (UGC)
El conector MySQL debe obtenerse e instalarse por separado.
Los pasos necesarios son:
    • La versión debe ser >= 5.1.38
  1. Extraer mysql-Connector-java-<version>-bin.jar (paquete) del archivo
  2. Utilice la consola web para instalar e iniciar el paquete:
    • Por ejemplo, http://localhost:4502/system/console/bundles
    • Seleccione Install/Update
    • Examinar... para seleccionar el paquete extraído del archivo ZIP descargado
    • Compruebe que el controlador JDBC de Oracle Corporation para MySQLcom.mysql.jdbc está activo y comience si no (o compruebe los registros)
  3. Si realiza la instalación en una implementación existente después de haber configurado JDBC, vuelva a conectar JDBC al nuevo conector al volver a guardar la configuración JDBC desde la consola web:
    • Por ejemplo, http://localhost:4502/system/console/configMgr
    • Localizar Day Commons JDBC Connections Pool configuración
    • Seleccionar para abrir
    • Seleccione Save
  4. Repita los pasos 3 y 4 en todas las instancias de creación y publicación
Encontrará más información sobre la instalación de paquetes en la página Consola Paquetes web.

Ejemplo: Paquete de conector MySQL instalado

Paquete SCORM

El Modelo de referencia de objetos de contenido compartido (SCORM) es una colección de estándares y especificaciones para el aprendizaje electrónico. SCORM también define cómo se puede empaquetar el contenido en un archivo ZIP transferible.
El motor SCORM de AEM Communities es necesario para la función de habilitación . Los paquetes de Scorm admitidos en la versión 6.4 de AEM Communities son:
Para una nueva instalación del motor SCORM, debe utilizarse el paquete que contiene SCORM 2017.1 (que es cq -social- scorm -package, versión 2.2.2 ). Para que pueda reproducir recursos de aprendizaje compatibles con SCORM 2017.

Para instalar un paquete SCORM por primera vez

  1. Descargue /libs/social/config/scorm/database_scormengine_data.sql de la instancia de cq y ejecútela en el servidor mysql para crear un esquema de scormEngineDB actualizado.
  2. Agregar /content/communities/scorm/RecordResults en la propiedad Rutas excluidas en el filtro CSRF desde https://<hostname>;:<port>/system/console/configMgr los editores.
Las instalaciones SCORM existentes se pueden actualizar a cq-social-scorm-package, versión 2.2.2 (que utiliza SCORM 2017.1 ), si el contenido del curso creado requiere SCORM 2017.1.
La actualización al paquete SCORM 2017.1 requiere la migración de la base de datos existente (como se explica más adelante).

Para actualizar la versión del motor SCORM

  1. Realice una copia de seguridad del esquema ScormEngineDB.
  2. Descargue el paquete /libs/social/config/scorm/ScormEngine.zip y extraiga el mismo.
  3. Vaya a la carpeta del instalador del directorio extraído.
  4. Actualice SystemDatabaseConnectionString con el scorm db connection url archivo EngineInstall.xml .
  5. Ejecute la herramienta de actualización de esquema mysql en la carpeta del instalador con el comando:
    java -Dlogback.configurationFile=logback.xml -cp "lib/*" RusticiSoftware.ScormContentPlayer.Logic.Upgrade.ConsoleApp EngineInstall.xml
  6. Supervisar engine_upgrade.log archivo para cualquier tipo de error y estado de actualización de esquema.
  7. Agregar /content/communities/scorm/RecordResults en la propiedad Rutas ​excluidas en el filtro CSRF desde https://<hostname>:<port>/system/console/configMgr los editores.

Registro SCORM

Como instalado, toda la actividad de habilitación se registra de forma incorrecta en la consola del sistema.
Si lo desea, el nivel de registro se puede establecer en WARN para el RusticiSoftware.* paquete.
Para trabajar con registros, consulte Uso de registros de auditoría y archivos de registro.

MLS avanzados de AEM

Para que la colección SRP (MSRP o DSRP) admita la búsqueda multilingüe avanzada (MLS), se necesitan nuevos complementos Solr además de un esquema personalizado y una configuración Solr. Todos los elementos necesarios se empaquetan en un archivo zip descargable.
La descarga avanzada de MLS (también conocida como 'phasetwo') está disponible en el repositorio de Adobe:
Para obtener información detallada y sobre la instalación, visite Solr Configuration for SRP.

Actualización

Al actualizar a la plataforma AEM 6.4 desde versiones anteriores de AEM, es importante leer Actualización a AEM 6.4.
Además de actualizar la plataforma, lea Actualización a AEM Communities 6.4 para obtener más información sobre los cambios en las comunidades.

Configuraciones

Editor principal

Cuando la implementación elegida es un conjunto de servidores de publicación, se debe identificar una instancia de publicación de AEM como la primary publisher de las actividades que no deben producirse en todas las instancias, como las funciones que dependen de notificaciones o Adobe Analytics .
De forma predeterminada, la configuración de AEM Communities Publisher Configuration OSGi se configura con la casilla de verificación Primary Publisher activada, de modo que todas las instancias de publicación de un conjunto de servidores de publicación se identificarán como principales.
Por lo tanto, es necesario editar la configuración en todas las instancias de publicación secundarias para desmarcar la Primary Publisher casilla de verificación.
Para el resto de instancias de publicación (secundarias) en un conjunto de servidores de publicación:
  • Iniciar sesión con privilegios de administrador
  • Acceso a la consola web
  • Localice la variable AEM Communities Publisher Configuration
  • Seleccione el icono de edición
  • Desmarcar la casilla Publicador ​principal
  • Seleccione Guardar

Agentes de replicación en el autor

La replicación se utiliza para el contenido del sitio creado en el entorno de publicación, como grupos de la comunidad, así como para administrar miembros y grupos de miembros desde el entorno de creación mediante el servicio de túnel.
Para el publicador principal, asegúrese de que la configuración del agente de replicación identifique correctamente al servidor de publicación y al usuario autorizado. El usuario autorizado predeterminado admin, ya tiene los permisos adecuados (es miembro de Communities Administrators ).
Para que algún otro usuario tenga los permisos adecuados, debe agregarse como miembro al grupo de administrators usuarios (también como miembro de Communities Administrators ).
Hay dos agentes de replicación en el entorno de creación que necesitan que la configuración de transporte esté configurada correctamente.
  • Acceso a la consola de replicación en el autor
    • Desde la navegación global: Herramientas > Implementación > Replicación > Agentes en el autor
  • Siga el mismo procedimiento para ambos agentes:
    • Agente predeterminado (publicación)
    • Agente de replicación inversa (publicar inversa)
      1. Seleccione el agente
      2. Select edit
      3. Select the Transport tab
      4. Si no es un puerto 4503 , edite el URI para especificar el puerto correcto
      5. Si no es usuario admin , edite el usuario y la contraseña para especificar un miembro del grupo de administrators usuarios
Las siguientes imágenes muestran los resultados de cambiar el puerto de 4503 a 6103 por:

Agente predeterminado (publicación)

Agente de replicación inversa (publicar inversa)

Servicio de túnel en el autor

Al utilizar el entorno de creación para crear sitios , modificar propiedades del sitio o administrar miembros de la comunidad, es necesario acceder a los miembros (usuarios) registrados en el entorno de publicación, no a los usuarios registrados en el autor.
El servicio de túnel proporciona este acceso mediante el agente de replicación del autor.
Para habilitar el servicio de túnel:

Replicar la clave de cifrado

Existen dos funciones de Comunidades AEM que requieren que todas las instancias de servidor AEM utilicen las mismas claves de cifrado. Son Analytics y ASRP .
A partir de AEM 6.3, el material clave se almacena en el sistema de archivos y ya no en el repositorio.
Para copiar el material clave del autor en todos los demás casos, es necesario:
  • Acceda a la instancia de AEM, normalmente una instancia de autor, que contiene el material clave que copiar
    • Localizar el com.adobe.granite.crypto.file paquete en el sistema de archivos local
      Por ejemplo,
      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • El bundle.info archivo identificará el paquete
    • Navegar a la carpeta de datos
      Por ejemplo,
      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Copiar los archivos principales y hmac
  • Para cada instancia de AEM de destino
    • Navegar a la carpeta de datos
      Por ejemplo,
      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Pegar los 2 archivos copiados anteriormente
    • Es necesario actualizar el paquete Granite Crypto si la instancia de AEM de destino se está ejecutando en ese momento
Si ya se ha configurado otra característica de seguridad basada en claves criptográficas, replicar las claves criptográficas podría dañar la configuración. Para obtener ayuda, póngase en contacto con el servicio de atención al cliente.

Replicación del repositorio

El hecho de que el material clave esté almacenado en el repositorio, como ocurrió con AEM 6.2 y versiones anteriores, se puede conservar especificando la siguiente propiedad del sistema en el primer inicio de cada instancia de AEM (que crea el repositorio inicial):
  • -Dcom.adobe.granite.crypto.file.disable=true
Es importante verificar que el agente de replicación del autor esté correctamente configurado.
Con el material clave almacenado en el repositorio, la manera de replicar la clave criptográfica de autor a otras instancias es la siguiente:
Uso de CRXDE Lite :

Actualizar el paquete de criptografía de granito

  • Después de un momento, debería aparecer un diálogo de éxito :
    Operation completed successfully.

Apache HTTP Server

Si utiliza el servidor Apache HTTP, asegúrese de utilizar el nombre de servidor correcto para todas las entradas relevantes.
En particular, tenga cuidado de utilizar el nombre de servidor correcto, no localhost , en el RedirectMatch .

muestra de 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

Si utiliza un despachante, consulte: