Tomcat Deployment Package for Linux

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 Linux.

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 for enterprises.

Therefore, you are advised to adopt containerized deployment.

Environment Preparation

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

Note: 

FineReport cannot be installed on 32-bit Linux operating systems.

Deployment Package Download

1. FanRuan provides the deployment package for Linux x86_64 and Linux ARM64. Before downloading the package, run the uname -m command to check if your system architecture meets the installation requirements, as shown in the following figure.

2. 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.

3. After the download is complete, upload it to the Linux system, as shown in the following figure

Note: 

1. In this example, the package is uploaded to the /home/wendy directory, which will be used as the deployment package directory in the following steps. You can customize the path as needed.

2. In this example, an FTP client is used to upload files. You can use any other available file transfer tools.

Deployment Package Extraction

1. Enter the deployment package directory. (Modify the directory in the command to the actual one.)

cd /home/wendy

2. Extract the deployment package. (Modify the package name in the command to the actual one.)

tar -zxvf tomcat-linux-x64.tar.gz

3. Rename the Tomcat directory as needed.  (In this example, it is renamed to tomcat).

mv tomcat-linux-x64 tomcat

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\webapps directory of the extracted deployment package.

2. Copy the webroot folder of the original project (in the FineReport installation directory\webapps directory) 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 project requirements, downtime issues may occur.

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

Tomcat Server Startup

1. Enter the bin directory. (Modify the directory in the command to the actual one.)

cd /home/wendy/tomcat-linux/bin

2. Start Tomcat.

./startup.sh

2. Check the real-time log. If the consumed time is displayed in the log, the project has been started successfully.

cd /home/wendy/tomcat-linux/bin
tail -f catalina.out

Note: 

If the error message "Database is not initialized" is displayed after Tomcat is started, you need to check your read/write permissions. You can configure the permissions using the command chmod -R 777 tomcat.

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.