Tomcat Server Package Deployment in Windows

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

Note:

You are advised to deploy the official FineBI project through Linux because Linux has better performance in aspects like stability, security, customizability, and reliability than Windows.

For details, see Tomcat Server Package Deployment in Linux.

Environment Preparation

Prepare the related environment by referring to Recommended Environment and Configuration for Project Deployment.

Note:

You cannot install FineBI in 32-bit operating systems.

Deployment Package Download

Premium users can contact our 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 Decompression

The project configured by the deployment package downloaded from the official channel is a brand-new FineBI project.

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

Note:

1. Do not select the system disk (disk C). You are advised to select a directory from a non-Chinese path to avoid startup issues.

2. Wait patiently since it may take a long time to decompress such a large deployment package

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 %Tomcat_HOME%\tomcat-win64\webapps path to which the deployment package is decompressed.

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 Startup

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

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.

For details about common deployment FAQs, see Common Tomcat Deployment FAQs.