Implementación de comunidades

Requisitos previos

Lista de comprobación de la 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 AEM Notas de la versión 6.4.

Actualizaciones de AEM 6.4

A partir de AEM 6.3, las actualizaciones a las comunidades se entregan como parte de AEM paquetes de correcciones acumulativas y Service Packs.

Para las últimas actualizaciones de AEM 6.4, asegúrese de comprobar Paquetes de correcciones acumulativas y Service Packs 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 habilitación: grabación de actividades y alumnos SCORM
  • Para DSRP: almacenamiento de contenido generado por el usuario (UGC)

El conector MySQL debe obtenerse e instalarse por separado.

Los pasos necesarios son:

  1. Descargue el archivo ZIP de https://dev.mysql.com/downloads/connector/j/

    • La versión debe ser >= 5.1.38

  2. Extraer mysql-Connector-java-<version>-bin.jar (paquete) del archivo

  3. Utilice la consola web para instalar y inicio del 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 inicio si no (o compruebe los registros)

  4. 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 la configuración Day Commons JDBC Connections Pool
    • Seleccionar para abrir
    • Seleccione Save

  5. 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 web.

Ejemplo: Paquete de conector MySQL instalado

chlimage_1-410

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 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. Instale el paquete cq-social-scorm, versión 2.2.2.
  2. 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.
  3. Añada /content/communities/scorm/RecordResults en la propiedad Rutas excluidas del filtro CSRF de https://<hostname>;:<port>/system/console/configMgr en 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.

NOTA

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. Haga una copia de seguridad del esquema ScormEngineDB.

  2. Instale el paquete cq-social-scorm, versión 2.2.2.

  3. Descargue el paquete de /libs/social/config/scorm/ScormEngine.zip y extraiga el mismo.

  4. Vaya a la carpeta Installer del directorio extraído.

  5. Actualice SystemDatabaseConnectionString con su scorm db connection url archivo EngineInstall.xml.

  6. 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

  7. Monitoree el archivo engine_upgrade.log para cualquier tipo de error y estado de actualización de esquema.

  8. Añada /content/communities/scorm/RecordResults en la propiedad Rutas excluidas en el filtro CSRF de https://<hostname>:<port>/system/console/configMgr en 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 paquete RusticiSoftware.*.

Para trabajar con registros, consulte Uso de registros de auditoría y archivos de registro.

MLS AEM avanzado

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 una configuración personalizada de esquema y 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 Configuración de Solr para SRP.

Paquetes visibles en Adobe AEM Cloud

Los vínculos a los paquetes de esta página no requieren ninguna instancia de AEM en ejecución, ya que son para el uso compartido de paquetes en adobeaemcloud.com. Mientras los paquetes son visibles, el botón Installes para instalar los paquetes en un sitio alojado de Adobe. Si desea realizar la instalación en una instancia de AEM local, al seleccionar Installse producirá un error.

Cómo instalar en una instancia de AEM local

Para instalar los paquetes visibles en adobeaemcloud.com en una instancia de AEM local, el paquete debe descargarse primero en un disco local:

  • Seleccione la ficha Recursos
  • Seleccione descargar al disco

En la instancia de AEM local, utilice el administrador de paquetes (por ejemplo, http://localhost:4502/crx/packmgr/) para cargar en el repositorio de paquetes de AEM local.

Como alternativa, si accede al paquete mediante el uso compartido de paquetes desde la instancia de AEM local (por ejemplo, http://localhost:4502/crx/packageshare/), el botón Downloadse descargará en el repositorio de paquetes de la instancia de AEM local.

Una vez en el repositorio de paquetes de la instancia de AEM local, utilice el administrador de paquetes para instalar el paquete.

Para obtener más información, visite Cómo trabajar con paquetes.

En AEM Communities, un almacén común se utiliza para almacenar contenido generado por el usuario (UGC) y a menudo se denomina proveedor de recursos de almacenamiento (SRP). La implementación recomendada se centra en elegir una opción de SRP para la tienda común.

El almacén común admite moderación y análisis de UGC en el entorno de publicación, al tiempo que elimina la necesidad de replicación de UGC.

  • Almacenamiento de contenido de la comunidad: analiza las opciones de almacenamiento de SRP para las comunidades AEM

  • Topologías recomendadas: analiza la topología que se va a usar en función del caso de uso y la opción de 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 primary publisher para 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 OSGi AEM Communities Publisher Configuration se configura con la casilla Primary Publisher marcada, de modo que todas las instancias de publicación de un conjunto de servidores de publicación se identifican como principales.

Por lo tanto, es necesario editar la configuración en todas las instancias de publicación secundarias para desmarcar la casilla Primary Publisher.

chlimage_1-411

Para el resto de instancias de publicación (secundarias) en un conjunto de servidores de publicación:

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 identifica 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 usuarios administrators (también miembro de Communities Administrators).

Hay dos agentes de replicación en el entorno de creación que necesitan configurar correctamente la configuración de transporte.

  • 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 en sentido inverso)

      1. Seleccione el agente
      2. Seleccione editar
      3. Seleccione la ficha Transporte
      4. Si no es el puerto 4503, edite el URI para especificar el puerto correcto
      5. Si no es el usuario admin, edite los Usuarios y Contraseña para especificar un miembro del grupo de usuarios administrators

Las siguientes imágenes muestran los resultados de cambiar el puerto de 4503 a 6103 por:

Agente predeterminado (publicación)

chlimage_1-412

Agente de replicación inversa (publicar en sentido inverso)

chlimage_1-413

Servicio de túnel en Autor

Al utilizar el entorno de creación para crear sitios, modificar propiedades del sitio o administrar miembros de la comunidad, es necesario tener acceso 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:

chlimage_1-414

Replicar la clave de cifrado

Existen dos funciones de AEM Communities 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

    • Localice el paquete com.adobe.granite.crypto.file en el sistema de archivos local

      Por ejemplo,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • El archivo bundle.info identificará el paquete

    • Navegar a la carpeta de datos

      Por ejemplo,

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

    • Copiar los archivos hmac y principal del nodo

  • Para cada instancia de AEM destinatario

    • 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 destinatario AEM se está ejecutando en ese momento

ATENCIÓN

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 tener el material clave 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
NOTA

Es importante verificar que el agente de replicación del autor está configurado correctamente.

Con el material clave almacenado en el repositorio, la manera de replicar la clave criptográfica de autor a otras instancias es la siguiente:

Usando CRXDE Lite:

chlimage_1-415

Actualizar el paquete de criptografía de granito

chlimage_1-416

  • Después de un momento, debería aparecer un cuadro de diálogo Éxito:

    Operation completed successfully.

Servidor HTTP Apache

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:

  • Visite Administración de sitios de comunidades para obtener información sobre cómo crear un sitio de comunidad, configurar plantillas de sitio de comunidad, moderar contenido de comunidad, administrar miembros y configurar mensajes.

  • Visite Desarrollar comunidades para conocer el marco de componentes sociales (SCF) y personalizar componentes y características de Communities.

  • Visite Creación de componentes de comunidades para obtener información sobre cómo crear y configurar componentes de comunidades.

En esta página