本地機器資訊認證遷移

1.1 版本

1.2 應用場景

1）若 BI 工程需要遷移伺服器，伺服器的 Mac 位址不同，此時需要進行本地機器資訊認證遷移。

2）若 BI 工程跨大版本升級（如 FineBI 4.1 升級到 FineBI5.1），此時需要使用遷移工具銷燬舊 lic，生成新 lic。

1.3 實現方法

使用者匯出新伺服器/工程的資訊併傳送給帆軟商務，商務會生成新 License 的遷移過程併傳送給使用者。

使用者在電腦上直接開啟，輸入原 FineBI 伺服器的 URL，遷移過程自動將原 BI 工程伺服器的登入銷燬，並解鎖新的 FanRuan.lic 。

1.4 注意事項

推薦使用者改用更簡單快捷的登入方法：公有云認證 。

1）License 遷移之前，必須確定舊的 FineBI 工程可以在原伺服器上正常啟動。

2）一個遷移工具只能進行一次遷移，如遷移完成後需要再次遷移，請重新聯絡商務獲取新的遷移工具。

3）無論伺服器環境為 Windows/Linux/Mac，使用者只需將遷移工具上傳到一個可以和原伺服器通訊的機器上即可運作，所以商務預設傳送Windows版本的遷移工具。

4）臨時登入無法遷移，請參考 本地機器資訊認證 進行正式登入。若進行遷移，提示：Unregistered or registered temporary lic

5）單點登入環境不支援 lic 遷移。

2.1 獲取遷移過程

1）請複製好舊 BI 工程的%BI_HOME%/webroot/WEB-INF/resources 目錄下的「FanRuan.lic」檔案。

2）請參考：本地機器資訊認證，應答新 BI 工程的工程名，匯出新 BI 工程的登入資訊 rif 檔案。

3）请使用合同中指定的郵箱傳送登入資訊給 FineBI 商務business@fanruan.com，郵件格式如下： 

商務收到郵件，覈實無誤後會為您生成一個 License 遷移過程，以郵件方式傳送給您。如下圖所示：

2.2 生成檢驗碼

注：JAR 包版本在 2020-01-15 之前的舊 FineBI 工程，無需執行此操作。

超級管理者登入舊 FineBI 工程的數據決策系統，在決策平台記憶體取指定 URL 生成檢驗碼。如下圖所示：

URL 範例：http://ip:埠/webroot/decision/v10/register/remove/captcha

注1：此處的數據決策系統為原工程，即需要將 License 銷燬的工程。

注2：每次存取 URL 重新生成檢驗碼，在新檢驗碼生成時舊檢驗碼失效。

注3：若舊 FineBI 工程配置了短域名，則 URL 為 http://域名/decision/v10/register/remove/captcha

2.3 運作遷移過程

2.3.1 輸入舊 FineBI 工程位址

將「遷移過程」上傳至一個可以和舊 FineBI 工程通訊的機器上，並運作。運作後彈出命令行視窗。提示：卸載伺服器目標位址：

輸入舊 FineBI 工程的伺服器位址：http://ip:埠/webroot/decision 或 http://域名/webroot/decision

注1：請確定運作「遷移過程」的伺服器與舊 FineBI 工程的伺服器可以正常通訊。否則將提示：連結伺服器失敗，請檢查位址是否正確，重新輸入：

注2：若輸入伺服器目標位址未注冊或為臨時注冊，則提示使用者：遷移失敗， FineBI 伺服器未登入或為臨時注冊。

2.3.2 輸入檢驗碼

注：JAR 包版本在 2020-01-15 之前的舊 FineBI 工程，無需執行此操作。

正確輸入寫在伺服器目標位址後，彈出提示：請輸入檢驗碼。將 2.2 節獲取的檢驗碼輸入，如下圖所示：

注：檢驗碼有效期30分鐘，若檢驗碼校驗失敗，則提示：檢驗碼錯誤或已失效，請重新輸入

2.3.3 生成 FanRuan.lic 檔案

檢驗碼輸入成功後，跳出提示：遷移成功，請把當前命令行視窗工作區間下這個lic檔案put 命令 FineBI 伺服器中。

此時舊 FineBI 工程的注冊失效，在遷移工具同目錄下自動生成新 FineBI 工程的注冊檔案「FanRuan.lic」。如下圖所示：

2.4 新工程注册

管理者登入新 FineBI 工程的數據決策系統，點選「管理系統>注冊管理>版本資訊」，點選「上傳lic檔案」，匯入 FanRuan.lic 授權檔案。

若正確無誤，此時會顯示注冊成功，如下圖所示：

注：FanRuan.lic會自動儲存到當前工程%BI-HOME%\webroot\WEB-INF\resources 目錄下。

3.1 獲取遷移過程

1）請複製好舊 BI 工程的%BI_HOME%/webroot/WEB-INF/resources 目錄下的「FanRuan.lic」檔案。

2）请参考：本地機器資訊認證，應答新 BI 工程的工程名，匯出新 BI 工程的登入資訊 rif 檔案。

3）請使用合同中指定的郵箱傳送注冊資訊給 FineBI 商務business@fanruan.com，郵件格式如下： 

商務收到郵件，覈實無誤後會為您生成一個 License 遷移過程，以郵件方式傳送給您。如下圖所示：

3.2 生成檢驗碼

注：JAR 包版本在 2020-01-15 之前的舊 FineBI 工程，無需執行此操作。

超級管理者登入舊 FineBI 工程的數據決策系統，在決策平台記憶體取指定 URL 生成檢驗碼。如下圖所示：

URL 範例：http://ip:端埠/webroot/decision/v10/register/remove/captcha

注1：此處的數據決策系統為原工程，即需要將 License 銷燬的工程。

