啟用功能的MySQL配置

MySQL是關係資料庫，主要用於SCORM追蹤和報告啟用資源的資料。 其中包括追蹤視訊暫停/繼續等其他功能的表格。

這些說明說明如何連接到MySQL Server、建立啟用資料庫以及將初始資料填充到資料庫。

需求

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

• 安裝MySQL Server Community Server版本5.6
  • SCORM不支援5.7版
  • 可能與製作AEM例項相同
• 在所有AEM實例上，安裝MySQL🔗的官方JDBC驅動程式
• 安裝MySQL Workbench
• 在所有AEM執行個體上，安裝SCORM套件

安裝MySQL

MySQL應按照目標作業系統的說明下載並安裝。

小寫表名

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

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

• 編輯檔案/etc/my.cnf
• 在[mysqld]區段中，新增下列行：
  lower_case_table_names = 1

UTF8字元集

若要提供更好的多語言支援，必須使用UTF8字元集。

將MySQL更改為以UTF8作為其字元集：

• mysql>設定名稱'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首次啟動時（除非已用於其他用途），它將不會顯示任何連線：

新連接設定

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
• 選擇的Connection Name在JDBC OSGi配置中作為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
    請依照下列步驟操作(
    開啟, 執行)以安裝每個 SQL指令碼 。🔗 必要時重新整理，以查看指令碼執行的結果。

安裝資料之前，請務必安裝架構。

步驟1:開啟SQL檔案

在MySQL Workbench中

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

步驟2:執行SQL指令碼

在Workbench視窗中，針對在步驟1中開啟的檔案選取lightening (flash) icon以執行指令碼。

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

重新整理

執行指令碼後，必須刷新Navigator的SCHEMAS節，才能查看新資料庫。 使用「結構」右側的刷新表徵圖：

結果：scorginedb

安裝和重新整理架構後，將會顯示​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 Server輸入配置的用戶名（如果不是「root」），則為root
  • 密碼:如果未為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輸入配置的用戶名（如果不是「root」），則為root
  • 密碼:如果未為MySQL設定密碼，則清除此欄位，否則，請為MySQL用戶名輸入配置的密碼
• 關於下列參數：

  • Scorm用戶密碼:不編輯

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

• 選擇​保存

AdobeGranite CSRF篩選器

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

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