Independent Tomcat Server Deployment in Linux

1. Version

Note: Multiple FineBI projects cannot be deployed in the same Tomcat server.

2. Expected Results

The user wants to deploy the FineBI report project to Tomcat on the Linux system, and the effect is shown in the following figure:

3. Environment preparation

Users need to install JDK and Tomcat under the Linux system in advance. The specific installation method can be consulted by themselves. Documentation and technical support are not responsible for the content of the environment construction part.

Note: The installed JDK version must match the operating system. A 64-bit operating system can install a 32-bit JDK, but FineBI does not support such operations and must be unified.

4. Implementation ideas

1) Upload the webroot folder of the local project in the form of a compressed package to the %TOMCAT_HOME%\webapps of the Tomcat server, and decompress it.

2) Put the tools.jar file under %TOMCAT_HOME%\libunder or under %TOMCAT_HOME%\webapps\ProjectName\WEB_INF\lib .

3) Restart the Tomcat server and access the report project address.

This article takes CentOS7+JDK1.8+Tomcat9.0.44 as an example to demonstrate, Commands of other versions may be slightly different, please handle them yourself.

1. Upload the webroot file to the Tomcat environment

1) Compress the webroot folder of the local FineBI project, and upload the compressed package to %TOMCAT_HOME%\webapps, which can be uploaded through WinSCP/FTP and other software. As shown below:

Note: It is not recommended to upload the folder directly to prevent file problems.

2) After uploading, decompress the compressed package, the code is as follows:

cd /usr/BI/apache-tomcat-9.0.44/webapps
unzip webroot.zip

2. Introduce tools.jar  file in JDK

Copy tools.jar under %JAVA_HOME%\jdk\lib to the deployed server, and copy it to %TOMCAT_HOME%\lib or %TOMCAT_HOME%\webapps\project name\WEB_INF\lib.

The code looks like this:

cp /usr/java/jdk1.8.0_241-amd64/lib/tools.jar /usr/BI/apache-tomcat-9.0.44/lib

3. Confirm whether to modify the port number

If there are multiple Tomcats running at the same time in the Linux system, you need to confirm the default 8080 ; Whether the port number is occupied; if the Linux system has not deployed a project before, this section can be ignored.

1) Check whether the default 8080  port number is occupied. The following figure shows the occupied situation.

netstat -anp |grep 8080

2) If it is occupied, you need to modify the Tomcat port number. For details, please refer to Tomcat Port Configuration 

4. Configuration parameters

1) Configure BI to use memory parameters

FineBI has certain configuration requirements for the server, so it is necessary to configure memory parameters to ensure the stability of the server. For details, see: Modify FineBI Configuration Parameters 

Note: If the headless parameter in Modify FineBI Configuration Parameters Section 5.1 is not configured, while the super administrator Export to Excel , an error will be reported: No export permission.

2) Configuring dump JVM parameters

Here, you need to configure the JVM parameter for automatically generating dump logs when the project is down. Configuring this parameter has no impact on the performance of the project, and is only used to generate dump logs when the server is down.

Enter%TOMCAT_HOME%/bin directory, edit the configuration file catalina.sh, and add the following JVM parameters:

JAVA_OPTS="$JAVA_OPTS -XX:+HeapDumpOnOutOfMemoryError"
JAVA_OPTS="$JAVA_OPTS -XX:HeapDumpPath=/opt/"

Note: The /opt/ path represents the downtime file generation path, and the file path can be modified as needed. After the modification is saved, you need to restart Tomcat for the configuration to take effect.

As shown below:

5. Start Tomcat

Note: Close and restart the BI  project deployed in Tomcat  in the Linux  system, see Close the FineBI project

The execution statement is as follows:

cd /usr/BI/apache-tomcat-9.0.44/bin   #Enter the bin directory
./startup.sh                   #Start Tomcat

6. Effect View

Start the browser and type in the address bar:http://ip:server port number/project name/decision, as shown below: