反饋已提交

網絡繁忙

遠端設計常見問題

1. 常見排查步驟

1. 1 查看是否支援遠端設計。

場景描述:遠端設計連結前,需要先應答遠端的工程是否支援遠端設計功能點。

解決方案:登入數據決策系統,查看http://IP:port/webroot/decision/remote/design/vt的傳回值,若傳回{"data":"success"},代表支援。

1.2 查看使用者權限

場景描述:非超管賬戶遠端設計連結失敗。

解決方案:超管登入數據決策系統,查看是否為使用者分配了遠端設計的權限,詳情請參見:遠端設計 。

1.3 查看JAR包版本

場景描述:本地設計器版本和遠端JAR包版本不一致,會導致很多問題。

解決方案:遠端連結時,若版本不匹配,會提示版本不一致,遠端設計時部分功能將受影響。如下圖所示。建議及時更新,保證伺服器和設計器版本一致。版本相關說明詳見:升級指南

11.png

1.4 檢查設定是否正確

首檢查遠端設計的配置介面的資訊是否正確,參考:遠端設計,可點選測試連結,根據報錯提示和日誌報錯進行排查。

2. 31300101 遠端設計無權限

問題簡介:遠端設計連結時,使用的決策系統帳號沒有遠端連結權限,無法遠端連結到伺服器工程。

解決方案:請聯系超級管理者,為需要遠端的使用者分配「遠端連結權限」,詳情請參見:給使用者分配遠端設計權限範例 。

3. 31300102 範本已鎖定

3.1 遠端設計範本佔用(已被鎖定)的判斷機制

問題簡介:開啟了範本,重啓伺服器後開啟遠端工作區間發現範本已鎖定,但只有一個人在編輯。

原因分析:範本鎖的釋放邏輯為每1分鍾清理下,判斷是否釋放的前提是該範本在1分鍾半中沒有其他人操作。

解決方案:重啓伺服器,或者等一段時間會被釋放。

3.2 範本已鎖定

問題簡介:遠端設計開啟一張範本時,提示「範本已鎖定」。

原因分析:範本鎖定的原因有以下幾種:

1)多人編輯:使用者A和使用者B同時遠端連結了該工程,使用者A開啟了X範本。使用者B開啟X範本時,提示範本已鎖定。

2)開發者除錯:使用者A和使用者B同時遠端連結了該工程,使用者A在開發者除錯狀態下編輯X範本。使用者B開啟X範本時,提示範本已鎖定。

解決方案:詳情請參見:遠端設計範本鎖定

4. 11300104 遠端設計連結失敗

4.1 報錯 Response HTTP/1.1 404 by

問題簡介:遠端設計連結時報錯:com.fr.workspace.engine.exception.WorkspaceConnectionException: Response HTTP/1.1 404 by  http://IP:埠號/webroot/decision

解決方案:卸載重裝設計器。

4.2 報錯 The SolidRecordExecutor should be register first

問題簡介:遠端設計連結時報錯:The SolidRecordExecutor should be register first

原因分析:伺服器沒有安裝雲端健檢分析插件,不影響功能的正常使用。

這個是伺服器上埋點功能相關的報錯 只不過是透過遠端設計日誌派送推到設計器上展示,實際上與遠端設計功能本身無關。

4.3 遠端設計偶發連結失敗

問題簡介:遠端設計連結偶發出現連結失敗的情況,設計器頁面會出現遠端主機強迫關閉了一個現有的連結,就無法連結到伺服器了。

原因分析:Tomcat中配置了一個連結逾時時間connectionTimeout,如果在這個時間之後用戶端還未得到伺服器端的響應的話,就會主動斷開連結,即出現上述異常了。

解決方案:Tomcat中預設連結逾時時間是20秒,一般最好設定為60秒,進而避免後臺過程處理時間長導緻連結斷開,修改如下:connectionTimeout="60000"。

4.4 遠端設計頻繁斷開

問題簡介:

遠端設計,頻繁斷開。

報錯:網路連結異常:websocket已斷開。如下圖所示:

排查方案:

