Introduction to Wizard Page when Deploying FineBI on Servers

Version

Application Scenarios

When you deploy the server, the deployment may fail due to multiple reasons. At this time, a guiding page will be provided to help you detect and fix the problem.

Function

When the server deployment fails, the wizard will guide you to detect and fix problems in time for a successful deployment.

The deployment procedure is as follows:

Deployment Environment Exception

The error message is displayed as follows:

For details, see Deployment Environment Exception.

Database Connection Exception

1.     Built-In Database Connection Failture

WhenFineBI fails to be connected to the built-in database, the error message is shown like this:

2.     External Database Connection Failture

WhenFineBI fails to be connected to the external database, the error message is shown like this:

After modifying the configuration of the external database, click Retest. If the connection is successful, you will directly access the new database. If the connected database has no data, it will prompt that the target database is an unusable new database.

WebSocket Port Exception

When the WebSocket port conflicts with other ports, the error message is shown like this:

External Database Exception

If an external database exception is detected, an error message will be prompted: Check whether the database user has the permission to create and modify tables. Or check the database logs to rectify the fault.

To address this issue, we need to check whether the user has the permission to create and modify tables in the database. If the user does not have the permission, grant the permission to the user. If the user has, check the database logs for other problems.

Note: External database user without database permissions will be prompted during the upgrade to terminate the upgrade.

Take Tomcat container as an example. Copy webroot folder under %BI_HOME%/webapps/webroot to %TOMCAT_HOME%/webapps and start Tomcat.

Jumping to the Deployment Wizard

If the project fails to start, visit http://localhost:8080/webroot/decision, and you will automatically be directed to the server deployment wizard page http://localhost:8080/webroot/decision/v10/deployment/recommendation.

Following the Prompt

Copy the tools.jar file under %JAVA_HOME%\jdk\lib to %Tomcat_home%\webapps\webroot\WEB-INF\lib.

Successful Deployment

Restart Tomcat and visit http://localhost:8080/webroot/decision. If you can be directed to the login page, the deployment is successful.