Tomcat Deployment Package for Windows

Version

Application Scenario

Deploying a FineReport project on the Tomcat server requires the manual installation of Tomcat and the JDK, which can be challenging for beginners.

In view of this, FanRuan has pre-integrated a web container (for example, Tomcat) with the project and environment configurations, enabling direct deployment and start in the corresponding system without manual environment configuration.

Function Description

This document introduces how to use the Tomcat deployment package on Windows.

Note:

Compared with traditional deployment methods, containerized deployment keeps applications separate from each other, runs consistently across different environments, and makes it easier to change, scale, and manage services. This helps reduce maintenance and resource costs significantly for enterprises.

Additionally, the Linux system is more stable, secure, reliable, and flexible compared to the Windows system. Therefore, you are advised to use the containerized deployment to deploy the FineReport production project on the Linux system.

Environment Preparation

For details about environment preparation, see Supported Environment and Configuration for Standalone Project Deployment.

Server Deployment Package Download

Premium users can contact FanRuan technical support to obtain the deployment package of the corresponding version. For details about how to contact technical support, see Technical Support Channel Introduction.

Server Deployment Package Extraction

The deployment package includes a new FineReport project.

Extract the deployment package to a directory, as shown in the following figure.

Note: 

1. Do not extract the files to the system drive (C drive).

2. Due to the large size of the deployment package, the extraction may take longer than usual. Your patience during the extraction process would be much appreciated.

Project Migration (Optional)

You can proceed with the following two steps if you want to retain the local project configured previously; otherwise, you can skip this section.

1. Delete the webroot folder in the Tomcat installation directory\tomcat-win64\webappspath of the extracted deployment package.

2. Copy and paste the webroot folder of the original project (in the FineReport installation directory\webapps path) to the current location.

Note: 

If you use the new project in the deployment package, you need to set the username and password for platform login. If you use the original project for deployment, you can use the username and password of the original project for platform login.

Parameter Configuration (Optional)

The web application server for deploying the FineReport project must meet specific configuration requirements.

If the web application server does not meet the configuration requirements for project deployment, downtime issues may occur.

You are advised to configure the required parameters before starting the Tomcat server.

Tomcat Server Startup

Go to Tomcat installation directory\tomcat-win64\bin, and double-click the startup.bat file to start the Tomcat server, as shown in the following figure.

Accessing the Decision-making Platform

Enter the URL http://IP address:Port number/Project name/decision in a browser. If you are redirected to the initialization page of FineReport, the deployment is successful, as shown in the following figure.

Note: 

In the URL, the default port number of Tomcat is 8080, and the default project name is webroot.