Redhat v9.x の高可用性モデルのインストールガイド

1. 始める前に

このドキュメントは、以下のように高可用性モデル (「フェイルオーバー」モデル) に新しい akaBot Center をインストールする方法を案内することを目的としています。

Architecture

モデルコンポーネント:

#	コンポーネント	説明
1	Nginxロードバランサー	Nginx ロードバランサーは、akaBot Center サーバーの前にある「交通警官」として機能し、速度と容量の使用率を最大化する方法でクライアントリクエストを処理できるすべての akaBot Center サーバー間でクライアントリクエストをルーティングし、パフォーマンスを低下させる可能性のある過負荷状態のサーバーが存在しないようにします。
2	別名ボットセンター	akaBot Center を使用すると、環境内での akaBot Agent の作成、監視、展開を管理できます。
3	ActiveMQ サービス	akaBot Center のキュー関連機能をサポートするメッセージングアプリケーション。
4	エルクスタック	akaBot センターによって生成されたログの詳細な検索、分析、表示を支援する包括的なログ分析ソリューション。
5	Redisキャッシュ	データベース、キャッシュ、メッセージブローカー、ストリーミングエンジンとして使用されるインメモリデータ構造ストアにより、データベースアクセスが少なくなり、必要なトラフィックとインスタンスの量が削減されます。

他のモデルまたは akaBot Center のアップグレードについては、プロジェクトコーディネーター (いる場合) に連絡するか、support@akaBot.com に電子メールを送信してガイダンスを取得してください。

akaBot チームは常にお客様のインストールの成功をサポートします。

[!重要] インストールを正常に完了するために、以下のセクションをよく読み、必要なリソース/情報を準備してください。

1.1.ハードウェア要件

高可用性モデルで akaBot Center をインストールして使用するには、以下のハードウェア要件を準備する必要があります。

#	サーバー	数量	コア	RAM	SSD	注記
1	akaBot センターサーバー	2	08以上	32GB以上	500GB以上	akaBot Center をインストールするサーバー
2	ActiveMQサーバー	2	08以上	16GB以上	250GB以上	ActiveMQ サービスをインストールするサーバー。
3	ELKサーバー	1	16以上	16以上	100GB以上	インデックスサービスをインストールするサーバー。
4	Redisキャッシュサーバー	1	04以上	4GB以上	100GB以上	キャッシュサービスをインストールするサーバー。
5	Nginxサーバー	1	04以上	4GB以上	100GB以上	ロードバランサーサービスをインストールするサーバー。

1.2.データベース要件

このインストールモデルには 2 つのデータベースが必要です。

akaBot Center の 01 データベース
ActiveMQ サービス用の 01 データベース

これらのデータベースが使用できる状態であることを確認し、接続するために各データベースの以下の情報を準備してください。

#	情報	説明
1	DBサーバー	データベースの IP アドレス。例: 3.112.124.176
2	DBユーザー	データベースのユーザー名。例: AKA_CENTER_01
3	DBパスワード	ユーザー名のパスワード。例: akaBot123
4	DBポート	データベースポート。例: 1521
5	DB-SID/サービス名	データベース SID/サービス名。例: オルクル

1.3.ファイルストレージの要件

Nuget パッケージを保存するための専用フォルダーがファイルストレージサーバー上にあり、akaBot Center サーバーがこのフォルダーに対する読み取り/書き込みアクセス許可を持っていることを確認してください。

例:NFS-NUGET

1.4.許可要件

各マシンでインストールを実行するには、ユーザーアカウントに Sudo としての実行権限が必要です。

1.5.インストールパッケージの準備

akaBot Center マシンに以下の正確なバージョンのインストールパッケージがあることを確認してください。

#	プラットフォーム名	パッケージ名	バージョン	説明	ダウンロード
1	JDK/JRE	openlogic-openjdk-11.0.16+8-linux-x64-el.rpm	11.0.16	OpenJDK	Download
2	Apacheトムキャット	apache-tomcat-8.5.57.tar.gz	8.5.57	Webサーバー Apache Tomcat	Download
3	アクティブMQ	apache-activemq-5.15.1-bin.tar.gz	5.15.1	ActiveMQ はキュー関連の機能に使用されます	Download
4	別名ボットセンター	akaBot-center-x.x.x.x.war	3.0.1.2以降	akaBot Center インストールパッケージ	akaBotが提供
5	Oracle JDBCドライバー	ojdbc8.jar	ojdbc8	Oracle JDBCドライバー	Download
6	Nginxロードバランサー	nginx-1.22.1-1.el8.ngx.x86_64.rpm	1.22.1	NGINX ロードバランサーパッケージ	Download
7	Redisキャッシュ	redis-5.0.3-5.module+el8.4.0+12927+b9845322.x86_64.rpm	5.0.3	Redis キャッシュパッケージ	Download
8	キバナ	kibana-7.17.12-x86_64.rpm	12.7.17	Kibana パッケージ (オプション)	Download
9	弾性検索	elasticsearch-7.17.12-x86_64.rpm	12.7.17	ElasticSearch パッケージ	Download
10	ログスタッシュ	logstash-7.17.12-x86_64.rpm	12.7.17	ログ分析基盤パッケージ	Download
11	ファイルビート	filebeat-7.17.12-x86_64.rpm	12.7.17	ファイルビートパッケージ	Download

