Implementación de comunidades deploying-communities

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

Requisitos previos prerequisites

Lista de comprobación de instalación installation-checklist

Para la variable plataforma AEM

Para la variable Capacidad de las comunidades

Últimas versiones latest-releases

AEM 6.4 Communities GA incluye el paquete Communities. Para conocer las actualizaciones de AEM 6.4 Comunidades, consulte Notas de la versión de AEM 6.4.

Actualizaciones de AEM 6.4 aem-updates

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 version-history

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 jdbc-driver-for-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 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 e iniciar el paquete:

    • Por ejemplo, http://localhost:4502/system/console/bundles
    • Seleccionar Install/Update
    • Examinar… para seleccionar el paquete extraído del archivo ZIP descargado
    • Compruebe que Controlador JDBC de oracle Corporation para MySQLcom.mysql.jdbc está activo y debe iniciarlo en caso contrario (o comprobar 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 Day Commons JDBC Connections Pool configuración
    • Seleccione para abrir
    • Seleccionar 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 sección Consola web página.

Ejemplo: Paquete de conector MySQL instalado example-installed-mysql-connector-bundle

chlimage_1-410

Paquete SCORM scorm-package

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 variable habilitación funció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, 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. Descargar /libs/social/config/scorm/database_scormengine_data.sql desde la instancia cq y ejecútela en mysql server para crear un esquema de scormEngineDB actualizado.
  3. Agregar /content/communities/scorm/RecordResults en la propiedad Rutas excluidas del filtro CSRF de https://<hostname>;:<port>/system/console/configMgr en 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.

NOTE
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 desde /libs/social/config/scorm/ScormEngine.zip y extraiga lo mismo.

  4. Vaya a Instalador carpeta del directorio extraído.

  5. Actualizar 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. Monitorización engine_upgrade.log para cualquier tipo de error y estado de actualización de esquema.

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

Registro de SCORM scorm-logging

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 la variable RusticiSoftware.* paquete.

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

MLS AEM Advanced aem-advanced-mls

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 MLS AEM Advanced en la sección deploy 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 e información de instalación, visite Configuración de Solr 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, la variable Installes para instalar los paquetes en un sitio alojado de Adobe. Si desea realizar la instalación en una instancia de AEM local, seleccione Installgenerará 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 el Recursos ficha
  • Select descargar en disco

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

También puede acceder al paquete utilizando el paquete compartido desde la instancia de AEM local (por ejemplo, http://localhost:4502/crx/packageshare/), el 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.

Implementaciones recomendadas recommended-deployments

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, al tiempo que elimina la necesidad de replicación de UGC.

Actualización upgrading

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 configurations

Editor principal primary-publisher

Cuando la implementación elegida es una publicar granja, entonces una instancia de publicación AEM debe identificarse como la variable primary publisher para actividades que no deben producirse en todas las instancias, como las funciones en las que se confía notificaciones o Adobe Analytics.

De forma predeterminada, la variable AEM Communities Publisher Configuration La configuración de OSGi se configura con la variable Primary Publisher esté activada, de modo que todas las instancias de publicación de 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 Primary Publisher casilla de verificación.

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 replication-agents-on-author

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

Para el publicador principal, asegúrese de que la variable Configuración del agente de replicación 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 otro usuario tenga los permisos adecuados, debe agregarlos como miembro a la variable administrators grupo de usuarios (también es 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 el autor
  • Siga el mismo procedimiento para ambos agentes:

    • Agente predeterminado (publicar)

    • Agente de replicación inversa (publicar inversa)

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

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

Agente predeterminado (publicar) default-agent-publish

chlimage_1-412

Agente de replicación inversa (publicar inversa) reverse-replication-agent-publish-reverse

chlimage_1-413

Servicio de túnel en Author tunnel-service-on-author

Al utilizar el entorno de creación para crear sitios, modificar las 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 replicate-the-crypto-key

Existen dos funciones de AEM Communities que requieren que todas las instancias de servidor AEM utilicen las mismas claves de cifrado. Estos 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

    • Busque la variable com.adobe.granite.crypto.file paquete en el sistema de archivos local

      Por ejemplo,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • La variable bundle.info El archivo 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 está ejecutándose

CAUTION
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 asistencia, póngase en contacto con el servicio de atención al cliente.

Replicación del repositorio repository-replication

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
NOTE
Es importante verificar que la variable agente de replicación en author 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 CRXDE Lite:

chlimage_1-415

Actualizar el paquete de criptografía de Granite refresh-the-granite-crypto-bundle

chlimage_1-416

  • Después de un momento, Correcto El cuadro de diálogo debe aparecer:

    Operation completed successfully.

Servidor HTTP Apache apache-http-server

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 httpd-conf-sample

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

Si utiliza un Dispatcher, consulte:

Documentación de Communities relacionadas related-communities-documentation

  • Visita Administración de sitios de comunidades para obtener información sobre la creación de un sitio de comunidad, la configuración de plantillas de sitio de comunidad, la moderación del contenido de la comunidad, la administración de miembros y la configuración de mensajes.

  • Visita Desarrollo de comunidades para obtener información sobre el marco de componentes sociales (SCF) y la personalización de componentes y funciones de Communities.

  • Visita Creación de componentes de Communities para aprender a crear con y configurar componentes de Communities.

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6