Configuración MySQL para características de habilitación

MySQL es una base de datos relacional que se utiliza principalmente para datos de informes y seguimiento de SCORM para recursos de habilitación. Se incluyen tablas para otras funciones, como el seguimiento de la pausa/reanudación de vídeo.

Estas instrucciones describen cómo conectar con el servidor MySQL, establecer la base de datos de habilitación y rellenar la base de datos con datos iniciales.

Requisitos

Antes de configurar la función de habilitación de MySQL para Communities, asegúrese de

• Instale MySQL server Community Server versión 5.6
  • La versión 5.7 no es compatible con SCORM
  • Puede ser el mismo servidor que la instancia AEM autor
• En todas AEM instancias, instale el controlador oficial JDBC para MySQL
• Instalar MySQL workbench
• En todas las AEM instancias, instale el paquete SCORM

Instalación de MySQL

MySQL debe descargarse e instalarse siguiendo las instrucciones para el sistema operativo de destino.

Nombres de tabla en minúsculas

Como SQL no distingue entre mayúsculas y minúsculas, en los sistemas operativos que distinguen entre mayúsculas y minúsculas, es necesario incluir una configuración para que todos los nombres de tabla estén en minúsculas.

Por ejemplo, para especificar todos los nombres de tabla en minúsculas en un sistema operativo Linux:

• Editar archivo /etc/my.cnf
• En la sección [mysqld], agregue la línea siguiente:
  lower_case_table_names = 1

Conjunto de caracteres UTF8

Para proporcionar una mejor compatibilidad multilingüe, es necesario utilizar el conjunto de caracteres UTF8.

Cambie MySQL para que tenga UTF8 como conjunto de caracteres:

• mysql> ESTABLECER NOMBRES 'utf8';

Cambie la base de datos MySQL a UTF8 de forma predeterminada:

• Editar archivo /etc/my.cnf
• En la sección [client], agregue la línea siguiente:
  default-character-set=utf8
• En la sección [mysqld], agregue la línea siguiente:
  character-set-server=utf8

Instalación de MySQL Workbench

MySQL Workbench proporciona una interfaz de usuario para ejecutar secuencias de comandos SQL que instalan el esquema y los datos iniciales.

MySQL Workbench debe descargarse e instalarse siguiendo las instrucciones para el sistema operativo de destino.

Conexión de habilitación

Cuando MySQL Workbench se inicia por primera vez, a menos que ya se esté utilizando para otros fines, todavía no mostrará ninguna conexión:

Nueva configuración de conexión

1. Seleccione el icono "+" a la derecha de MySQL Connections.
2. En el cuadro de diálogo Setup New Connection, introduzca los valores apropiados para su plataforma con fines de demostración, con la instancia de autor AEM y MySQL en el mismo servidor:
   • Nombre de la conexión: Enablement
   • Método de conexión: Standard (TCP/IP)
   • Nombre del host: 127.0.0.1
   • Nombre de usuario: root
   • Contraseña: no password by default
   • Esquema predeterminado: leave blank
3. Seleccione Test Connection para verificar la conexión con el servicio MySQL en ejecución

Notas:

• El puerto predeterminado es 3306
• El Connection Name elegido se introduce como nombre datasource en la configuración OSGi de JDBC

Conexión correcta

Nueva conexión de habilitación

Configuración de base de datos

Al abrir la nueva conexión de habilitación, observe que hay un esquema de prueba y cuentas de usuario predeterminadas.

Obtener scripts SQL

Las secuencias de comandos SQL se obtienen mediante CRXDE Lite en la instancia de autor. El paquete SCORM debe estar instalado:

1. Vaya al CRXDE Lite
   • Por ejemplo, http://localhost:4502/crx/de
2. Expanda la carpeta /libs/social/config/scorm/
3. Descargar database_scormengine.sql
4. Descargar database_scorm_integration.sql

Un método para descargar el esquema es

• Seleccione el nodo jcr:contentpara el archivo sql
• Observe que el valor de la propiedad jcr:dataes un vínculo de vista
• Seleccione el vínculo de vista para guardar los datos en un archivo local

Crear base de datos SCORM

La base de datos SCORM de habilitación que se creará es:

• name: ScormEngineDB
• creada a partir de secuencias de comandos:
  • esquema: database_scormengine.sql
  • datos: database_scorm_integration.sql
    Siga los pasos a continuación (
    abra, ejecute) para instalar cada script SQL . 🔗 Actualice cuando sea necesario para ver los resultados de la ejecución de la secuencia de comandos.

Asegúrese de instalar el esquema antes de instalar los datos.

Paso 1: abrir archivo SQL

