Implementación de comunidades

Requisitos previos

Lista de comprobación de instalación

Para la plataforma de AEM

Para la capacidad 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 para 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 fijos 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 estudiantes SCORM
  • Para DSRP: almacenamiento del contenido generado por el usuario (UGC)

El conector MySQL debe obtenerse e instalarse por separado.

Los pasos necesarios son:

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

    • La versión debe ser >= 5.1.38

  2. Extraiga mysql-connector-java-<version>-bin.jar (paquete) del archivo

  3. 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, e inícielo 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 y vuelva 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
    • Seleccione para abrir
    • Seleccione Save

  5. Repita los pasos 3 y 4 en todas las instancias de autor 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 compartible (SCORM) es una colección de estándares y especificaciones para el aprendizaje electrónico. SCORM también define cómo el contenido puede empaquetarse en un archivo ZIP transferible.

El motor AEM Communities SCORM es necesario para la función habilitación. Los paquetes de valoración compatibles con la versión 6.4 de AEM Communities son:

Para una nueva instalación del motor SCORM, se debe utilizar el paquete que contiene SCORM 2017.1 (que es cq -social-scorm -package, versión 2.2.2). Para poder reproducir recursos de aprendizaje compatibles con SCORM 2017.

Para instalar un paquete SCORM por primera vez

  1. Instale el cq-social-scorm-package, versión 2.2.2.
  2. Descargue /libs/social/config/scorm/database_scormengine_data.sql de la instancia cq y ejecútela en el servidor mysql para crear un esquema de scormEngineDB actualizado.
  3. Agregue /content/communities/scorm/RecordResults en la propiedad Rutas excluidas del filtro CSRF de https://<hostname>;:<port>/system/console/configMgr a los editores.

Las instalaciones existentes de SCORM 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 cq-social-scorm-package, 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 en el 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. Supervise el archivo engine_upgrade.log para cualquier tipo de error y estado de actualización del esquema.

  8. Agregue /content/communities/scorm/RecordResults en la propiedad Rutas excluidas en el filtro CSRF de https://<hostname>:<port>/system/console/configMgr en los editores.

Registro de 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 configurar como WARN para el paquete RusticiSoftware.*.

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

MLS AEM Advanced

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:

  • AEM-SOLR-MLS-phasetwo

    Para obtener el paquete MLS avanzado, consulte AEM Advanced MLS en la sección de implementación de la documentación.

    • Versión 1.2.40, 6 de abril de 2016
    • Descargue AEM-SOLR-MLS-phasetwo-1.2.40.zip

Para obtener más información sobre la instalación, visite Solr Configuration para SRP.

Paquetes visibles en Adobe AEM Cloud

Los vínculos a paquetes en 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 en Adobe. Si se pretende instalar en una instancia de AEM local, seleccionar Installproducirá un error.

Instalación 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 pestaña Assets
  • 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.

Alternativamente, al acceder al paquete utilizando el paquete compartido 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 el almacén común.

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

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 de Communities.

Configuraciones

Editor principal

Cuando la implementación elegida es una granja de publicación, entonces una instancia de publicación AEM debe identificarse como la primary publisher para 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 OSGi AEM Communities Publisher Configuration se configura con la casilla Primary Publisher marcada, de modo que todas las instancias de publicación en un conjunto de servidores de publicación se autoidentificarán como el principal.

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

chlimage_1-411

Para todas las demás instancias de publicación (secundarias) en un conjunto de servidores de publicación:

Agentes de replicación en Author

La replicación se utiliza para el contenido del sitio creado en el entorno de publicación, como los grupos de comunidades, así como para administrar miembros y grupos de miembros del entorno de creación mediante el servicio de túnel.

Para el editor principal, asegúrese de que Replication Agent Config identifica correctamente el servidor de publicación y el 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 agregarlos como miembro del grupo de usuarios administrators (también miembro de Communities Administrators).

Hay dos agentes de replicación en el entorno de creación que necesitan que la configuración del transporte sea correcta.

  • Acceso a la consola Replicación en el autor

    • Desde la navegación global: Herramientas > Implementación > Replicación > Agentes en author

  • Siga el mismo procedimiento para ambos agentes:

    • Agente predeterminado (publicar)

    • Agente de replicación inversa (publicar inversa)

      1. Seleccione el agente
      2. Seleccione editar
      3. Seleccione la pestaña Transport
      4. Si no es el puerto 4503, edite el URI para especificar el puerto correcto
      5. Si no es el usuario admin, edite Usuario 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 mediante:

Agente predeterminado (publicar)

chlimage_1-412

Agente de replicación inversa (publicar inversa)

chlimage_1-413

Servicio de túnel en Author

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 en el autor.

Para habilitar el servicio de túnel:

chlimage_1-414

Replicar la clave criptográfica

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 todas las demás instancias, es necesario:

  • Acceda a la instancia de AEM, normalmente una instancia de autor, que contiene el material clave que desea 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

    • Vaya a la carpeta de datos

      Por ejemplo,

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

    • Copiar los archivos de nodo principal y hmac

  • Para cada instancia de AEM de destino

    • Vaya 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 actualmente

PRECAUCIÓN

Si ya se ha configurado otra función de seguridad basada en las 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

Tener el material clave almacenado en el repositorio, como ocurrió con AEM 6.2 y 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:

Uso del CRXDE Lite:

chlimage_1-415

Actualizar el paquete de criptografía de Granite

chlimage_1-416

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

    Operation completed successfully.

Servidor HTTP Apache

Si utiliza el servidor HTTP Apache, asegúrese de utilizar el nombre de servidor correcto para todas las entradas relevantes.

En particular, tenga cuidado de usar el nombre de servidor correcto, no localhost, en el RedirectMatch.

ejemplo 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 Dispatcher, consulte:

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

  • Visite Desarrollo de comunidades para obtener más información sobre el marco de componentes sociales (SCF) y la personalización de componentes y características de Communities.

  • Visite Creación de componentes de comunidades para aprender a crear y configurar componentes de Communities.

En esta página