系統安裝

背景

openKM官網¹有詳細的安裝過程說明，還有其他周邊軟體的安裝或設定。此處特別提出注意事項以供參考。

openKM主程式

磁碟機空間

• 由於openKM系統內不能局部選擇磁碟機存取位置，因此必須事先將$TOMCAT_HOME/repository放在足夠大的磁碟機，以免事後搬遷
• (可以由Administration→statistic看到系統資源使用的情況，詳下述)。

Openoffice以及Tesseract的安裝

• 安裝之後要找到其檔案所在位置，以便在openKM裏逐一設定，如Configuration之check。

system.swftools.pdf2swf
OK - /home/openkm/tomcat/bin/pdf2swf
system.imagemagick.convert
OK - /usr/bin/convert
system.ocr
OK - **/usr/bin/tesseract**
system.openoffice.path
OK - **/opt/openoffice4/program/soffice.bin**

加入使用者

• 初始登入okmAdmin(pw:admin)，再依序增加管理者之使用者帳密。
• 批次增加帳密可參考下述。

有關中文之介面²

可下載³後在Configure→default.lang處設定，之後可在Administration→Language處修改局部之翻譯。

有關mail server

openKM需要有mail server，因此需要在啟動tomcat時，同時將postfix啟動，(至少)使notify功能能作用。

Window系統上安裝之注意事項

mysql版本

雖然官網有介入MySQL8版本的注意及修改事項，但經測試結果發現，java(新版connector/J)並不能連結上資料庫平台，還是安裝舊版MySQL比較穩定能搭配。因此如果伺服器上有別的mysql運作需求將會遭遇困難，符合伺服器必須是專用(dedicated)之原則。

okmAdmin登入後trash目錄無法產生之問題

此問題應為OpenKM.cfg內重複新增(create)hibernate.hbm2ddl所置，將其改為none即可。

openoffice目錄設定

不需要到“program”(C:\Program Files (x86)\OpenOffice 4)

tomcat版本與中文顯示

網友曾提及tomcat 8內設字形並非UTF8的問題，並且建議將tomcat.connector.uri.encoding設成UTF-8，然而此舉在centos卻不需要，且無益於中文字的顯示，顯示可能還有其他因素無法正確顯示中文字型。

Mysql的管理

• 給定root的密碼：mysql -u root password

• 給定其他使用者的帳密⁴

• 給定特定的socket

` --socket="/var/lib/mysql/mysql.sock"`

JBOSS的安裝

JBOSS是早期或window所需的虛擬機器平台(JVM)。由於目前最新的版本⁵( boss-as-7.1.1.Final) 與java8並不相容，必須使用較早版本。安裝過程也可以參考openKM早期版本的介紹[^14]。

可以由redhat官網下載(須註冊[^15])後，按照7.1版方式安裝即可。

由於openKM已經佔用了8080的端口，因此要在standalone.xml檔[^16]中將8080改成其他端口。同時也要注意將127.0.0.1改成intranet IP位址。

啟動前後，要記得加入使用者帳密。JBOSS要求的密碼必須是8碼，同時要求至少一碼非英數，要特別注意。