Configuração do MySQL para Recursos de Ativação mysql-configuration-for-enablement-features
O MySQL é um banco de dados relacional usado principalmente para rastreamento e relatórios de dados SCORM para recursos de capacitação. Inclui tabelas para outros recursos, como rastreamento de pausa/retomada de vídeo.
Essas instruções descrevem como se conectar ao servidor MySQL, estabelecer o banco de dados de ativação e preencher o banco de dados com dados iniciais.
Requisitos requirements
Antes de configurar o recurso de ativação do MySQL for Communities, certifique-se de
-
Instalar Servidor MySQL Community Server versão 5.6
- A versão 5.7 não é compatível com SCORM
- Pode ser o mesmo servidor que a instância do autor AEM
-
Em todas as instâncias AEM, instale o Driver JDBC para MySQL
-
Instalar Workbench MySQL
-
Em todas as instâncias AEM, instale o Pacote SCORM
Instalando o MySQL installing-mysql
O MySQL deve ser baixado e instalado de acordo com as instruções para o SO de destino.
Nomes de tabela em minúsculas lower-case-table-names
Como o SQL não diferencia maiúsculas de minúsculas, para sistemas operacionais que diferenciam maiúsculas de minúsculas, é necessário incluir uma configuração para minúsculas todos os nomes de tabela.
Por exemplo, para especificar todos os nomes de tabela de letras minúsculas em um sistema operacional Linux:
- Editar arquivo
/etc/my.cnf
- No
[mysqld]
adicione a seguinte linha:lower_case_table_names = 1
Conjunto de caracteres UTF8 utf-character-set
Para oferecer um melhor suporte multilíngue, é necessário usar o conjunto de caracteres UTF8.
Altere MySQL para ter UTF8 como seu conjunto de caracteres:
- mysql> DEFINIR NOMES 'utf8';
Altere o banco de dados MySQL para UTF8:
- Editar arquivo
/etc/my.cnf
- No
[client]
adicione a seguinte linha:default-character-set=utf8
- No
[mysqld]
adicione a seguinte linha:character-set-server=utf8
Instalar o MySQL Workbench installing-mysql-workbench
O MySQL Workbench fornece uma interface para executar scripts SQL que instalam o esquema e os dados iniciais.
O MySQL Workbench deve ser baixado e instalado seguindo as instruções para o SO de destino.
Habilitar conexão enablement-connection
Quando o MySQL Workbench é iniciado pela primeira vez, a menos que já esteja em uso para outros fins, ele ainda não mostrará conexões:
Novas configurações de conexão new-connection-settings
-
Selecione o ícone "+" à direita de
MySQL Connections
. -
Na caixa de diálogo
Setup New Connection
, insira os valores adequados para sua plataforma para fins de demonstração, com a instância de AEM do autor e o MySQL no mesmo servidor:- Nome da conexão:
Enablement
- Método de conexão:
Standard (TCP/IP)
- Nome do host:
127.0.0.1
- Nome de usuário:
root
- Senha:
no password by default
- Esquema padrão:
leave blank
- Nome da conexão:
-
Selecionar
Test Connection
para verificar a conexão com o serviço MySQL em execução
Notas:
- A porta padrão é
3306
- O
Connection Name
escolhido é inserido comodatasource
nome em Configuração JDBC OSGi
Conexão bem-sucedida successful-connection
Nova conexão de ativação new-enablement-connection
Configuração do banco de dados database-setup
Ao abrir a nova conexão de Ativação, observe que há um esquema de teste e contas de usuário padrão.
Obter Scripts SQL obtain-sql-scripts
Os scripts SQL são obtidos usando o CRXDE Lite na instância do autor. O Pacote SCORM deve ser instalado:
- Navegue até CRXDE Lite
- Por exemplo, http://localhost:4502/crx/de
- Expanda o
/libs/social/config/scorm/
pasta - Download
database_scormengine.sql
- Download
database_scorm_integration.sql
Um método para baixar o esquema é
- Selecione o
jcr:content
nó para o arquivo sql - Observe o valor da variável
jcr:data
propriedade é um link de exibição - Selecione o link de exibição para salvar os dados em um arquivo local
Criar Banco de Dados SCORM create-scorm-database
O Banco de Dados SCORM de Ativação a ser criado é:
-
name:
ScormEngineDB
-
criado a partir de scripts:
- esquema:
database_scormengine.sql
- dados:
database_scorm_integration.sql
Siga as etapas abaixo (
open, execute) para instalar cada Script SQL . Atualizar quando necessário para ver os resultados da execução do script.
- esquema:
Certifique-se de instalar o esquema antes de instalar os dados.
Etapa 1: abrir arquivo SQL step-open-sql-file
No MySQL Workbench
-
No menu suspenso Arquivo
-
Selecionar
Open SQL Script ...
-
Nesta ordem, selecione um dos seguintes:
database_scormengine.sql
database_scorm_integration.sql
Etapa 2: executar script SQL step-execute-sql-script
Na janela Workbench para o arquivo aberto na Etapa 1, selecione o lightening (flash) icon
para executar o script.
Observe que a execução da variável database_scormengine.sql
o script para criar o banco de dados SCORM pode levar um minuto para ser concluído.
Atualizar refresh
Depois que os scripts forem executados, será necessário atualizar a variável SCHEMAS
da seção Navigator
para ver o novo banco de dados. Use o ícone de atualização à direita de 'SCHEMAS':
Resultado: scormenginedb result-scormenginedb
Depois de instalar e atualizar o SCHEMAS, o scormenginedb
estará visível.
Configurar conexões JDBC configure-jdbc-connections
A configuração OSGi para Pool de Conexões JDBC do Day Commons configura o driver JDBC do MySQL.
Todas as instâncias de publicação e criação de AEM devem apontar para o mesmo servidor MySQL.
Quando o MySQL é executado em um servidor diferente de AEM, o nome do host do servidor deve ser especificado no lugar de 'localhost' no conector JDBC (que preenche a variável ScormEngine configuração).
- Em cada autor e publicar AEM instância
- Conectado com privilégios de administrador
- Acesse o console da web
- Por exemplo, http://localhost:4502/system/console/configMgr
- Localize a variável
Day Commons JDBC Connections Pool
- Selecione o
+
ícone para criar uma nova configuração
-
Insira os seguintes valores:
- Classe de driver JDBC:
com.mysql.jdbc.Driver
- URIJ de conexão DBC:
jdbc:mysql://localhost:3306/aem63reporting
especifique o servidor no lugar de localhost se o servidor MySQL não for o mesmo que 'this' AEM server - Nome do usuário: Raiz ou insira o nome de usuário configurado para o servidor MySQL, se não for 'root'
- Senha: Limpar este campo se não houver senha definida para o MySQL, caso contrário, introduzir a senha configurada para o nome de utilizador do MySQL
- Nome da fonte de dados: Nome inserido para o Conexão MySQL, por exemplo, "ativation"
- Classe de driver JDBC:
-
Selecione Salvar
Configurar Scorm configure-scorm
Serviço do AEM Communities ScormEngine aem-communities-scormengine-service
A configuração OSGi para Serviço do AEM Communities ScormEngine configura o SCORM para o uso do servidor MySQL pela comunidade de ativação.
Essa configuração está presente quando a variável Pacote SCORM está instalado.
Todas as instâncias de publicação e criação apontam para o mesmo servidor MySQL.
Quando o MySQL é executado em um servidor diferente de AEM, o nome do host do servidor deve ser especificado no lugar de 'localhost' no Serviço ScormEngine, que normalmente é preenchido a partir do Conexão JDBC configuração.
-
Em cada autor e publicar AEM instância
-
Conectado com privilégios de administrador
-
Acesse o console da web
- Por exemplo, http://localhost:4502/system/console/configMgr
-
Localize a variável
AEM Communities ScormEngine Service
-
Selecione o ícone de edição
-
Verifique se os seguintes valores de parâmetro estão consistentes com a variável Conexão JDBC configuração:
- URI de conexão JDBC:
jdbc:mysql://localhost:3306/ScormEngineDB
ScormEngineDB é o nome padrão do banco de dados nos scripts SQL - Nome do usuário: Raiz ou insira o nome de usuário configurado para o servidor MySQL, se não for 'root'
- Senha: Limpar este campo se não houver senha definida para o MySQL, caso contrário, introduzir a senha configurada para o nome de utilizador do MySQL
- URI de conexão JDBC:
-
Em relação ao seguinte parâmetro:
-
Senha do usuário do Scorm: NÃO EDITAR
Apenas para uso interno. É para um usuário de serviço especial usado pelo AEM Communities para se comunicar com o mecanismo de pontuação.
-
-
Selecione Salvar
Filtro CSRF do Adobe Granite adobe-granite-csrf-filter
Para garantir que os cursos de ativação funcionem corretamente em todos os navegadores, é necessário adicionar o Mozilla como Agente de usuário que não é verificado pelo filtro CSRF.
- Em cada instância do AEM de publicação
- Conectado com privilégios de administrador
- Acesse o console da web
- Por exemplo, http://localhost:4503/system/console/configMgr
- Localizar
Adobe Granite CSRF Filter
- Selecione o ícone de edição
- Selecione o
[+]
ícone para adicionar um Agente de Usuário Seguro - Insira
Mozilla/*
- Selecione Salvar