1)管理者登入數據決策系統,點選「管理系統>智慧維運>記憶體管理」,查看「記憶體預警」Tab 下「記憶體利用率和「CPU 利用率」兩張圖是否顯示空白。

 若顯示空白,則說明 WebSocket 連結失敗,請參考文檔配置 WebSocket 埠:Websocket 連結失敗

2)檢查網路是否連通:ping ip位址是否聯通、檢查vpn是否有問題、檢查網路狀況。

5. 11300105 遠端設計使用者名密碼錯誤

5.1 帳號密碼錯誤

原因分析:遠端設計連結時,使用的決策系統帳號密碼不正確。

解決方案:使用和遠端設計連結一緻的位址、帳號、密碼,在瀏覽器進行存取登入,檢查是否能正常登入。如無法正常登入,請聯系管理者應答自己的帳號密碼是否正確。

5.2 無遠端連結權限

原因分析:遠端設計連結時,填寫的帳號和密碼,沒有遠端設計的權限,需要聯系管理者新增。

解決方案:請聯系超級管理者,為需要遠端的使用者分配「遠端連結權限」,詳情請參見:給使用者分配遠端設計權限範例 。

5.3 PC端使用使用者限制

原因分析:系統開啓了「PC端使用使用者」限制,但是遠端設計使用的決策系統帳號密碼不在「PC端使用使用者」。

解決方案:請聯系管理者,將遠端設計使用的決策系統帳號新增到「PC端使用使用者」中。

6. 31300106 遠端設計無權限修改配置

6.1 沒有權限編輯/儲存範本

問題簡介:使用者在遠端設計時,試圖編輯/儲存沒有權限的範本。

解決方案:請聯系超級管理者,為需要遠端的使用者分配「遠端設計範本權限」和「資料連結權限」,詳情請參見:給使用者分配遠端設計權限範例 。

6.2 找不到範本

排查步驟:

1)linux環境,檢查編碼,中文字體

2)查看登入功能點,是否有這個功能點

3)檢查遠端設計使用者權限

4)檢查範本權限

5)檢查範本所屬的賬戶組

6.3 編輯範本儲存失敗

問題簡介:遠端伺服器儲存範本時,報錯:"xxx.cpt" is locked by user admin with client xxx,client後的編號和設計器編號一緻,但是遠端設計和激活碼是不限制的。

原因分析:

傳送的請求中只要包含了特定字串,那麼伺服器在讀取的時候就會發生java.io.IOException: Connection reset by peer 導緻拿不到。

這是伺服器網路問題,是某種 SQL 防注入安全策略。

