データ管理

データ保存

スタンドアロン展開モードでは、ストレージコンポーネントはすでにイメージ内に組み込まれているため、ユーザーが個別にインストールする必要はありません。生成されるデータは、マウントにより指定ディレクトリに保存されます。

HAP のデフォルトデータパスは /data/mingdao です。ただし、カスタムデータパスを設定している場合は、実際のパスをご利用ください。

ストレージコンポーネントが生成するデータは、デフォルトでサーバー上の /data/mingdao/script/volume/data/ ディレクトリにマウントされます。ディレクトリ構成は以下の通りです。

/data/mingdao/script/volume/data/
├── elasticsearch
├── elasticsearch-8
├── kafka
├── logs
├── mongodb
├── mysql
├── redis
├── storage
└── zookeeper

各ディレクトリに保存されるデータの内容は以下の通りです。

elasticsearch … バージョン3.9.0以前のElasticsearchデータ
elasticsearch-8 … バージョン3.9.0以降のElasticsearchデータ（主にスーパーサーチおよびアプリケーションログ対応）
kafka … メッセージキューのデータ。期限切れデータは自動削除されます
logs … コンポーネントサービスのログ
mongodb … 業務データ（アプリケーション、ワークシート、ワークフローなど）の保存
mysql … システムコアデータ（ユーザー、組織など）の保存
redis … キャッシュデータ
storage … 添付ファイルデータ
zookeeper … kafkaへのサービス提供

データバックアップ

バックアップの詳細はこちら
クラウドサーバーをご利用の場合は、クラウドベンダーが提供するディスクスナップショット機能をご活用いただけます。

データクリーン

logs、mongodb、およびstorage内のデータは、一般的にディスク容量を多く消費します。

logsディレクトリ内のコンポーネントサービスログは、不要な場合にはクリーンアップが可能です。
mongodb内に保存された業務データについては、現在ログデータのアーカイブおよび削除済みアプリケーションデータのクリーンのみ対応しています。
storageに保存される添付ファイルデータについては、ディスク容量が不足する場合、アップロードページ側でファイルサイズ制限を推奨します。
- クラウドサーバーをご利用の場合は、オブジェクトストレージの有効化をご参照いただき、ディスク容量の負荷軽減が可能です。

環境をアップグレードした場合、未クリーンアップの過去バージョンのイメージファイルもディスク容量を消費します。

過去イメージファイルのクリーンアップ例

現在のサーバー上にあるイメージファイル一覧の確認

[root@localhost ~]# docker images
REPOSITORY                                                        TAG                   IMAGE ID       CREATED         SIZE
registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap   4.4.2                 cacc79998cbd   5 days ago      9.33GB
registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap   4.3.0                 e0c6e370de63   9 days ago      9.26GB
registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-doc   1.2.0                 cc4d668f289b   4 months ago    2.66GB

現在のバージョンが4.4.2の場合、4.3.0のイメージはクリーンアップ対象です。

過去バージョンのイメージをクリーンアップ

docker image rm registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap:4.3.0
または
docker image rm e0c6e370de63

上記で十分な容量確保ができない場合は、ディスク容量の拡張もご検討ください。

データ移行

方法1：バックアップと復元

データバックアップの手順で旧環境のデータをバックアップし、データ復元の手順で新環境に復元します。dump 方式またはファイルコピー方式を選択できます。

方法2：ディレクトリの移行

サービスを停止し、旧環境のデータディレクトリ全体を新しいサーバーに移行します。既存の設定とデータは保持されます。

注意

以下ではデフォルトのデータディレクトリ /data/mingdao を使用します。新旧環境のデータパスは同じにしてください。カスタムパスの場合は、実際のパスに置き換えます。

移行前に、圧縮ファイルと展開後のデータを保存できるディスク容量を確保してください。データディレクトリ外のマウントファイル、プロキシ設定、証明書は別途移行する必要があります。

新環境をデプロイ

旧環境と同じバージョンの HAP と関連コンポーネントをインストールします。CPU アーキテクチャも同じにしてください。
新旧環境を停止

新旧それぞれのサーバーでマネージャーのルートディレクトリに移動し、マネージャーと HAP サービスを停止します。
```
bash ./service.sh stopall
```
両方のサービスが停止したことを確認してからデータを圧縮します。移行中は旧環境を起動しないでください。
旧環境のデータを圧縮

旧サーバーで /data/mingdao 内のすべてのデータを圧縮し、データディレクトリと同じ階層に保存します。
```
tar -zcpf /data/mingdao.tar.gz -C /data/mingdao .
```
データ圧縮ファイルを転送

旧サーバーの /data/mingdao.tar.gz を新サーバーの同じパスに転送します。

新環境の既存データディレクトリを移動

mv /data/mingdao /data/mingdao.bak-$(date +%Y%m%d%H%M%S)

新環境のデータディレクトリを作成

新サーバーでデータディレクトリを作成し直します。
```
mkdir -p /data/mingdao
```
旧環境のデータを展開

新サーバーで圧縮ファイルを /data/mingdao に展開し、ファイルの権限と所有者を保持します。
```
tar -zxpf /data/mingdao.tar.gz -C /data/mingdao
```
新環境のアクセスアドレスを変更

新サーバーで移行後の設定ファイルを編集します。
```
vi /data/mingdao/script/docker-compose.yaml
```
ENV_ADDRESS_MAIN などのアクセスアドレス設定を確認し、旧環境のアクセスアドレスを参照するすべての設定項目を、対応する新環境のアドレスに変更します。
新環境を起動

新サーバーでマネージャーのルートディレクトリに移動し、マネージャーと HAP サービスを起動します。
```
bash ./service.sh startall
```
移行結果を確認

新環境のアドレスからシステムにアクセスし、ログイン、業務データ、ワークフロー、添付ファイルのアップロードとダウンロードが正常か確認します。

データ保存​

データバックアップ​

データクリーン​

データ移行​

方法1：バックアップと復元​

方法2：ディレクトリの移行​