Implementación de comunidades

Requisitos previos

Lista de comprobación de instalación

Para la plataforma AEM

Para la capacidad de Comunidades

Latest Releases

AEM 6.4 Communities GA incluye el paquete Communities. Para conocer las actualizaciones de AEM 6.4 Communities, consulte AEM Notasde 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 obtener las últimas actualizaciones de AEM 6.4, asegúrese de comprobar los paquetes de correcciones acumulativas de Adobe Experience Manager 6.4 y los Service Packs.

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 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 vincular 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
  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 AEM Communities SCORM 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. Instale el paquete 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. Añada /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.

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-package, versión 2.2.2.

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

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

  5. Actualice SystemDatabaseConnectionString con el 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 engine_upgrade.log el archivo 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 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 archivosde 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 Solr Configuration for 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 Installbotón es para instalar los paquetes en un sitio alojado de Adobe. Si desea realizar la instalación en una instancia de AEM local, la selección Installproducirá un error.

Cómo instalar en una instancia de AEM local

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

  • Select the Assets tab
  • Seleccione descargar en 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 Downloadbotón se 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 se le suele llamar 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.

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

  • Topologíasrecomendadas: 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 conocer los cambios de las comunidades.

Configuraciones

Editor principal

Cuando la implementación elegida es un conjunto de servidores depublicación, una instancia de publicación AEM debe identificarse como la primary publisher de actividades que no deben producirse en todas las instancias, como las funciones que dependen de las 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.

chlimage_1-411

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 detú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 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. 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)

chlimage_1-412

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

chlimage_1-413

Servicio de túnel en el autor

Al utilizar el entorno de autor para crear sitios, modificar propiedades del sitio o administrar miembrosde 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:

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

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

PRECAUCIÓ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ónal 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é 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 del 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 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:

  • 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 Comunidades.

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

En esta página