マルチテナンシー版 FRUCtoS vM1.0.0 エクスポート手順 (Docker)
1. 本手順の目的
本手順はマルチテナンシー版FRUCtoS vM1.0.0のデータのエクスポート手順を記載しています。
FRUCtoSではFHIRリソース本体とその履歴のほかに検索のためのイ ンデックスを内部的に生成し保持しています。 エクスポート時にFHIRリソース本体とその履歴のみを出力し、インポート時にFHIRリソース本体とその履歴の入力とインデックスの再生成することで異なるバージョン間でのデータ移行を実現しています。
ダンプツールは、1つ前のバージョンからのデータ移行のみサポートしています。
本手順は、以下に関する基本的な知識を有する作業者を対象としています。
- FRUCtoS
- Docker
- ダンプツールではFRUCtoSリポジトリのリソースの登録・改変履歴をテキストファイルに出力し、リポジトリのバックアップやデータ移行に用いることができます。その性質上内部には機密性の高いデータが含まれるため、取り扱いに際しては運用ルール等を定めて厳格に取り扱うことが求められます。
- バックアップ等データの復元可能な準備を行ってから実施してください。
2. 準備
2.1. 必要な資材
- vM1.0.0-dump-tools-export
- 通常リソースのエクスポートの資材
- vM1.0.0-dump-tools-auditevent-export
- 監査ログのエクスポートの資材
- 監査ログのデータ移行を行う場合のみ必要
2.2. 資材のダウンロード
vM1.0.0-dump-tools-exportは、FRUCtoSの資材のdump-toolsフォルダに、
vM1.0.0-dump-tools-auditevent-exportは、FRUCtoSの資材のdump-tools-auditeventフォルダにそれぞれ入っています。
FRUCtoSの資材をお持ちでない場合は、こちらからお申込みください。
2.3. 配布資材の構成
- vM1.0.0-dump-tools-exportのフォルダ/ファイル構成は以下となっています。
vM1.0.0-dump-tools-export/
|── Export.ps1 ・・・エクスポート時に実行するファイル(Windows環境)
|── Export.sh ・・・エクスポート時に実行するファイル(Linux/Mac環境)
|── README.md
|── fructoslog ・・・デフォルトでエクスポートしたファイルが出力されるディレクトリ
└── tools/
└── export.sh ・・・エクスポート時にDockerコンテナ内で実行するファイル
- vM1.0.0-dump-tools-auditevent-exportのフォルダ/ファイル構成は以下となっています。
vM1.0.0-dump-tools-auditevent-export/
|── AuditEventExport.ps1 ・・・エクスポート時に実行するファイル(Windows環境)
|── AuditEventExport.sh ・・・エクスポート時に実行するファイル(Linux/Mac環境)
|── README.md
|── fructoslog ・・・デフォルトでエクスポートしたファイルが出力されるディレクトリ
└── tools/
└── audit_event_export.sh ・・・エクスポート時にDockerコンテナ内で実 行するファイル
docker-composeのバージョンがv2.0.0以上の場合、以下ファイル内のdocker-composeコマンドをdocker composeコマンドに修正した後ご利用ください。
・ Export.bat
・ Export.sh
・ AuditEventExport.bat
・ AuditEventExport.sh
3. エクスポート手順
通常リソースと監査ログのデータ移行を行う場合は、3.1.以降の全ての手順を実施してください。
通常リソースのみデータ移行を行う場合は、3.1., 3.2., 3.3., 3.4. のみ実施してください。
3.1. FRUCtoSの停止
-
FRUCtoSの配置フォルダへ移動して以下コマンドを実行します。
Powershell/Shelldocker-compose stop tomcat
3.2. 【通常リソース】エクスポートの準備
- Windowsの場合
- Linux/Macの場合
- vM1.0.0-dump-tools-exportをFRUCtoSの配置フォルダ直下に配置します。
- vM1.0.0-dump-tools-export/Export.ps1をメモ帳などで開き、ユーザー設定項目のエクスポート先を修正してください。デフォルトはvM1.0.0-dump-tools-export/fructoslogとなっています。
# =============== ユーザー設定項目 ===============
## エクスポートしたファイルを保存するディレクトリ
$TransactionlogFilePath="$(pwd)/fructoslog/"
# ================================================
- vM1.0.0-dump-tools-export/tools/export.shをメモ帳などで開き、設定項目のパーティション情報を修正してください。デフォルトはallとなっています。
# ============================= 設定項目 =============================
# パーティション情報--------------------------------------------------
## エクスポートするパーティション名(全てのパーティションをエクスポートする場合はallを指定)
PARTITION=all
- vM1.0.0-dump-tools-exportをFRUCtoSの配置フォルダ直下に配置します。
- vM1.0.0-dump-tools-export/Export.shをメモ帳などで開き、ユーザー設定項目のエクスポート先を修正してください。デフォルトはvM1.0.0-dump-tools-export/fructoslogとなっています。
# =============== ユーザー設定項目 ===============
## エクス ポートしたファイルを保存するディレクトリ
TRANSACTIONLOG_FILE_PATH="$(pwd)/fructoslog/"
# ================================================
- vM1.0.0-dump-tools-export/tools/export.shをメモ帳などで開き、設定項目のパーティション情報を修正してください。デフォルトはallとなっています。
# ============================= 設定項目 =============================
# パーティション情報--------------------------------------------------
## エクスポートするパーティション名(全てのパーティションをエクスポートする場合はallを指定)
PARTITION=all
3.3. 【通常リソース】エクスポートの実施
- Windowsの場合
- Linux/Macの場合
-
vM1.0.0-dump-tools-exportで以下コマンドをを実行します。
PowershellPowerShell .\Export.ps1 -
エクスポートが開始されるので、コマンドが終了するまで待機します。
-
コマンド終了後、以下コマンドを実行します。 0 が表示されれば正常に終了しています。
Powershellecho $lastexitcode
環境によりPowerShellスクリプトが実行出来ない場合は、必要に応じてPowerShellスクリプトの実行に先立ち、 以下の「Windowsの実行ポリシーの設定」や「PowerShellスクリプトのプロパティ変更」を行ってください。
-
実行ポリシーの設定
PowerShellSet-ExecutionPolicy RemoteSigned -Scope Process『y』を入力してください。
-
プロパティ変更
Export.ps1ファイルの『セキュリティ』を次の手順で許可にしてください。- Export.ps1ファイルをエクスプローラーで選択し、マウスボタン右クリックでプロパティを表示します。
- 『全般』タブの『セキュリティ:』の『許可する(K)』をチェックします。
-
vM1.0.0-dump-tools-exportで以下コマンドを実行します。
Shellsh Export.sh -
エクスポートが開始されるので、コマンドが終了するまで待機します。
-
コマンド終了後、以下コマンドを実行します。 0 が表示されれば正常に終了しています。
Shellecho $?
3.4. 【通常リソース】出力ファイルの確認
- 正常にエクスポートが実行された場合、3.2. 【通常リソース】エクスポートの準備で設定したフォルダにfhirlogファイルとgzファイルが存在します。
- gzファイルをインポートで使用します。よって、gzファイルは適切な場所に保管しておいてください。
3.5. 【監査ログ】エクスポートの準備
監査ログのエクスポートの準備
- Windowsの場合
- Linux/Macの場合
- vM1.0.0-dump-tools-auditevent-exportをFRUCtoSの配置フォルダ直下に配置します。
- vM1.0.0-dump-tools-auditevent-export/AuditEventExport.ps1をメモ帳などで開き、ユーザー設定項目のエクスポート先を修正してください。デフォルトはvM1.0.0-dump-tools-auditevent-export/fructoslogとなっています。修正する場合は3.2. 【通常リソース】エクスポートの準備とは異なるフォルダを設定してください。
# =============== ユーザー設定項目 ===============
## エクスポートしたファイルを保存するディレクトリ
$TransactionlogFilePath="$(pwd)/fructoslog/"
# ================================================
- vM1.0.0-dump-tools-auditevent-export/tools/audit_event_export.shをメモ帳などで開き、設定項目のパーティション情報を修正してください。デフォルトはallとなっています。
# ============================= 設定項目 =============================
# パーティション情報--------------------------------------------------
## エクスポートするパーティション名(全てのパーティションをエクスポートする場合はallを指定)
PARTITION=all
- vM1.0.0-dump-tools-auditevent-exportをFRUCtoSの配置フォルダ直下に配置します。
- vM1.0.0-dump-tools-auditevent-export/AuditEventExport.shをメモ帳などで開き、ユーザー設定項目のエクスポート先を修正してください。デフォルトはvM1.0.0-dump-tools-auditevent-export/fructoslogとなっています。修正する場合は3.2. 【通常リソース】エクスポートの準備とは異なるフォルダを設定してください。
# =============== ユーザー設定項目 ===============
## エクスポートしたファイルを保存するディレクトリ
TRANSACTIONLOG_FILE_PATH="$(pwd)/fructoslog/"
# ================================================
- vM1.0.0-dump-tools-auditevent-export/tools/audit_event_export.shをメモ帳などで開き、設定項目のパーティション情報を修正してください。デフォルトはallとなっています。
# ============================= 設定項目 =============================
# パーティション情報--------------------------------------------------
## エクスポートするパーティション名(全てのパーティションをエクスポートする場合はallを指定)
PARTITION=all
3.6. 【監査ログ】エクスポートの実施
監査ログのデータ移行を行わない場合、本手順はスキップしてくださ い。
監査ログのエクスポートの実施
- Windowsの場合
- Linux/Macの場合
-
vM1.0.0-dump-tools-auditevent-exportで以下コマンドを実行します。
PowershellPowerShell .\AuditEventExport.ps1 -
エク スポートが開始されるので、コマンドが終了するまで待機します。
-
コマンド終了後、以下コマンドを実行します。 0 が表示されれば正常に終了しています。
Powershellecho $lastexitcode
環境によりPowerShellスクリプトが実行出来ない場合は、必要に応じてPowerShellスクリプトの実行に先立ち、 3.3. 【通常リソース】エクスポートの実施と同様に「Windowsの実行ポリシーの設定」や「PowerShellスクリプトのプロパティ変更」を行ってください。
-
vM1.0.0-dump-tools-auditevent-exportで以下コマンドを実行します。
Shellsh AuditEventExport.sh -
エクスポートが開始されるので、コマンドが終 了するまで待機します。
-
コマンド終了後、以下コマンドを実行します。 0 が表示されれば正常に終了しています。
Shellecho $?
3.7. 【監査ログ】出力ファイルの確認
監査ログのデータ移行を行わない場合、本手順はスキップしてください。
監査ログの出力ファイルの確認
- 正常にエクスポートが実行された場合、3.5. 【監査ログ】エクスポートの準備で設定したフォルダにfhirlogファイルとgzファイルが存在します。
- gzファイルをインポートで使用します。よって、gzファイルは適切な場所に保管しておいてください。