MySQL啟用功能配置

MySQL是關係型資料庫，主要用於SCORM追蹤和報告資料，以利啟用資源。 包含其他功能的表格，例如追蹤視訊暫停／繼續。

這些說明說明如何連接到MySQL伺服器、建立啟用資料庫，以及使用初始資料填充資料庫。

要求

在配置MySQL for Communities啟用功能之前，請務必

• 安裝MySQL Server Community Server 5.6版
  • SCORM不支援5.7版
  • 可能與作者AEM例項相同的伺服器
• 在所有AEM實例上，安裝MySQL的正式JDBC驅動程式
• 安裝MySQL工作台
• 在所有AEM例項上，安裝SCORM套件

安裝MySQL

MySQL應按照目標OS的說明下載並安裝。

小寫表名

由於SQL不區分大小寫，因此對於區分大小寫的作業系統，必須包含將所有表名都小寫的設定。

例如，要在Linux OS上指定所有小寫表名：

• 編輯檔案/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提供了一個UI，用於執行安裝模式和初始資料的SQL指令碼。

MySQL Workbench應按照目標OS的說明下載並安裝。

啟用連接

當MySQL工作台首次啟動時（除非已用於其他用途），它將不顯示任何連接：

新的連接設定

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資料庫是：

• 名稱: ScormEngineDB
• 從指令碼建立：
  • 結構描述: database_scormengine.sql
  • 資料：database_scorm_integration.sql
    請遵循下列步驟(
    open, execute)來安裝每 個SQL指令碼 。視需 要重新整理，以查看指令碼執行的結果。

請務必先安裝架構，然後再安裝資料。

步驟1:開啟SQL檔案

在MySQL工作台中

• 從「檔案」下拉菜單
• 選取 Open SQL Script ...
• 按此順序，選擇以下選項之一：
  1. database_scormengine.sql
  2. database_scorm_integration.sql

步驟2:執行SQL指令碼

在步驟1中開啟的檔案的「工作台」窗口中，選擇lightening (flash) icon以執行指令碼。

請注意，database_scormengine.sql指令碼建立SCORM資料庫可能需要一分鐘的時間才能完成。

重新整理

執行指令碼後，需要刷新Navigator的SCHEMAS部分才能查看新資料庫。 使用「方案」右側的刷新表徵圖：

結果：scormenginedb

安裝和刷新SCHEMAS後，將顯示​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伺服器輸入已配置的Root用戶名（如果不是「root」）
  • 密碼:如果未為MySQL設定口令，請清除此欄位，否則，請輸入MySQL用戶名的配置口令
  • 資料來源名稱:為 MySQL連接輸入的名稱，例如「啟用」
• 選擇​保存

配置Scorm

AEM Communities ScormEngine Service

AEM Communities ScormEngine Service​的OSGi設定會針對啟用社群使用MySQL伺服器來設定SCORM。

當安裝SCORM軟體包時，此配置即存在。

所有發佈和作者實例都指向同一個MySQL伺服器。

當MySQL在與AEM不同的伺服器上執行時，必須在ScormEngine服務中指定伺服器主機名稱，而ScormEngine服務通常會從JDBC Connection組態填入。

• 在每個作者上並發佈AEM例項
• 以管理員權限登入
• 訪問Web控制台
  • 例如，http://localhost:4502/system/console/configMgr
• 找到AEM Communities ScormEngine Service
• 選取編輯圖示
  
• 驗證以下參數值是否與JDBC Connection配置一致：
  • JDBC連接URI: jdbc:mysql://localhost:3306/ScormEngineDB ** ScormEngineDB是SQL指令碼中的預設資料庫名
  • 使用者名稱:為MySQL伺服器輸入已配置的Root用戶名（如果不是「root」）
  • 密碼:如果未為MySQL設定口令，請清除此欄位，否則，請輸入MySQL用戶名的配置口令
• 關於下列參數：

  • Scorm使用者密碼:不要編輯

    僅供內部使用。 AEM Communities使用的特殊服務使用者可與Scorm引擎通訊。

• 選擇​保存

Adobe Granite CSRF Filter

為確保啟用課程在所有瀏覽器中都能正常運作，必須將Mozilla新增為未經CSRF篩選器勾選的使用者代理。

• 在每個發佈AEM例項上
• 以管理員權限登入
• 訪問Web控制台
  • 例如，http://localhost:4503/system/console/configMgr
• 找到Adobe Granite CSRF Filter
• 選取編輯圖示
  
• 選擇[+]表徵圖以添加安全用戶代理
• 輸入Mozilla/*
• 選擇​保存