反饋已提交

網絡繁忙

遠端設計常見問題

1. 概述

本文主要概述了使用設計器進行遠端連結設計範本時的常見問題及解決方案。

2. 常見排查步驟

遠端設計的常見問題及排查思路,如下圖所示:

2.1 查看是否支援遠端設計

問題描述:遠端設計連結前,需要先確認遠端的工程是否支援遠端設計功能點。

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

2.2 查看使用者權限

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

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

2.3 查看JAR包版本

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

解決方案:遠端連結時,若版本不匹配,會提示版本不一致,遠端設計時部分功能將受影響。建議即時更新,保證伺服器和設計器版本一致。

2.4 檢查設定是否正確

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

3. 31300101 遠端設計無權限

問題描述:

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

解決方案:

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

4. 31300102 範本已鎖定

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

問題描述:

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

原因分析:

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

解決方案:

重啟伺服器,或者等一段時間會被釋放。

4.2 範本已鎖定

問題描述:

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

原因分析:

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

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

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

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

5. 11300104 遠端設計連結失敗

5.1 報錯 Response HTTP/1.1 404 by

問題描述:

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

解決方案:

卸載重裝設計器。

5.2 報錯 The SolidRecordExecutor should be register first

問題描述:

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

原因分析:

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

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

5.3 報錯 Caused by: java.net.UnknownHostException: ??: ??

問題描述:

遠端設計連結時報錯:Caused by: java.net.UnknownHostException: ??: ??

原因分析:

連結遠端環境時需要獲取本機 IP,如果主機名亂碼會導致獲取本機 IP 失敗。

排查步驟:

1)開啟 cmd 輸入 hostname 並回車,查看主機名 hostname 是否為亂碼。

2)若 hostname 為亂碼,在「控制台>系統與安全>系統」中查看計算機名稱是否為中文或者特殊符號。

解決方案1:若 hostname 為亂碼,在「控制台>時鐘和區域」面板中,點選「區域>管理>更改系統區域設定」,設定計算機適配語言為中文即可。如下圖所示:

解決方案2:

若計算機名稱為中文或者特殊符號。

在「控制台>系統與安全>系統」面板中。點選「更改設定」,修改計算機名稱為英文即可。如下圖所示:

5.4 遠端設計偶發連結失敗

問題描述:

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

原因分析:

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

解決方案:

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

5.5 遠端設計頻繁斷開

問題描述:

遠端設計,頻繁斷開。報錯:網路連結異常:websocket已斷開。

排查方案:

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

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

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

5.6 報錯 Server workspace no response

問題描述:

遠端設計失敗,報錯Server workspace no response,如下圖所示:

排查方案:

使用 postman 工具測試 post 請求下 channel API回傳值,http://ip:port/webroot/decision/remote/design/channel

如果傳回 could not get response,則說明 channel API不通,需要排查下防火牆、安全軟體是否有反序列化漏洞或者是 channel 請求的攔截記錄。之後放行即可

注:不要使用瀏覽器測試channel請求,有時會出現channel實際不通但是會傳回true的情況,建議優先使用postman工具測試

5.7 報錯 Not in GZIP format

問題描述:

HTTPS遠端設計報錯:Not in GZIP format

原因分析:

遠端設計請求被攔截

解決方案:

請自行聯絡網路維護相關人員,修改網路安全攔截策略,將/webroot/decision/remote/design/*相關請求加入白名單

6. 11300105 遠端設計帳號密碼錯誤

6.1 帳號密碼錯誤

原因分析:

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

解決方案:

使用和遠端設計連結一致的地址、帳號、密碼,在瀏覽器進行存取登入,檢查是否能正常登入。如無法正常登入,請聯絡管理者確認自己的帳號密碼是否正確。

6.2 無遠端連結權限

原因分析:

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

解決方案:

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

6.3 PC端使用使用者限制

原因分析:

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

解決方案:

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

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

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

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

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

7.2 找不到範本

排查步驟:

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

2)查看註冊功能點,是否有這個功能點

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

4)檢查範本權限

5)檢查範本所屬的使用者組

7.3 編輯範本儲存失敗

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

原因分析:

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

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

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

7.4 儲存範本沒有權限

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

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

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

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

  • 日誌中出現報錯:NoHttpResponseException

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

解決方案:

調整tomcat配置:修改 Tomcat 的 server.xml 的 connectionTimeout ,調大後重啟生效。

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

問題描述:

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

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

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

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

8. 11300107 遠端設計功能未註冊

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

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

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

9. 11300108 憑證域名資訊錯誤

9.1 什麼時候需要憑證

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

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

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

9.2 不支援免費ssl憑證

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

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

9.3 不支援crt憑證

問題描述:遠端設計不支援 crt 憑證。

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

9.4 遠端設計啟動https無法連結bi伺服器

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

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

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

9.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後的遠端設計

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

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

9.6.1 憑證未綁定域名

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

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

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

-Dfine.remote.design.skipHostnameVerifier=true

9.6.2 憑證和遠端設計的域名不一致

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

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

9.6.3 IP和域名未映射

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

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

9.7 報錯 Unrecognized SSL message, plaintext connection?

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

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

9.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:參考 9.1 節,確認是否需要新增憑證,若無需新增,刪除憑證即可。

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

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

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

9.9 報錯 Tag mismatch

問題描述:遠端設計連結時報錯:SSLHandshakeException  Tag mismatch

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

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

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

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

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

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

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

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

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

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

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

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

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

問題描述:

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

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

解決方案:

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

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

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

13.1 請求被伺服器網路攔截

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

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

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

13.2 伺服器已關閉

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

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

13.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

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

14.1 資料連結失敗

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

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

14.2 資料連結密碼為無

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

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

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

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

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

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

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

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

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

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

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

15. 叢集遠端設計出錯

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

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

原因分析:redis 存在髒資料

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

15.2 範本無法儲存

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

原因分析:redis 存在髒資料

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

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

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

排查方向:

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

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

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

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

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

解決方案:

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

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

3)重啟叢集節點。

15.5 Response HTTP/1.1 411 Length Required by

問題描述:

遠端設計測試連結成功,但切換工作區間失敗,日誌報錯:Response HTTP/1.1 411 Length Required by

原因分析:

Nginx 1.3.9以下版本,當使用者POST一個帶有檔案的請求的時候,出現HTTP 411錯誤,需要升級nginx版本,或為nginx安裝chunkin-nginx-module修補

解決方案:

1)確認nginx版本,如果是低於Nginx 1.3.9版本,升級nginx版本,或為nginx安裝chunkin-nginx-module修補

2)升級設計器版本至10.0.8及以上版本,遠端設計的post請求頭中已經加入了Content-Length

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

16.1 一部分範本無法開啟

問題描述:

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

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

原因分析:

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

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

解決方案:

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

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

16.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 檔案,重啟伺服器。

17. 其他問題

17.1 遠端設計插件安裝邏輯

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

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

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

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

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


附件列表


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

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

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

不再提示

10s後關閉

獲取幫助
線上支援
獲取專業技術支援,快速幫助您解決問題
工作日9:00-12:00,13:30-17:30在线
頁面反饋
針對當前網頁的建議、問題反饋
售前咨詢
業務咨詢
電話:0933-790886或 0989-092892
郵箱:taiwan@fanruan.com
頁面反饋
*問題分類
不能為空
問題描述
0/1000
不能為空

反馈已提交

网络繁忙