CMDBuildとは
CMDBuildは、クラウド環境に最適な構成管理システムです。
仮想化環境での論理構成と物理構成の複雑化、変更の高頻度・高速化による構成情報の爆発に対して、強力な自動化機能、外部システム連携機能を備え、運用管理自動化基盤を実現します。
詳細は以下をご参照ください。
https://www.cmdbuild.org/en
https://www.ossl.co.jp
また、本記事は以下記事のアップデート版となります。
https://qiita.com/satoruf/items/558132e8cf6e4e0a55e6
CMDBuildの特長
オープンソース（GNU Affero General Public License）
・主要機能が無料で使用可能
・サポートライセンスを購入すれば、モバイルアプリおよびQA、障害対応、バグフィックス／ワークアラウンドの提供、新機能の早期提供をサポート
自由なデータモデル
・構成アイテム（サーバ等）と属性情報（担当者連絡先、契約情報、ロケーション等）の関係を自由に定義可能
・ITIL V3に準拠したプロセスをサポート
稼働条件
・CMDBuild 3.3.2
・メモリ16GB推奨
・ディスク空き容量120GB以上推奨
・PostgreSQL 9.6 to 10.x;
・ApacheTomcat 9.0
・JDK 1.11
・DMS（Alfresco Community recommended - optional）
稼働条件の詳細は以下に記載されております。
https://www.cmdbuild.org/en/download/latest-version
CMDbuildインストール環境（CentOS7）
・CentOS 7.9
・CMDBuild 3.3.2
・PostgreSQL 9.6.23
・openjdk 11
・ApacheTomcat 9.0.53
・Alfresco Community 6
・SELinuxはDisabled、Firewalldは停止されていること
・作業はすべてrootで実施
・CMDbuildインストール時に必要なパッケージをインストールするためインターネットへの接続が可能なこと
CMDBuildインストール手順
Javaインストール
以下のサイトからOracleJDK11をダウンロードし、適当なディレクトリに配置しインストールします。
https://jdk.java.net/archive/
・ファイル名：openjdk-11_linux-x64_bin.tar.gz
・配置先：/root
# cd /root
# wget https://download.java.net/java/ga/jdk11/openjdk-11_linux-x64_bin.tar.gz
# mkdir -p /usr/java
# tar xvzf openjdk-11_linux-x64_bin.tar.gz -C /usr/java
# alternatives --install /usr/bin/java java /usr/java/jdk-11/bin/java 1
# alternatives --install /usr/bin/javac javac /usr/java/jdk-11/bin/javac 1
# ln -s /usr/java/jdk-11 /usr/java/latest
# ln -s /usr/java/latest /usr/java/default
javaインストール確認
# java --version
openjdk 11 2018-09-25
OpenJDK Runtime Environment 18.9 (build 11+28)
OpenJDK 64-Bit Server VM 18.9 (build 11+28, mixed mode)
# javac --version
javac 11
PostgreSQLインストール
以下のコマンドでPostgreSQLをインストールし、DBの初期化を行います。
# rpm -ivh https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
# yum install postgresql96-server postgresql96-devel
# /usr/bin/postgresql-9.6-setup initdb
初期化後、以下の設定ファイルの修正を行います。
※PostgreSQLの修正は環境に合わせて修正を行ってください。
パス：/var/lib/pgsql/9.6/data
設定ファイル：postgresql.conf
# vim /var/lib/pgsql/9.6/data/postgresql.conf
※以下の設定値を修正
#listen_addresses = 'localhost'
#port = 5432
↓
listen_addresses = '*'
port = 5432
パス：/var/lib/pgsql/9.6/data
設定ファイル：postgresql.conf
# vim /var/lib/pgsql/9.6/data/pg_hba.conf
※以下のように修正します。
# "local" is for Unix domain socket connections only
local all all trust
# IPv4 local connections:
host all all 0.0.0.0/0 trust
# IPv6 local connections:
host all all ::1/128 trust
設定修正後、PostgreSQLのサービスの自動起動を有効化し、起動します。
# systemctl enable postgresql-9.6.service
# systemctl start postgresql-9.6.service
Tomcatインストール
以下のサイトからApache Tomcatをダウンロードし、インストールします。
http://tomcat.apache.org/
・ファイル名：apache-tomcat-9.0.53.tar.gz
・Tomcatインストール先ディレクトリ：/opt/tomcat/cmdbuild
# cd /root
# wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.53/bin/apache-tomcat-9.0.53.tar.gz
# tar zxvf apache-tomcat-9.0.53.tar.gz
# mkdir -p /opt/tomcat
# mv apache-tomcat-9.0.53 /opt/tomcat/cmdbuild
# rm -rf /opt/tomcat/cmdbuild/webapps/docs
# rm -rf /opt/tomcat/cmdbuild/webapps/examples/
setenv.shを作成します。
パス：/opt/tomcat/cmdbuild/bin
設定ファイル：setenv.sh
# vim /opt/tomcat/cmdbuild/bin/setenv.sh
※以下を設定します、以下の値は環境に合わせて修正を行ってください。
JAVA_HOME=/usr/java/default
export CATALINA_OPTS="-Dfile.encoding=UTF-8 -Xms8g -Xmx10g -server"
LANG="ja_JP.UTF-8"
起動スクリプトを作成します。
パス：/usr/lib/systemd/system
設定ファイル：cmdbuild.service
# vim /usr/lib/systemd/system/cmdbuild.service
※以下を設定します。
[Unit]
Description=Apache Tomcat
After=network.target
[Service]
Type=oneshot
ExecStart=/opt/tomcat/cmdbuild/bin/startup.sh
ExecStop=/opt/tomcat/cmdbuild/bin/shutdown.sh
RemainAfterExit=yes
User=tomcat
[Install]
WantedBy=multi-user.target
CMDBuild3.3.2インストール
以下のサイトからCMDBuild3.3をダウンロードし、適当なディレクトリに配置します。
https://www.cmdbuild.org/en/download/latest-version
・ファイル名：cmdbuild-3.3.2.war
・配置先：/root
# cd /root
# mv cmdbuild-3.3.2war /opt/tomcat/cmdbuild/webapps/cmdbuild.war
tomcatユーザを作成し、Tomcatインストールディレクトリのオーナ/グループを修正します。
# useradd -M tomcat
# chown -R tomcat. /opt/tomcat
warファイルの配置、Tomcatディレクトリの権限修正後、CMDbuildのサービスの自動起動を有効化し、起動します。
# systemctl enable cmdbuild.service
# systemctl start cmdbuild.service
サービス起動後、CMDBuildのWebUIにアクセスできることを確認し、初期設定を行います。
http://＜CMDbuildのIPアドレス＞:8080/cmdbuild
以下の情報を入力し、「Test database connection」を選択し、設定に問題がないことを確認します。
設定に問題がないことを確認し、「Configure」を選択し、初期設定を完了します。
・Type：Demo # 「Empty」、「Demo」、「Existing」、「Upload backup」より選択
・Name：cmdbuild # DB名を入力
・Host：localhost # PostgreSQLのアドレスを入力
・Port：5432 # PostgreSQLのポートを入力
・Username：cmdbuild # DBのユーザを入力
・Password：password # DBのユーザパスワードを入力
・Admin username：postgres # DBの管理ユーザを入力
・Admin password：postgres # DBの管理ユーザパスワードを入力
※事前にDB、ロールの作成は必要なく、デモデータベース作成の際に必要なDB、ロールが作成されます。
※上記の情報を入力し、「Test database connection」を選択後にエラーが発生する場合は、以下を実施し、再度CMDBuildのWebUIにアクセスし、初期設定を行います。
# cp -p /opt/tomcat/cmdbuild/webapps/cmdbuild/WEB-INF/lib_ext/postgresql-42.2.5.jar /opt/tomcat/cmdbuild/lib/
# systemctl restart cmdbuild.service
初期設定完了後、CMDBuildのログイン画面に切り替わり、以下のアカウントでログインできることを確認します。
http://＜IPアドレス＞:8080/cmdbuild
ユーザ：admin
パスワード：admin
ログイン後、以下のようなDemo画面が表示されることを確認します。
また、用意されている「cmdbuild.sh」を使用することにより、設定の変更、設定の確認、現在のステータス等を確認することができます。
パス：/opt/tomcat/cmdbuild/webapps/cmdbuild
設定ファイル：cmdbuild.sh
・設定変更例
DMSサービスの有効化）
# cd /opt/tomcat/cmdbuild/webapps/cmdbuild
# ./cmdbuild.sh restws setconfig org.cmdbuild.dms.enabled true
cmdbuild r setconfig org.cmdbuild.dms.enabled 'true'
# ./cmdbuild.sh restws reload
OK
・設定の確認
# cd /opt/tomcat/cmdbuild/webapps/cmdbuild
# ./cmdbuild.sh restws configs
org.cmdbuild.database.db.admin.password postgres
org.cmdbuild.database.db.password password
org.cmdbuild.database.db.username cmdbuild
org.cmdbuild.database.db.admin.username postgres
org.cmdbuild.database.db.url jdbc:postgresql://localhost:5432/cmdbuild
org.cmdbuild.core.logger.config paxg2c6uehd0gggg4c69sudlpmttq4ohgfefeoaqd75o9l4eslk566q0e2s3g0pa7v02g77sppdm8r1jnmmb6t759avjkelbv...
org.cmdbuild.core.config.ready true
org.cmdbuild.sql.ddl_log.enabled true
org.cmdbuild.auth.preferredPasswordAlgorythm cm3easy
org.cmdbuild.workflow.enabled true
org.cmdbuild.dms.enabled true ※設定変更したDMSサービスが有効化される
・現在のステータス確認
# cd /opt/tomcat/cmdbuild/webapps/cmdbuild
# ./cmdbuild.sh restws status
system status: READY
BIM Service disabled
BIM_ Bimserver client disabled
Clustering disabled
DMS Service * ready
DMS_ CMIS client * ready
DMS_ SharePoint Online disabled
Email Queue disabled
GIS Service disabled
GIS_ GeoServer client disabled
Log Service * ready
Multitenant disabled
Scheduler Service (core) * ready
Scheduler_ Jobs disabled
Workflow Engine * ready
version: 3.3.2
build: 6bd7d2d/6bd7d2d69bfda629db7499d47127fff0e06aa427 (2021-05-03T14:38:23Z) (dirty)
runtime: java 11 (OpenJDK 64-Bit Server VM Oracle Corporation 11+28)
uptime: qiita-cmdbuild332 18m 49.504s
memory: 150 MB used, 2,147 MB total, 4,294 MB max (java heap memory)
process: pid 1159, 2,075 MB total (process memory)
db pool: 1 active, 19 idle, 50 max
Alfresco Communityインストール手順（オプション）
CMDbuildから添付ファイル機能を使用するためにAlfresco Communityをインストールします。
Alfresco用Javaのインストール
Alfresco Community v6はJava11に対応していないため、Java8を使用します。
以下のサイトからJDK8をダウンロードし、適当なディレクトリに配置します。
https://www.oracle.com/jp/java/technologies/javase/javase8-archive-downloads.html
・ファイル名：jdk-8u202-linux-x64.tar.gz
・配置先：/root
# cd /root
# tar xvzf jdk-8u202-linux-x64.tar.gz -C /usr/java
# alternatives --install /usr/bin/java java /usr/java/jdk1.8.0_202/bin/java 2
# alternatives --install /usr/bin/javac javac /usr/java/jdk1.8.0_202/bin/javac 2
javaインストール確認
# alternatives --config java
2 プログラムがあり 'java' を提供します。
選択 コマンド
-----------------------------------------------
+ 1 /usr/java/jdk-11/bin/java
* 2 /usr/java/jdk1.8.0_202/bin/java
# alternatives --config javac
2 プログラムがあり 'javac' を提供します。
選択 コマンド
-----------------------------------------------
+ 1 /usr/java/jdk-11/bin/javac
* 2 /usr/java/jdk1.8.0_202/bin/javac
Alfresco Communityのインストール
AlfrescoのDBを作成します。
# psql -U postgres
postgres=# create database alfresco;
CREATE DATABASE
postgres=# \q
以下のサイトからAlfresco Communityをダウンロードし、適当なディレクトリに配置します。
https://www.alfresco.com/jp/
・ファイル名：alfresco-community-installer-201604-linux-x64.bin
・配置先：/root
Alfresco Communityのインストールを行います。
# cd /root
# chmod +x alfresco-content-services-community-full-installer-6.0.2.1-ea-linux-x64.bin
# ./alfresco-content-services-community-full-installer-6.0.2.1-ea-linux-x64.bin \
--unattendedmodeui none --mode unattended \
--enable-components libreofficecomponent,alfrescosolr4,aosmodule,alfrescogoogledocs \
--disable-components javaalfresco,postgres,alfrescosolr,alfrescowcmqs \
--prefix /opt/alfresco \
--installer-language ja \
--alfresco_admin_password admin \
--jdbc_username postgres --jdbc_password postgres \
--tomcat_server_port 10080 --tomcat_server_shutdown_port 10005 --tomcat_server_ssl_port 10443 \
--tomcat_server_ajp_port 10009 --alfresco_ftp_port 1121 \
--baseunixservice_install_as_service 1 \
--alfrescocustomstack_services_startup demand \
--jdbc_url jdbc:postgresql://localhost/alfresco
Alfresco Communityの設定
Alfresco Communityが使用するjavaのパスを修正します。
# vim /opt/alfresco/tomcat/bin/setenv.sh
※以下を修正
JAVA_HOME=/usr
↓
JAVA_HOME=/usr/java/jdk1.8.0_202
以下のファイルを作成し、CMDbuildとの連携ができるようにします。
パス：/opt/alfresco/tomcat/shared/classes/alfresco
ファイル：cmdbuild-model-context.xml、cmdbuildModel.xml
# vim /opt/alfresco/tomcat/shared/classes/alfresco/extension/cmdbuild-model-context.xml
※以下を設定します。
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>
<beans>
<!-- Registration of new models -->
<bean id="example.dictionaryBootstrap" parent="dictionaryModelBootstrap" depends-on="dictionaryBootstrap">
<property name="models">
<list>
<value>alfresco/extension/cmdbuildModel.xml</value>
</list>
</property>
</bean>
</beans>
# vim /opt/alfresco/tomcat/shared/classes/alfresco/extension/cmdbuildModel.xml
※以下を設定します。
<?xml version="1.0" encoding="UTF-8"?>
<!-- The important part here is the name - Note: the use of the my: namespace which is defined further on in the document -->
<model name="cmdbuild:module" xmlns="http://www.alfresco.org/model/dictionary/1.0">
<description>Custom Model for CMDBuild</description>
<author>CMDBuild Team</author>
<version>1.0</version>
<imports>
<!-- Import Alfresco Dictionary Definitions -->
<import uri="http://www.alfresco.org/model/dictionary/1.0" prefix="d" />
<!-- Import Alfresco Content Domain Model Definitions -->
<import uri="http://www.alfresco.org/model/content/1.0" prefix="cm" />
</imports>
<!-- Introduction of new namespaces defined by this model -->
<namespaces>
<namespace uri="org.cmdbuild.dms.alfresco" prefix="cmdbuild" />
</namespaces>
<aspects>
<aspect name="cmdbuild:classifiable">
<title>Classification</title>
<properties>
<property name="cmdbuild:classification">
<type>d:text</type>
</property>
</properties>
</aspect>
</aspects>
</model>
上記のファイル設定後、サービスを起動します。
# systemctl start alfresco.service
Alfresco リポジトリの作成
再起動後、ブラウザからAlfrescoのWebUIにアクセスし、以下のアカウントでログインし、CMDBuildで使用するリポジトリを作成します。
http://＜IPアドレス＞:10080/share
ユーザ：admin
パスワード：admin
ログイン後、メニューバーより、リポジトリを選択し、を移動し、
作成 ＞ フォルダ を選択し、「User Homes」を作成し、作成した「User Homes」に移動後、「cmdbuild」を作成します。
CMDBuild DMS設定
CMDBuildのWebUIにログインし、アドミニストレーションモジュールへ移行します。
http://＜CMDbuildのIPアドレス＞:8080/cmdbuild
ナビゲーションツリーよりDMS ＞ Settingsの順に移動し、Alfrescoとの連携設定を行います。
以下の情報を入力し、設定を保存します。
・Active：チェックを入れる
・DMS Category：AlfrescoCategory
・Server Type：CMIS
・Host：http://localhost:10080/alfresco/api/-default-/public/cmis/versions/1.1/atom
・Webserver Path：/User Homes/cmdbuild
・Username：admin
・Password：admin
Alfrescoとの連携確認
CMDBuildのWebUIにログインし、Alfrescoへのファイルを添付が行えることの確認を行います。
適当なカードを開き、クリップマークを選択し、「Add attachment」を選択します。
適当なファイルを「Brows...」から開くか、ファイルをドロップし、保存します。
ファイルの添付に成功すると以下のように表示され、ファイルのダウンロードができます。
AlfrescoのWebUIからも添付したファイルが表示、ダウンロードすることが可能です。
また、CMDbuildのWebUI上から添付ファイルの削除を行うと、Alfresco上からもファイルが削除されます。
以下の画面のようにAlfresco上のWebUIでも添付したファイルが表示さず削除されていることを確認できます。
