授權遷移插件

1.1 版本

1.2 應用場景

「授權遷移插件」支援以下情況的授權遷移：

1）跨大版本升級：僅支援 FineReport10.0（2020-04-26及之後版本）升級到 FineReport11.0。

                             如 FineReport9.0 升級到 FineReport10.0，請參見：本地機器資訊認證遷移程式 。

2）伺服器遷移：報表工程使用本地機器資訊認證，新舊報表工程伺服器的 Mac 地址不同，需要遷移工程授權。

1.3 功能簡介

若報表工程使用本地機器資訊認證，當需要授權遷移時，可使用本地機器資訊認證授權遷移插件。

使用者匯出新舊工程的資訊併傳送給帆軟商務，商務會生成「授權遷移插件」併傳送給使用者。

使用者在舊報表工程上安裝並運作該插件，將舊報表工程的授權銷燬，並生成新報表工程的授權。

1.3 注意事項

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

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

3）臨時註冊無法遷移，請參考 本機機器資訊認證 進行正式註冊。

4）FineReport9.0 升級到 FineReport10.0，請參見：本地機器資訊認證遷移程式 。

5）僅支援遷移授權期限在一年及以上的 License，如授權過期時間與授權生成時間小於一年，不支援本文方案。

2.1 準備材料

1）舊報表工程的註冊資訊 rif 檔案

管理者登入舊報表工程，點選「管理系統>註冊管理>版本資訊」，點選「匯出註冊資訊」，匯出舊報表工程的註冊資訊 rif 檔案。如下圖所示：

2）新報表工程的註冊資訊 rif 檔案

管理者登入新報表工程，點選「管理系統>註冊管理>版本資訊」，點選「立即註冊」。

認證方式選擇「本地機器資訊認證」，點選「匯出註冊資訊」，匯出新報表工程的註冊資訊 rif 檔案。如下圖所示：

3）新報表工程的工程名

開啟新報表工程所在伺服器%FR_HOME%\webapps\目錄，確認報表 Web 工程名，預設為webroot。

使用者可在註冊前根據自身需要修改工程名，註冊後將無法修改。

注：此工程名的修改可能會影響範本的超連結等設定，請謹慎修改。

       修改工程名就是改這個資料夾的名稱，修改後，存取工程的地址就變成了http://IP:埠/工程名/decision

2.2 獲取授權遷移插件

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

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

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

2.3 舊工程安裝插件

管理者登入舊報表工程，點選「管理系統>插件管理」，點選「從本地安裝」，選擇商務傳送的授權遷移插件，安裝成功後提示「Lic遷移插件安裝成功」。如下圖所示：

2.4 運作遷移插件

管理者登入舊報表工程，點選「管理系統>註冊管理>授權遷移」，點選「執行銷燬並激活」。

插件會自動銷燬舊報表工程的授權，生成銷燬證件檔案FanruanLic.DC，以及生成新報表工程的註冊Lic，如下圖所示：

注1：使用者在需要時可前往以下路徑獲取銷燬證件，並提供給帆軟技術支援。

        單機環境的銷燬證件存放在%FR_HOME%/webroot/WEB-INF/resources資料夾下，叢集環境的銷燬證件存放在檔案伺服器的/WEB-INF/resources資料夾下。

注2：銷燬舊授權需要一段時間，請耐心等待。若未成功銷燬便重新整理瀏覽器視窗，會導致404錯誤，需要等待至銷燬成功後，才可以正確顯示遷移頁面，並獲取到新Lic。

注3：若不小心遺失了新授權lic，在首次銷燬舊授權後10小時內，管理者仍可再次進入「授權遷移」頁面，點選「執行銷燬並激活」按鈕。

         當再次點選執行銷燬並激活」按鈕後，會為管理者再次生成一份新報表工程的註冊Lic，之前生成的Lic失效。

2.5 新工程註冊

管理者登入新報表工程，點選「管理系統>註冊管理>版本資訊」，點選「上傳lic檔案」，匯入 FanRuan.lic 授權檔案，如下圖所示：

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

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

注2：新報表工程註冊成功後，請即時刪除舊報表工程中的授權遷移插件。

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

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

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

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

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

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

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

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

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

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

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