注:

各サーバーにインストールパッケージを配置するには、別のフォルダーを使用する必要があります。このガイドでは、/appsという名前のフォルダーを使用します。

1.6.その他の注意事項

インストール中の今後のエラーを防ぐために、以下の注意事項に注意してください。

フォルダー名にスペースが含まれていないことを確認してください。
構文エラーを防ぐには:
- 便宜上、このガイドのコマンドラインを akaBot Center マシンにコピーして実行する必要があります。
- 文字エンコードモードが異なるため、akaBot Center マシンに再度コピーする前に、コマンドを メモ帳ファイル にコピーしてください。
- 構成ファイルを更新するときは、ファイルの構文に厳密に従ってください。

2. インストール

2.1. Redis をインストールする

Redis サーバーでは、次の 3 つの簡単な手順に従って Redis サービスをインストールして構成してください。

2.1.1.ステップ 1 – Redis パッケージをインストールします。

システムリポジトリを更新する

sudo dnf update -y

Redis パッケージをインストールする

sudo rpm -ivh <package name>
# Ex: sudo rpm -ivh redis-5.0.3-5.module+el8.4.0+12927+b9845322.x86_64.rpm

インストールされている Redis のバージョンを確認します。

rpm -q redis
rpm -qi redis

image-20230804101914-2

Redis サービスを開始して有効にします。

sudo systemctl start redis
sudo systemctl enable redis

Redis サービスのステータスを確認する

sudo systemctl status redis

image-20230804101914-3

2.1.2.ステップ 2 – Redis リモートアクセスを構成する

Redis サービスをオフにする (実行中の場合)

sudo systemctl stop redis

redis.confファイルを開く

sudo vi /etc/redis.conf

bindパラメータ値を検索し、127.0.0.1から0.0.0.0に更新します。
変更を保存して終了します。ESCを押して、:wqと入力します。
Redisサービスを再起動します

sudo systemctl start redis

2.1.3.ステップ 3 – セキュリティ設定を構成する (オプション)

Redis サービスをオフにする (実行中の場合)

sudo systemctl stop redis

redis.confファイルを開く

sudo vi /etc/redis.conf

requirepassパラメータを検索してコメントを解除します。
変更を保存して終了します。ESCを押して、:wqと入力します。
Redisサービスを再起動します

sudo systemctl start redis

2.2. ActiveMQ をインストールする

高可用性モデルでは、フェイルオーバー状況で相互にバックアップするために 2 つの ActiveMQ サーバーが必要です。以下の手順を繰り返して、2 つの別々のサーバーに ActiveMQ サービスをインストールして構成してください。

2.2.1.ステップ 1 - インストールファイルを抽出する

インストールフォルダーに移動します。

cd apps/

フォルダーを作成します:/opt/activemq

sudo mkdir /opt/activemq

Apache ActiveMQ インストールパッケージを抽出し、/opt/activemqフォルダーに移動します。

sudo tar -xvzf apache-activemq-*-bin.tar.gz
sudo mv apache-activemq-5.15.1 /opt/activemq

2.2.2.ステップ 2 - グループと ActiveMQ ユーザーを作成する

別のアカウントを作成し、Root アカウントを使用する代わりにこのアカウントで ActiveMQ インストールを実行します。

ActiveMQグループの作成

sudo groupadd activemq

グループ ActiveMQ およびホームリンクの下にアカウント ActiveMQ を作成します:/opt/activemq

sudo useradd -s /bin/false -g activemq -d /opt/activemq activemq

ファンクインチョートゥオンActiveMQ

sudo chown -R activemq:activemq /opt/activemq

2.2.3.ステップ 3 - ActiveMQ サービスを構成する

構成ファイルの作成:activemq.service

sudo vi /etc/systemd/system/activemq.service

以下の内容をこのファイルにコピーします。

[Unit]
Description=Apache ActiveMQ
After=network.target

[Service]
Type=forking
User=activemq
Group=activemq
ExecStart=/bin/bash /opt/activemq/bin/activemq start
ExecStop=/bin/bash /opt/activemq/bin/activemq stop

[Install]
WantedBy=multi-user.target

変更を保存して終了します。ESCを押して、:wqと入力します。
リロードデーモン

sudo systemctl daemon-reload

ActiveMQサービスを開始する

sudo systemctl start activemq

ActiveMQ サービスを有効にする

sudo systemctl enable activemq

ActiveMQ ステータスを確認する

sudo systemctl status activemq

image-20230804101914-6

2.2.4.ステップ 4 - ActiveMQ サービスの Java ヒープメモリを構成する

ActiveMQ サービスを停止する

sudo systemctl stop activemq

Java ヒープメモリの値を更新します。環境ファイルを開きます:

sudo vi /opt/activemq/bin/env

