Tableau Desktop 或 Tableau Prep Builder 授權疑難排解

啟用 Tableau Desktop 或 Tableau Prep Builder 時,啟用可能不會總是完全按計劃進行。在本文中,可以找到有關如何對可能遇到的問題進行疑難排解的資訊以及如何解決這些問題的建議。

本主題中的疑難排解步驟僅適用於使用產品金鑰啟用的 Tableau Desktop 和 Tableau Prep Builder。

其他授權情境疑難排解:

搜尋支援知識庫

為了幫助您快速找到問題的答案,可以搜尋 Tableau 知識庫。知識庫包含可用於解決問題的疑難排解技能、已解決的已知問題描述、並提供常見問題的答案。

  1. 要搜尋疑難排解文章,請移至知識庫
  2. 輸入描述。
  3. 在「支援」頁面中,從「資源」索引標籤中選取「知識庫」

解決啟動或開啟 Tableau Desktop 或 Tableau Prep Builder 時的 FlexNet 授權錯誤

如果 Tableau 授權服務無法讀取或存取產品金鑰,您可能會看到以下錯誤之一:

  • 找不到「TableauDesktop」的授權

  • 無法新增授權

  • 函數 flxActCommonLicSpcPopulateFromTS 返回了錯誤 50030、71521、0

若要診斷和解決錯誤,請按所示順序嘗試此部分中的步驟。

1.驗證系統日期和時間

驗證電腦上的日期和時間是否設定為目前日期。如果電腦上的時鐘設定為早於目前日期的日期,則無法啟動 Tableau。

2.驗證是否安裝了 FlexNet Licensing Service

安裝 Tableau Desktop 時會自動安裝 FlexNet Licensing Service。Tableau 需要此服務才能執行。在 Mac 上安裝 Tableau Desktop 時,可能會提示您輸入密碼,為安裝程式提供安裝 FlexNet 的權限。對於 Windows,使用者帳戶設定中隱含了安裝 FlexNet 的權限。

若要檢查電腦上是否正確安裝了授權服務,請完成以下步驟:

Windows

  1. 巡覽到以下資料夾:

    C:\Program Files\Common Files\Macrovision Shared\FlexNet Publisher

  2. 驗證該資料夾中是否有 FNPLicensingService 應用程式。

    如果未安裝 FlexNet 授權服務,請嘗試重新安裝 Tableau Desktop 或檢查您的使用者帳戶權限設定。

Mac

  1. 啟動終端應用程式。

  2. 鍵入以下命令以列出 FlexNet 目錄的內容:

    ls '/Library/Application Support/FLEXnet Publisher/Service/11.16.2/FNPLicensingService'

    如果命令未返回任何內容,或者返回訊息No such file or directory(無此檔或目錄),則未安裝授權服務。有關如何手動安裝 FlexNet Licensing Service 的資訊,請參閱 Tableau 知識庫中的在 Mac 上啟動時出現錯誤:「FlexNet Licensing Service 在系統上不存在」(連結在新視窗開啟)

3.驗證 FlexNet Licensing Service 是否正在執行

如果驗證了 FlexNet Licensing Service 已安裝,請驗證該授權服務是否正在執行。如果未在執行,您可能需要手動啟動該服務。若要啟動該服務,請根據您的作業系統完成下面的步驟,然後重新開機 Tableau Desktop。

Windows

  1. 從 Windows 的「開始」功能表中,開啟 services.msc

  2. 「服務」對話方塊中,驗證 FlexNet Licensing Service 的狀態是否為「已啟動」

    如果「啟動」選項顯示為灰色,請在清單中以滑鼠右鍵按一下「FlexNet Licensing Service」,並選取「屬性」。在「常規」索引標籤上,按一下「啟動」,然後按一下「確定」關閉對話方塊。

