疑難排解 直接存取閘道

本區段說明解決 直接存取閘道 的問題可執行的各種動作。

檢視和下載記錄檔案

記錄檔案提供關於 直接存取閘道 操作的資訊。Qlik 支援可能會請您提供記錄檔案以供故障排除。您可以在記錄檢視器中檢視或下載記錄檔案。在一般情況下，沒有理由要檢驗記錄檔案，但若您遇到重複故障或其他問題，記錄檔案通常有助於查明原因。

若要開啟記錄檢視器：

1. 在 管理主控台 中，前往資料閘道並找到 直接存取閘道。

2. 按一下列末尾的 ，並選取檢視記錄。

   就會開啟記錄檢視器視窗。

3. 從左上方的下拉式清單，選擇 Qlik 支援要求您檢視或下載的記錄類型。

   下列記錄可用：

   • 直接存取閘道 記錄 (DirectAccessAgent)
   • DCaaS 記錄 (dcaas_logs)
   • 以 ODBC 為基礎的連接器記錄 (odbc-connector_logs)
   • SAP BW 連接器記錄 (QvSAPBwConnector-<date + timestamp>)
   • SAP SQL 連接器記錄 (QvSqlBwConnector-<date + timestamp>)
   • 連接器代理程式記錄 (connector-agent_logs_<date>)

4. 從鄰近的下拉式清單，選取您要檢視或下載的記錄。從最新 (目前作用中的記錄檔案) 到最舊排序記錄檔案。選取記錄檔案後，您可以使用 和 按鈕分別跳至記錄檔案的開始或結尾。

   提示備註記錄檔檢視不會自動更新最新訊息。若要更新檢視，請按一下 跳至記錄檔案的結尾，會以最新訊息更新。

5. 若要下載記錄檔案，按一下下載。

   檔案將會下載至您的電腦或將會提示您儲存，視您的瀏覽器設定而定。

在 直接存取閘道 機器上開啟 直接存取閘道 記錄

除了能夠從 管理主控台 下載 直接存取閘道 (DirectAccessAgent) 記錄，您也可以直接從 直接存取閘道 機器開啟。在預設安裝下，這些記錄位於：

C:\Program Files\Qlik\ConnectorAgent\data\logs

變更記錄詳細資訊層級

您可以根據需要檢視並變更 直接存取閘道 (DirectAccessAgent) 記錄的記錄詳細資訊層級。若要這麼做，從 ConnectorAgent 子資料夾 (預設安裝為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) 執行下列命令。

• 如要檢視目前的記錄層級，請執行：

  connectoragent configuration getloggers

• 如要將記錄層級設定為「追蹤」，請執行：

  connectoragent configuration setloggers -l Root -v DEBUG

• 如要將記錄層級設定為「詳細資訊」，請執行：

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

更新註冊金鑰

在金鑰損毀這種不太可能發生的事件中，或者若您懷疑未獲授權的使用者存取資料閘道伺服器，可能有必要變更註冊金鑰。

若要更新註冊金鑰：

1. 在直接存取閘道伺服器上，以管理員身分開啟命令提示字元並將工作目錄變更為 ConnectorAgent 子資料夾 (預設安裝為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)。

2. 執行下列命令：

   • 產生新的金鑰：

     connectoragent qcs generate_keys

   • 顯示金鑰：

     connectoragent qcs get_registration

     就會顯示金鑰：

     

3. 複製整個金鑰，如上面範例所示。

4. 在 管理主控台 中，按一下相關列末尾的 按鈕並選取編輯，以開啟資料閘道設定。

5. 在金鑰欄位中貼上金鑰 (取代目前金鑰) 並儲存設定。

6. 返回直接存取閘道伺服器並重新啟動 Qlik 資料閘道 - 直接存取 服務，如 管理 Qlik 資料閘道 - 直接存取 服務 中的說明。

遷移連接器在載入期間毀損

流程隔離允許可直接存取閘道伺服器作業系統的管理員控制每個連接器類型有多少處理程序可用於載入。在多個連接器處理程序上擴展載入會增加隔離程度，方法是減少每個連接器處理程序上同時執行的載入次數。若發生連接器毀損，這反過來可以改善整體 直接存取閘道 穩定性。

若要開啟處理序隔離：

1. 開啟 C:\ProgramData\Qlik\Gateway\configuration.properties 檔案。若您透過 Windows Explorer 這麼做，務必選取顯示隱藏的檔案、資料夾和磁碟機。

   檔案包含三個對應至不同連接器類型的前置詞：ODBC_<property-name>、SAPBW_<property-name> 和 SAPSQL_<property-name>。

2. 將 ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE 設定為載入並將 ODBC|SAPBW|SAPSQL_MAX_PROCESS_COUNT 設定為 N。

   其中：

   N = 一個命令處理序 + 要配置的並行載入處理序數量。因此，例如，值 10 表示最多 9 個並行載入。

   資訊備註

   在預設連接埠號碼和範圍設定之下，您無法設定高於 10 的 [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT 值。

3. 儲存 configuration.properties 檔案並重新啟動 Qlik 資料閘道 - 直接存取 服務。

若要關閉處理序隔離：

1. 開啟 C:\ProgramData\Qlik\Gateway\configuration.properties 檔案。若您透過 Windows Explorer 這麼做，務必選取顯示隱藏的檔案、資料夾和磁碟機。

2. 將 ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE 設定為無。

3. 儲存 configuration.properties 檔案並重新啟動 Qlik 資料閘道 - 直接存取 服務。

ODBC 連接器處理序隔離範例

下列 configuration.properties 檔案節錄顯示如何為最多 9 個載入啟用 ODBC 連接器處理序隔離：

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=10

若您變更預設連接埠設定，MAX_PROCESS_COUNT 值可以超過 10。不過，在此情況下：

• ODBC_PORT 或 ODBC_DATA_PORT_RANGE_START 和 SAPBW_PORT 或 SAPBW_DATA_PORT_RANGE_START 之間的連接埠數量必須等於或大於 ODBC_MAX_PROCESS_COUNT

• SAPBW_PORT 或 SAPBW_DATA_PORT_RANGE_START 和 SAPSQL_PORT 或 SAPSQL_DATA_PORT_RANGE_START 之間的連接埠數量必須等於或大於 SAPBW_MAX_PROCESS_COUNT

因此，例如，若要設定 ODBC_MAX_PROCESS_COUNT=30，連接埠參數應如下所示：

# ODBC Connector

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=30

ODBC_DATA_PORT_RANGE_START=50260

ODBC_PORT=3005

# SAP BW Connector

SAPBW_PROCESS_ISOLATION_MODE=None

SAPBW_MAX_PROCESS_COUNT=0

SAPBW_DATA_PORT_RANGE_START=50290

SAPBW_PORT=3035

# SAP SQL Connector

SAPSQL_PROCESS_ISOLATION_MODE=None

SAPSQL_MAX_PROCESS_COUNT=0

SAPSQL_DATA_PORT_RANGE_START=50300

SAPSQL_PORT=3045