Guide to Deploy FineBI Personal Trial

Version

Application Scenario

• General users (for personal trial) are advised to directly use the online analysis platform of FineBI 6.1. This platform requires no installation and supports online sharing and collaboration.

• Download and installation on local devices/personal computers are suitable for product selection testing. This mainly meets IT personnel's research and simple functional testing requirements before product purchase.

This document briefly introduces how to download and install FineBI on a local computer.

Note:

1. For official use by enterprises or for simulating official enterprise use scenarios (such as product training/promotion and performance testing), select a containerized deployment solution by referring to Containerized Deployment.

2. The name of the path to which FineBI is installed must be in English, for example, D:\FR\FineBI6.1. Otherwise, FineBI cannot be started.

3. FineBI installed and downloaded on a local device/personal computer does not support sharing or collaboration. Namely, created analysis dashboards cannot be shared, and dashboards with large data volume may suffer from shuttering due to the limited memory and disk space of the personal computer. For more installation FAQs, refer to Common FineBI Installation FAQs.

System Requirement

FineBI can be installed in mainstream operating systems that meet specific requirements on items such as the CPU, JDK version, and memory.

• Linux system requirement:

• Windows system requirement:

• Mac system requirement:

Note:

In addition to the JDK mentioned above, OpenJDK (such as Amazon Corretto and AdoptOpenJDK) is also supported. Before installation, you need to ensure that the current operating system meets the requirements on the CPU and JDK version (JDK 1.8 with the minor version at least JDK8u102). You can download the JDK of the required version from the corresponding app vendor to install and deploy FineBI. Otherwise, FineBI cannot be installed properly.

Installation Instruction

• You are not advised to run multiple projects simultaneously on the same server. NIO will fill up the memory, which may cause problems such as unavailability of another project, system crash, and login timeout during access through the same browser.

• For formal enterprise projects, do not install FineBI by referring to this document. The installation package in this document is only suitable for trial. You can select an appropriate project  deployment solution by referring to Selecting a Project Deployment Solution.

• For details about installation FAQs, refer to Common FineBI Installation FAQs.

Installation Process

FineBI is often installed in Linux, a commonly-used server system. The following describes how to install FineBI in Linux.

Note:

For formal enterprise projects, do not install FineBI by referring to this document. The installation package in this document is only suitable for trial. You can select an appropriate project deployment solution by referring to Selecting a Project Deployment Solution.

Installation Package Download

Note:

The installation package deployment is only for personal trial. For formal project environments, deploy FineBI using a web container.

(1) Visit the FineBI download website https://intl.finebi.com/.

(2) Download the Linux-compatible installation package linux_unix_FineBI6_0-EN.sh, and upload the package to the Linux server.

(3) Connect to the Linux server through a terminal and execute the following command to grant the file permission to the installation package.

chmod 777 linux_unix_FineBI6_0-EN.sh

Note:

If you do not execute the permission assignment command first, the error message "-bash: ./linux_unix_FineBI6_0-EN.sh: Permission denied" will be displayed.

FineBI Installation

(1) Execute the installation command, as shown in the following figure.

./linux_unix_FineBI6_0-EN.sh

(2) Press Enter to start installation. After the license agreement appears, press Enter again and decide whether to agree to the agreement. If you agree, enter 1 and press Enter again, as shown in the following figure.

(3) Enter the directory (where FineBI is to be installed) in the format shown in the following figure. The default value is used here. You can also directly press Enter.

(4) Set the maximum memory (unit: MB) used by FineBI by entering the value directly. The default value is used here. You can directly press Enter, as shown in the following figure.

Note:

 If a 64-bit operating system is used here, you need to set the minimum JVM memory to 2048 MB (2 GB). Otherwise, FineBI cannot run normally.

(5) Wait until a prompt is displayed for you to determine whether to create a quick connection. Usually, no quick connection needs to be created for FineBI placed on the server. Just enter n and press Enter.

Likewise, no desktop shortcut needs to be created. Enter n, press Enter, and determine whether to generate a security key file, as shown in the following figure. If you determine to generate one, the file will be decompressed for installation.

Note:

For details about the Generate a security key file button, refer to Creating a Security Key File.

(6) After the installation is complete, wait until a prompt is displayed for you to determine whether to run FineBI, enter y, and press Enter to run FineBI, as shown in the following figure.

FineBI Startup

For details, refer to Starting FineBI in Linux.

