Utilize a Deployment Package

I. Overview

1) In a deployment package, JRE, Tomcat and FineReport project have been installed in advance. After unzipping, the deployment package can be used directly, free the need to deploy Tomcat.

2) This article describes the steps to utilize deployment package in Windows servers and Linux servers, using Windows 10 and CentOS 6 as examples.

3) Before using a deployment package, please check that your server has enough space for FineReport project, and it is recommended to reserve 2-4 G.

II. Utilize a deployment package in Windows

1. Download a deployment package

1) Go to the product download page via the official website ( https://www.finereport.com/en/).

2) In the [Download a Deployment Package], find the package that matches your operating system and click to download.

2. Unzip the deployment package

1) Unzip the deployment package to a desired directory.

2) C drive is not recommended.

3. Start Tomcat

1) Go to folder bin in the deployment package and double click startup.bat.

2) Minimize the Tomcat window to let it run in the background.

4. Login the decision-making platform

Input http://localhost:8080/webroot/decision/ in the browser to enter the decision-making platform. Set the username and password.

5. Shutdown Tomcat

Go to folder bin and double click shutdown.bat to shutdown Tomcat.

III. Utilize a deployment package in Linux

1. Click to download a deployment package for Linux servers

Use your local PC to download the deployment package. The file after downloading takes tar.gz as the suffix.

2. Transmit the deployment package from local PC to the Linux server

In the picture below, the deployment package is transmitted to a folder named opt in the Linux server.

3. Unzip the deployment package

1) Use the commands below to unzip the deployment package.

cd opt/  # Change the current working directory to opt
ls # View all files and folders in opt to check whether the deployment package was successfully transmitted
chmod 770 tomcat-linux_ENG.tar.gz # Enable current user to access the deployment package
tar -zxvf tomcat-linux_ENG.tar.gz  # Unzip the deployment package

2) A folder named tomcat-linux_ENG is created after the unzipping.

ll # View all files and folders in opt, along with their detailed information
ls -l # Use this for Ubuntu

4. Start Tomcat

1) Change the current working directory to the folder named bin in the unzipped deployment package.

chmod 770 -R tomcat-linux_ENG # Enable current user to access the unzipped deployment package as well as the directories and files inside
cd tomcat-linux_ENG/bin/ # Change the current working directory to the folder named bin, which stores the startup and shutdown files of Tomcat

2) Run the file named startup.sh.

./startup.sh # Run the startup file of Tomcat

3) Check the status of Tomcat.

tail -f ../logs/catalica.out # Output Tomcat logs

The last 2 rows of log indicate that Tomcat was started normally and uses port 8080.

5. Login the decision-making platform

Input http://server ip:8080/webroot/decision/ in the browser of your local PC and set username and password.

6. Shutdown Tomcat

1) Run the file named shutdown.sh in folder bin.

./shutdown.sh

2) Kill remnant Tomcat processes.

ps -ef | grep tomcat # List all remnant Tomcat processes
kill -9 5013 5113 5114 # Kill the processes. 5013, 5113 and 5114 are IDs of Tomcat processes

IV. Solve abnormal conditions when using a deployment package for Linux servers

1. Fail to access reports after login the decision-making platform

1) Abnormal condition: The browser display the following error messages.

2) Solution: Install fontconfig in any folder in the Linux server.

yum instll fontconfig # Use this for CentOS
sudo apt-get install fontconfig # Use this for Utuntu

Page viewed 628 times

Kumpulan Tutorial Kito

Senin, 29 November 2021

FINEREPORT-english

Unduh V10.0

Unduh Penyebaran Server

Ayo Mulai FineReport