1. 概述
1.1 版本
| FineBI伺服器版本 |
|---|
| 6.0 |
1.2 應用場景
「授權遷移插件」支援以下情況的授權遷移：
1）跨大版本升級：
支援 FineBI5.1 升級到 FineBI6.0、FineBI5.0 升級到 FineBI5.1。
5.0之前版本的跨版本升級，請參見：本地機器資訊認證遷移程式 。
2）伺服器遷移：
BI 工程使用本地機器資訊認證，新舊 BI 工程伺服器的 Mac 地址不同，需要遷移工程授權。
1.3 功能簡介
若 BI 工程使用本地機器資訊認證，當需要授權遷移時，可使用本地機器資訊認證授權遷移插件 。
使用者匯出新舊工程的資訊併傳送給帆軟商務，商務會生成「授權遷移插件」併傳送給使用者 。
使用者在舊 BI 工程上安裝並運作該插件，將舊 BI 工程的授權銷燬，並生成新 BI 工程的授權 。
1.4 注意事項
1）License 遷移之前，必須確定舊的 BI 工程可以在原伺服器上正常啟動 。
2）「授權遷移插件」只能進行一次遷移，如遷移完成後需要再次遷移，請重新聯絡商務獲取新的遷移工具 。
3）臨時註冊無法遷移，請參考 本地機器資訊認證 進行正式註冊 。
4）5.0之前版本的跨版本升級，請參見：本地機器資訊認證遷移程式 。
5）Lic 的過期時間與生成時間超過一年，才能使用該插件 。
2. 範例
2.1 準備材料
2.1.1 舊工程相關材料
1）舊 BI 工程的版本資訊截圖
管理者登入舊 BI 工程，點選「管理系統>註冊管理>版本資訊」，獲取舊 BI 工程「版本資訊」模組的完整截圖，如下圖所示：
2）舊 BI 工程的註冊資訊 rif 檔案
管理者登入舊 BI 工程，點選「管理系統>註冊管理>版本資訊」，點選「匯出註冊資訊」，匯出舊 BI 工程的註冊資訊 rif 檔案。如下圖所示：
2.1.2 新工程相關材料
1）新 BI 工程的版本資訊截圖
管理者登入新 BI 工程，點選「管理系統>註冊管理>版本資訊」，獲取新 BI 工程「版本資訊」模組的完整截圖，如下圖所示：
2）新 BI 工程的註冊資訊 rif 檔案
管理者登入新 BI 工程，點選「管理系統>註冊管理>立即註冊」，如下圖所示：
認證方式選擇「本地機器資訊認證」，點選「匯出註冊資訊」，匯出新 BI 工程的註冊資訊 rif 檔案。如下圖所示：
3）新 BI 工程的工程名
開啟新 BI 工程所在伺服器%BI_HOME%\webapps\目錄，確認 BI Web 工程名，預設為webroot。
使用者可在註冊前根據自身需要修改工程名，註冊後將無法修改。
注：此工程名的修改可能會影響範本的超連結等設定，請謹慎修改。
修改工程名就是改這個資料夾的名稱，修改後，存取工程的地址就變成了http://IP:埠/工程名/decision
2.2 獲取授權遷移插件
請使用合同中指定的信箱傳送註冊資訊給 FineBI 商務business@fanruan.com，郵件格式如下：
商務收到郵件，覈實無誤後會為您生成一個授權，以郵件方式傳送給您。如下圖所示：
注：若有任何特殊情況，請在郵件中註明。
| 清單 | 內容 | 注意事項 |
|---|---|---|
| 寄件人 | 請使用合同中指定的信箱 | 如傳送註冊資訊的信箱，非合同中指定的信箱，則不予註冊遷移 |
| 收件人 | business@fanruan.com | - |
| 標題 | XXX 公司註冊遷移 FineBI 正式授權 | 如傳送註冊資訊時，未註明公司名稱，則不予註冊 |
| 正文 | 公司名稱：XXX 公司 項目名稱：XXX 項目 合同簽定日期：XXXX年XX月XX日 註冊方式：本地機器資訊認證 遷移方式：授權遷移插件 新 BI 工程名：2.1節獲取的新 BI 工程的工程名 | 其他併發數、使用者數等資訊，將按照簽訂的合同進行註冊 |
| 附件1 | 舊 BI 工程匯出的 rif 檔案 新 BI 工程匯出的 rif 檔案 | 請將檔案用資料夾儲存，以便區分新舊 BI 工程的rif 檔案 不要開啟生成的 RegistrationInformation.rif 檔案，這會導致檔案損壞，如果再將其傳送給帆軟商務，就會導致註冊不成功 |
| 附件2 | 舊 BI 工程的版本資訊截圖 新 BI 工程的版本資訊截圖 | - |
| 附件3 | 舊BI工程的「管理系統>註冊管理」頁面截圖 | 1）截圖中必須包含伺服器地址，確定工程可正常運作 舊的BI工程必須可以在原伺服器上正常啟動，否則無法進行註冊遷移，只能重新申請授權，請交握銷售處理 2）截圖中註冊管理頁面必須顯示「註冊成功」，確定工程已成功註冊 若工程當前未註冊/臨時註冊/註冊過期，無法進行註冊遷移，請交握銷售增購/溝通 |
2.3 舊工程安裝插件
管理者登入舊 BI 工程，點選「管理系統>插件管理」，點選「從本地安裝」，選擇商務傳送的授權遷移插件，安裝成功後提示「Lic遷移插件安裝成功」。如下圖所示：
2.4 運作遷移插件
管理者登入舊 BI 工程，點選「管理系統>註冊管理>授權遷移」，點選「執行銷燬並激活」。
插件會自動銷燬舊報表工程的授權，生成銷燬證件檔案FanruanLic.DC，以及生成新報表工程的註冊Lic，如下圖所示：
注1：使用者在需要時可前往以下路徑獲取銷燬證件，並提供給帆軟技術支援。
單機環境的銷燬證件存放在%BI_HOME%/webroot/WEB-INF/resources資料夾下，叢集環境的銷燬證件存放在檔案伺服器的/WEB-INF/resources資料夾下。
注2：銷燬舊授權需要一段時間，請耐心等待。若未成功銷燬便重新整理瀏覽器視窗，會導致404錯誤，需要等待至銷燬成功後，才可以正確顯示遷移頁面，並獲取到新Lic。
注3：若不小心遺失了新授權lic，在首次銷燬舊授權後10小時內，管理者仍可再次進入「授權遷移」頁面，點選「執行銷燬並激活」按鈕。
當再次點選執行銷燬並激活」按鈕後，會為管理者再次生成一份新報表工程的註冊Lic，之前生成的Lic失效。
2.5 新工程註冊
管理者登入新 BI 工程，點選「管理系統>註冊管理>版本資訊」，點選「上傳lic檔案」，匯入 FanRuan.lic 授權檔案。
若正確無誤，此時會顯示註冊成功，如下圖所示：
注1：FanRuan.lic會自動儲存到您當前工程%BI-HOME%\webroot\WEB-INF\resources 目錄下。
注2：新 BI 工程註冊成功後，請即時刪除舊 BI 工程中的授權遷移插件。
3. 遷移失敗
在舊 BI 工程的「管理系統>註冊管理>授權遷移」頁面，點選「執行銷燬並激活」可能會出現失敗提醒。
本章將詳細給出各種報錯的原因。
1）遷移失敗：當前伺服器未註冊或為臨時註冊
未註冊的 BI 工程，無法執行銷燬授權的操作。請交握商務進行正式註冊。
臨時註冊的 BI 工程，無法遷移授權。請交握商務進行正式註冊。
2）遷移失敗：當前伺服器機器碼不匹配，無法激活新授權
發給商務的舊 BI 工程 rif 檔案中的伺服器機器碼，和插件當前所在舊 BI 工程的伺服器機器碼不相同。
請確認插件是否安裝在正確的、需要遷移的舊 BI 工程中，而不是誤安裝到了新 BI 工程/其他工程中。
3）遷移失敗：該授權已被激活過，無法重新激活
新舊 BI 工程的lic唯一標識完全相同，此時無法遷移工程授權。
「授權遷移插件」只能進行一次遷移，如遷移完成後需要再次遷移，請重新交握商務獲取新的遷移工具。
