License Migration Plugin

Version

Application Scenarios

• Cross-major-version upgrade: Only support the upgrade from FineReport 10.0 (versions released after 2020-04-26) to FineReport 11.0. To upgrade from FineReport 9.0 to FineReport 10.0, contact the technical support team.

• Server migration: The report server uses local machine information authentication. The MAC addresses of the new and old report servers are different, so the server license needs to be migrated.

Functions

If the report project uses Local Machine Info for authentication, you can authenticate the License Migration plugin using the local machine information to migrate the license (if needed).

After exporting the information of new and old servers and sending it to FineReport business team, they will generate the License Migration plugin and send it back to you.

You can install and run the plugin on the old report server, destroy the license of the old report server and generate the license of the new report server.

Notes

• Before migrating the license, you should make sure that the old report server can start normally.

• The License Migration plugin can only be used once. If you need to migrate the license again after the migration is complete, contact the business team again to obtain a new migration tool.

• If the migration fails due to temporary registration, you can refer to Local Machine Info AUTH for formal registration.

• To upgrade from FineReport 9.0 to FineReport 10.0, contact the technical support team.

Preparing Materials

Registration Information RIF File of the Old Report Server

Log in to the old report server, click Manage > Registration > Version Information, and click Export Registration Information to export the registration information rif file of the old report server.

Registration Information RIF File of the New Report Server

Log in to the new report server, click Manage > Registration > Version Information, and click Register Now.

Select Local Machine Info as the authentication method, and click Export Registration Information to export the registration information rif file of the new report server.

Name of the New Report Server

Open the directory %FR_HOME%/webapps, and confirm the name of the Web report project, which is webroot by default.

You can modify the server name according to the actual situation only before registration.

Note:

1. Modifying the server name may affect the hyperlinks and other settings of the template, so be cautious when modifying. 

2. Modifying the server name means to rename this folder. After the modification, the address to access the server will be http://IP:port/project name/decision.

Getting License Migration Plugin

You should use the email address specified in the contract to send the registration information to FineReport business team (business@fanruan.com). The email format is as follows:

After the business team receives the email and verifies that it is correct, they will generate a License Migration plugin and send it to you by email.

Note:

If there are any problems, indicate them in the email.

List	Content	Notes
Sender	Use the email specified in the contract.	If you do not use the email specified in the contract to send registration information, the   registration will not be allowed.
Recipient	business@fanruan.com	/
Title	Your company (company name) is registering for formal license to migrate FineReport.	If you do not mark the company name in the email, the registration will not be allowed.
Body	Company name Server name Contract signing date Registration method: local machine information authentication Migration method: License Migration plugin New report server name: the name of the new report server obtained in section "Preparing Materials" New report project version: the minor project version and the JAR package version, which can be found in System Management > Registration Management > Version Information	Concurrency, user number, and other information will be registered according to the signed contract.
Attachment 1	The RIF file exported by the old report server The RIF file exported by the new report server	Store the files in folders to distinguish the RIF files of new and old report servers. Do not open generated RegistrationInformation.rif file, otherwise the file will be corrupted. If you send them to FanRuan business team, the registration will not be allowed.
Attachment 2	Screenshot of the Registration Management page of the old report server	1. The server address must be included in the screenshot to ensure that the project can run normally. Note: The old report server must be able to start normally, otherwise registration migration cannot be carried out, and you need to re-apply for a license. Contact sales personnel for processing. 2. The registration management page in the screenshot must display Registered Successfully to ensure that the project has been successfully registered. Note: If the server is unregistered, temporarily registered, or its registration expires, registration migration cannot be performed. Contact sales personnel for additional purchase/communication.

Installing Plugins For Old Server

Log in to the old report server, click System Management > Plugin Management > Local Install, and select the License Migration plugin sent by the business team. After successful installation, it will prompt that the plugin was installed successfully.

Running Migration Plugin

Log in to the old report server, click System Management > Registration Management > LIC Migration, and click Execute Destruction and Activation.

The plugin will automatically destroy the license of the old report server, generate the destruction certificate file FanruanLic.DC, and generate the registration license file for the new report server.

Note:

1. You can go to the following path to obtain the destruction certificate when needed and provide it to FineReport technical support group.

    The destruction certificate of the standalone environment is stored in the %FR_HOME%/webroot/WEB-INF/resources, and the destruction certificate of the cluster environment is stored in /WEB-INF/resources folder of the file server.

2. Destroying old license takes some time. Be patient. If the destruction fails, refreshing the browser window will cause a 404 error. Therefore, only after the old licnese is successfully destroyed can you correctly display the migration page and obtain the new license.

3. If the new license is accidentally lost, you can still enter the license migration page and click the Execute Destruction and Activation button within 10 hours after the old license is destroyed for the first time. 

    When you click the Execute Destruction and Activation button again, a new registration license for the report server will be generated, and the previous one will become invalid.

Registering New Server

Log in to the new report server, click System Management > Registration Management > Version Information, click Upload License, and import the FanRuan.lic file.

If everything is correct, it will display Registered Successfully.

Note:

1. The FanRuan.lic file will be automatically stored in the %FR-HOME%\webroot\WEB-INF\resources directory of your current server.

2. After the new report server is successfully registered, you should delete the license migration plugin in the old report server promptly.

On the System Management > Registration Management > LIC Migration page of the old report server, clicking Execute Destruction and Activation may trigger in a failure prompt.

This section will give detailed explanation for various error messages.

1. Migration failed: The current server is not registered or is temporarily registered.

• Unregistered report servers are unable to destroy the license. Contact the business team for formal registration.

• The license of temporarily registered report servers can not be migrated. Contact the business team for formal registration.

2. Migration failed:  The current server machine code does not match that of the plugin. The new license cannot be activated.

The server machine code in the old report server RIF file sent to the business team is different from the server machine code where the plugin is currently located in the old report server.

Confirm whether the plugin is installed in the correct old report server that needs to be migrated, instead of being mistakenly installed in the new report server/other servers.

3. Migration failed: The current license has already been activated and cannot be activated again.

The unique identifier of the licenses of the new and old report server is completely the same, and the server license cannot be migrated.

The License Migration plugin can only be used once. If you need to migrate the license again, contact the business team to obtain a new migration tool.