Mac

  1. 啟動終端應用程式。

  2. 巡覽到 FlexNet 目錄:

    '/Applications/Tableau Desktop <Tableau version.app>/Contents/Frameworks/FlexNet/'custactutil -view

    例如, '/Applications/Tableau Desktop 2021.3.app/Contents/Frameworks/FlexNet/'custactutil -view

  3. 驗證 FlexNet Licensing Service 是否正在執行。您應會看到 Trust Flags = FULLY TRUSTEDStatus = ENABLED

  4. 然後使用以下命令將輸出儲存到桌面上的一個檔案:

    /Applications/Tableau\ Desktop\ <Tableau version.app>/Contents/Frameworks/FlexNet/custactutil -view > /users/$(whoami)/Desktop/licresults.txt

4.修復受信任的存放

如果 FlexNet Licensing Services 已安裝並正在執行,但您仍然看到錯誤,則 Tableau 產品金鑰資訊可能有問題。若要解決此問題,請完成以下步驟以修復位於以及儲存在受信任的存放中的金鑰資訊。

附註: 您將需要存取位於 bin 資料夾中的「客戶啟動公用程式」來執行這些步驟。

Windows

  1. 開啟命令視窗,並巡覽到「客戶啟動公用程式」所在的目錄。例如:

    cd "C:\Program Files\Tableau\Tableau <version>\bin"

    其中 <version> 是您安裝的 Tableau 產品版本。

  2. 輸入以下命令:

    custactutil –localrepair

  3. 啟動 Tableau。

    如果修復未成功,請鍵入以下命令以建立 LicResults.txt 檔案:

    custactutil -view >LicResults.txt

    聯絡技術支援(連結在新視窗開啟)並在您建立的檔案中包含LicResults.txt

Mac

  1. 啟動終端應用程式。

  2. 巡覽到 FlexNet 目錄:

    cd /Applications/Tableau Desktop <version>.app>/Contents/Frameworks/Flexnet

  3. 輸入以下命令:

    ./custactutil -localrepair

  4. 啟動 Tableau。

  5. 如果修復未成功,請鍵入以下命令以建立 LicResults.txt 檔案:

    ./custactutil -view > /users/<username>/licresults.txt

    聯絡技術支援(連結在新視窗開啟)並在您建立的檔案中包含LicResults.txt

使用啟動結束代碼排除啟動錯誤

在啟動 Tableau 並包括 -activate 選項時,啟動過程會透過將 ERRORLEVEL 環境變數設定為結束代碼來返回狀態資訊。如果啟動成功,Tableau 應用程式結束代碼為 0(零)。下表列出了啟動過程中的結束代碼及其含義。

如果啟動失敗,您還可以在 Tableau 記錄檔中找到錯誤資訊。記錄檔位於目前使用者的 Documents 資料夾下 My Tableau Repository 資料夾中的 Logs 資料夾內。例如:

/Users/<user>/Documents/My Tableau Repository/Logs

以下範例指令碼顯示了如何啟動適用於 Windows 的 Tableau Desktop 並檢查特定錯誤,例如無效的產品金鑰 (536871018) 和一般授權問題 (536871012)。

@echo off
start/wait tableau.exe -activate  <product_key>
if %errorlevel% EQU 536871018 (ECHO TABLEAU_ERROR_LICENSING_INVALID_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU_ERROR_LICENCING_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)
結束代碼訊息
536871012TABLEAU_ERROR_LICENSING_GENERAL授權操作過程中發生未知錯誤。
536871013TABLEAU_ERROR_LICENSING_INTERNAL產品由於內部授權錯誤而無法啟動。
536871014TABLEAU_ERROR_LICENSING_SETUP產品由於內部授權錯誤而無法啟動。
536871015TABLEAU_ERROR_LICENSING_CONNECT與 Tableau 授權伺服器聯絡時出錯。
536871017TABLEAU_ERROR_LICENSING_ACTIVATION_ASR啟動 ASR 時出錯。
536871016TABLEAU_ERROR_LICENSING_ACTIVATION_GENERAL啟動失敗,請重試。
536871018TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEY產品金鑰無效。
536871019TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINE無法完成離線啟動。
536871020TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODEL授權伺服器返回了錯誤。請檢查 Tableau 記錄檔案以瞭解詳細資料。
536871033TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONS由於您已達到此授權的啟用次數限制,因此無法啟用授權。
536871022TABLEAU_ERROR_LICENSING_UNLICENSED_GENERAL取消授權操作過程中發生未知錯誤。請檢查產品金鑰或與支援人員聯絡。
536871023TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUND找不到授權。
536871024TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED只找到過期的產品金鑰。
536871025TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIAL此版本的試用期已結束。
536871026TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTION產品金鑰已過期。
536871027TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCE維護已過期。
536871028TABLEAU_ERROR_LICENSING_RESYNC_GENERAL無法同步產品金鑰。
536871029TABLEAU_ERROR_LICENSING_REGISTRATION_GENERAL產品註冊過程中出錯。
536871030TABLEAU_ERROR_LICENSING_SERVICE_INSTALL授權操作過程中發生未知錯誤。
536871031TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALL授權操作過程中發生未知錯誤。

