Ubuntu16.04 tomcat9 Bimserver-1.5.125安装部署

背景

本地Ubuntu服务器已安装Java环境，没有安装Java环境的请自行百度或参考我之前的文章。

本文主要是实现了在Linux服务器下，用tomcat9启动bimserver服务，最终上传示例模型可在线预览。

这方面资料感觉很少，过程中踩了很多坑，最终在本地未挂VPN的情况下部署成功。

安装tomcat9

下载tomcat9

为避免权限问题，以下所有操作均为root用户。

su root
mkdir /usr/lib/tomcat
cd /usr/lib/tomcat
wget http://mirrors.shu.edu.cn/apache/tomcat/tomcat-9/v9.0.16/bin/apache-tomcat-9.0.16.tar.gz
tar -zxvf apache-tomcat-9.0.16.tar.gz

修改配置文件

配置Java环境

whereis java
# /usr/lib/jvm/java-8-oracle
cd /usr/lib/tomcat/apache-tomcat-9.0.16
vi ./bin/startup.sh
# before last line, add content.
JAVA_HOME=/usr/lib/jvm/java-8-oracle
JRE_HOME=${JAVA_HOME}/jre
PATH=$JAVA_HOME/bin:$PATH
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
TOMCAT_HOME=/usr/lib/tomcat/apache-tomcat-9.0.16
# same as shutdown.sh
vi ./bin/shutdown.sh

配置jvm内存

bimserver要求的内存较大，默认的jvm内存大小不够，会导致内存溢出的异常，此处修改。

vi ./bin/catalina.sh
# before first line, add content.
JAVA_OPTS="-Xms256m -Xmx512m"

配置远程访问

不配置此步骤会导致tomcat服务只有本机可访问，其他机器无法访问。

vi ./conf/webapps/manager/META-INF/context.xml
# modify this line
allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1|\d+\.\d+\.\d+\.\d+"

配置用户名密码和角色

记住用户名和密码，后面web网页管理app时会要求登陆。

vi ./conf/tomcat-users.xml
# add content
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<user username="root" password="root" roles="manager-gui,manager-script"/>

修改端口号

此步骤为非必须，如果服务器8080端口未使用，可以不修改。

vi ./conf/server.xml
# modify this line: 8080-->8090
<Connector port="8090" protocol="HTTP/1.1"

部署bimserver

部署bimserver时，请确保tomcat未启动。

下载bimserver

cd /usr/lib/tomcat
wget https://github.com/opensourceBIM/BIMserver/releases/download/v1.5.125/bimserverwar-1.5.125.war
cp bimserverwar-1.5.125.war ./apache-tomcat-9.0.16/webapps/bimserver.war

下载plugin插件

下面的插件版本仅与bimserver-1.5.125版本适配，一定注意版本配对。大家可自行去网站搜索下载。

# https://mvnrepository.com/artifact/org.opensourcebim/bimsurfer3/0.0.17
bimviews:0.0.141
bimsurfer3:0.0.17
ifcopenshellplugin:0.5.51
ifcplugins:0.0.57
binaryserializers:0.0.57
console:0.0.32
gltf:0.0.23
mergers:0.0.30

安装部署

启动tomcat9

cd /usr/lib/tomcat/apache-tomcat-9.0.16
sh ./bin/startup.sh

tomcat在解压bimserver的war包时会耗时，等待tomcat启动完成后打开网页。

http://server_ip:port/
# http://192.168.31.114:8090/

进入manage app的页面，此时会要求登陆，输入tomcat中配置的用户名和密码即可；app列表中会有一个bimserver的应用，点击链接即可进入部署页面，按照提示一步步填写就OK了。

最重要的是选择plugin的页面，去掉所有默认的勾线，自己手动上传前面下载的jar包即可。其中，ifcopenshellplugin这个插件由于是联网下载，安装过程会比较慢，请耐心等待即可。

等所有步骤都完成后，即可进入进入bimviews页面管理项目了。

此处有个技巧，可以通过查看bimserver中的log文件及时发现问题：

cat ./webapps/bimserver/WEB-INF/logs/bimserver.log

模型示例展示

新建项目

进入bimviews页面，新建项目，填写项目名称，test，完善其他信息后点击add完成项目添加。

上传模型

通过console接口为项目添加模型文件。

登陆console

进入console页面，首先点击右上角的login，输入bimserver配置中填写的管理员用户名和密码，点击send，成功后会显示一个token。

getAllProjects

在左侧的API列表中找到getAllProjects，找到刚建立项目的信息，记录项目的oid。

getSuggestedDeserializerForExtension

在左侧的API列表中找到getSuggestedDeserializerForExtension，填入参数信息，extension：ifc；poid：上面project的oid；点击send后，会返回Deserializer的oid，记录下来。

checkinSync

在左侧的API列表中找到checkinSync，填入参数信息，poid:project的oid； deserializerOid:上面返回的oid；filesize：字节大小；filename：文件名；并上传ifc文件；点击send，会提示上传成功，状态为finish。

该步骤中若出现如下错误，则表示ifc文件格式不对：
Error on line 4: IFC2X_FINAL is not supported by this deserializer (IFC2X3 is)

没有ifc文件时候，可以去下载测试文件，地址如下：
https://github.com/opensourceBIM/TestFiles

查看模型

返回bimviews页面找到项目，即可查看该项目的bim模型数据。