Tomcat Package Deployment in Linux

Version

Application Scenario

To deploy the project to Tomcat, you need to install Tomcat and JDK, which is troublesome for beginners.

FanRuan has integrated the Web container including projects and environment configurations, allowing you to directly deploy and start FineBI in the corresponding system without configuring the environment.

Function Description

This document introduces how to use the Tomcat deployment package in Linux.

Environment Preparation

You have prepared the required environment  by referring to Preparations for Environment Deployment of FineBI Project.

Note:

You cannot install FineBI in 32-bit operating systems.

Deployment Package Download

1. FanRuan provides the deployment package for Linux x64. Before downloading the deployment package, you need to check whether the system architecture meets the installation requirements through the command uname -m, as shown in the following figure.

2. Paying users can contact our technical support to obtain the deployment package of the corresponding version.

3. Upload the deployment package to Linux, as shown in the following figure.

Note:

The example uses the FTP tool to upload the package. You can also use other file transmission tools.

Deployment Package Unzipping

1. Go to the directory where the uploaded deployment package is located.

cd /home/BItest

2. Decompress the deployment package.

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

3. Rename the Tomcat folder through the command
mv tomcat-linux-x64 tomcat.

Project Migration (Optional)

If you want to retain the project previously configured on the local computer, you can proceed with steps in this section. If not, you can skip this section.

1. Delete the webroot folder from the decompressed deployment package (in the %Tomcat_HOME%\tomcat-win64\webapps path).

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

Note:

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

Parameter Configuration (Optional)

You need to deploy the FineBI project on the application server that meet some configuration requirements.

The downtime risk exists if the application server does not meet the requirements for project use.

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

Tomcat Server Starting

1. Go to the bin directory.

cd /home/BItest/tomcat/bin

2. Start Tomcat.

./startup.sh

3. Check whether consumed time for Tomcat re-startup is displayed in the real-time log. If so, the Tomcat startup is successful.

cd /home/BItest/tomcat/logs

tail -f catalina.out

Note:

If the error "Database is not initialized" is displayed after Tomcat is started, you need to check the user read/write permission, which can be configured through the command chmod -R 777 tomcat.

FineBI Access

Enter the access address http://IP address:Port number/Project name/decision in the browser address bar. If the FineBI initialization configuration page is displayed, the deployment is successful, as shown in the following figure.

Note:

The access address includes Server IP address, Port number, Project file name, and decision.

The default port number of Tomcat is 8080. The default project name is webroot.