解決方案:請伺服器網路維運相關負責人,修改網路安全攔截策略,將/webroot/decision/remote/design/*相關請求加入白名單。

6.4 儲存範本沒有權限

問題簡介:使用超級管理者帳號遠端設計,儲存範本時出現以下現象:

  • 儲存範本,提示沒有權限

  • 子目錄有查看權限但不顯示

  • 範本已儲存在伺服器環境,但依然提示“請將範本儲存在當前運作環境”

  • 日誌中出現報錯:NoHttpResponseException

原因分析:服務端斷開了http連結,但並沒有通知用戶端,下次請求該服務時httpclient繼續使用該連結導緻報錯

解決方案:調整tomcat配置:修改 Tomcat 的 server.xml 的 connectionTimeout ,調大後重啓生效。


6.5 儲存時發現範本鎖定資訊不一緻,是否生成備份檔案

場景描述:

在遠端設計下開啟了範本,修改了內容但是沒儲存。

然後切換到本地目錄後,再切換回遠端目錄,再次預覽或者儲存時提示「儲存時發現範本鎖定資訊不一緻,是否生成備份檔案」。

並且另存了備份後原來修改的內容也沒生效。

解決方案:將工程升級到11.0.6及以上即可解決。

7. 11300107 遠端設計功能未登入

問題簡介:遠端的工程未購買遠端設計功能點。

排查步驟:登入數據決策系統,查看http://IP:port/webroot/decision/remote/design/vt的傳回值,若傳回{"data":"success"},代表支援。

解決方案:請聯系帆軟銷售,增購遠端設計功能點。

8. 11300108 憑證域名資訊錯誤

8.1 什麼時候需要憑證

憑證來源
是否需要新增憑證
CA簽發的憑證

僅勾選https即可,無需新增憑證

透過keytool等工具生成的自簽章憑證勾選https後,需要新增憑證作為信任

8.2 不支援免費ssl憑證

問題簡介:使用了阿裏雲的免費ssl憑證,格式是pfx,配置好後直接存取位址可以進入決策平台,但是遠端設計連結失敗。

解決方案:不支援免費的ssl憑證,可以先轉成.keystore憑證。

8.3 不支援crt憑證

問題簡介:遠端設計不支援 crt 憑證。

解決方案:可以將crt轉換成jks的憑證。

8.4 遠端設計啟用https無法連結bi伺服器

問題簡介:根據文檔「配置 SSL 憑證實現 HTTPS 存取」後,CAS 單點登入正常,但是遠端設計連結伺服器無法連結成功。

原因分析:客戶本機的hosts檔案沒有配置域名導緻無法本地透過域名存取到伺服器。

解決方案:將本機的hosts檔案配置好正確的域名之後,重啓服務之後本地正常遠端設計連結。

8.5 報錯 result does not conform to JSON format

問題簡介:遠端設計連結時報錯:Caused by: java.lang.RuntimeException: result does not conform to JSON format!

原因分析:

遠端連結登入響應傳回的不是json格式資料。
請查看是不是配置了單點登入,如果配置了單點,需要過濾遠端設計的請求 /remote/design/*
解決方案:詳情請參見:11.0整合CAS後的遠端設計

8.6 報錯 doesn't match any of the subject alternative names

遠端設計連結時報錯:doesn't match any of the subject alternative names

8.6.1 憑證未綁定域名

原因分析:若報錯資訊後面跟隨的列表為空,說明憑證生成時沒有綁定域名。

解決方案1:重新生成憑證,綁定域名,連結成功。以keytool生成自簽章憑證為例,下圖所示即是綁定的域名:


解決方案2:若更換憑證代價較大或者其他原因導緻不能綁定域名,在設計器%FR_HOME%\bin\designer.vmoptions檔案中新增一行,重啓設計器即可:-Dfine.remote.design.skipHostnameVerifier=true


8.6.2 憑證和遠端設計的域名不一緻

原因分析:遠端設計配置時使用的域名不是憑證生成時填寫的域名。

解決方案:遠端設計配置時,輸入與憑證一緻的域名。

8.6.3 IP和域名未映射

原因分析:自簽章憑證使用時,設計器本地電腦沒有在host檔案中做ip與域名之間的映射

解決方案:以windows為例,在設計器所在電腦的host檔案中新增 ip  域名的映射  如下:


8.7 報錯 Unrecognized SSL message, plaintext connection?

問題簡介:遠端設計連結時報錯:Unrecognized SSL message, plaintext connection?

解決方案:埠錯誤,提供的不是 https 服務的埠,詳情請參見:請求遇到異常分析

8.8 報錯 unable to find valid certification path to requested target

問題簡介:存在以下關鍵報錯資訊 

SSLHandshakeException  sun.security.validator.ValidatorException:  PKIX path building failed

SunCertPathBuilderException: unable to find valid certification path to requested target

排查步驟1:參考 8.1 節,應答是否需要新增憑證,若無需新增,刪除憑證即可。

排查步驟2:應答新增的憑證是否正確,比如伺服器用nginx做了代理,此時遠端設計新增的憑證應該是nginx使用的https憑證。

排查步驟3:嘗試新增憑證到設計器jre的憑證庫中。詳情請參見:https://www.cnblogs.com/chenxushu/p/7340263.html

排查步驟4:單點也做了https,伺服器過濾器前後位置放置錯誤。

8.9 報錯 Tag mismatch

問題簡介:遠端設計連結時報錯:SSLHandshakeException  Tag mismatch

解決方案:這是由於jdk bug引起的,請將工程所使用的jdk版本升級。

9. 11300113 不匹配的遠端設計版本

場景描述:本地設計器版本和遠端JAR包版本不一緻,會導緻很多問題。詳情請參見:伺服器和設計器的JAR包不匹配 。

解決方案:建議及時更新,保證伺服器和設計器版本一緻。

10. 11300114 範本已被超管解除鎖定,儲存失敗,建議另存範本

場景描述:遠端設計時,若範本正在被編輯,支援超管解鎖範本,正在編輯的使用者可另行備份範本。

解決方案:另存範本即可。

11. 11300116 遠端設計主機位置不支援重定向

遠端連結時,若包含get請求、post請求,禁止重定向,需要修改主機位置。

11.1 配置了虛擬目錄的工程無法連結

問題簡介:使用者工程做了虛擬目錄配置,配置遠端設計連結是無法連結。

解決方案:在虛擬目錄後面(即:Servlet處)加了/desicion,連結成功。

11.2 內網環境無法遠端設計連結伺服器

問題簡介:

沒有做重定向和攔截設定,外網映射就正常連結,改成VPN內網之後用戶端遠端設計就出現連結失敗。

日誌:failed: Connection timed out: connect
警告:com.fr.workspace.engine.exception.WorkspaceConnectionException: remote design connect failure

解決方案:

1)VPN適配的問題,開啓VPN裏面用戶端連結的所有的權限即可。

2)深信服VPN ,需要將伺服器 IP 和 埠設定成 L3VPN資源,設計器才能遠端連結存取。

12. 11300117 遠端伺服器網路配置存在問題

12.1 請求被伺服器網路攔截

問題簡介:切換遠端目錄失敗 ,且設計器日誌中有類似報錯:java.util.zip.ZipException: Not in GZIP format

原因分析:遠端設計請求被伺服器網路攔截了。

解決方案:請伺服器網路維運相關負責人,修改網路安全攔截策略,將/webroot/decision/remote/design/*相關請求加入白名單。

12.2 伺服器已關閉

問題簡介:遠端連結測試是通的,切換到遠端設計後一直會彈出提示框,提示伺服器已關閉(實際是沒有關閉的)。

解決方案:遠端設計要加上埠,如果是做了直接存取 ip 的設定,那一般是預設 80 埠。

12.3 Nginx 504 Gateway Time-out  

問題簡介:遠端設計出現切換慢/操作卡,且設計器日誌中有類似報錯:

com.fr.workspace.engine.exception.WorkspaceConnectionException: Response HTTP/1.1 504 Gateway Time-out by 10.1.1.96:80

原因分析:

Nginx 504 Gateway Time-out的含義是所請求的網關沒有請求到,

簡單來說就是沒有請求到可以執行的PHP-CGI。

Nginx 504 Gateway Time-out一般與Nginx.conf的設定有關。

解決方案:

調整nginx.conf參數  重啓nginx生效。預設fastcgi進程響應的緩沖區是8K,可以調大以下參數:

  • fastcgi_buffer_size 128k

  • fastcgi_buffers 8 128k

  • fastcgi_busy_buffers_size 由 128K 改為 256K

  • fastcgi_temp_file_write_size 由 128K 改為 256K

13. 遠端設計資料連結出錯

13.1 資料連結失敗

問題簡介:遠端設計時,資料連結失敗,或者資料連結測試連結成功,但是建立資料庫查詢時顯示失敗。

解決方案:檢查伺服器和設計器jar包是否一緻,保持一緻即可。

13.2資料連結密碼為無

問題簡介:遠端設計時,現有的資料連結密碼丟失,無法連結。重新填寫密碼後連結,都會報錯密碼為無。設計器日誌報錯Decrypt failed:Decryption error

解決方案:工程有祕鑰種檔案,在config下面,如default_alpha、default beta、default gamma,刪掉即可。

13.3 遠端設計無法看到 Excel 檔案

問題簡介:遠端設計無法看到 Excel 檔案,這是需求,暫時無法支撐。

13.4 遠端設計選不了json資料集

問題簡介:本地可以正常選到json資料集的連結,但是遠端設計下選不到。

解決方案:關閉 遠端設計資料連結權限控制 。

13.5 遠端設計連結成功後看不見資料連結

問題描述:普通使用者FR11.0遠端設計連結成功,但是看不見資料連結,全是空白的。

原因分析:平台插件-資料平台導致的異常,該插件會影響權限生效

解決方案:直接刪除或者禁用插件,如不生效,刪除禁用後重啓下恢復正常。

14. 叢集遠端設計出錯

14.1 範本開啟是建立的空白範本

問題簡介:遠端設計所有範本都無法開啟,所有範本開啟是建立的空白範本

原因分析:redis 存在髒資料

解決方案:清空redis,如果是使用redis叢集,每個節點都需要清空

14.2 範本無法儲存

問題簡介:遠端設計時出現範本儲存不上,且伺服器日誌中有以下類似報錯:java.lang.NullPointerException

原因分析:redis 存在髒資料

解決方案:清空redis,如果是使用redis叢集,每個節點都需要清空

14.3 切換遠端目錄卡慢,開啟報表卡死

問題簡介:遠端設計目錄切換速度很慢,開啟伺服器上範本直接卡死。

排查方向:

1)叢集環境,檢查 nginx 等配置是否正確,調整 nginx 的參數。

2)查看 redis 狀態伺服器是否異常,重啓 redis 之後再次遠端。

14.4 叢集環境遠端設計連結LogDB查詢報錯

問題簡介:遠端設計連結後,資料集查詢 LogDB 中的表,匯出 SQL 時報錯。

原因分析:Swift 取數限制導緻。

解決方案:

1)刪除叢集節點中舊的 LogDB。

2)清空 FineDB 中的 fine_swift_seg_location 和 fine_swift_segments 兩張表。

3)重啓叢集節點。

15. 遠端設計無法儲存預覽範本

15.1 一部分範本無法開啟

問題描述:

1)遠端連結使用設計器打不開一部分範本,一部分可以開啟,設計器日誌報錯:

ERROR: read error report content,ERROR: 範本缺失

2)遠端連結使用設計器雙擊開啟幾個 cpt 打不開,並且自動建立了一個空 cpt,日誌裏有遠端設計無權限的報錯。

原因分析:

1)FTP 磁碟記憶體滿了後,造成了使用設計器修改或者建立的範本,點選儲存後為 0KB,且沒有生成 .tmp 備份檔案,無法還原。

2)使用者帳號權限無法開啟範本或伺服器中使用者權限缺失。

解決方案:

1)清理 FTP 磁碟記憶體即可。

2)使用超管帳號登入,或修改伺服器中的使用者權限。

15.2 遠端設計不能儲存範本

問題描述:目錄切換為遠端設計,所有已經做好的範本不能進行改動儲存,儲存報錯:儲存失敗!建立範本可以進行儲存,遠端的範本切換到本地預設環境也是可以儲存的。本地建立範本以及重新儲存之前的範本都是正常的。不能儲存的時候報錯:

Workspace rpc target not found by class interface com.fr.esd.core.remote.ESDConfigEventOperator , reasons may be : 1.servers' jar version is not consistence with client 2. some plugins are not consistence , please check its version。

原因分析:這個路徑 classes/com/fr/config/server/server.xml 下的 server.xml 檔案本來應該存在 fine-activator.jar 裏。

classes 優先更高,優先讀取這個路徑下的檔案造成的異常。

解決方案:刪除伺服器中 classes/com/fr/config/server/server.xml 下的 server.xml 檔案,重啓伺服器。

16. 其他問題

16.1 遠端設計插件安裝邏輯

對於設計器和伺服器都會用到的插件,要求伺服器端和設計器端都要安裝:

1)若設計器端已經有插件,伺服器端的插件下載、刪除、禁用 不會立即生效,需要等幾分鍾才會生效

2)若伺服器端有插件,設計器端沒有插件,則插件不會生效,需要切換到本地進行插件安裝。

不過設計器切換到本地時對插件設定的“禁用”狀態不會影響到遠端設計時的插件使用,遠端設計時,插件的狀態受伺服器控制。

簡單理解就是只需要保證設計器本地有這個插件即可。


附件列表


主題: 數據決策系統
已經是第一篇
已經是最後一篇
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

文 檔回 饋

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