授權遷移插件

1. 應用場景。

   【授權遷移插件】支援以下情況的授權遷移：
   

①跨大版本升級：僅支援 FineReport10.0 升級到 FineReport11.0。如 FineReport9.0 升級到 FineReport10.0，請參見：本機機器資訊認證遷移程式。

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

2. 功能簡介。
   

   若報表工程使用本機機器資訊認證，當需要授權遷移時，可使用兩種方法：

①本機機器資訊認證遷移程式：授權遷移程式較為繁瑣。

②本機機器資訊認證授權遷移插件：簡單易用，本文将詳細描述如何使用插件進行授權遷移。

使用者匯出新舊工程的資訊并發送給帆軟商務，商務會生成【授權遷移插件】并發送給使用者。

使用者在【舊報表工程】上安裝并運行該插件，将【舊報表工程】的授權銷毀，并生成新報表工程的授權。

3. 注意事項。
   

   推薦使用者改用更簡單快捷的註冊方法：公有雲認證 。

①License 遷移之前，必須确保【舊報表工程】可以在原伺服器上正常啓動。

②【授權遷移插件】只能進行一次遷移，如遷移完成後需要再次遷移，請重新聯繫商務獲取新的遷移工具。

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

1

準備材料。

1. 【舊報表工程】的註冊資訊 rif 檔案

管理員登錄舊報表工程，點擊【管理系統】→【註冊管理】→【版本資訊】，點擊【匯出註冊資訊】，匯出【舊報表工程】的註冊資訊 rif 檔案。如下圖1所示：

2. 【新報表工程】的註冊資訊 rif 檔案

管理員登錄新報表工程，點擊【管理系統】→【註冊管理】→【版本資訊】，點擊【立即註冊】。

認證方式選擇【本機機器資訊認證】，點擊【匯出註冊資訊】，匯出【新報表工程】的註冊資訊 rif 檔案。如下圖2、3所示：

3. 【新報表工程】的工程名
   

打開新報表工程所在伺服器【%FR_HOME%\webapps\目錄】，确認報表 Web 工程名，預設為【webroot】。如下圖4所示：

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

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

      修改工程名就是改這個檔案夾的名稱，修改後，訪問工程的地址變為 http://IP:埠/工程名/decision

2

獲取授權遷移插件。

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

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

3

舊工程安裝插件。

管理員登錄【舊報表工程】，點擊【管理系統】→【插件管理】，點擊【從本地安裝】，選擇商務發送的授權遷移插件，安裝成功後提示【Lic遷移插件安裝成功】。如下圖所示：

4

運行遷移插件。

管理員登錄【舊報表工程】，點擊【管理系統】→【註冊管理】→【授權遷移】，點擊【執行銷毀并激活】。

插件會自動銷毀【舊報表工程】的授權，并生成【新報表工程】的註冊Lic，如下圖所示：

注1：銷毀舊授權需要一段時間，請耐心等待。若未成功銷毀便刷新浏覽器窗口，會導緻404錯誤，需要等待至銷毀成功後，才可以正确顯示遷移頁面，并獲取到新Lic。

注2：銷毀舊授權後10小時内，進入【授權遷移】頁面，點擊【執行銷毀并激活】，均可獲取到新報表工程的註冊 Lic。

5

新工程註冊。

管理員登錄【新報表工程】，點擊【管理系統】→【註冊管理】→【版本資訊】，點擊【上傳lic檔案】，匯入 Fanruan.lic 授權檔案。

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

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

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

在【舊報表工程】的【管理系統】→【註冊管理】→【授權遷移】頁面，點擊【執行銷毀并激活】可能會出現失敗提醒，一般有以下三種原因。

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

未註冊的報表工程，無法執行銷毀授權。請聯繫商務進行正式註冊。

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

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

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

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

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

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

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