基本セットアップ
IBM Passport Advantage からパッケージをダウンロードした後、 IBM Process Mining を使い始めるための基本的なセットアップを完了する必要があります。 詳細については、次のトピックを参照してください。
設定ファイル編集ガイドライン
processmining.conf は設定ファイルで、 IBM Process Mining が正しく動作するために必要なプロパティが含まれている。 このファイルは、デフォルト値を使用した場合、何も修正せずに動作するように配布されている。 ただし、ファイルを編集する際には、必ず以下のガイドラインに従ってください:
必要な値(たとえば、
LDAP hostname)を変更する必要があります。使用していない値を削除する必要はありません。たとえ空白であっても、すべての値を指定しなければならない。 そうしないと、 IBM Process Mining。
誤って変更を加えると、YAMLフォーマットのスタイルが壊れ、正しく動作しなくなる可能性があります。
IBM のインストール Process Mining
IBM Process Mining をインストールするには、以下の手順を実行する:
- 以下のコマンドを実行して、 IBM Process Mining パッケージを解凍し、次のディレクトリを作成する。
<PM_HOME>ディレクトリを作成します:cd /opt sudo tar xvf ibmprocessmining-setup-X.Y.Z.tar.gz - の所有者を
<PM_HOME<をRUNASユーザー、例えばmyuserに変更する:sudo chown -R myuser:myuser <PM_HOME> サーバー設定ファイルを編集し、
<PM_HOME</bin/environment.conf、インストール・ディレクトリーに合わせる:PM_HOME
PM_HOME=/opt/processminingTMPDIR:
TMPDIR=/opt/processmining/repository/temp
/opt/processmining ディレクトリにインストールされていない場合、 filesystem.home プロパティを次の値に設定する必要があります。 <PM_HOME< /etc/processmining.conf プロパティを次の値に設定する必要があります: filesystem.home:
"/opt/processmining-X.Y.Z/repository/data/"データベースの設定
MonetDB および を使用するには、 が必要である。 PostgreSQL IBM Process Mining
MonetDB
MonetDB は、 のデプロイの一部として、 がサポートする主なプラットフォーム用にバンドルされている。 IBM Process Mining Process Mining デプロイメントがこの標準から外れている場合でも、 MonetDB のデプロイメントで Process Mining を使用することができます。 インストールの詳細については、 MonetDB のインストール」を参照してください。
PostgreSQL
データベースのインストールを進める前に、 PostgreSQL インスタンスが動作している必要があります。 PostgreSQL, PostgreSQL インストール」を参照してください。
アプリケーション用に PostgreSQL を設定し初期化するには、以下の設定を行う:
PostgreSQL 基本構成
まず、 IBM Process Mining、次のスクリプトを使用して、 PostgreSQL 内にユーザーとデータベースを作成する必要があります:
export POSTGRES_PROCESSMINER_PWD="XXXXXX"
export POSTGRES_PROCESSMINER_USER="processmining"
export POSTGRES_PROCESSMINER_DATABASE="processmining"
pushd /tmp
sudo -E -u postgres createuser ${POSTGRES_PROCESSMINER_USER}
sudo -E -u postgres createdb ${POSTGRES_PROCESSMINER_DATABASE}
sudo -E -u postgres psql -c "alter user ${POSTGRES_PROCESSMINER_USER} with encrypted password '${POSTGRES_PROCESSMINER_PWD}';"
sudo -E -u postgres psql -c "grant all privileges on database ${POSTGRES_PROCESSMINER_DATABASE} to ${POSTGRES_PROCESSMINER_USER};"
sudo -E -u postgres psql -c "GRANT ALL ON ALL TABLES IN SCHEMA public TO ${POSTGRES_PROCESSMINER_USER}";
sudo -E -u postgres psql -c "ALTER DATABASE ${POSTGRES_PROCESSMINER_DATABASE} OWNER TO ${POSTGRES_PROCESSMINER_USER}";
popd
PostgreSQL, を設定するには、 <PM_HOME</etc/processmining.conf の persistence セクションのjdbc設定を編集する必要があります:
persistence: {
jdbc: {
database: "<database name>",
host: "<database host>",
port: <database port>,
user: "<database user>",
password: "<encrypted database password>"
}
...
PostgreSQL プロセスアプリのコンフィギュレーション
プロセスアプリ用に PostgreSQL を設定するには、 PostgreSQL の既存の設定に従って、 <PM_HOME</etc/accelerator-core.properties ファイルの以下の属性を編集する:
spring.datasource.database=<database name>
spring.datasource.port=<database port>
spring.datasource.host=<database host>
spring.datasource.username=<database user>
spring.datasource.password=<encrypted database password>
PostgreSQL データベース初期化
IBM Process Mining を起動する前に、この作業を行うことが重要です。上記で作成した新しいデータベー スには、いくつかの設定が必要だからです。
これは <PM_HOME</utils/database-utils
データベースとユーザー作成に関する上記の手順が実行され、 <PM_HOME</etc/processmining.conf が PostgreSQL の設定で適切に設定されていることを確認してください。
以下の手順でツールを実行する:
./postgres-utils.sh
Python カスタムプロセスアプリとBRMサービスの展開
Python 3.12 を RedHat, にインストールするには、以下のコマンドを実行する:
sudo yum install python3.12
Ubuntu オペレーティング・システムに Python 3.12 をインストールするには、以下のコマンドを実行する:
sudo apt install python3.12-venv
Python を他のバージョンにインストールする
バージョン 3.11 および非標準 Python のデプロイメントも、追加設定によりサポートされます。
Python 3.11 または Python 3.12 を別の場所から使用するには、以下のカスタム設定を使用します:
この設定が
<PM_HOME</bin/environment.confファイルの Python の場所と一致していることを確認してください:a. 標準的な場所:
b. 規格外の場所:CMD_PYTHON=/usr/bin/python3.11CMD_PYTHON=/home/my-user/.local/usr/bin/python3.12- Ubuntu の場合、 Python 3.11 または非標準の Python 配置を使用している場合は、このチェックのオーバーライドを実行します:
ACF_CUSTOM_UBUNTU_CHECK=1 - 元の配備が
<PM_HOME</bin/environment.confに記載されている詳細と一致しているかどうかを確認する:
which python3.12
/usr/bin/python3.12
プロセスアプリ用にメモリを最適化
プロセスアプリのメモリを最適化するには、以下のファイルパスにある custom.ini ファイルの mem_limit_bytes の値を変更します:
PM_HOME/etc/accelerators/custom.ini
ただし、 mem_limit_bytes の推奨最小値は 16000 * 1024 * 1024 (16 GB) である。
ウェブとSSLの設定
ウェブブラウザを使用して IBM Process Mining にアクセスできるように NGINX ウェブサーバを設定する必要があります。 ウェブサーバーは、SSLサーバー、リバースプロキシ、アプリケーションサーバーの圧縮オフローダーとして使用できます。 以下のトピックを参照して、NGINX Web サーバーを設定します:
NGINX のインストール
NGINXをインストールするには、Webサーバーのオペレーティングシステムに応じて、次のいずれかのオプションを使用します:
- Ubuntu オペレーティングシステムにNGINXをインストールする場合は、次のコマンドを使用します:
sudo apt-get install nginx
- Red Hat オペレーティングシステムにNGINXをインストールする場合は、次のコマンドを使用します:
sudo yum install nginx
以下のコマンドを実行して、確認と変更を行う:
# check version available
sudo yum info nginx
# list available versions
sudo yum module list nginx
# reset module to allow change
sudo yum module reset -y nginx
# enable your latest version
yum module enable -y nginx:<LATEST>
# install will now install using this <LATEST> version
sudo yum install nginx
NGINXをアクティブにするには、以下のコマンドを実行します:
sudo systemctl enable nginx
sudo systemctl start nginx
NGINXバーチャルホストの設定
NGINXバーチャルホストを設定するには、 IBM Process Mining パッケージにある Template Virtual Host ファイルをNGINX設定にコピーする必要があります。 ウェブ・サーバーのオペレーティング・システムに応じて、 以下のいずれかのオプションを使用して Template Virtual
Host ファイルをコピーします:
Ubuntu オペレーティング・システムを使用している場合は、以下のコマンドを使用する:
cp <PM_HOME>/nginx/processmining.conf /etc/nginx/sites-available/Red Hat オペレーティング・システムを使用している場合は、以下のコマンドを使用する:
mv /etc/nginx/conf.d/default.conf /etc/nginx/confd/default_origin.conf cp <PM_HOME>/nginx/processmining.conf /etc/nginx/conf.d/default.conf
NGINX SSLを設定する
NGINX SSLを設定するには、次の手順を実行します:
以下のコマンドを使用して、
sslディレクトリを作成する:mkdir /etc/nginx/sslSSL証明書を
sslディレクトリにコピーします。 作成した証明書のタイプに応じて、以下のオプションのいずれかを使用する:- 自己署名証明書 」のトピックで説明した手順で自己署名証明書を作成した場合は、以下のコマンドを使用します:
cp /home/pm/cert/server.* /etc/nginx/ssl/- 認証局(CA)から証明書を作成しダウンロードしたい場合は、選択したCAの文書に従ってください。 証明書をダウンロードしたら、
/etc/nginx/ssl/リポジトリに証明書をコピーする。
作成した証明書と鍵の両方のファイルパスで、
Virtual Hostファイルを更新する。ssl_certificate /etc/nginx/ssl/mycompany_com.pem; ssl_certificate_key /etc/nginx/ssl/mycompany_com.key;例えば、自己署名証明書を作成した場合は、以下のファイルパスを使用する:
ssl_certificate /etc/nginx/ssl/server.pem; ssl_certificate_key /etc/nginx/ssl/server.key;オペレーティング・システムによっては、以下のオプションのいずれかを実行してください:
ウェブサーバーのオペレーティングシステムが Ubuntu の場合は、以下のコマンドを使用して、有効なサイトにバーチャルホストを追加します:
ln -s /etc/nginx/sites-available/processmining.conf /etc/nginx/sites-enabled/ウェブ・サーバーのオペレーティング・システムが Red Hat、SELinuxが有効になっている場合は、以下のコマンドを使用する:
chcon -t httpd_config_t /etc/nginx/ssl/*.* setsebool -P httpd_can_network_connect 1
NGINXのテストと再起動
NGINX設定の変更をテストするには、次のコマンドを使用します:
nginx -T
テスト結果に問題がなければ、以下のコマンドを使用してNGINXサービスを再起動します:
systemctl restart nginx
データ由来のエンド・アクティビティを無効にする
<PM_HOME</etc/processmining.conf ファイルで、 engine.defaults セクションに以下のプロパティを追加し、データ由来のエンド・アクティビティを無効にする:
endActivity:{
enable: false
},
例:
engine: {
defaults: {
...
endActivity:{
enable: false
},
....
}
}
プロセスアプリの秘密鍵と公開鍵の作成
プロセスアプリ用のキーペアを作成する必要があります。 公開鍵と秘密鍵を含む鍵ペアを作成するには、以下のコマンドを実行する:
<PM_HOME>/utils/generateKeyPair.sh
手動でキー・ペアを生成し、抽出したい場合は、 プロセス・アプリ構成用のキー・ペアの生成を参照してください。
/opt/processmining ディレクトリにインストールされていない場合は、 processmining.conf ファイルの accelerator.publicKeyPath プロパティを次の値に設定する必要があります: filesystem.home:
"<PM_HOME</etc/acf-ext-publicKey.der" 。JWTサインキー
プロセス・アプリ・サービスとアプリケーション間の通信を確立するには、JWTサインキーが必要です。 デフォルトでは、プロセスアプリ・サービスの基本設定で、 IBM Process Mining。 ただし、新しいJWT署名キーを生成したい場合は、 プロセスアプリ用のJWT署名キーの生成トピックを参照してください。
アプリケーション起動
サーバーを起動・停止するには、以下のコマンドを実行する:
cd <PM_HOME>/bin/
./pm-monet.sh start | stop
./pm-web.sh start | stop
./pm-engine.sh start | stop
./pm-analytics.sh start | stop
./pm-accelerators.sh start | stop
./pm-brm.sh start | stop
./pm-monitoring.sh start | stop
サーバーを起動したら、ホスト URL, https://yourhost を使って IBM Process Mining アプリケーションにアクセスできます。 IBM Process Mining アプリケーションへのアクセスについては、 IBM® Process Mining へのアクセスを参照。
信頼されたサーバー通信を可能にするCA証明書
セットアップのこのステップを実行する前に、 IBM Task Mining。
IBM Process Mining とともに IBM Task Mining を使用する場合は、 IBM Task Mining サーバーから IBM Process Mining サーバーに CA 証明書をインポートして設定する必要があります。 IBM Process Mining から IBM Task Mining への通信を保証するために、キーストアにあるCA証明書を信頼できる証明書としてインポートするために、以下のコマンドを実行する。
<PM_HOME>/jdk/linux/ibm-openjdk-semeru/bin/keytool -import -trustcacerts -alias "My Custom Server CA" -file /home/pm/cert/rootCA.pem -keystore <PM_HOME>/jdk/linux/ibm-openjdk-semeru/lib/security/cacerts -storepass changeit
IBM Process
Mining と IBM Task Mining 間の接続を確立するために、 IBM Task
Mining で同じ CA 証明書 ( rootCA ) を使用する。 自己署名証明書が設定されている場合のみ、 rootCA 証明書のインストールを使用する。
IBM Process Mining に CA 証明書をインポートしてセットアップしたら、 Jetty を再起動します。
認証と権限の設定
IBM Process Mining アプリケーションにアクセスした後、各ユーザーの承認と権限を付与または取り消す必要があります。 詳細については、 認可と許可を参照。
アプリのアクセス許可を処理する
- IBM Process Mining バージョン 1.14.0 以降では、 Core > Tenant で Owners グループに
Process Apps権限を割り当てることで、ユーザーがプロセスアプリにアクセスできるようにする必要があります。 さらに、 Core > Projectで Owners グループに割り当てられているprocess app権限を削除する必要があります。 権限の追加の詳細については、 権限の追加を参照してください。 - ユーザーがカスタムプロセスアプリを作成できるようにするには、 Core > Tenantで Owners グループに
Custom Process Apps権限を割り当てる必要があります。 権限の追加の詳細については、 権限の追加を参照してください。
モニター許可
ユーザーがモニターにアクセスできるようにするには、 Core > Projectで Monitor 、 Suite access > Monitor and Actionで read 、 Owners グループに権限を割り当てる必要があります。 権限の追加の詳細については、 権限の追加を参照してください。