BIMServer1.5.88服务器部署及IFC文件上传并3D显示

一、JDK安装与环境变量配置
- 1、JDK SE 8下载
- 2、JDK SE 8安装
- 3、JDK 环境配置
二、BIMServer1.5.88安装与环境变量配置
- 1、BIMServer 1.5.88下载
- 2、BIMServer 1.5.88安装
- - NOTE 1: 插件及其必需依赖包下载及安装
- 3、BIMServer 1.5.88信息配置
- 4、bimviews应用及IFC文件上传
- - NOTE 2: 更改默认渲染引擎

BIMServer1.5.88版本其实已经很老了，最新版本都到1.5.182了，但没办法，对于一个刚接触BIMServer的人来说，网上哪个版本的教程多就选哪个，省事，但是…貌似一点也不省事，不知道是别人太牛还是我太菜（应该是后者）。建议选新版本进行安装，涉及maven的问题比较少。
环境及版本：WIN10-x64 JDK8 bimserver1.5.88.jar
简单应用简单安装，毕竟电脑菜鸟，还是离诸如Linux、CentOs或者tomcat、eclipse远一些比较延年益寿…

一、JDK安装与环境变量配置

安装之前最好检查一下系统中是否有与你想下载的JDK版本不同的版本，如果有的话最好卸载掉，以免导致java版本和javac版本不一致，出现类似“A JNI error has occurred, please check your installation and try again”的错误。

1、JDK SE 8下载

Step 1: 直接去Oracle官网下载，目前最新版本为JDK SE 15,往下滑找到JDK SE 8，点击下载。

Step 2: 根据自己操作系统选择相应版本下载，这里以windows-x64为例。登录或者注册一下Oracle就可以下载。

2、JDK SE 8安装

Step 1: 双击下载后的“jdk-8u271-windows-x64.exe”文件就可以进入安装界面，一路【下一步】就行（需要更改安装路径的更改）。

Step 2: JDK自带了jre,但是安装的时候还是需要安装一下（有的说可以取消jre安装，原谅我不知道咋弄，尝试取消安装，但直接就退出整个安装了），更改一下路径就行。

3、JDK 环境配置

Step 1: 单击"【计算机】-【属性】-【高级系统设置】-【环境变量】"，进行环境变量配置。

Step 2: 单击“【系统变量】-【新建】”，注意是系统变量，不是用户变量。将变量名设置为"JAVA_HOME"，变量值设置为"F:\develop\java\jdk1.8.0_271"（就是JDK的安装路径，可以通过【浏览目录】或者复制粘贴）。

Step 3: 选中"Path"进行编辑，单击【新建】，输入值"%JAVA_HOME%\bin"，【确定】后再次【新建】，输入值"%JAVA_HOME%\jre\bin"，单击【确定】。

Step 4: 单击【系统变量】-【新建】，将变量名设置为"CLASSPATH",变量值设为".;%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar",注意最前面是“.;”，表示当前路径。这块一定要设置好，要不然JVM可能找不到类class文件。

Step 5: 环境变量配置完毕后，进入cmd中检查Java是否安装正确。依次输入“java -version”和“javac -version”,版本显示一致则安装结束。

二、BIMServer1.5.88安装与环境变量配置

1、BIMServer 1.5.88下载

Step 1: github下载地址：https://github.com/opensourceBIM/BIMserver/releases/tag/parent-1.5.88
可以看到BIMServer支持war和jar两种部署方式。jar部署只要双击即可，war部署还要安装Tomcat或者Jetty。如果就想简单的运用一下BIMServer，建议还是选择jar部署，相对来说安装比较简单（对于我来说，war部署整一堆操作就望而止步了）。

Step 2: 往下滑，在【Assets】中选择【bimserverjar-1.5.88.jar】并下载到一个没有空格符的英文文件夹中，我直接下载到“F:\BIMServer”了。

2、BIMServer 1.5.88安装

Step 1: 双击并运行【bimserverjar-1.5.88.jar】，这些参数默认即可，无需改动，直接单击【Start】启动程序。

Step 2: 等待程序启动，Server启动成功后，日志窗口会显示“Server started successfully”，文件夹中可以看到以下文件。

NOTE 1: 插件及其必需依赖包下载及安装

启动成功后，不要着急去点击【launch webbrowser】，很多人在安装ifcengine或者ifcopenshellplugin插件时会一直卡在那或者显示如“Required dependency net.java.dev.jna:jna is not installed”等问题导致加载失败（其实不止这两个插件加载失败，如果你换一下插件安装顺序，你会发现还有几个插件都会加载失败），这不是因为插件太大导致加载不出来，而是因为这些插件缺少jar依赖,所以我们在安装插件之前，先要安装某些插件必需的依赖。
Bimservers将需要安装以下插件，可将其放置在“F:\plugins”文件下：

推荐大家去https://mvnrepository.com/artifact/org.opensourcebim下载插件，且提供了插件所需依赖。

Step 1: 找到对应版本点击打开即可，每个插件及其不同的版本都有，有些插件打开后只有一个版本，并没有你想要的版本，没关系，返回后往下翻，很快就可以找到你想要的插件，里头会有所有版本。打开后点击【jar】下载即可，以“ifcEngine-0.0.16.jar”为例：（下载后不要着急退出此下载界面）

