用于启用功能的MySQL配置

MySQL是一个关系数据库，主要用于SCORM跟踪和报告启用资源的数据。 其中包含用于其他功能（如跟踪视频暂停/恢复）的表。

这些说明描述了如何连接到MySQL服务器、建立启用数据库以及使用初始数据填充数据库。

要求

在配置MySQL for Communities的启用功能之前，请务必

• 安装MySQL Server Community Server版本5.6:
  • SCORM不支持版本5.7。
  • 可能与创作AEM实例相同的服务器。
• 在所有AEM实例上，安装MySQL🔗的官方JDBC驱动程序。
• 安装MySQL Workbench。
• 在所有AEM实例上，安装SCORM包。

安装MySQL

应按照目标操作系统的说明下载和安装MySQL。

小写表名称

由于SQL不区分大小写，因此对于区分大小写的操作系统，必须包含一个设置，以使所有表名称都小写。

例如，要在Linux操作系统中指定所有小写表名：

• 编辑文件/etc/my.cnf
• 在[mysqld]部分中，添加以下行：lower_case_table_names = 1

UTF8字符集

要提供更好的多语言支持，必须使用UTF8字符集。

将MySQL更改为将UTF8作为其字符集：

• mysql > SET NAMES 'utf8';

将MySQL数据库更改为默认UTF8:

• 编辑文件/etc/my.cnf
• 在[client]部分中，添加：default-character-set=utf8
• 在[mysqld]部分中，添加：character-set-server=utf8

安装MySQL Workbench

MySQL Workbench提供了用于执行SQL脚本的UI，这些脚本安装了架构和初始数据。

应按照目标操作系统的说明下载和安装MySQL Workbench。

启用连接

首次启动MySQL Workbench时，除非该MySQL Workbench已用于其他目的，否则它尚不显示任何连接：

新建连接设置

1. 选择MySQL Connections右侧的“+”图标。
2. 在对话框Setup New Connection中，为演示目的输入适用于您的平台的值，并在同一服务器上将创作AEM实例和MySQL:
   • 连接名称：Enablement
   • 连接方法：Standard (TCP/IP)
   • 主机名：127.0.0.1
   • 用户名: root
   • 密码: no password by default
   • 默认架构：leave blank
3. 选择Test Connection以验证与正在运行的MySQL服务的连接。

注释:

• 默认端口为3306。
• 在JDBC OSGi配置中，选择的Connection Name作为datasource名称输入。

成功连接

新建启用连接

数据库设置

打开新的启用连接时，请注意存在一个测试架构和默认用户帐户。

获取SQL脚本

SQL脚本是使用创作实例上的CRXDE Lite获取的。 必须安装SCORM包:

1. 浏览CRXDE Lite:
   • 例如， http://localhost:4502/crx/de
2. 展开/libs/social/config/scorm/文件夹
3. 下载 database_scormengine.sql
4. 下载 database_scorm_integration.sql

下载模式的一种方法是：

• 为sql文件选择jcr:content节点。
• 请注意jcr:data属性的值是一个视图链接。
• 选择视图链接以将数据保存到本地文件。

创建SCORM数据库

要创建的启用SCORM数据库包括：

• name: ScormEngineDB
• 从脚本创建：
  • 架构: database_scormengine.sql
  • 数据：database_scorm_integration.sql
    按照以下步骤(
    打开, 执行)以安装每 个SQL脚本 。🔗 根据需要刷新以查看脚本执行的结果。

在安装数据之前，请务必先安装架构。

步骤1:打开SQL文件

在MySQL Workbench中

• 从文件下拉菜单
• 选择 Open SQL Script ...
• 按此顺序，选择以下选项之一：
  1. database_scormengine.sql
  2. database_scorm_integration.sql

步骤2:执行SQL脚本

在步骤1中打开的文件的Workbench窗口中，选择lightening (flash) icon以执行脚本。

请注意，执行database_scormengine.sql脚本以创建SCORM数据库可能需要一分钟才能完成。

刷新

执行脚本后，需要刷新Navigator的SCHEMAS部分，才能查看新数据库。 使用“架构”右侧的刷新图标：

结果：scormenginedb

安装和刷新架构后，将显示scormenginedb。

配置JDBC连接

Day Commons JDBC连接池​的OSGi配置配置MySQL JDBC驱动程序。

所有发布和创作AEM实例都应指向同一MySQL服务器。

当MySQL在与AEM不同的服务器上运行时，必须在JDBC连接器中指定服务器主机名代替“localhost”（该连接器填充ScormEngine配置）。

• 在每个创作和发布AEM实例上

• 使用管理员权限登录

• 访问Web控制台

  • 例如， http://localhost:4502/system/console/configMgr

• 找到Day Commons JDBC Connections Pool

• 选择+图标以创建新配置

  

• 输入以下值：

  • JDBC驱动程序类: com.mysql.jdbc.Driver
  • DBC连接URIJ: jdbc:mysql://localhost:3306/aem63reporting 如果MySQL服务器与'this' AEM服务器不同，请指定服务器代替localhost。
  • 用户名:为MySQL服务器输入根或配置的用户名（如果不是“根”）。
  • 密码:如果未为MySQL设置密码，则清除此字段，否则输入MySQL用户名的配置密码。
  • 数据源名称:为MySQL连接 输入的名称，例如“启用”。

• 选择​保存。

配置Scorm

AEM Communities ScormEngine服务

AEM Communities ScormEngine服务​的OSGi配置可为启用社区使用MySQL服务器配置SCORM。

安装SCORM包时，即存在此配置。

所有发布和创作实例都指向同一MySQL服务器。

当MySQL在与AEM不同的服务器上运行时，必须在ScormEngine服务中指定服务器主机名代替“localhost”，该服务通常从JDBC连接配置中填充。

• 在每个创作和发布AEM实例上

• 使用管理员权限登录

• 访问Web控制台

  • 例如， http://localhost:4502/system/console/configMgr

• 找到AEM Communities ScormEngine Service

• 选择编辑图标

  

• 验证以下参数值是否与JDBC连接配置一致：

  • JDBC连接URI: jdbc:mysql://localhost:3306/ScormEngineDB ** ScormEngineDB是SQL脚本中的默认数据库名称
  • 用户名:为MySQL Server输入根或配置的用户名（如果不是“根”）
  • 密码:如果未为MySQL设置密码，则清除此字段，否则输入MySQL用户名的配置密码

• 关于以下参数：

  • Scorm用户密码:不编辑

    仅供内部使用：它是供AEM Communities使用的特殊服务用户与scorm引擎通信的。

• 选择​Save

AdobeGranite CSRF过滤器

要确保支持课程在所有浏览器中正常工作，必须将Mozilla添加为CSRF筛选器未选中的用户代理。

• 使用管理员权限登录AEM发布实例。

• 访问Web控制台

  • 例如， http://localhost:4503/system/console/configMgr

• 找到Adobe Granite CSRF Filter。

• 选择编辑图标。

  

• 选择[+]图标以添加安全用户代理。

• 输入Mozilla/*。

• 选择​保存。