Tomcat服务器部署

  • 文档创建者:doreen0813
  • 编辑次数:51次
  • 最近更新:Roxy 于 2020-11-04
  • 1. 概述

    Tomcat 是免费且性能相对稳定的 Web 应用服务器,在许多中小型企业中深受欢迎,本文将介绍如何将 FineBI 5.0 &5.1 部署到 Tomcat 服务器端。

    1.1 支持版本

    用户需提前下载并安装 JDK 和 Tomcat 服务器。Tomcat & JDK 安装及配置步骤请自行查阅资料。

    Tomcat 版本与 JDK 版本需要与操作系统对应,Tomcat 版本、 JDK 版本与 BI 版本对应关系如下:

    Tomcat 版本JDK 版本
    8.0 (不支持 Tomcat 8.0.32 版本)JDK1.8
    9.0JDK1.8

    注1:FineBI5.0 以上仅支持 JDK1.8 版本,且同一个 Tomcat 服务器中不能部署多个 BI 工程。

    注2:不支持 32 位的操作系统。

    注3:不支持 Tomcat 10.0 版本。

    2. 操作步骤

    示例在 Windows 系统下部署步骤。

    2.1 准备工作

    2.1.1 确认 JDK 安装成功

    调用终端命令,输入 java -version javac ,出现如下则表示 JDK 安装成功:

    1594199300832465.png

    2.1.2 Tomcat 服务器已经安装成功

    %Tomcat_HOME%\bin 目录下双击 startup.bat,启动 Tomcat 服务器( Linux 系统下执行./startup.sh ),在浏览器输入命令http://localhost:8080,出现如下图所示的网页则表示安装成功:

    1594199584155131.png

    2.2 拷贝 BI 工程

    %FineBI%\webapps下的 webroot 文件拷贝到%Tomcat_HOME%\webapps下,如下图所示:

    注:BI 工程名 webroot 可以自定义修改,但是需要注意的是后面访问 BI 工程时地址http://ip:端口/工程名/decision中的工程名也要随之更改。

    1576487101509101.png

    2.3 拷贝 tools.jar

    %JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%/lib%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置下

    注:如果不执行该操作,访问 BI 工程时,页面显示报错信息:HTTP Status 404。

    2.png

    2.4 配置参数

    2.4.1 配置 BI 使用内存参数

    FineBI 对服务器有一定的配置要求,因此需要配置内存参数保证服务器稳定,详情参见:修改 FineBI 配置参数 

    2.4.2 配置 dump JVM 参数

    1)此处需要为工程配置上宕机自动生成 dump 日志的 JVM 参数,配置该参数对工程运行没有性能损耗的影响,仅用于在服务器宕机时生成 dump 日志。

    进入%Tomcat%/bin目录下,编辑配置文件 catalina.bat ( Linux 系统下为 catalina.sh ),增加如下 JVM 参数:

    set JAVA_OPTS=%JAVA_OPTS% -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=D:\heapdump

    注:其中D:\heapdump 路径表示的是宕机文件生成路径,可以根据需要修改文件路径。修改保存后,需要重启 Tomcat 才能使配置生效。

    如下图所示:

    6.gif

    2.4 启动 Tomacat 服务器

    进入%Tomcat_HOME%/bin目录下双击 startup.bat,即可启动 Tomcat 服务器( Linux 系统下执行 ./startup.sh ),如下图所示:

    2.png

    2.5 访问 BI 工程

    在浏览器中输入访问地址http://IP:端口/webroot/decision,示例为http://localhost:8080/webroot/decision,打开 BI 工程登录页面,即部署成功,如下图所示:

    1.png

    3. 注意事项

    3.1 Windows 系统下 CMD 窗口

    1)Windows 系统下的 CMD 窗口默认可编辑,如果鼠标点进窗口,会造成所有的 Java 线程阻塞,造成 Tomcat 假死宕机不能使用。此时需要在 Tomcat 的 CMD 界面点击属性。如下图所示:

    222

    2)取消勾选两个编辑选项,点击确定保存该属性,并重启 Tomcat 即可。如下图所示:

    222

    3.2 关于页面显示 HTTP Status 404

    将安装的 JDK 目录lib下面的tools.jar拷贝到%Tomcat_home%/lib%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置。

    3.3 Tomcat 高版本对 URL 特殊字符限制

    1)Tomcat 9.0 做了更严格的限制,严格按照 RFC 3986 规范进行访问解析,而 RFC 3986 规范定义了 URL 中只允许包含英文字母(a-zA-Z)、数字(0-9)、-_.~4个特殊字符以及所有保留字符(RFC3986中指定了以下字符为保留字符:! * ’ ( ) ; : @ & = + $ , / ? # [ ])。

    2)解决方法:

    需要在 server.xml 文件中增加如下代码:

    <Connector port="8084" protocol="HTTP/1.1" relaxedPathChars="[]|" relaxedQueryChars="[]|
    {}^&#x5c;&#x60;&quot;&lt;&gt;" useBodyEncodingForURI="true" connectionTimeout="20000" redirectPort="8443"
    URIEncoding="UTF-8"/>

    3.4 内存不足

    问题报错:配置管理员密码出错Java heap space

    原因分析:表示 Tomcat 的内存不足,需修改Tomcat 内存配置。

    解决方案:修改内存的方法参见文档:Java heap space

    3.5 7.0.100 版本的 Tomcat 部署

    7.0.100 版本的 Tomcat 需要将 web.xml 放到%Tomcat_HOME%\webapps\webroot\WEB-INF下,否则会报错。

    文件请参见:web.xml

    注:该 Tomcat 的 bug 已经在 7.0.103 中修复。

    附件列表


    主题: 部署集成
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!