Local Machine Info AUTH Migration

1. Version 

2. Application scenarios

1) If the BI project needs to migrate the server, the Mac address of the server is different, and the local machine information authentication migration is required at this time.

2) If the BI project is upgraded across major versions (for example, FineBI 4.1 is upgraded to FineBI5.1), you need to use the migration tool to destroy the old lic and generate a new lic.

3. Implementation method

The user exports the information of the new server/project and sends it to FanRuan Business, and the business will generate a new license migration program and send it to the user.

The user directly opens it on the computer, enters the URL of the original FineBI server, and the migration program automatically destroys the registration of the original BI project server and unlocks the new FanRuan.lic.

4. Notes

It is recommended that users switch to a simpler and faster registration method: public cloud authentication .

1) Before the license migration, it must be ensured that the old FineBI project can be started normally on the original server.

2) A migration tool can only be migrated once. If you need to migrate again after the migration is completed, please contact the business again to obtain a new migration tool.

3) No matter the server environment is Windows/Linux/Mac, users only need to upload the migration tool to a machine that can communicate with the original server to run, so the business defaults to send the Windows version of the migration tool.

4) Temporary registration cannot be migrated, please refer to the local machine information authentication for formal registration. If migrating, prompt: Unregistered or registered temporary lic

5) Single sign-on environment does not support lic migration.

1. Get the migration program

1) Please copy the "FanRuan.lic" file in the %BI_HOME%/webroot/WEB-INF/resources directory of the old BI project .

2) Please refer to: Local machine information authentication , confirm the project name of the new BI project , and export the registration information rif file of the new BI project .

3) Please use the email address specified in the contract to send the registration information to FineBI Business business@fanruan.com , the email format is as follows:

After the business receives the email, it will generate a license migration program for you after verification and send it to you by email. As shown below:

2. Generate verification code

Note: Old FineBI projects with JAR package versions before 2020-01-15 do not need to do this.

super administrator logs in to the data decision-making system of the old FineBI project , and accesses the specified URL in the decision-making platform to generate a verification code. As shown below:

Example URL: http://ip:port/webroot/decision/v10/register/remove/captcha

Note 1: The data decision system here is the original project, that is, the project that needs to destroy the license.

Note 2: The verification code is regenerated every time the URL is accessed, and the old verification code is invalid when a new verification code is generated.

Note 3: If the old FineBI project is configured with a short domain name, the URL is http://domain/decision/v10/register/remove/captcha

3. Run the migration program

1) Enter the old FineBI project address

Upload the "migration program" to a machine that can communicate with the old FineBI project, and run it. A command line window will pop up after running. Tip: Uninstall server target address:

Enter the server address of the old FineBI project: http://ip:port/webroot/decision or http://domain/webroot/decision

Note 1: Please make sure that the server running "Migration Program" can communicate with the server of the old FineBI project normally. Otherwise, it will prompt: Failed to connect to the server, please check whether the address is correct, and re-enter:

Note 2: If the input server target address is not registered or is temporarily registered, the user will be prompted: Migration failed, FineBI server is not registered or is temporarily registered.

Please enter an address like http://localhost : 8075/ webroot/ decision to specify the server you want to migrate
Uninstall server target address: http://localhost :8080/ webroot/ decision
Failed to connect to the server, please check if the address is correct and re-enter:
Uninstall server target address:

2) Enter verification code

Note: Old FineBI projects whose JAR package version is before 2020-01-15 do not need to perform this operation.

After entering the target address written in the server correctly, a prompt will pop up: Please enter the verification code. Enter the verification code obtained in Section 2.2, as shown in the following figure:

Note: The verification code is valid for 30 minutes. If the verification code fails, it will prompt: The verification code is wrong or has expired, please re-enter

Please enter an address like http://localhost : 8075/ webroot/ decision to specify the server you want to migrate
Uninstall server target address: http://localhost :8080/ webroot/ decision
Please enter the verification code:8ad7c8b98a604d3cb8cf9de54306c916
The verification code is wrong or expired, please re-enter:8ad7c8b98a604d3cb8cf9de54306c916
The migration is successful, please put the lic file in the working directory of the current command line window into the report server

