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 optls # View all files and folders in opt to check whether the deployment package was successfully transmittedchmod 770 tomcat-linux_ENG.tar.gz # Enable current user to access the deployment packagetar -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 informationls -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 insidecd 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 processeskill -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 CentOSsudo apt-get install fontconfig # Use this for Utuntu |
Previous：Server Deployment Principles