Step 2: 页面继续往下翻你就可以发现下方列出了插件“ifcEngine-0.0.16.jar”所必需的编译依赖，它包括依赖的版本号和安装路径。选择Version里头的版本依次下载下来。如果你安装插件失败后去看home文件的话，你会发现在“BIMServer\home\maven”中会自动生成“net\java\dev\jna\jna\4.2.1”文件且此文件为空，所以你在安装的时候才会出现“Required dependency net.java.dev.jna:jna is not installed”错误，导致插件安装失败。所以安装插件前应先把依赖“jna-4.2.1.jar”放到这个“4.2.1”文件夹中。

当然，你现在不需要等失败后再把插件放进去了（失败后放进去也于事无补了，一切都得重新启动Server，我重来了n次），现在你只需要在“BIMServer\home\maven”中创建以下文件夹，并把依赖包丢进去就行。别想着直接把依赖丢进maven中，必须把每一个依赖放置在设置好的maven路径中，路径中间少一个文件夹都会失败。其中shared和pluginbase依赖非必需，但最好选择一个版本装上。粗体为必需依赖，必须得装，路径如下：

依赖包	放置路径
shared-1.5.88.jar	org\opensourcebim\shared\1.5.88
pluginbase-1.5.68.jar	org\opensourcebim\pluginbase\1.5.68

jna-4.2.1.jar	net\java\dev\jna\jna\4.2.1

opencsv-3.3.jar	com\opencsv\opencsv\3.3
jxl-2.6.10.jar	net\sourceforge\jexcelapi\jxl\2.6.10
bcf-0.0.13.jar	org\opensourcebim\bcf\0.0.13

commons-lang-2.6.jar	commons-lang\commons-lang\2.6

jts-1.13.jar	com\vividsolutions\jts\1.13
prefuse-core-1.0.0.jar	de\sciss\prefuse-core\1.0.0

Step 3: 把所有包含依赖的文件放置在“BIMServer\home\maven”下，你会发现路径其实就是下载依赖时【Group/Artifact】栏+【Version】栏，maven文件如图所示：

Step 4: 以上工作完成后，点击【launch webbrowser】进入web端配置BIMServer服务器信息。

3、BIMServer 1.5.88信息配置

Step 1: 设置一下服务器名称，其他默认即可，点击【Next】。

Step 2: 设置管理员账号和密码，账号名建议填写真实的邮箱地址，完成后点击【Next】。

Step 3: E-mail页面可以直接下一步，不用勾选，进入Plugins设置页面。

Step 4: 双击（这样比较快）每一个插件进行加载，所有插件（12个）加载完毕后，页面最底下直接点击【Next】进入下一步。

Step 5: 默认下一步后进入安装界面，点击【Setup】进行安装。如果之前依赖安装没问题的话，不到30秒就可以安装成功，显示以下界面：

Step 6: 点击下方“refresh to go to the status page”进入管理界面，安装成功的话会显示如下4个插件。下次启动Server只需打开bimserver.jar文件，【Start】运行成功后单击【launch webbrowser】即可进入此管理界面。

4、bimviews应用及IFC文件上传

Step 1: 点击【bimviews】，进入BIM Views登陆界面，输入之前注册的管理员账户和密码。

登录成功后显示以下界面：

NOTE 2: 更改默认渲染引擎

此时，不用着急去创建New project。很多人在创建project且导入ifc文件后，发现页面可以看到导入的ifc文件，却看不到3D模型，本人刚开始也这样。博客上可以找到以下原因和解决方案，比如：
        - 原因1：132之前的老版本maven仓库路径更新而引发的问题；
        解决方法：找一个新的版本安装，可参考BimServerjar-1.5.182 环境部署安装避坑之路20200710
        - 原因2：浏览3d模型的IfcOpenShellPlugin依赖的libstdc++.so.6版本比较高；
       解决方法：升级系统中的libstdc++.so.6和glibc，可参考BimServer安装使用
       这个是用的war包部署，jar部署我不清楚怎么升级（当时一脸懵逼，我单方面选择了放弃），war包部署的可以参考。
       在github上找了很久，说实话我确实不知道哪出的问题，日志里出现一堆错误我也看不懂。找了个学过java的给看了看，也没管啥用，但得出了一个小结论：那就是安装过程没问题，因为日志里出现错误是从导入IFC文件开始的。而且基本都是类似“JvmRenderEnginePlugin”、找不到Class类等错误。当时很懵逼，但当在GitHub上偶然间瞥到了一句关于“默认渲染引擎”的话后我就豁然开朗了，终于知道日志里报错的内容是啥。解决如下：

Step 2: 单击【User Settings】-【Render Engines】,选择【…IfcOpenShellEnginePlugin】为默认渲染引擎即可。

Step 3: 更改渲染引擎完毕后，就可以创建新项目了，如下操作：

Step 4: 输入项目名称和项目描述，其他默认即可，单击【Add】进入下一步：

Step 5: 创建项目成功后，在下拉三角中选择【Checkin】上传IFC文件：

Step 6: 上传模型有两种方式，一种是本地文件，一种是URL，这里以本地文件为例进行演示，点击【Choose File】添加IFC文件后可直接点击【Checkin new revision】，其他的默认。

正在上传…

Step 7: 上传结束后会显示“Model data successfully loaded”，即上传成功。单击【3D】即可显示模型，另外可打开IFC树结构，通过控制眼睛状态来决定构件显隐。

至此，BIMServer安装及试运行完毕。希望能帮到你！！！