以下の行を更新します。

ACTIVEMQ_OPTS_MEMORY="-Xms1G -Xmx2G"

注:

パラメータ-Xms: 最小 Java ヒープサイズ。 <= 1/4 の RAM 容量を設定してください。 (例: RAM = 4G、-Xms1G を設定)。
パラメータ-Xmx: 最大 Java ヒープサイズ。 <= RAM 容量の 1/2 の数値を設定してください。 (例: RAM = 4G、-Xmx2G を設定)。

image-20230804101914-7

変更を保存して終了します。ESCを押して、:wqと入力します。
ActiveMQ サービスを再起動します

sudo systemctl start activemq

ActiveMQ サービスのステータスを確認する

sudo systemctl status activemq

image-20230804101914-8

2.2.5.ステップ 5 – ActiveMQ サービスを構成します。

activemq サービスを停止します

sudo systemctl stop activemq

ファイルojdbc8.jar(Oracle JDBC ドライバー) をオプションのライブラリフォルダーにアップロードしてコピーします。

cd ~/apps/
cp ojdbc8.jar /opt/activemq/lib/optional/

ファイルactivemq.xmlを構成します

sudo vi /opt/activemq/conf/activemq.xml

ブローカー名の変更 (オプション)
ファイルの最後に以下のコードセクションを追加して、Oracle DataSource を構成します。

<bean id="oracle-ds" class="org.apache.commons.dbcp2.BasicDataSource" destroy-method="close">
      <property name="driverClassName" value="oracle.jdbc.driver.OracleDriver"/>
      <property name="url" value="<DB-URL>"/>
      <property name="username" value="<DB-USER>"/>
      <property name="password" value="<DB-PASSWORD>"/>
      <property name="poolPreparedStatements" value="true"/>
</bean>

image-20230804101914-10

注:

データベースが SID を使用している場合:DB_URL = jdbc:oracle:thin:@<DB-SERVER>:<DB-PORT>:<DB-SID>
データベースがサービス名を使用している場合:DB_URL = jdbc:oracle:thin:@//<HOST>:<PORT>/<SERVICE NAME>

persistenceAdapter構成を変更します。

<jdbcPersistenceAdapter dataSource="#oracle-ds" createTablesOnStartup="true" />

image-20230804101914-11

変更を保存して終了します。ESCキーを押して、:wq!と入力します。
activemq サービスのステータスを開始して確認する

sudo systemctl start activemq
sudo systemctl status activemq

2.3. ELK スタックのインストール

ELK Stack は、akaBot Centers によって生成されたログの詳細な検索、分析、表示を支援する包括的なログ分析ソリューションです。

コンポーネント:

Elasticsearch: RESTful 分散検索エンジン。
Logstash: データ収集エンジン。
Kibana: データ視覚化ツール (オプション)。
FileBeat: データシッパーはエージェントとしてサーバーにインストールされます。

ソース:Elastic Stack Definition

2.3.1.ステップ 1 - ElasticSearch をインストールする

ElasticSearch パッケージをインストールする

cd apps/
sudo rpm --install elasticsearch-7.17.12-x86_64.rpm

ElasticSearch サービスを開始する

sudo systemctl start elasticsearch

ElasticSearch サービスを有効にする

sudo systemctl enable elasticsearch

サービスステータスを確認する

sudo systemctl status elasticsearch

ElasticSearch サービスを停止する

sudo systemctl stop elasticsearch

構成用の設定ファイルを開きます。

sudo vi /etc/elasticsearch/elasticsearch.yml

以下の値を更新します。

network.host: 0.0.0.0
cluster.initial_master_nodes: ["node-1"]

変更を保存して終了します。ESCを押して、:wqと入力します。

2.3.2.ステップ 2 - Logstash をインストールする

Logstash パッケージをインストールする

cd apps/
sudo rpm --install logstash-7.17.12-x86_64.rpm

LogStash サービスを有効にする

sudo systemctl enable logstash

LogStash サービスを開始する

sudo systemctl start logstash

LogStash サービスのステータスを確認する

sudo systemctl status logstash

LogStash サービスを停止する

sudo systemctl stop logstash

LogStash 構成ファイルを開きます。

sudo vi /etc/logstash/conf.d/logstash.conf

ファイル内の以下のコードを更新します。

input {
  beats {
    port => 5044
    type => "log"
  }
}

filter {
  json {
    source => "message"
    target => "doc"
  }
}

output {
  elasticsearch {
    hosts => "localhost:9200"
    manage_template => false
    index => "%{[@metadata][beat]}-%{+yyyy.ww}"
    document_type => "%{[@metadata][type]}"
  }
}

変更を保存して終了します。ESCを押して、:wqと入力します。
LogStash サービスを開始する

sudo systemctl start logstash

2.3.3.ステップ 3 - Filebeat をインストールする

FileBeat パッケージをインストールする

cd apps/
sudo rpm --install filebeat-7.17.12-x86_64.rpm

FileBeat サービスを有効にする

sudo systemctl enable filebeat