存取授權伺服器疑難排解

任何需要特殊設定(例如靜態 IP 安全清單)才能存取 licensing.tableau.comatr.licensing.tableau.com 的環境都需要先更新,然後才能啟用、重新整理或停用 Tableau 產品金鑰。

若要檢查是否為此問題,請執行以下操作:

  1. 在 Web 瀏覽器中,巡覽到以下地址:

    • https://licensing.tableau.com/_status/healthz

    • https://atr.licensing.tableau.com/_status/healthz

    您應該會在頁面上看到一條「確定」訊息。

  2. 如果未看到成功頁面,您可能需要更新本機環境才能存取授權服務。有關更多詳細資訊,請參閱 Tableau 社群(連結在新視窗開啟)

有關 Tableau DesktopTableau Prep Builder 網際網路地址要求的其他詳細資訊,請參看所需的位址、Proxy 和連接埠

授權報告疑難排解(僅限於 Tableau Desktop)

正確設定 Tableau Server 和 Tableau Desktop 執行個體後,可在兩個管理檢視(Desktop 授權使用情況(連結在新視窗開啟)Desktop 授權過期(連結在新視窗開啟))中獲得 Tableau Desktop 授權使用情況資訊。如果無法看到這些檢視,或者檢視中沒有資料,則授權報告可能存在問題。下面各部分可幫助您找出故障原因。

有關如何設定 Tableau Desktop 報告的資訊,請參閱管理 Tableau Desktop 授權使用情況

管理檢視不可用

只有 Tableau Server 管理員才能使用桌面授權報告管理檢視。如果在「伺服器狀態」頁上看不到「桌面授權使用情況」和「桌面授權過期」檢視的連結(從「網站」功能表中選取「管理所有網站」),請驗證以下各項:

  • 您以 Tableau Server 管理員身分進行了登入。

  • 授權報告在 Tableau Server 中啟用。(該功能預設情況下已停用。)有關詳細資訊,請參閱本指南的管理 Tableau Desktop 授權使用情況一文中有關在 Tableau Server 上啟用授權報告的過程。

管理檢視不包括預期內容

如果您未看到期望的資料,這可能是因為此處列出的原因之一。

Tableau Desktop 是在最近八小時內設定的

預設情況下,Tableau Desktop 按八小時的間隔來報告授權資料。如果自從為報告設定 Tableau Desktop 執行個體以來還不到八小時,您可能在管理檢視中看不到使用量資料。Tableau Desktop 執行時每八小時報告一次,在啟動正確設定的 Tableau Desktop 執行個體時開始計小時數。

如果達到八小時後 Tableau Desktop 仍然沒有執行,下次啟動 Tableau Desktop 時會傳送報告。設定 Tableau Desktop 執行個體之後至少要等待八個小時,然後再在「桌面授權報告」檢視中查找那些授權。

以下事件會強制立即從正確設定的 Tableau Desktop 執行個體向 Tableau Server 報告:

  • 啟用 Tableau Desktop

  • 停用 Tableau Desktop

  • 更新 Tableau Desktop 授權的維護