3) Generate FanRuan.lic file

After the verification code is entered successfully, a prompt will pop up: Migration is successful, please put the lic file in the working directory of the current command line window into the FineBI server.

At this time, the registration of the old FineBI project is invalid, and the registration file "FanRuan.lic" of the new FineBI project is automatically generated in the same directory of the migration tool. As shown below:

4. New Project Registration

The administrator logs in to the data decision system of the new FineBI project, clicks "Manage > Registration> Registration Information", clicks "Upload lic file", and imports the FanRuan.lic authorization file.

If it is correct, it will show that the registration is successful, as shown in the following figure:

Note: FanRuan.lic will be automatically saved to the current project %BI-HOME%\webroot\WEB-INF\resources directory.

1. Get the migration program

1) Please copy the "FanRuan.lic" file in the %BI_HOME%/webroot/WEB-INF/resources directory of the old BI project .

2) Please refer to: Local machine information authentication , confirm the project name of the new BI project , and export the registration information rif file of the new BI project .

3) Please use the email address specified in the contract to send the registration information to FineBI Business business@fanruan.com , the email format is as follows:

After the business receives the email, it will generate a license migration program for you after verification and send it to you by email. As shown below:

2. Generate verification code

Note: Old FineBI projects whose JAR package version is before 2020-01-15 do not need to perform this operation.

The super administrator logs in to the data decision-making system of the old FineBI project, and accesses the specified URL in the decision-making platform to generate a verification code. As shown below:

Example URL: http://ip:port/webroot/decision/v10/register/remove/captcha

Note 1: The data decision system here is the original project, that is, the project that needs to destroy the license.

Note 2: The verification code is regenerated every time the URL is accessed, and the old verification code is invalid when a new verification code is generated.

Note 3: If the old FineBI project is configured with a short domain name, the URL is http://domain/decision/v10/register/remove/captcha

3. Running the migration program

Put the "migration program" on a machine that can communicate with the old FineBI project.

1) Add executable permission

Add the executable permission to the executor. The code looks like this:

chmod u+x lic_remove

2) Enter the old FineBI project address

A command line window will pop up after running. Tip: Uninstall the server destination address. As shown below:

Enter the server address of the old FineBI project: http://ip:port/webroot/decision or http://domain/webroot/decision

Note 1: Please make sure that the server running "Migration Program" can communicate with the server of the old FineBI project normally. Otherwise, it will prompt: Failed to connect to the server, please check whether the address is correct, and re-enter:

Note 2: If the input server target address is not registered or is temporarily registered, the user will be prompted: Migration failed, FineBI server is not registered or is temporarily registered.

Please enter an address like http://localhost : 8075/ webroot/ decision to specify the server you want to migrate
Uninstall server target address: http://localhost :8080/ webroot/ decision
Failed to connect to the server, please check if the address is correct and re-enter:
Uninstall server target address:

3) Enter verification code

Note: Old FineBI projects whose JAR package version is before 2020-01-15 do not need to perform this operation.

After entering the target address written in the server correctly, a prompt will pop up: Please enter the verification code. Enter the verification code obtained in Section 3.2, as shown in the following figure:

Note: The verification code is valid for 30 minutes. If the verification code fails, it will prompt: The verification code is wrong or has expired, please re-enter.

Please enter an address like http://localhost : 8075/ webroot/ decision to specify the server you want to migrate
Uninstall server target address: http://localhost :8080/ webroot/ decision
Please enter the verification code:8ad7c8b98a604d3cb8cf9de54306c916
The verification code is wrong or expired, please re-enter:8ad7c8b98a604d3cb8cf9de54306c916
The migration is successful, please put the lic file in the working directory of the current command line window into the report server

4) Generate FanRuan.lic file

After the verification code is entered successfully, a prompt will pop up: Migration is successful, please put the lic file in the working directory of the current command line window into the FineBI server.

At this time, the registration of the old FineBI project is invalid, and the registration file "FanRuan.lic" of the new report project is automatically generated in the same directory of the migration tool. As shown below:

4. New Project Registration

