BIMServer1.5.88伺服器部署及IFC檔案上傳並3D顯示

       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安裝及試執行完畢。希望能幫到你！！！