FileBeatサービスを開始する

sudo systemctl start filebeat

FileBeat サービスのステータスを確認する

sudo systemctl status filebeat

FileBeat サービスを停止する

sudo systemctl stop filebeat

FileBeat 設定ファイルを開きます。

sudo vi /etc/filebeat/filebeat.yml

ファイル内のコードを次のように更新します。

filebeat.inputs:
- type: log
  paths:
    - /opt/tomcat/logs/agents/*/*.log

コードの下のコメントを解除します。

output.logstash:
  hosts: ["localhost:5044"]

変更を保存して終了します。ESCを押して、:wqと入力します。
FileBeatサービスを開始する

sudo systemctl start filebeat

2.3.5.ステップ 4 - Kibana をインストールする (オプション)

Kibana パッケージをインストールする

cd apps/
sudo rpm --install kibana-7.17.12-x86_64.rpm

Kibana サービスを有効にする

sudo systemctl enable kibana

Kibanaサービスを開始する

sudo systemctl start kibana

Kibana サービスのステータスを確認する

sudo systemctl status kibana

Kibana サービスを停止する

sudo systemctl stop kibana

Kibana 構成ファイルを開きます。

sudo vi /etc/kibana/kibana.yml

ファイル内の以下のコードを更新します。

server.port: 5601
server.host: "0.0.0.0"

変更を保存して終了します。ESCを押して、:wqと入力します。
Kibanaサービスを開始する

sudo systemctl start kibana

2.4. akaBot センターをインストールする

高可用性モデルでは、フェイルオーバー状況で相互にバックアップするために 2 つの akaBot Center サーバーが必要です。以下の手順を繰り返して、2 つの別々のサーバーに akaBot Center サービスをインストールして構成してください。

2.4.1.ステップ 1 - JDK をインストールする

注:

akaBot マシンに JDK 11 未満がインストールされている場合は、JDK 11 にアップグレードしてください。
それ以外の場合は、この手順を無視してください。

インストールフォルダーに移動します。

cd apps/

インストールコマンドを実行します。

sudo yum install openlogic-openjdk-11.0.16+8-linux-x64-el.rpm

インストールを確認します。

java -version

image-20230804101914-12

2.4.2.ステップ 2 - Apache Tomcat Web サーバーをインストールする

2.4.2.1.ステップ 1: インストールファイルを抽出する

インストールフォルダーに移動します。

cd apps/

フォルダーを作成します:/opt/tomcat

sudo mkdir /opt/tomcat

Apache Tomcat を抽出します。

sudo tar xzvf apache-tomcat-8*tar.gz -C /opt/tomcat --strip-components=1

2.4.2.2.ステップ 2: グループとユーザー Tomcat を作成する

Tomcat グループを作成します。

sudo groupadd tomcat

Tomcat アカウントを作成します。

sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat

マシンコード用にアカウント Tomcat を構成します (ライセンスのアクティベーション)。

sudo visudo /etc/sudoers

最後に以下の行を追加します。

tomcat ALL= NOPASSWD: ALL

image-20230804101914-13

変更を保存:ESCキーを押して、:wqと入力します。

現在のユーザーをグループ Tomcat に追加します。

sudo usermod -g tomcat [current_user_logged]

2.4.2.3.ステップ 3: フォルダーのアクセス権を構成する

所有権を変更します。

cd /opt
sudo chown tomcat:tomcat tomcat
ls -l

image-20230804101914-14

権限を構成します。

cd /opt/tomcat
sudo chgrp -R tomcat /opt/tomcat
sudo chmod -R g+r conf
sudo chmod g+x conf
sudo chown -R tomcat webapps/ work/ temp/ logs/
ls -l

image-20230804101914-15

2.4.2.4 ステップ 4: Tomcat サービスの実行を構成する

Java インストールフォルダーを取得します。

sudo update-alternatives --list | grep java

%JAVA_HOME% = /usr/lib/jvm/openlogic-openjdk-11-hotspot

tomcat.serviceファイルを作成します。

sudo vi /etc/systemd/system/tomcat.service

以下のコードをファイルにコピーします。

[Unit]
Description=Apache Tomcat Web Application Container
After=network.target

[Service]
Type=forking
Environment=JAVA_HOME=/usr/lib/jvm/openlogic-openjdk-11-hotspot
Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
Environment='CATALINA_OPTS=-Xms1G -Xmx2G -server -XX:+UseParallelGC'
Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom'
WorkingDirectory=/opt/tomcat
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
User=tomcat
Group=tomcat
RestartSec=10
Restart=always

[Install]
WantedBy=multi-user.target

JAVA_HOME変数を更新します。

環境=JAVA_HOME=%JAVA_HOME%

環境=JAVA_HOME=/usr/lib/jvm/openlogic-openjdk-11-hotspot

Java ヒープメモリサイズを変更します。

環境='CATALINA_OPTS=-Xms1G -Xmx2G -server -XX:+UseParallelGC'

パラメータ -Xms: 最小 Java ヒープサイズ。 <= 1/4 の RAM 容量を設定してください。

例: akaBot Center マシンの RAM = 4G の場合、-Xms1G を設定します。

パラメータ -Xmx: 最大 Java ヒープサイズ。 <= RAM 容量の 1/2 の数値を設定してください。

例: akaBot Center マシンの RAM = 4G の場合、-Xms2G を設定します。

変更を保存して終了します

ESC を押して、「:wq」と入力します。

2.4.2.5 ステップ 5: Tomcat ログの構成

/opt/tomcat/conf/logging.propertiesファイルを開きます
maxDays属性を追加して、catalina、localhost、host-manager、manager ログについて、ローテーションされたアクセスログが削除されるまで保持される最大日数を指定します。指定しない場合は、デフォルト値の -1 が使用されます。これは、古いファイルを削除しないことを意味します。例: 10 日分の履歴を保持します。

1catalina.org.apache.juli.AsyncFileHandler.maxDays = 10
2localhost.org.apache.juli.AsyncFileHandler.maxDays = 10
3manager.org.apache.juli.AsyncFileHandler.maxDays = 10
4host-manager.apache.juli.AsyncFileHandler.maxDays = 10

1714726922102-116

変更を保存して終了します。
/opt/tomcat/conf/server.xmlファイルを開きます
ログをオンにするには、ログ設定の行のコメントを解除します。
属性 maxDays を追加して、catalina、localhost、host-manager、manager ログについて、ローテーションされたアクセスログが削除されるまで保持される最大日数を指定します。指定しない場合は、デフォルト値の -1 が使用されます。これは、古いファイルを削除しないことを意味します。例: 10 日分の履歴を保存します。

例: maxDays="10"

1714726968776-214 7. 変更を保存して終了します

リロードデーモン:

sudo systemctl daemon-reload

Tomcat サービスを開始します (webappsにROOTフォルダーのみが存在することを確認します)。

sudo systemctl start tomcat

Tomcat サービスを有効にします。

sudo systemctl enable tomcat

Tomcat のステータスを確認します。

sudo systemctl status tomcat

image-20230804101914-17

curl localhost:8080

image-20230804101914-18

ログの所有者/グループを変更します。

sudo chown -R tomcat /opt/tomcat/logs
sudo chgrp -R tomcat /opt/tomcat/logs

2.4.3.ステップ 3 - akaBot Center パッケージをインストールする

2.4.3.1.インストールフォルダーを解凍します

Tomcat サービスを停止します (実行中の場合)。

sudo systemctl stop tomcat

/opt/tomcat/webapps内のすべてのフォルダーを削除します。

sudo rm -rf /opt/tomcat/webapps/*

akaBot-center-x.x.x.x.warを/opt/tomcat/webapps/にコピーし、その名前をROOT.warに変更します。

cd ~/apps
sudo cp akaBot-center-3.0.1.2.war /opt/tomcat/webapps/ROOT.war

Tomcat を起動し、抽出を待ちます。

sudo systemctl start tomcat
cd /opt/tomcat/webapps
ls –l

Tomcat を停止し、ROOT.warを削除します。

sudo systemctl stop tomcat
sudo rm /opt/tomcat/webapps/ROOT.war

2.4.3.2. akaBot センターを構成する

akaBot Center がデータベース、キャッシュ、およびキューサービスと対話できるようにするには、次のように構成します。

A. ファイル`quartz.properties`を設定します。

ファイルを開く:

sudo vi /opt/tomcat/webapps/ROOT/WEB-INF/classes/quartz.properties

使用するデータベースの種類 (MSSQL 上の Oracle または MySQL) に応じて、次のように実行します。

データベースタイプのdriverDelegateClass変数の行のコメントを解除して、データベースタイプの設定を有効にします。

例: Oracle データベースを使用し、Oracle の行のコメントを解除します。

image-20230804101914-19

driverDelegateClass変数他のデータベースタイプの行をコメントアウトして、他のデータベースタイプの設定を無効にします。

image-20230804101914-20

変更を保存して終了します。ESCを押して、:wqと入力します。

B. ログバック設定を構成する

ログバック設定ファイルを開きます。

sudo vi /opt/tomcat/webapps/ROOT/WEB-INF/classes/logback-spring.xml

次の行を更新します。

/opt/tomcat/logs/center/akaCenter.%d{yyyy-MM-dd}.%i.log
To:
/opt/tomcat/logs/agents/${agentName}/BotAgent.%d{yyyy-MM-dd}.%i.log

ラインを更新する

${application.home:-.}/logs/agents/${agentName}/BotAgent.%d{yyyy-MM-dd}.%i.log

必要に応じてログレベルを変更します。例: エラー
他の設定を変更します。

maxFileSize: 各ファイルのサイズを制限します。例: 100MB。
maxHistory: オプションの maxHistory プロパティは、保持するアーカイブファイルの最大数を制御します。例: 20
totalSizeCap: オプションの totalSizeCap プロパティは、すべてのアーカイブファイルの合計サイズを制御します。例：20GB

変更を保存して終了します。

ESCを押して、:wqと入力します。 1714722756676-901

C. データベース接続の構成

ファイルapplication-prod.ymlを開きます

cd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/

sudo vi application-prod.yml

使用するデータベースの種類 (Oracle、MSSQL、または MySQL) に応じて、次のようにファイルを更新します。

例: データベースの種類は Oracle です

ａ．データベースの URL を更新する

データベースの URL 行のコメントを解除し、対応する URL を更新します。
他のデータベースの URL 行をコメントアウトします。

Oracle URL 形式:

サービスの SID を使用する場合、URL 形式は次のようになります。

url: jdbc:oracle:thin:@<DB-SERVER>:<DB-PORT>:<DB-SID>

サービス名を使用する場合、JDBC URL 形式は次のようになります。

url: jdbc:oracle:thin:@//<DB-SERVER>:<PORT>/<SERVICE NAME>

MSSQL URL 形式:

url: jdbc:sqlserver://<DB-SERVER>:<DB-PORT>;databaseName=<DB- NAME>;encrypt=true;trustServerCertificate=true;

MySQL URL 形式:

url: jdbc:mysql://< DB-SERVER >:<DB-PORT>/<DB-NAME>

b.データベースのユーザー名とパスワードを更新します

c. driverClassName 変数を更新します。

データベースタイプの driverClassName 変数の行のコメントを解除します。
他のデータベースタイプの driverClassName 変数の行をコメントアウトします。

d.データベースプラットフォームとデータベース変数を更新する

データベースプラットフォームとデータベースタイプのデータベース変数の行のコメントを解除します。
他のデータベースタイプのデータベースプラットフォームおよびデータベース変数の行をコメント化します。

e.変更を保存して終了します

ESC を押して、「:wq」と入力します。

application-dev.ymlファイル用に設定します。

ａ．ファイルapplication-dev.ymlを開きます

sudo vi application-dev.yml

b.同じステップ 2 からステップ 3 を繰り返して、ファイル application-dev.yml を構成します。

D. ActiveMQ 接続の構成

application.ymlを開く

cd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/

sudo vi application.yml

brokerURLの値を更新します。

brokerURL: failover:(tcp://<IP-ACTIVEMQ-01>:61616,tcp://<IP-ACTIVEMQ-02>:61616)?randomize=false&jms.messagePrioritySupported=true&nested.wireFormat.maxInactivityDurationInitalDelay=30000

その中で:

<IP-ACTIVEMQ-01>: ActiveMQ サーバー 01 の IP アドレス
<IP-ACTIVEMQ-02>: ActiveMQ サーバー 02 の IP アドレス

変更を保存して終了します。 ESC を押して、「wq」と入力します。

E. Redis キャッシュ接続の構成

application-prod.ymlファイルを開きます

cd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/

sudo vi application-prod.yml

以下のようにファイルを更新します

modeを1およびserverURL に更新します。

image-20230804101914-30

サーバー変数の値を更新します。

If your Redis service requires a password, then server variable’s value is:
server: redis://:<REDIS-PASSWD>@<REDIS-IP>:6379

otherwise, server variable’s value is:
server: redis://<REDIS-IP>:6379

変更を保存して終了します

ESC を押して、「:wq」と入力します。

application-dev.ymlファイル用に設定します。

ａ．ファイルapplication-dev.ymlを開きます

sudo vi application-dev.yml

b.同じステップ 2 からステップ 3 を繰り返して、ファイル application-dev.yml を構成します。

F. ElasticSearch 接続の構成

application.ymlファイルを開きます

cd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/

sudo vi application.yml

以下のように、ファイルの末尾に以下のコードを追加します。

elasticsearch:
  enabled: true
  clustername: elasticsearch
  index: filebeat-*
  host: <IP_ES>
  port: 9200
  user:
  password:
  index-max-result-window: 20000000

ここで: <IP_ES>は ElasticSearch サーバーの IP アドレスです。

変更を保存して終了します

ESC を押して、「:wq」と入力します。

G. Elasticsearch 設定の構成

ステップ 1:`application-prod.yml`ファイルを開く

cd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/

sudo vi application-prod.yml

ステップ 2: 以下のコードをコメントアウトして Tomcat のデフォルト設定をオフにします

次の行を見つけます。

hibernate.search.backend.directory.root: indexes/
hibernate.search.backend.type: lucene

それらをコメントアウトします。

#hibernate.search.backend.directory.root: indexes/
#hibernate.search.backend.type: lucene

ステップ 3: 以下のコードのコメントを外して、エラスティック検索設定をオンにします

次の構成を追加するか、コメントを解除します。

hibernate.search.backend.type: elasticsearch
hibernate.search.backend.host: <IP_ES>:9200
hibernate.search.backend.protocol: http
hibernate.search.backend.username:
hibernate.search.backend.password:

例:

hibernate.search.backend.type: elasticsearch
hibernate.search.backend.host: 3.112.124.176:9200
hibernate.search.backend.protocol: http
hibernate.search.backend.username:
hibernate.search.backend.password:

場所:

<IP_ES>は Elasticsearch サーバーの IP アドレスです

ステップ 4: 変更を保存して終了する

ESCを押して、次のように入力します。 :wq

---

## Step 5: Configure `application-dev.yml`

Open the file:

```bash
sudo vi application-dev.yml

Repeat the same configuration from Step 2 → Step 4.

2.4.3.3. Step 3 – Start Tomcat Service and Test

Start Tomcat:

sudo systemctl tomcatを起動

Test connection:

カールローカルホスト:8080

image-20230804101914-33

2.5 Install NGINX Load Balancer

2.5.1. Step 1 - Install Nginx package

Install package:

CD アプリ/
sudo rpm -ivh<package name>

Start and enable Nginx:

sudo systemctl で nginx を有効にする
sudo systemctl nginxを起動

Verify:

nginx -v
sudo systemctlステータスnginx

image-20230804101914-35

2.5.2. Step 2 - Configure Nginx service

2.5.2.1. Configure Nginx Load Balancing

Stop Nginx: sudo systemctl stop nginx
Open /etc/nginx/sites-available/default
Configure upstream and server blocks:

アップストリーム akaBotCenter {
サーバー<IP-SRV-CENTER-01>:8080;
サーバー<IP-SRV-CENTER-02>:8080;
}

サーバー {
80を聞いてください。
サーバー名<YOUR-DOMAIN>;
client_max_body_size 200M;
場所 / {
proxy_pass http://akaBotCenter;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header ホスト $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_http_バージョン 1.1;
proxy_set_header アップグレード $http_upgrade;
proxy_set_header 接続「アップグレード」;
}
}

2.5.2.2. Configure Nginx SSL

Follow provider guides or use Self-Signed SSL:

Create SSL Cert:

sudo mkdir /etc/ssl/private
sudo chmod 700 /etc/ssl/private
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/nginx-selfsigned.key -out /etc/ssl/certs/nginx-selfsigned.crt

Create Diffie-Hellman:

sudo openssl dhparam -out /etc/ssl/certs/dhparam.pem 2048

Configure /etc/nginx/conf.d/default.conf with SSL settings.

2.6. Configure Catalina.out

By default, Tomcat will write out the logs into catalina.out file which may cause dramatic increasing of the file size and decrease the performance. To stop this, change the configuration in Catalina.out as below:

Open the file /opt/tomcat/bin/catalina.sh
Press ESC then type: “:229” to the line 229
Comment out this line to stop writing log to catalina.out.: #CATALINA_OUT="$CATALINA_BASE"/logs/catalina.out
Add below line affer the commented line.: CATALINA_OUT=/dev/null
Save changes and close the file.

Press ESC then type: “:wq”

image-20230804101914-36

DONE!!! You have successfully completed the akaBot Center installation and configuration in High Availability model.

3. Troubleshoot issues

3.1. Self-Troubleshoot

If any raised issue during your installation, please follow below actions to self-troubleshoot.

3.1.1 Step 1 - Detect issue

Please use the logs to detect the issue.

Issues related to Tomcat service start, please use Tomcat log file: /opt/tomcat/logs/catalina.out Issues related to akaBot Center, please use Center log file: /opt/tomcat/logs/center/akaCenter.yyyy—mm-dd.0.log

Remove the log of previous run by navigating to log folder then remove all the log files.
Start service again to generate log.
Open the log file to detect the issue.

3.1.2 Step 2 – Troubleshoot issues

Issue 1: Could not commit with auto-commit

Issue: Could not commit with auto-commit as below image:

image-20230804101914-37

Solution:

At step 2.2.4 Step 4: Configure Tomcat service, please add below option into the JAVA-OPTS variable into service configuration file. -Doracle.jdbc.autoCommitSpecCompliant=false

image-20230804101914-38

Continue to follow the next steps in the guide

1. 始める前に

モデルコンポーネント:​

1.1.ハードウェア要件​

1.2.データベース要件​

1.3.ファイルストレージの要件​

1.4.許可要件​

1.5.インストールパッケージの準備​

1.6.その他の注意事項​

2. インストール

2.1. Redis をインストールする​

2.1.1.ステップ 1 – Redis パッケージをインストールします。​

2.1.2.ステップ 2 – Redis リモート アクセスを構成する​

2.1.3.ステップ 3 – セキュリティ設定を構成する (オプション)​

2.2. ActiveMQ をインストールする​

2.2.1.ステップ 1 - インストール ファイルを抽出する​

2.2.2.ステップ 2 - グループと ActiveMQ ユーザーを作成する​

2.2.3.ステップ 3 - ActiveMQ サービスを構成する​

2.2.4.ステップ 4 - ActiveMQ サービスの Java ヒープ メモリを構成する​

2.2.5.ステップ 5 – ActiveMQ サービスを構成します。​

2.3. ELK スタックのインストール​

2.3.1.ステップ 1 - ElasticSearch をインストールする​

2.3.2.ステップ 2 - Logstash をインストールする​

2.3.3.ステップ 3 - Filebeat をインストールする​

2.3.5.ステップ 4 - Kibana をインストールする (オプション)​

2.4. akaBot センターをインストールする​

2.4.1.ステップ 1 - JDK をインストールする​

2.4.2.ステップ 2 - Apache Tomcat Web サーバーをインストールする​

2.4.2.1.ステップ 1: インストール ファイルを抽出する​

2.4.2.2.ステップ 2: グループとユーザー Tomcat を作成する​

2.4.2.3.ステップ 3: フォルダーのアクセス権を構成する​

2.4.2.4 ステップ 4: Tomcat サービスの実行を構成する​

2.4.2.5 ステップ 5: Tomcat ログの構成​

2.4.3.ステップ 3 - akaBot Center パッケージをインストールする​

2.4.3.1.インストールフォルダーを解凍します​

2.4.3.2. akaBot センターを構成する​

A. ファイルquartz.propertiesを設定します。​

B. ログバック設定を構成する​

C. データベース接続の構成​

D. ActiveMQ 接続の構成​

E. Redis キャッシュ接続の構成​

F. ElasticSearch 接続の構成​

G. Elasticsearch 設定の構成​

ステップ 1:application-prod.ymlファイルを開く​

ステップ 2: 以下のコードをコメントアウトして Tomcat のデフォルト設定をオフにします​

ステップ 3: 以下のコードのコメントを外して、エラスティック検索設定をオンにします​

ステップ 4: 変更を保存して終了する​

2.4.3.3. Step 3 – Start Tomcat Service and Test​

2.5 Install NGINX Load Balancer​

2.5.1. Step 1 - Install Nginx package​

2.5.2. Step 2 - Configure Nginx service​

2.5.2.1. Configure Nginx Load Balancing​

2.5.2.2. Configure Nginx SSL​

2.6. Configure Catalina.out​

3. Troubleshoot issues

3.1. Self-Troubleshoot​

3.1.1 Step 1 - Detect issue​

3.1.2 Step 2 – Troubleshoot issues​

Issue 1: Could not commit with auto-commit​

モデルコンポーネント:

1.1.ハードウェア要件

1.2.データベース要件

1.3.ファイルストレージの要件

1.4.許可要件

1.5.インストールパッケージの準備

1.6.その他の注意事項

2.1. Redis をインストールする

2.1.1.ステップ 1 – Redis パッケージをインストールします。

2.1.2.ステップ 2 – Redis リモートアクセスを構成する

2.1.3.ステップ 3 – セキュリティ設定を構成する (オプション)

2.2. ActiveMQ をインストールする

2.2.1.ステップ 1 - インストールファイルを抽出する

2.2.2.ステップ 2 - グループと ActiveMQ ユーザーを作成する

2.2.3.ステップ 3 - ActiveMQ サービスを構成する

2.2.4.ステップ 4 - ActiveMQ サービスの Java ヒープメモリを構成する

2.2.5.ステップ 5 – ActiveMQ サービスを構成します。

2.3. ELK スタックのインストール

2.3.1.ステップ 1 - ElasticSearch をインストールする

2.3.2.ステップ 2 - Logstash をインストールする

2.3.3.ステップ 3 - Filebeat をインストールする

2.3.5.ステップ 4 - Kibana をインストールする (オプション)

2.4. akaBot センターをインストールする

2.4.1.ステップ 1 - JDK をインストールする

2.4.2.ステップ 2 - Apache Tomcat Web サーバーをインストールする

2.4.2.1.ステップ 1: インストールファイルを抽出する

2.4.2.2.ステップ 2: グループとユーザー Tomcat を作成する

2.4.2.3.ステップ 3: フォルダーのアクセス権を構成する

2.4.2.4 ステップ 4: Tomcat サービスの実行を構成する

2.4.2.5 ステップ 5: Tomcat ログの構成

2.4.3.ステップ 3 - akaBot Center パッケージをインストールする

2.4.3.1.インストールフォルダーを解凍します

2.4.3.2. akaBot センターを構成する

A. ファイル`quartz.properties`を設定します。

B. ログバック設定を構成する

C. データベース接続の構成

D. ActiveMQ 接続の構成

E. Redis キャッシュ接続の構成

F. ElasticSearch 接続の構成

G. Elasticsearch 設定の構成

ステップ 1:`application-prod.yml`ファイルを開く

ステップ 2: 以下のコードをコメントアウトして Tomcat のデフォルト設定をオフにします

ステップ 3: 以下のコードのコメントを外して、エラスティック検索設定をオンにします

ステップ 4: 変更を保存して終了する

2.4.3.3. Step 3 – Start Tomcat Service and Test

2.5 Install NGINX Load Balancer

2.5.1. Step 1 - Install Nginx package

2.5.2. Step 2 - Configure Nginx service

2.5.2.1. Configure Nginx Load Balancing

2.5.2.2. Configure Nginx SSL

2.6. Configure Catalina.out

3.1. Self-Troubleshoot

3.1.1 Step 1 - Detect issue

3.1.2 Step 2 – Troubleshoot issues

Issue 1: Could not commit with auto-commit