En MySQL Workbench

• Desde el menú desplegable Archivo
• Seleccione Open SQL Script ...
• En este orden, seleccione una de las siguientes opciones:
  1. database_scormengine.sql
  2. database_scorm_integration.sql

Paso 2: ejecutar script SQL

En la ventana Workbench del archivo abierto en el paso 1, seleccione lightening (flash) icon para ejecutar la secuencia de comandos.

Tenga en cuenta que la ejecución del script database_scormengine.sql para crear la base de datos SCORM puede tardar un minuto en completarse.

Actualizar

Una vez ejecutadas las secuencias de comandos, es necesario actualizar la sección SCHEMASde la Navigator para ver la nueva base de datos. Utilice el icono de actualización a la derecha de "SCHEMAS":

Resultado: scormenginedb

Después de instalar y actualizar SCHEMAS, el scormenginedb estará visible.

Configuración de conexiones JDBC

La configuración OSGi para Day Commons JDBC Connections Pool configura el controlador JDBC de MySQL.

Todas las instancias de AEM de publicación y creación deben apuntar al mismo servidor MySQL.

Cuando MySQL se ejecuta en un servidor diferente de AEM, el nombre de host del servidor debe especificarse en lugar de "localhost" en el conector JDBC (que rellena la configuración ScormEngine).

• En cada instancia de autor y publicación AEM
• Inicio de sesión con privilegios de administrador
• Acceda a la consola web
  • Por ejemplo, http://localhost:4502/system/console/configMgr
• Busque el Day Commons JDBC Connections Pool
• Seleccione el icono + para crear una nueva configuración

• Introduzca los siguientes valores:
  • Clase de controlador JDBC: com.mysql.jdbc.Driver
  • URIJ de conexión DBC: jdbc:mysql://localhost:3306/aem63reporting especificar servidor en lugar de localhost si el servidor MySQL no es igual que "this" AEM servidor
  • Nombre de usuario: Raíz o introduzca el nombre de usuario configurado para el servidor MySQL, si no es "raíz"
  • Contraseña: Borre este campo si no hay ninguna contraseña establecida para MySQL, sino introduzca la contraseña configurada para el nombre de usuario de MySQL
  • Nombre de la fuente de datos: Nombre introducido para la conexión MySQL, por ejemplo, "habilitación"
• Seleccione Guardar

Configurar Puntuación

Servicio AEM Communities ScormEngine

La configuración OSGi para AEM Communities ScormEngine Service configura SCORM para el uso del servidor MySQL por parte de una comunidad de habilitación.

Esta configuración está presente cuando se instala el paquete SCORM.

Todas las instancias de publicación y autor apuntan al mismo servidor MySQL.

Cuando MySQL se ejecuta en un servidor diferente de AEM, el nombre de host del servidor debe especificarse en lugar de "localhost" en el servicio ScormEngine, que generalmente se rellena desde la configuración JDBC Connection.

• En cada instancia de autor y publicación AEM
• Inicio de sesión con privilegios de administrador
• Acceda a la consola web
  • Por ejemplo, http://localhost:4502/system/console/configMgr
• Busque el AEM Communities ScormEngine Service
• Seleccione el icono de edición
  
• Compruebe que los siguientes valores de parámetro son coherentes con la configuración JDBC Connection:
  • URI de conexión JDBC: jdbc:mysql://localhost:3306/ScormEngineDB ** ScormEngineDBes el nombre de base de datos predeterminado en los scripts SQL
  • Nombre de usuario: Raíz o introduzca el nombre de usuario configurado para el servidor MySQL, si no es "raíz"
  • Contraseña: Borre este campo si no hay ninguna contraseña establecida para MySQL, sino introduzca la contraseña configurada para el nombre de usuario de MySQL
• Respecto al siguiente parámetro:

  • Contraseña del usuario de Scorm: NO EDITAR

    Solo para uso interno. Es para un usuario de servicio especial utilizado por AEM Communities para comunicarse con el motor de escorm.

• Seleccione Guardar

Filtro CSRF de Granite de Adobe

Para garantizar que los cursos de habilitación funcionen correctamente en todos los navegadores, es necesario agregar Mozilla como agente de usuario que no esté seleccionado por el filtro CSRF.

• En cada instancia de AEM de publicación
• Inicio de sesión con privilegios de administrador
• Acceda a la consola web
  • Por ejemplo, http://localhost:4503/system/console/configMgr
• Localizar Adobe Granite CSRF Filter
• Seleccione el icono de edición
  
• Seleccione el icono [+] para agregar un agente de usuario seguro
• Escriba Mozilla/*
• Seleccione Guardar