Tableau Desktop 自設定授權報告以來尚未重新開機

為授權報告設定要報告到的伺服器位址時,如果已在執行 Tableau Desktop,則必須重新啟動 Tableau Desktop。

自從針對授權報告設定以來,Tableau Desktop 尚未開啟

如果自從針對報告進行設定以來 Tableau Desktop 尚未開啟,您可能在管理檢視中看不到使用量資料。只有當 Tableau Desktop 正在執行時,才會報告授權資訊。

未針對授權報告正確設定 Tableau Desktop

驗證是否為 Tableau Desktop 的執行個體正確設定了要報告到的 Tableau Server 位址。

使用 Tableau Desktop 電腦上的記錄檔來說明確定是否正確設定了執行個體。查找記錄檔 %Documents%\My Tableau Repository\Logs\log.txt。搜尋“licUsageReport" 要查找與授權報告相關的條目。

授權報告的錯誤訊息

下表列出了可以幫助確定授權報告問題的記錄訊息。

記錄訊息詳細資訊和可能的原因
licUsageReport: Response code from server: <server> is: 200Tableau Desktop 已成功向伺服器報告。
licUsageReport: Response code from server: <server> is: 0

Internet communication error: Couldn't connect to server (server_name).

針對錯誤的協定設定了 Tableau Desktop。例如,將伺服器設定為支援 HTTPS,而 Tableau Desktop 設定為使用 HTTP 進行報告。

Tableau Desktop 向不存在的伺服器報告。

Tableau Desktop 正在向未執行的 Tableau Server 執行個體進行報告。

licUsageReport: License reporting server config does not exist登錄機碼未設定,或在登錄檔 (Windows) 或 .plist 檔案 (Mac) 中的錯誤位置。

在 Mac 電腦上,在錯誤位置建立了 .plist 檔後,可能會記錄此訊息。例如,.plist 檔已建立到或已複製到 ~\Library\Preferences(而不是 \Library\Preferences)中。

在 Mac 電腦上,如果建立了 .plist 檔案,但後來用一個新的或變更的伺服器名稱更新了該檔案,並且未重新開機 Mac 電腦,則可能會記錄此訊息。

變更預設報告間隔

預設情況下,如果針對 Desktop 授權報告進行了設定,Tableau Desktop 將每八小時向設定的一個或多個伺服器進行報告。可在 Tableau Desktop 電腦上修改登錄檔或 .plist 檔案來變更此間隔。對於疑難排解,這特別有用。

Windows

若要從 Windows 電腦中變更 Tableau Desktop 向伺服器報告的頻率,請編輯登錄檔,向 ReportingServer 項中新增一個字串值:

  • 路徑:HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ReportingServer

  • 名稱:新增一個名為 scheduleReportInterval 的字串值。

  • 資料:Tableau Desktop 向伺服器傳送報告的間隔時間量(以秒為單位)。預設情況下,此值為 8 小時,如果沒有條目,則使用預設值。如有必要,可增加此值以進行疑難排解,但請記住,間隔越頻繁,產生的網路流量就越多。

    例如,下圖顯示的登錄檔設定使 Tableau Desktop 每小時(3600 秒)向設定的 Tableau 伺服器進行報告:

Mac

若要變更 Mac 的 Tableau Desktop 向伺服器報告的頻率,請編輯 /Library/Preferences 中的 com.tableau.ReportingServer.plist 檔案,新增 scheduleReportInterval 項。將此項設定為報告從 Tableau Desktop 到達設定的 Tableau Server 所需的時間長度(以秒為單位)。以下範例顯示了一個 .plist 檔的內容,該檔設定為每小時(3600 秒)將資訊傳送到兩個伺服器(https://mytableau02:8010http://mytableau)。

 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  <plist version="1.0">
    <dict>
      <key>Server</key>
      <string>https://mytableau02:8010,http://mytableau</string> 
      <key>scheduleReportInterval</key>
      <string>3600</string>
    </dict>
</plist>
感謝您的意見反應!已成功提交您的意見回饋。謝謝!