1. Description
Now it offers a separate aid program to upgrade, you can upgrade 9.0 to 10.0 Web engineering projects, including the JAR package, various configuration files, FineDB data sheets compatible upgrade.
1) provide free installation program, click to run, without having to install uninstall.
2) supports Simplified Chinese, English, Traditional Chinese.
3) support for Windows, Linux mainstream operating system.
Note: Please read carefully before upgrading 9-10 Compatibility Statement
2. Get the upgrade tool
Since FineReport function continuously optimized, product iterative upgrade, so upgrade tools are constantly updated.
Technical support provided soft sail
3. To prepare before upgrading
1) Project Backup: Turn off the project to be upgraded before you upgrade, back up this project.
2) Administrator way to start the upgrade tool to ensure that the upgrade tool can create a folder (usually not the project will be placed in the C drive) disk project is located.
3) currently only supports JDK1.8, so be sure to check before the upgrade project JDK version (if the environment does not allow changes, please copy the project to upgrade the environment jdk1.8 then copy back), otherwise there will be upgraded after the successful deployment of an error
4) under an offline environment within the network, up from the 9.0 upgrade project, can not be upgraded plug-mall script
You need to be replaced after the upgrade manually script file scripts , with a path:% FR_HOME% / webapps / webroot / scripts, restart the server after the replacement, and clear your browser cache
Note: Click to download scripts: scripts.zip
5) upgrade project to be carried out as platform database migration, upgrade need to make sure to connect to an external database.
6) 9.0 and earlier versions synchronize data set can select the built-in password MD5 encryption, such as after the upgrade still use MD5 encryption, see: MD5 encryption
If the previous user is stored in plain text, later rose up, no longer able to log on, only to reset; all other custom encryption classes to upgrade to 10.0 will need to re-fit
7) does not support the new version of the plug-in section, please delete it before upgrading.
8) single sign customers to upgrade to 10.0 to be re-adaptation.
9) deep integration of customers, it is recommended to get the data to a separate deployment project which, after the upgrade is complete, further adaptation 10.0.
10) before non-simplified Chinese users of the system upgrade, be sure to manually back up database information. Upgrade tool will delete permissions for different language configuration.
11) under non-simplified Chinese Linux environment, 2018-02-28 ~ 9.0 JAR package between 2018-09-06 and 10.0 are not fully compatible, you need to first upgrade to the latest 9.0 JAR, then use the upgrade tool to upgrade to 10.0.
Step 4. Upgrade
4.1 upgrade tool
1) Right-click on the upgrade tool, select Run as administrator. As shown below:
2) Open the program, select the language, choose Simplified Chinese, Traditional Chinese, English. As shown below:
3) Click OK to enter Setup Wizard FineReport 10.0 upgrade tool, choose to be upgraded 9.0 project folder. As shown below:
Note: The project folder is typically% FR9.0_HOME% / WebReport, is included in the WEB-INF folder.
Note: If the selected directory does not detect the WEB-INF folder, you are prompted to select the WEB container file that contains the WEB-INF directory folder.
Note: If you choose non-engineering version 9.0, you are prompted to upgrade only support the project 9.0.
4) Click Next to enter the original project backup interface, choose the original folder backup saved address, as shown below:
NOTE: The backup address can not be empty, you must enter a backup directory is empty.
5) Click Next, suggesting that the upcoming upgrade, do not turn off this program during the upgrade, and do not make any editorial changes to the original project operations. As shown below:
6) Click Next, start the backup update, as shown below:
Note: After a successful backup, backup files generated WebReport_bak set a good folder.
7) After the upgrade, the interface is shown below:
8) After clicking Finish, the project file is 9.0 WebReport file after being upgraded. As shown below:
4.2 After the upgrade deployment
1) The% JAVA_HOME% / jdk / lib tools.jar Environment variables into at% TOMCAT_HOME% / lib or% TOMCAT_HOME% / webapps / project name / WEB_INF / lib, as shown below:
Note: If you do not perform this step, server deployment process will get an error 500, please see: Server deployment should be introduced tools.jar .
Note: If the environment variable pointing% JRE_HOME% / bin without attach.dll file will need% JAVA_HOME% / jdk / jre / attach.dll the bin copied to this path.
2) deploying the upgraded files to the server, you can see the upgrade 9.0 to 10.0 and engineering retain data, as shown below:
Note: Here is the WebReport upgraded files folder name to the webroot.
5. Frequently Asked Questions
5.1 upgrade tool flash back
Description of the problem: the upgrade process might cause the upgrade tool because some flash back.
Solution: flash back condition occurs, please contact technical support solutions, and send error.log file, located as follows:
1) Windows: error.log clip file to generate the same level in the upgrade tool
2) Linux: do not generate a log file, a log output upgrade the console, the console needs to manually save the pre-upgrade information, such as xshell
5.2 Unsupported major.minor version 52.0
Problem Description: Project success can be upgraded, but the upgrade deployment error: com / sun / tools / attach / VirtualMachine: Unsupported major.minor version 52.0
Analysis: Upgrade Tool only supports JDK1.8 environment, other versions of the JDK environment does not support
solution:
1. Direct replacement for the JDK1.8 environment upgrade
2. A copy of the customer's project to another JDK1.8 environment to upgrade, and then copied back to complete other environmental
5.3 Permissions missing
Problem Description: 2018-02-28 ~ 2018-09-06 JAR package between, under Linux English / Traditional Chinese environment, there is the legacy of all sectors in all positions, resulting in rights exist on all sectors in all their duties or All DepartmentAll Post.
Solution: Since the upgrade tool according to JAR package upgrade time and locale corresponding privilege escalation, so directly upgrade to the latest 9.0 JAR, then use the upgrade tool to upgrade to 10.0.
5.4 port is occupied
Analysis: 2018-11-06 and after the JAR package. 10.0 Project has two ports, one port container: The default is 8075, and the other is websocket: The default is 38888. 10.0 When there is more than one project on the same device, the two ports can not be the same, otherwise the problem port is occupied by an error will occur.
Solution: treatment works is occupied port
5.5 Other notes
1) only to upgrade the Web works, does not provide a complete upgrade of the designer. Designer If you need to upgrade, you can clean installation 10.0, then upgrade project under the old designer to 10.0, works Copies will be upgraded to the new installation of 10.0 designer directory (that is, webroot file 10.0 webapps directory replace project file after the upgrade).
2) If a Web project has been upgraded, regardless of whether the upgrade is successful, you can not run again the upgrade tool to upgrade. 9.0 project has been backed up only by the upgrade again.
3) After upgrading to 10.0, migration had FineDB goes back to the original FineDB back from the database, you need to re-migrate.
4) upgrade tool can not be cross-version upgrades, such as 8.0 project want to upgrade to 10.0, the project needs to be upgraded to 9.0, and then upgrade from 9.0 to 10.0.
5) April 2019 15 and later upgrade tool to support the official data set class plug-ins, support listed below:
| Plug |
| Cubes |
| SAP datasets |
| JSON data set |
| MongoDB data set |
| The new SAP BW data sets |
| Helical dataset |