安装Smartbi（tomcat中间件）

Smartbi主体应用程序，核心程序，必须安装。

服务器推荐配置：

1. 环境准备

①在apache官网下载tomcat安装包

tomcat8 官方下载地址：https://tomcat.apache.org/download-80.cgi

tomcat9 官方下载地址：https://tomcat.apache.org/download-90.cgi

如下图，下载zip包或者tar.gz包即可。

②在oracle官网下载64位的jdk安装包

③创建Smartbi知识库，知识库字符集编码请指定GBK或UTF-8。

在数据库服务器上创建一个空库，作为Smartbi的知识库。

1.1. 防火墙配置

为了便于安装，建议在安装前关闭防火墙。使用过程中，为了系统安全可以选择启用防火墙，但必须启用Smartbi使用到的相关端口。

1.1.1. 关闭防火墙

临时关闭防火墙（立即生效）

# systemctl stop firewalld

永久关闭防火墙（重启后生效）

# systemctl disable firewalld

查看防火墙状态

# systemctl status firewalld

1.1.2. 开启防火墙

相关服务及端口对照表

如果确实需要打开防火墙安装，需要给防火墙放开以下需要使用到的端口
开启端口：8080

# firewall-cmd --permanent --add-port=8080/tcp

配置完以后重新加载firewalld，使配置生效

# firewall-cmd --reload

查看防火墙的配置信息

# firewall-cmd --list-all

1.1.3. 关闭selinux

临时关闭selinux，立即生效，不需要重启服务器。

# setenforce 0

永久关闭selinux，修改完配置后需要重启服务器才能生效

# sed -i 's/=enforcing/=disabled/g'  /etc/selinux/config

1.2 安装Java环境

 安装包解压到/data目录

# tar -zxvf jdk8.0.202-linux_x64.tar.gz -C /data

2. 部署Smartbi

2.1. 安装Tomcat

① Tomcat安装包解压到/data目录

# tar -zxvf apache-tomcat-8.5.51.tar.gz -C /data

② 修改Tomcat启动参数

进入Tomcat下的bin目录

# cd /data/apache-tomcat-8.5.51/bin/

创建Tomcat启动参数文件：setenv.sh

# vi setenv.sh

具体参数如下，此步骤不可省略(根据实际部署替换配置中的路径)：

export JAVA_HOME="/data/jdk8.0.202-linux_x64"
export JRE_HOME="/data/jdk8.0.202-linux_x64/jre"
export CATALINA_HOME="/data/apache-tomcat-8.5.51"
export JAVA_OPTS="-Dfile.encoding=UTF-8 -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms2048m -Xmx8192m -XX:MaxMetaspaceSize=512m -Dmail.mime.splitlongparameters=false -XX:+HeapDumpOnOutOfMemoryError -XX:-OmitStackTraceInFastThrow -XX:+UseG1GC"

赋予setenv.sh相关权限

# chmod 755 setenv.sh

2.2. 部署Smartbi

2.2.1. 上传war包

将smartbi.war上传到/data/apache-tomcat-8.5.51/webapps目录下

s

2.2.2. 启动Tomcat 服务器

进入/data/apache-tomcat-8.5.51/bin目录下，执行startup.sh脚本启动tomcat程序

cd /data/apache-tomcat-8.5.51/bin
./startup.sh

2.3. 配置Smartbi

Tomcat服务启动完成后，访问 http://IP:PORT/smartbi/vision/config 进入Smartbi系统配置页面。

首次登陆会要求设置Config页面登陆密码

完成知识库连接配置、上传License文件、以及其他设置项，然后保存配置。配置详情参考Smartbi系统配置信息说明

2.4. 上传字体

将simsun.ttc(宋体)上传到/data/apache-tomcat-8.5.51/bin/Font-smartbi目录下，附件如下：

simsun.ttc

2.5. 重启Tomcat服务

Smartbi config页面配置保存完成后需要重启Tomcat服务，完成知识库表的自动创建工作。

① 停止tomcat程序

# ps -ef|grep tomcat
# kill -9 tomcat进程ID

② 重新启动Tomcat服务

cd /data/apache-tomcat-8.5.51/bin
./startup.sh

