I. Overview
1. Version
| Designer version | JAR |
|---|---|
| 10.0 | 2021-05-26 |
2. Function introduction
Local Machine Info AUTH is the most common authentication method, it is very simple and convenient.
The physical information of the server where the report project locates is fixed. You can export the rif file to obtain the mac address and machine code to generate a unique license file.
3. Precautions
You are advised to use Public Cloud AUTH as the simplest and fastest registration method.
1) Local Machine Info AUTH requires the physical information of the server where the report project is located to be fixed. If not fixed, this registration method is not suitable.
For example, if the report project is deployed on a VM, physical information may change in the VM environment, causing the registration failure. In this case, select another registration method.
2) A formal license file can be registered only once on a machine. To register multiple projects on the same machine, you need to purchase multiple licenses.
3) An official license file applies to only one server. If a server needs to be replaced, you need to register and migrate the license file.
4) After a large-scale upgrade (9.0 to 10.0) on the same server, registration migration is required.
II. Steps
1. Confirm the project name
Open the report project server %FR_HOME%\webapps directory and confirm the report Web project name, which is webroot by default.
Users can change the project name based on their own needs before registration, but cannot change the project name after registration.
Note: The modification of this project name may affect the template hyperlink and other settings, please be careful to modify.
To change the project name is to change the name of this folder. After changing the project name, the address to access the project is changed to http://IP: port/project name/decision
2. Export registration information
Start FineReport project server, the administrator access the decision-making platform, click "Manage > Registration".
Click "Sign Up Now" under the "Registration Information" tab, select "Local Machine Info AUTH" as the authentication method, and click "Export Registration Information", as shown below:
The exported file called RegistrationInformation.rif, the file storage engineering version information in a statement.
3. Send an email to business team
Please use the email address specified in the contract to send the registration information to FineReport business, and the mailbox is business@fanruan.com , the email formats are as follows:
| List | Content | Precautions |
|---|---|---|
| First contact | Please contact fanruan sales in advance to confirm relevant matters and sign the contract. | - |
| Sender | Please use the email address specified in the contract. | If the email from which the registration information is sent is not specified in the contract, the registration will not be granted. |
| Recipient | business@fanruan.com | - |
| Title | XXX company registered FineReport official authorization document | If the company name is not indicated when sending the registration information, it will not be registered. |
| Body | Company name: XXX Company Project Name: XXX Project Contract signing date: XX, XX, XXXX Registration method: Local Machine Info AUTH | Other information, such as the number of concurrent users, will be registered according to the signed contract. |
| Attachment | The exported rif file that talked above. | Don't open the generated RegistrationInformation.rif file, which can lead to the file is damaged, if you send it to fanruan business again, will cause the registration fail. |
4. Obtain the authorization file for registration
After receiving the email, the business department will generate a FanRuan.lic authorization file for you and send it to you by email.
Click "Manage > Registration > Registration Information", click "Upload Lic File", import FanRuan.lic authorization file, as shown below:
If the information is correct, the successful registration will be displayed, as shown below:
Note: FanRuan.lic will be automatically saved to your current project %FR_Home%\webroot\WEB-INF\resourcesdirectory.
III. Cancel the registration
1) Go to the %FR_HOME%\webroot\WEB-INF\resources directory and delete the "FanRuan.lic" file, as shown below:
2) Restart the report server.
IV. Registration failed
1. Description
If the registration fails, a prompt pop-up window will appear on the page, as shown below:
2. Reasons
Click Details to view the cause of the registration failure and rectify the failure according to the specific cause.
| Reason | Prompt |
|---|---|
| Certificate has expired | Expiration time: xxx |
| Version does not match | Authentication application version: 9.0 Local application version: 10.0 |
| MAC address does not match | Authentication MAC address: xxx Local MAC address: xxx |
| Machine code does not match | Authentication machine code: xxx Local machine code: xxx |
| Application name does not match | Authentication application name: xxx Local application name: xxx |
| The authorized number has reached the upper limit. | The certificate has been used by other projects on the server |
| Project contents do not match | Authentication project content: xxx Local project content: xxx |
Note: In addition to the above reasons for failure, other errors are reported: the content of the certificate is incorrect.
When there are multiple reasons for failure, they are all displayed in the platform.
V. Registration expiration reminder
Note: License registered with jar before 2018-12-27 need to be registered again when the JAR package is updated to 2018-12-27 or later, and lic expiration notification is added to the platform.
Notification: The validity period is 15 days. After the validity period expires, the super administrator receives a notification every time he logs in to the decision-making platform.
Content: Your license will expire in n days, please renew it as soon as possible.
