Implementación de comunidades deploying-communities
Requisitos previos prerequisites
-
Licencia de AEM Communities
-
Licencias opcionales para:
Lista de comprobación de instalación installation-checklist
Para la variable plataforma AEM
-
Instale la última Actualizaciones de AEM 6.4
-
Si no utiliza los puertos predeterminados (4502, 4503), configurar agentes de replicación
-
Si apoyamos la globalización, configurar traducción automatizada
(la configuración de muestra se proporciona para el desarrollo)
Para la variable Capacidad de las comunidades
-
Si se implementa un publicar granja, identificar el publicador principal
-
Configure un servicio de correo electrónico predeterminado
-
Identificar la opción para almacenamiento UGC compartido (SRP)
-
Si MongoDB SRP (MSRP)
-
Si la base de datos relacional es SRP (DSRP)
-
Si el Adobe es SRP (ASRP)
- Póngase en contacto con su representante de cuentas para realizar el aprovisionamiento
- Seleccionar ASRP
-
Si JCR SRP (JSRP)
-
No es una tienda UGC compartida:
- UGC nunca se replica
- UGC solo visible en AEM instancia o clúster en el que se introdujo
-
El valor predeterminado es JSRP
-
Para la variable función de habilitación
-
Ú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:
-
Descargue el archivo ZIP de https://dev.mysql.com/downloads/connector/j/
- La versión debe ser >= 5.1.38
-
Extraer mysql-connector-java-<version>-bin.jar (paquete) del archivo
-
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)
-
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
-
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
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:
-
cq -social- scorm -package, versión 1.2.11. Este paquete SCORM es compatible con todas las versiones de AEM 6.4 Communities.
-
cq -social- scorm -package, versión 2.2.2 incluye SCORM 2017.1 motor. Este paquete SCORM es compatible con AEM comunidades 6.4.2.x en adelante.
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
- Instale el cq-social-scorm-package, versión 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. - Agregar
/content/communities/scorm/RecordResults
en la propiedad Rutas excluidas del filtro CSRF dehttps://<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.
Para actualizar la versión del motor SCORM
-
Haga una copia de seguridad del esquema ScormEngineDB.
-
Instale el cq-social-scorm-package, versión 2.2.2.
-
Descargue el paquete desde
/libs/social/config/scorm/ScormEngine.zip
y extraiga lo mismo. -
Vaya a Instalador carpeta del directorio extraído.
-
Actualizar
SystemDatabaseConnectionString
con suscorm db connection url
en el archivo EngineInstall.xml. -
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
-
Monitorización
engine_upgrade.log
para cualquier tipo de error y estado de actualización de esquema. -
Agregar
/content/communities/scorm/RecordResults
en Rutas excluidas propiedad en el filtro CSRF dehttps://<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.
Acerca de los vínculos a Package Share about-links-to-package-share
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 Install
es para instalar los paquetes en un sitio alojado de Adobe. Si desea realizar la instalación en una instancia de AEM local, seleccione Install
generará 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 Download
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.
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.
-
Almacenamiento de contenido de la comunidad: analiza las opciones de almacenamiento de SRP para comunidades AEM
-
Topologías recomendadas: analiza la topología que se va a usar en función del caso de uso y la elección de SRP
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.
Para todas las demás instancias de publicación (secundarias) en un conjunto de servidores de publicación:
-
Iniciar sesión con privilegios de administrador
-
Acceda a la consola web
- Por ejemplo, http://localhost:4503/system/console/configMgr
-
Busque la variable
AEM Communities Publisher Configuration
-
Seleccione el icono de edición
-
Desmarque la Editor principal box
-
Seleccione Guardar
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)
- Seleccione el agente
- Select editar
- Seleccione el Transporte ficha
- Si no es puerto
4503
, edite el URI para especificar el puerto correcto - Si no es un usuario
admin
, edite el Usuario y Contraseña para especificar un miembro deadministrators
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
Agente de replicación inversa (publicar inversa) reverse-replication-agent-publish-reverse
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:
-
Activado author
-
Iniciar sesión con privilegios administrativos
-
Si el editor no es localhost:4503 o el usuario de transporte no lo es
admin
,Entonces configurar el agente de replicación
-
Acceda a la Consola web
- Por ejemplo, http://localhost:4502/system/console/configMgr
-
Busque la variable
AEM Communities Publish Tunnel Service
-
Seleccione el icono de edición
-
Marque la enable box
-
Seleccione Guardar
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 localPor 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
-
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
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:
-
select
/etc/key
-
open
Replication
ficha -
select
Replicate
Actualizar el paquete de criptografía de Granite refresh-the-granite-crypto-bundle
-
En cada instancia de publicación, acceda a la variable Consola web
- Por ejemplo, https://<server>:<port>/system/console/bundles
-
Localizar
Adobe Granite Crypto Support
paquete (com.adobe.granite.crypto) -
Select Actualizar
-
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.