等待Tomcat服务启动和Smartbi完成初始化即可访问 Smartbi：http://IP:PORT/smartbi/vision/index.jsp

Smartbi 初始登陆账号：admin 密码：manager

首次登陆会要求修改密码。

Smartbi部署完成！

2.6. Tomcat设置开机启动

进入/etc/init.d目录，创建Tomcat启动配置文件

vi /etc/init.d/tomcat

配置参考如下：

#!/bin/bash
# tomcat startup script for the Tomcat server
# chkconfig: 345 80 20
# description: start the tomcat deamon
#
# Source function library
. /etc/rc.d/init.d/functions

prog=tomcat
JAVA_HOME=/home/smartbi/jdk1.8.0_181/  #注意替换成实际的JAVA路径
export JAVA_HOME
CATALANA_HOME=/data/apache-tomcat-8.5.57/  #注意替换成实际的Tomcat目录路径
export CATALINA_HOME

case "$1" in
start)
    echo "Starting Tomcat..."
    $CATALANA_HOME/bin/startup.sh
    ;;

stop)
    echo "Stopping Tomcat..."
    $CATALANA_HOME/bin/shutdown.sh
    ;;

restart)
    echo "Stopping Tomcat..."
    $CATALANA_HOME/bin/shutdown.sh
    sleep 2
    echo
    echo "Starting Tomcat..."
    $CATALANA_HOME/bin/startup.sh
    ;;

*)
    echo "Usage: $prog {start|stop|restart}"
    ;;
esac
exit 0

设置开机启动

chmod +x /etc/init.d/tomcat    #添加执行权限
chkconfig tomcat on            #添加到开机启动
chkconfig --list               #查看开机启动服务列表

3. 常见问题

3.1. Smartbi日志文件路径

Smartbi日志存在路径：默认情况下，Smartbi日志保存在<tomcat安装路径>/bin/ 目录。确切路径可以登录Smartbi的config页面：http://IP:PORT/smartbi/vision/config.jsp 查看服务器日志中日志的存放位置的配置值。

3.2. 数据库用户没有创建表权限

问题：如果启动服务器后报这样的错：Caused by: com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: CREATE command denied to user 'admin'@'localhost' for table 't_upgradelock'。

问题原因：是因为当前数据库用户 admin 没有权限创建表。

解决方案：给这个用户授予相关操作权限。

3.3. 服务器端口被占用

问题：启动服务器不成功，查看smartbi.log日志文件，出现下面信息：

问题原因：端口号被占用。

解决方案：

方法一，停止占用端口的应用。

方法二，更改Smartbi应用服务器的默认端口。

3.4. 知识库字符集不正确

问题：启动服务器不成功，查看smartbi.log日志文件，出现下面信息：

问题原因：知识库实际字符集编码和smartbi config页面的配置的知识库字符集编码不一致导致。

解决方案：Smartbi可以支持GBK和UTF-8字符集编码。建议新创建一个指定GBK或UTF-8字符集编码的空库，在smartbi config页面配置和知识库一致的字符集编码，然后再重新启动smartbi。

如mysql数据库指定GBK字符集：create database test2 DEFAULT CHARACTER SET gbk COLLATE gbk_chinese_ci;  

3.5. Tomcat部署注意事项

 取消Tomcat上传大小限制

Tomcat8.x默认上传文件大小(maxPostSize)限制为2M，如果需要取消maxPostSize限制，需要将maxPostSize的值设置为负数：

vi  <Tomcat8.x目录>/conf/server.xml 

添加 maxPostSize="-1"

配置参考下图：

重启Tomcat，使其生效。

3.6 smartbi 启动提示权限不足

问题：smartbi启动，提示无法访问日志文件

问题原因：部署smartbi时，用root用户或其他用户来部署，启动时又使用另一个普通用户，导致对文件没有写权限。

解决方案：给整个tomcat目录赋予当前用户的权限。

3.7 解析 HTTP 请求 header 错误

问题：启动smartbi，访问smartbi失败，tomcat日志提示解析 HTTP 请求header 错误

问题原因：使用https请求http服务，导致http请求失败。

解决方案：访问smartbi的url，换成http，不要用https。