注2：每次存取 URL 重新生成檢驗碼，在新檢驗碼生成時舊檢驗碼失效。

注3：若舊 FineBI 工程配置了短域名，則 URL 為 http://域名/decision/v10/register/remove/captcha

3.3 運作遷移過程

將「遷移過程」一個可以和舊 FineBI 工程通訊的機器上。

3.3.1 新增可執行權限

為執行過程新增下可執行權限。代碼如下所示：

chmod u+x lic_remove

3.3.2 輸入舊 FineBI 工程位址

運作後彈出命令行視窗。提示：卸載伺服器目標位址。如下圖所示：

輸入舊 FineBI 工程的伺服器位址：http://ip:埠/webroot/decision 或 http://域名/webroot/decision

注1：請確定運作「遷移過程」的伺服器與舊 FineBI 工程的伺服器可以正常通訊。否則將提示：連結伺服器失敗，請檢查位址是否正確，重新輸入：

注2：若輸入伺服器目標位址未注冊或為臨時注冊，則提示使用者：遷移失敗， FineBI 伺服器未注冊或為臨時注冊。

3.3.3 輸入檢驗碼

注：JAR 包版本在 2020-01-15 之前的舊 FineBI 工程，無需執行此操作。

正確輸入寫在伺服器目標位址後，彈出提示：請輸入檢驗碼。將 3.2 節獲取的檢驗碼輸入，如下圖所示：

注：檢驗碼有效期30分鐘，若檢驗碼校驗失敗，則提示：檢驗碼錯誤或已失效，請重新輸入。

3.3.4 生成 FanRuan.lic 檔案

檢驗碼輸入成功後，跳出提示：遷移成功，請把當前命令行視窗工作區間下這個lic檔案put 命令 FineBI 伺服器中。

此時舊 FineBI 工程的注冊失效，在遷移工具同目錄下自動生成新報表工程的注冊檔案「FanRuan.lic」。如下圖所示：

3.4 新工程注冊

管理者登入新 FineBI 工程的數據決策系統，點選「管理系統>注冊管理>版本資訊」，點選「上傳lic檔案」，匯入 FanRuan.lic 授權檔案。

若正確無誤，此時會顯示注冊成功，如下圖所示：

注：FanRuan.lic会自动保存到当前工程%BI-HOME%\webroot\WEB-INF\resources 目录下。

4.1 獲取遷移過程

1）請複製好舊 BI 工程的%BI_HOME%/webroot/WEB-INF/resources 目錄下的「FanRuan.lic」檔案。

2）请参考：本地機器資訊認證，應答新 BI 工程的工程名，匯出新 BI 工程的登入資訊 rif 檔案。

3）請使用合同中指定的郵箱傳送登入資訊給 FineBI 商務business@fanruan.com，郵件格式如下： 

商務收到郵件，覈實無誤後會為您生成一個 License 遷移過程，以郵件方式傳送給您。如下圖所示：

4.2 生成檢驗碼

注：JAR 包版本在 2020-01-15 之前的舊 FineBI 工程，無需執行此操作。

超級管理者登入舊報表工程的數據決策系統，在決策平台記憶體取指定 URL 生成檢驗碼。如下圖所示：

URL 範例：http://ip:埠/webroot/decision/v10/register/remove/captcha

注1：此處的數據決策系統為原工程，即需要將 License 銷燬的工程。

注2：每次存取 URL 重新生成檢驗碼，在新檢驗碼生成時舊檢驗碼失效。

注3：若舊 FineBI 工程配置了短域名，則 URL 為 http://域名/decision/v10/register/remove/captcha

4.3 運作遷移過程

將「遷移過程」一個可以和舊 FineBI 工程通訊的機器上。

4.3.1 新增可執行權限

為執行過程新增下可執行權限。代碼如下所示：

chmod u+x lic_remove

4.3.2 輸入舊 FineBI 工程位址

執行遷移過程，代碼如下所示：

./lic_remove

運作後彈出命令行視窗。提示：卸載伺服器目標位址。如下圖所示：

輸入舊 FineBI 工程的伺服器位址：http://ip:埠/webroot/decision 或 http://域名/webroot/decision

注1：請確定運作「遷移過程」的伺服器與舊 FineBI 工程的伺服器可以正常通訊。否則將提示：連結伺服器失敗，請檢查位址是否正確，重新輸入：

注2：若輸入伺服器目標位址未注冊或為臨時注冊，則提示使用者：遷移失敗， FineBI 伺服器未注冊或為臨時注冊。

4.3.3 輸入檢驗碼

注：JAR 包版本在 2020-01-15 之前的舊 FineBI 工程，無需執行此操作。

正確輸入寫在伺服器目標位址後，彈出提示：請輸入檢驗碼。將 4.2 節獲取的檢驗碼輸入，如下圖所示：

注：檢驗碼有效期30分鐘，若檢驗碼校驗失敗，則提示：檢驗碼錯誤或已失效，請重新輸入。

4.3.4 生成 FanRuan.lic 檔案

檢驗碼輸入成功後，跳出提示：遷移成功，請把當前命令行視窗工作區間下這個lic檔案put 命令 FineBI 伺服器中。

此時舊 FineBI 工程的注冊失效，在遷移工具同目錄下自動生成新 FineBI 工程的注冊檔案「FanRuan.lic」。如下圖所示：

4.4 新工程注冊

管理者登入新 FineBI 工程的數據決策系統，點選「管理系統>注冊管理>版本資訊」，點選「上傳lic檔案」，匯入 FanRuan.lic 授權檔案。

若正確無誤，此時會顯示注冊成功，如下圖所示：

注：FanRuan.lic會自動儲存到當前工程%FineBI-HOME%\webroot\WEB-INF\resources 目錄下。