The administrator logs in to the data decision system of the new FineBI project, clicks"Manage > Registration> Registration Information", clicks "Upload lic file", and imports the FanRuan.lic authorization file.

If it is correct, it will show that the registration is successful, as shown in the following figure:

Note: FanRuan.lic will be automatically saved to the current project %BI-HOME%\webroot\WEB-INF\resources directory.

1. Get the migration program

1) Please copy the "FanRuan.lic" file in the %BI_HOME%/webroot/WEB-INF/resources directory of the old BI project .

2) Please refer to: Local machine information authentication , confirm the project name of the new BI project , and export the registration information rif file of the new BI project .

3) Please use the email address specified in the contract to send the registration information to FineBI Business business@fanruan.com , the email format is as follows:

After the business receives the email, it will generate a license migration program for you after verification and send it to you by email. As shown below:

2. Generate verification code

Note: Old FineBI projects whose JAR package version is before 2020-01-15 do not need to perform this operation.

The super administrator logs in to the data decision-making system of the old report project, and accesses the specified URL in the decision-making platform to generate a verification code. As shown below:

Example URL: http://ip:port/webroot/decision/v10/register/remove/captcha

Note 1: The data decision system here is the original project, that is, the project that needs to destroy the license.

Note 2: The verification code is regenerated every time the URL is accessed, and the old verification code is invalid when a new verification code is generated.

Note 3: If the old FineBI project is configured with a short domain name, the URL is http://domain/decision/v10/register/remove/captcha

3. Running the migration program

Put the "migration program" on a machine that can communicate with the old FineBI project.

1) Add executable permission

Add the executable permission to the executor. The code looks like this:

chmod u+x lic_remove

2) Enter the old FineBI project address

Execute the migration program, the code is as follows:

./lic_remove

A command line window will pop up after running. Tip: Uninstall the server destination address. As shown below:

Enter the server address of the old FineBI project: http://ip:port/webroot/decision or http://domain/webroot/decision

Note 1: Please make sure that the server running "Migration Program" can communicate with the server of the old FineBI project normally. Otherwise, it will prompt: Failed to connect to the server, please check whether the address is correct, and re-enter:

Note 2: If the input server target address is not registered or is temporarily registered, the user will be prompted: Migration failed, FineBI server is not registered or is temporarily registered.

Please enter an address like http://localhost : 8075/ webroot/ decision to specify the server you want to migrate
Uninstall server target address: http://localhost :8080/ webroot/ decision
Failed to connect to the server, please check if the address is correct and re-enter:
Uninstall server target address:

3) Enter verification code

Note: Old FineBI projects whose JAR package version is before 2020-01-15 do not need to perform this operation.

After entering the target address written in the server correctly, a prompt will pop up: Please enter the verification code. Enter the verification code obtained in Section 4.2, as shown in the following figure:

Note: The verification code is valid for 30 minutes. If the verification code fails, it will prompt: The verification code is wrong or has expired, please re-enter.

Please enter an address like http://localhost : 8075/ webroot/ decision to specify the server you want to migrate
Uninstall server target address: http://localhost :8080/ webroot/ decision
Please enter the verification code:8ad7c8b98a604d3cb8cf9de54306c916
The verification code is wrong or expired, please re-enter:8ad7c8b98a604d3cb8cf9de54306c916
The migration is successful, please put the lic file in the working directory of the current command line window into the report server

4) Generate FanRuan.lic file

After the verification code is entered successfully, a prompt will pop up: Migration is successful, please put the lic file in the working directory of the current command line window into the FineBI server.

At this time, the registration of the old FineBI project is invalid, and the registration file "FanRuan.lic" of the new FineBI project is automatically generated in the same directory of the migration tool. As shown below:

4. New Project Registration

The administrator logs in to the data decision system of the new FineBI project, clicks"Manage > Registration> Registration Information", clicks "Upload lic file", and imports the FanRuan.lic authorization file.

If it is correct, it will show that the registration is successful, as shown in the following figure:

Note: FanRuan.lic will be automatically saved to the current project %FineBI-HOME%\webroot\WEB-INF\resources directory.