授權遷移插件

1.1 版本

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.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，郵件格式如下： 

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

注：若有任何特殊情況，請在郵件中註明。

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 工程中的授權遷移插件。

在舊 BI 工程的「管理系統>註冊管理>授權遷移」頁面，點選「執行銷燬並激活」可能會出現失敗提醒。

本章將詳細給出各種報錯的原因。

1）遷移失敗：當前伺服器未註冊或為臨時註冊

• 未註冊的 BI 工程，無法執行銷燬授權的操作。請交握商務進行正式註冊。

• 臨時註冊的 BI 工程，無法遷移授權。請交握商務進行正式註冊。

2）遷移失敗：當前伺服器機器碼不匹配，無法激活新授權

發給商務的舊 BI 工程 rif 檔案中的伺服器機器碼，和插件當前所在舊 BI 工程的伺服器機器碼不相同。

請確認插件是否安裝在正確的、需要遷移的舊 BI 工程中，而不是誤安裝到了新 BI 工程/其他工程中。

3）遷移失敗：該授權已被激活過，無法重新激活

新舊 BI 工程的lic唯一標識完全相同，此時無法遷移工程授權。

「授權遷移插件」只能進行一次遷移，如遷移完成後需要再次遷移，請重新交握商務獲取新的遷移工具。