概要
https://www.openmbee.org/
OpenMBEEを構成する主な3つのソフトウェア「Model Development Kits(MDK)」「Model Management System(MMS)」「View Editor(VE)」がある。
このうちMMSのバージョン3まではalfrescoのプラグインとして作られていたがバージョン4からは単体で動作するようになった。このため導入方法がバージョン3と異なる。
MMSバージョン4とそれを利用するMDK,VEの導入方法を解説する。
環境
OpenMBEE
- MMS 4.0.20
- MDK 6.1.0
- VE 5.0.0
その他ソフトウェア
- docker
- java 17
- postgresql 11
- Elasticsearch 7.8.1
- minio
OS
- AlmaLinux8
このページの手順をそのまま利用可能 - Ubuntu22.04
dockerのインストールは別途行っておく
適時sudoが必要
Docker
導入にはDockerを使用するのでDockerの簡単な説明を記載する。
Dockerのインストール
下記のブログを参考にしました。
https://blog.trippyboy.com/2021/docker/almalinux%E3%81%ABdocker%E7%92%B0%E5%A2%83%E3%82%92%E6%A7%8B%E7%AF%89%E3%81%99%E3%82%8B/
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf erase podman buildah
dnf --allowerasing -y install docker-ce docker-ce-cli containerd.io
systemctl enable docker
systemctl start docker
docker info
docker run hello-world
docker rm $(docker ps -q -a)
Dockerの簡単な説明
MMS4の構築で主に利用するdockerコマンド
-
docker create
コンテナを作成 -
docker start
コンテナを起動 -
docker run
createとstartを同時に行う -
docker stop
コンテナを停止 -
docker rm
コンテナを削除 -
docker ps
起動中のコンテナ一覧を表示 -
docker ps -a
起動していないコンテナも表示
JDK17のインストール
wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.rpm
rpm -ivh jdk-17_linux-x64_bin.rpm
java -version
MMS4のインストール
参照元
https://mms-reference-implementation.readthedocs.io/en/latest/docker.html
DockerのインストールとJDK17のインストールは済ませておく。
Postgresql
docker run -d -e POSTGRES_PASSWORD=test1234 -e POSTGRES_USER=mmsuser -e POSTGRES_DB=mms -p 5432:5432 --name=postgres postgres:11-alpine
Elasticsearch
docker run -d -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" --name=elasticsearch docker.elastic.co/elasticsearch/elasticsearch:7.8.1
MinIO
docker run -d -p 9000:9000 -e "MINIO_ACCESS_KEY=admintest" -e "MINIO_SECRET_KEY=admintest" --name=minio minio/minio server /data
MMSコンテナをdocker create
docker create --name=mms --network="host" -e "SPRING_CONFIG_LOCATION=/mms.properties" openmbee/mms:4.0.20
設定ファイルの作成
vi application.properties.example
下記ページの内容をコピーして上記の設定ファイルに書き込む
https://github.com/Open-MBEE/mms/blob/develop/example/src/main/resources/application.properties.example
mms.admin.usernameは任意のユーザ名に変更。管理者のユーザ名となる。
mms.admin.username=test
mms.admin.passwordは任意のパスワードに変更。管理者パスワードとなる。
mms.admin.password=test
長い文字列に変更。exampleで書かれているデフォルト文字列では文字列長が不足
jwt.secret=test_test_test_test_test_12345677890_test_test_test
設定ファイルをコンテナ内へコピー
docker cp application.properties.example mms:/mms.properties
MMSを起動
docker start mms
postgres,elasticsearch,minio,mmsの4つのコンテナが起動していることを確認する。
下記コマンドで起動しているか確認
docker ps
MMSの操作
MMSの停止
docker stop mms
2回目以降のMMS起動方法
docker start postgres
docker start elasticsearch
docker start minio
docker start mms
起動確認
下記にアクセスできれば起動できている。
http://localhost:8080/v3/swagger-ui.html
http://[サーバアドレス]:8080/v3/swagger-ui.html
このページではAPIを発行できるのでMMSVersionを実行し、status:200とmmsのバージョンが返ってくるか確認する。
右上のAuthorizeをクリックし、usernameとpasswordを入力する。（設定ファイルに記載した管理者と管理者パスワード)
GETメソッドの/authenticationを実行する。
status:200が返ってくることを確認する。
MMSのログ
docker logsで確認できる
docker logs mms
または
docker logs mms -f
-fはログが書き込まれたら逐次表示を更新する。「tail -f [ファイル名]」のようなもの。
VEのインストール
git clone https://github.com/Open-MBEE/exec-ve.git
設定ファイルを変更しておく
cd exec-ve/config
vi example.json
localhostと記載された箇所をサーバアドレスに変更する。
dockerignoreを変更
vi .dockerignore
ファイルの末尾に以下を記載
!.eslintignore
docker imageの作成、dockerコンテナの作成と実行
docker build -t ve .
docker run -it -p 9001:9000 --name ve ve
上記設定で9001番ポートにアクセスするとveに接続できる。
起動確認
http://サーバアドレス:9001
2回目以降のVE起動
docker start ve
MDKのインストール
MDKにはいろいろ種類があるがMagicdrawにプラグインとして導入するタイプを利用。
以前書いたものから手順は変わっていない。
バージョン5.0.0以上を入れること。
https://qiita.com/crimson707/items/296457ee64bc49237d5a
MDK6.1.0
https://github.com/Open-MBEE/mdk/releases/tag/6.1.0
旧バージョンと比べてOptions→Project→General→MBEEからMMSサーバを指定するよう変更されている。
MMS,MDK,VEのバージョン対応は下記を参照。
https://github.com/Open-MBEE/open-mbee.github.io/wiki/Compatibilities