After successfully starting FineBI, you can access it by entering http://IP address:37799/webroot/decision (where IP address specifies the IP address of the server on which FineBI is installed) in the browser address bar.

If you cannot access FineBI through an extranet, you can use third-party tools, such as the peanut shell, fcn, and frp, to achieve intranet penetration. For subsequent operations, refer to Initialization Setting.

Note:

http://localhost:37799/webroot/decision is the default access address. You can modify it as needed.

For formal enterprise projects, do not install FineBI by referring to this document. The installation package in this document is only suitable for trial. You can select an appropriate project deployment solution by referring to Selecting a Project Deployment Solution.

FineBI Download

(1) Access the official FineBI website, and click Free Trial in the upper part of the page to access the FineBI installation package download page.

Enter your information to get a free activation code.

(2) Select one to download from installation packages of multiple versions provided on the download page based on your system. Take the Windows 64-bit system as an example. You can download the installation package mapping the Windows 64-bit system to the local computer.

FineBI Installation

(1) Double-click the FineBI installation file. After the installation wizard is loaded, click Next in the following dialog box that is displayed.

(2) In the license agreement dialog box that is displayed, select I accept the agreement. Click Next.

(3) In the Select Destination Directory dialog box that is displayed, click Browse, select the FineBI installation directory, and click Next.

Note:

You are not advised to install FineBI on the system disk.

(4) In the Set maximum memory dialog box that is displayed, set Maximum jvm memory to be at least 2 GB (recommended). The maximum JVM memory is 2048 MB (2 GB) by default. After completion, click Next.

Note:

The maximum JVM memory cannot exceed the maximum memory of the local computer.

(5) In the Select Start Menu Folder dialog box that is displayed, select options according to your needs. Click Next, as shown in the following figure.

(6) In the Select additional work dialog box that is displayed, select options according to your needs. Click Next, as shown in the following figure.

Note:

For details about the Generate a security key file button, refer to Creating a Security Key File.

(7) Wait until the Completing the FineBI Setup Wizard dialog box is displayed. If you select Run FineBI and click Finish, FineBI will automatically start and the FineBI setting page will pop up. If you deselect Run FineBI and click Finish, FineBI will not automatically start.

FineBI Startup

Two ways are available to start FineBI.

Method 1: Click the shortcut icon on the desktop.

Method 2: Click the finebi.exe file in the %FineBI%/bin installation directory.

The current BI installation package is originally configured with the Tomcat server. After you click this file, the loading page is displayed and the BI server is started through Tomcat.

After the Tomcat server starts, http://localhost:37799/webroot/decision is automatically displayed in the browser address bar to enter the FineBI initialization setting page, as shown in the following figure.

Note:

http://localhost:37799/webroot/decision is the default access address. You can modify it as needed.

For subsequent operations, refer to Initialization Setting.

Note:

You need to replace localhost in the FineBI access address with your server IP address during access through an extranet. If you cannot access FineBI through an extranet, you can use third-party tools, such as the peanut shell, fcn, and frp, to achieve intranet penetration.

Notes

If an anomaly prompt dialog box is displayed after you enter the registration code during FineBI startup, you can open the FineBIEnv.xml file in the C:\Users\Users\.FineBI60 directory.

Replace the existing activation code, as shown in the following figure.

You can access the official FineBI website, click Free Trial, and enter relevant information to obtain an activation code. For details, refer to the section "FineBI Download".

FineBI Download and Installation

FineBI download in a Mac system is similar to that in Windows. After downloading the installation package of the latest version from the official FineBI website, double-click the FineBI installation file, wait until the installation wizard is loaded and the dialog box is displayed, and perform subsequent operations by simply following the procedure in section "FineBI Installation."

During download, you need to click Open. Run the FineBI installation program.

FineBI Startup

Two methods are available to start FineBI in the Mac system. One is to find the installed finebi program directly in the program bar and double-click the icon to start FineBI.

The other is to enter the FineBI installation directory and start FineBI by clicking finebi4shell in %FineBI%/bin.

After successfully starting FineBI, you can access it by entering http://IP address:37799/webroot/decision (where IP address specifies the IP address of the server on which FineBI is installed) in the browser address bar. If you cannot access FineBI through an extranet, you can use third-party tools, such as the peanut shell, fcn, and frp, to achieve intranet penetration. For subsequent operations, refer to Initialization Setting.

Note:

http://localhost:37799/webroot/decision is the default access address. You can modify it as needed.

If you cannot start FineBI after installation, refer to Common FineBI Startup FAQs.