IROHA2装置管理サーバー

起動

手動起動

装置管理サーバーがインストールされたディレクトリにおいて以下のコマンドを実行する。

$ cd /opt/mlfsoft/iroha2/iroha-management-server
$ ./run.sh

コンソールにはアクセスログ（POST/GETなど）が出力される。

サービスとしての起動

装置管理サーバーをサービスとして登録している場合、systemctlコマンドによるサーバーの起動・停止の管理が可能である。

# 起動
$ sudo systemctl start irhmngsrv
# 状態確認
$ sudo systemctl status irhmngsrv
# 再起動
$ sudo systemctl restart irhmngsrv
# 停止
$ sudo systemctl stop irhmngsrv

サービスとして起動した場合、サーバーへのアクセス（POST/GETなど）を記録するアクセスログが出力される。 バージョン2.6までは /tmp に上書きで保存され、ファイル名のフォーマットは以下の通りである。

irhmngsrv.ポート番号.log

バージョン2.7からは起動時の日時をファイル名に付与して /tmp に保存する。ファイル名のフォーマットは以下の通りである。

irhmngsrv.ポート番号.YYYYmmdd-HHMMSS.log

Web UIへのアクセス

サーバーを起動しているマシンからアクセスする場合、Webブラウザで以下のURLにアクセスする。

http://localhost:8086

サーバー外のマシンからアクセスする場合、localhostをサーバーのIPアドレスに変更する。

URLにアクセスすると装置管理サーバーのログイン画面が表示される。

Alternative Text

Fig. 144 装置管理サーバーのログイン画面

初期状態では管理者のアカウントのみが登録されている。

Web UI

管理者ログインとホーム画面

管理者としてログインに成功すると装置管理サーバーのホーム画面が表示される。装置管理サーバーの画面構成を Fig. 25 に示す。

Alternative Text

Fig. 145 装置管理サーバーのホーム画面

装置管理サーバーのWeb UIはシステムステータスバー、メニューおよびメニューに依存して表示されるメインコンテンツで構成されている。

システムステータスバー

システムステータスバーは常に表示され、システム状態を表示する。

Table 66 システムステータスバー

項番

項目

説明

1

装置名

デフォルトでは、Management Serverと表示される。Settingsメニューで変更できる。

2

デバイス状態
装置名の右横に表示される。登録されたデバイス制御サーバー上にあるデバイスのうち、測定に使用する構成デバイスの統合された状態を表示する。状態は以下のプライオリティで表示される。
Unknown：デバイス構成にデバイスが含まれていない状態
Error：ひとつ以上のデバイス制御サーバーと通信できない状態
Disconnect：ひとつ以上の構成デバイスがデバイス本体と通信できていない状態
Connecting：ひとつ以上の構成デバイスがデバイス本体と接続中
ParameterSetting：ひとつ以上の構成デバイスがパラメータ設定中
InProgress：ひとつ以上の構成デバイスがパラメータ設置完了待ち
Ready：すべての構成デバイスが測定可能または測定状態

3

モニタリングデバイス状態
デバイス状態の右横に表示される。登録されたデバイス制御サーバー上にあるモニタリングデバイスの統合された状態を表示する。状態は以下のプライオリティで表示される。
Unknown：デバイス構成にデバイスが含まれていない状態
Error：ひとつ以上のデバイス制御サーバーと通信できない状態
Disconnect：ひとつ以上の構成デバイスがデバイス本体と通信できていない状態
Connecting：ひとつ以上の構成デバイスがデバイス本体と接続中
ParameterSetting：ひとつ以上の構成デバイスがパラメータ設定中
InProgress：ひとつ以上の構成デバイスがパラメータ設置完了待ち
Ready：すべての構成デバイスが測定可能または測定状態

4

DAQ状態
DAQ M/W の統合状態を表示する
UNKNOWN：状態を取得中
ERROR：DAQ
M/W のDAQ
Operator と通信できていない状態
FATAL：ひとつ以上のDAQ コンポーネントがFATAL
PAUSED：ひとつ以上のDAQ コンポーネントがPAUSED
CONFIGURED：ひとつ以上のDAQ コンポーネントがCONFIGURED
LOADED：ひとつ以上のDAQ コンポーネントがLOADED
FINISHED：ひとつ以上のDAQ コンポーネントがFINISHED
RUNNING：すべてのDAQ コンポーネントがRUNNNING

5

予約ボタン
システムを予約して、他のユーザが使用できないようにする。
NOT RESERVED：システムは誰にも予約されておらず、予約可能
RESERVERD for <User>：システムは＜User＞に予約され使用中

6

ログインユーザ名

ログインしているユーザ名を表示する

7

Logout

ログアウトボタン：押下するとログアウトする

8

Help

ヘルプ画面を表示する

メニュー

初期設定：Settings

初期設定はSettingsメニューで行う。この設定は通常運用中には変更しない項目である。 この画面は管理者のみに表示される。

Alternative Text

Fig. 146 Settings画面

Table 68 Settingsの設定内容

項番

項目

説明

1

srvName

サーバー名。システムステータスバーおよびWebページタイトルとして保存される。

2

instCode

3文字の装置コード。測定結果の出力等に使用される。DAQ M/W で設定している値と同一の値にする。

3

medPassword

MLF実験データベースから出力されるユーザファイルの出力先を指定する。未登録のユーザでもこのファイルに登録されていれば、ログイン時にインポートされる。

4

outputBasePath
runInfoやログなどの測定結果を出力するディレクトリのベースパスを設定する。測定結果は以下のように出力される。
＜ベースパス＞/＜装置コード＞/＜装置コード＞＜RUN#＞_YYYYMMDD/params/run<RUN#>.xml
例） /opt/mlfsoft/data/SIK/SIK012345_20140205/params/run012345.xml

5

logConf

構成ログの保存パスを指定する。

6

logAuth

認証ログの保存パスを指定する。

7

logMsg

メッセージログの保存パスを指定する。

8

runInfoPageMax
Run Informationメニューでの１ページあたりの表示数を設定する。
★admin 以外のユーザはユーザフィルタのため表示が著しく遅くなる可能性があるため、ページングされない。最新のRun情報の1ページ分が表示される。

9

retryMax

デバイス制御サーバー接続時のリトライ回数を設定する。リトライ回数を超えて接続できない場合は、該当サーバーへの接続はResetされるまで再試行されない。0に設定すると無限に接続を試みる。

10

authSrv

統合認証サーバーのURIを設定する。セカンダリーサーバーを登録する場合は、スペースで区切って設定する。

11

authSrvBaseDn

統合認証サーバーアクセス時のBaseDnを設定する。

12

authSrvSearchOu

統合認証サーバーアクセス時のOuを設定する。

13

infoSrv

連携データベースのIPアドレスを設定する。セカンダリーサーバーを登録する場合は、スペースで区切って設定する。

14

infoSrvUsr

連携データベースのユーザーを設定する。

15

infoSrvPass

連携データベースのパスワードを設定する。

16

keyDir
RSA 鍵の作成ディレクトリを設定する。本項目は、Web UI からは参照できないため、以下のファイルをエディタで編集する必要がある。
iroha-settings/management/database/settings.xml

想定システムディレクトリ構成

outputBasePathの設定で想定されているディレクトリ構成は以下の通りである。

  • /opt/mlfsoft/iroha2/iroha-device-server ：デバイス制御サーバー（ライブラリ用）

  • /opt/mlfsoft/iroha2/iroha-management-server ：装置管理サーバー

出力測定結果

  • /opt/mlfsoft/data/<ABC>/<ABC><Run 番号＞_＜年月日＞/params/run＜Run 番号＞.xml

  • /opt/mlfsoft/data/<ABC>/<ABC><Run 番号＞_＜年月日＞/Logs/構成デバイスの測定ログ

  • /opt/mlfsoft/data/<ABC>/<ABC><Run 番号＞_＜年月日＞/DAQ M/W データ ※

Note

※はDAQ M/Wの config.xml の設定であり、装置管理サーバーでの設定ではない。 装置管理サーバーは測定開始時にLoggerのディレクトリを作成する。 DAQ M/Wの config.xml におけるLoggerMlfコンポーネントのセクションでは<param pid=”ignoreMkdirErr”>yes</param>と設定してLoggingディレクトリが既に存在した場合でもFATALとならないようにしておく必要がある。

外部連携モード

統合認証システムおよび連携データベースとの外部連携モード種別については、以下の通りである。

Table 69 外部連携モード

項目

外部連携モード

説明

備考

1

フル (Fully-Integrated)

統合認証システムでの認証、連携データベースとの連携が行われる。認証情報はRSA公開鍵で暗号化される。

統合認証優先、ローカル認証

2

統合認証のみ (Integrated-Authentication)

統合認証システムでの認証が行われる。認証情報は、RSA公開鍵で暗号化される。

統合認証優先、ローカル認証

3

暗号化送信のみ (Encrypted-Authentication)

統合認証システムおよび連携データベースとの連携は行われない。認証情報は、RSA公開鍵で暗号化される。

ローカル認証

4

平文のみ (Plane-Authentication)

統合認証システムおよび連携データベースとの連携は行われない。認証情報は、平文でやり取りされる。

ローカル認証

Note

現在の外部連携モードはSettings画面に状態を表示する。

ユーザ登録および編集：Users

Users メニューでは管理者パスワードの変更、一般ローカルユーザの登録、削除、パスワード変更および強制ログアウトを行うことができる。 この画面は管理者のみに表示される。 ローカルユーザを追加するには、 new User にユーザ名を入力、 new Password にパスワードを設定して、 Add ボタンを押下する。 この画面から登録されたユーザの Type はLocalとなる。 登録済みユーザの削除は該当ユーザの右にある Delete を押下する。 ユーザパスワードの変更は該当ユーザの右にある Password を入力して Change Password ボタンを押下する。

統合認証サーバーの認証でログインしたユーザーの Type はLDAPとなり、パスワードの変更および削除は行えない。

MLF実験データベース（MED）のパスワードファイルからのユーザインポートは MEDパスワードファイルに登録されたユーザがログインするタイミングで実行される。 Type MED としてインポートされ、その後の扱いは一般ユーザと同じである。

Status にはログイン中のユーザ状態（On Line）とともに接続セッション数（異なるホストやブラウザでアクセスしているセッション数）が表示される。 Logout ボタンは接続中の該当ユーザセッションをすべて切断する。

Alternative Text

Fig. 147 Users画面

デバイス制御サーバーの登録：Servers

Servers メニューからデバイス制御サーバーを登録する。この画面は管理者のみに表示される。

Alternative Text

Fig. 148 Servers画面におけるデバイス制御サーバーの登録

デバイス制御サーバーを登録するにはデバイス制御サーバーのIPアドレスとポート番号、サービス名を入力して Add ボタンを押下する。 デバイス制御サーバーのデフォルトポート番号は8085、サービス名は変更していなければirhdevsrvである。 また、 Monitor のラジオボタンをOnにすることでこのデバイス制御サーバーをモニタリング対象とすることができる。

追加後、 Status 欄の表示がErrorとなった場合はデバイス制御サーバーとの通信ができていないことを示す。 IPアドレスやデバイス制御サーバーが起動しているかを確認を行う。 Error状態ではデバイス制御サーバーの監視は停止している。 設定確認後 Reset ボタンを押下すると再度接続を試みる。 Readyとなれば正常である（この画面の Status は自動更新されないので、Webブラウザの更新ボタンを押下する）。

paramiko(pythonによるsshログイン)がインストールされているマシンでは Control ボタンがアクティブになり、 押下すると該当サーバーのデバイス制御サーバーを起動、停止、状態取得できる。

Alternative Text

Fig. 149 Servers画面におけるデバイス制御サーバーの制御

Server Root Passwordを入力して Start Service で起動、 Stop Service で停止、 Status で起動状態が表示される。

Note

このパスワードは該当メニューから移動するまで保持される。 使用後は別なメニューに移動するか、ログアウトする必要がる。

DAQ M/Wの設定：Servers

Servers メニューの下部にはDAQ M/Wの設定がある。 DAQ OperatorのIPアドレスなどを設定する。 この画面は管理者のみに表示される。

Alternative Text

Fig. 150 Servers画面におけるDAQ M/Wの設定

Table 70 DAQ M/Wの設定内容

項番

項目

説明

1

host

DAQ OperatorのIPアドレスを設定する。

2

urlCnt

DAQ M/Wの制御スクリプトのパスを設定する。

3

inPathConfig

測定開始時に config.xml の書き換えを行う場合に入力となる config.xml のパスを設定する。入力しない場合はこの処理は行われない。

4

outPathConfig

測定開始時に config.xml の書き換えを行う場合に出力先となる config.xml のパスを設定する。入力しない場合はこの処理は行われない。

5

inPathCondition

測定開始時に condition.xml の変換を行う場合に入力元となる condition.xml のパスを設定する。入力しない場合はこの処理は行われない。またRun情報にcondition情報が記録されない。

6

outPathCondition

測定開始時に condition.xml の変換を行う場合に出力先となる condition.json のパスを設定する。未入力の場合はこの処理は行われない（本機能を利用するにはpythonのlxmlモジュールが必要）。

7

daqCntRetry

DAQ M/W 制御時のタイムアウト回数を指定する。Begin/Endコマンド送信後、DAQ M/W がRUNNING/CONFIGUREDとなるまで待ち時間となる（約1秒でデフフォルトでは1分待つ）。

8

kickerCompName

Kickerコンポーネントの名称を指定する。

デバイス構成の作成：Configuration

登録されたデバイス制御サーバー上にあるデバイスのうち、測定に使用するデバイスを選択してまとめたものをデバイス構成と呼ぶ。 Configuration 画面では、複数のデバイス構成を作成できる。 デバイス構成はユーザ毎に作成され、Public属性を持つものは他のユーザも使用できる（構成の変更・削除はできない）。 Publicでないデバイス構成（Private）は管理者以外の他のユーザから参照することはできない。

Alternative Text

Fig. 151 Configuration画面

デバイス構成を追加するには、まずデバイス構成名を設定し追加する。 デバイス構成名にはアルファベット、数字、＿（アンダースコア）が使用できる。 デバイス構成追加時に All Device チェックボックスをONにしておくと登録されているデバイス制御サーバーから取得されたすべてのデバイスをデバイス構成に追加する。 Public チェックボックスをONにしておくと公開構成となる。 デバイス構成の詳細は該当デバイス構成の Edit ボタンを押下すると編集できる。

Alternative Text

Fig. 152 Configuration編集画面

編集画面では各デバイスを以下の3つのカテゴリに分類することができる。

Table 71 Configurationにおけるデバイスのカテゴリ

項番

カテゴリ

説明

1

Use Device

監視および制御対象とするデバイス

2

Monitor Device

監視のみ行うデバイス。このデバイスがError状態となっても測定には影響が出ない。

3

Not Use Device

監視および制御を行わないデバイス

デバイス構成は複数作成できる。 測定に使用するデバイス構成は測定予約した後、 Activate ボタンを押下して有効化する。 測定予約していない状態ではActivateできない。

測定予約

測定を同時に実行できるユーザは一人である。 このため、測定を行うには測定予約をする必要がある。 測定予約はシステムステータスバーの NOT RESERVED となっているボタンを押下する。 NOT RESERVED以外の時には測定予約を行うことができない。 測定予約を解除するには、測定予約をしているユーザが RESERVED for ＜User＞ となっているボタンを押下して測定予約を解除する。 管理者は他のユーザの測定予約を解除することができる。 一般ユーザは他のユーザの測定予約を解除することはできない。 また、測定予約状態はログアウトやサーバーの再起動では解除されない。

測定画面：Measurement

測定画面ではコメントなどの測定設定と簡易測定制御を行うことができる。 測定画面は管理者には測定予約なしで表示されるが、一般ユーザには測定予約しないと表示されない。 測定制御は測定予約ユーザがいない状態では無効化されている。 測定予約をすると測定予約ユーザまたは管理者が測定制御を行える。

Alternative Text

Fig. 153 Measurement画面

Run No および Experiment ID はadminユーザに対してのみ表示される。 装置管理サーバーからBeginしたときに Application Name および Application Version がブランクの場合は Application Name にirhmngsrv、 Application Version に装置管理サーバーバージョンが入る。

測定制御：Measurement

デバイスの設定などを含む高度な測定はExperiment Schedulerなどの測定制御アプリケーションで行うことが想定されているため、 装置管理サーバーではサポートされていない。装置管理サーバーでは、測定開始、停止などの簡易測定制御を行うことができる。 簡易測定では次の処理を行う。

  • 測定開始（Begin)

    • デバイス構成およびDAQ M/W の状態確認（ERROR でない）

    • 測定結果用ディレクトリの作成、測定結果（runInfo）の準備

    • デバイス制御サーバーの測定ログパス変更と測定ログの取得開始

    • DAQ M/W の状態リセット（他の状態にあってもCONFIGURED 状態になります）

    • DAQの開始

  • 測定の中断及び再開（Pause/Resume)

    • DAQ のPAUSE（一時停止）およびRESUME(再開)

  • 測定終了（End)

    • DAQ の停止

    • デバイス制御サーバーの測定ログ停止

    • 測定結果の出力

  • リセット（Reset)

    • 全デバイス制御サーバーへのリセット送信

    • 装置管理サーバー上のデバイス制御サーバー通信状態のリセット

    • 測定状態のリセット（装置管理サーバー上の状態リセット）

    • DAQ M/W をCONFIGUREDとする

Note

Reset 時にはRun No はインクリメントされない

Recent Run情報は最近実行された測定または実行中の測定情報を表示する。 この情報は装置管理サーバーが起動している状態で管理されているため、 装置管理サーバーを再起動すると次回測定まで表示されない（ファイルには保存されていない）。

ログフィルターの設定（バージョン2.7以降）

Message Log画面、Configuration Log画面、Authentication Log画面では Filter でログの種類を絞って表示することができるが、 加えて特定の文字列を含むメッセージを非表示にすることができる。 iroha-settings/management/database/log_msg_filter.json にフィルターする文字列を定義する。

Message Logの設定

msg_log キーのリストに文字列を追加する。文字列は正規表現に対応している。 複数の文字列を登録する場合にはカンマ（,）区切りで追加していく。

{
    ...
    "msg_log": [
        "message a",
        "message b"
    ]
}

Configuration Logの設定

conf_log キーのリストに文字列を追加する。文字列は正規表現に対応している。 複数の文字列を登録する場合にはカンマ（,）区切りで追加していく。

{
    "conf_log": [
        "It was failed to import cx_Oracle module.*",
        "It was failed to import python pycrypt module.*"
    ],
    ...
}

Authentication Logの設定

auth_log キーのリストに文字列を追加する。文字列は正規表現に対応している。 複数の文字列を登録する場合にはカンマ（,）区切りで追加していく。

{
    ...
    "auth_log": [
        "message c",
        "message d"
    ],
    ...
}

Run情報へのユーザー定義情報の追加

測定時に出力されるRun情報ファイル（ 想定システムディレクトリ構成 で説明されている run＜Run 番号＞.xml ）にユーザー定義の情報を追加することができる。

設定ファイル database/measurement.xml にある<userOption>要素に任意の要素を追加することで、その要素がRun情報ファイルに追加される。 例えば、Run情報ファイルに要素名「udef」、値「123」を追加したい場合、装置管理サーバー停止後に以下の様に記述する。

<userOption>
  <udef>123</udef>
<userOption>

装置管理サーバーを起動して測定を行うと、Run情報ファイルには以下の様にユーザー定義情報が記述される。

...<fileStatus>Protected</fileStatus><udef>123</udef></runInfo>

Web UIによる設定（バージョン2.7以降）

バージョン2.7以降ではWeb UIによるユーザー定義情報の表示と更新が可能になった。 設定ファイル database/measurement.xml にユーザー定義情報が記述されている場合、 ホーム画面およびMeasurement画面にユーザー定義情報が表示される。 また、Measurement画面ではユーザー定義情報の値の更新が可能である。

Alternative Text

Fig. 154 Measurement画面におけるユーザー定義情報の表示

Note

ユーザー定義情報は複数の要素を設定可能である。 ただし、Web UI上で表示・更新するためには、userOption要素の直下の階層に定義されていなければならない。 階層をより深くした場合、 （例えば、<userOption><udef_root><udef1>123</udef1><udef2>456</udef2></udef_root></userOption> とした場合） Run情報ファイルに情報は記述されるが、Web UIでは正しく表示されない。

統合制御サーバーとの連携機能

統合制御サーバーの Measurment パネルは、統合制御サーバーのWebUIから測定制御やシーケンス制御を行うことを目的としている。 このパネルは2つの測定モード（簡易測定モード、シーケンスモード）を備えており、モード切り替えによっていずれかのモードを選択して使用する。

測定モード切替

Simple ボタンで簡易測定モード、 Sequence ボタンでシーケンスモードに切り替わる。 Begin ボタン（シーケンスモードでは Start ボタン）を押下した後は、開始した処理が終了するまでモードの切り替えは不可となる（両モード共通）。

Alternative Text

Fig. 155 測定モード切替ボタン

簡易測定モード

簡易測定モードはRunInfoサマリーパネルを拡張した機能を備えている。 装置管理サーバーに対して測定制御コマンド（BeginやEnd等）を送信する機能や、 装置およびRun情報を取得して表示する機能はRunInfoサマリーパネルと同様であるが、 測定終了条件としてKicker数または測定経過時間を指定することができる。

Alternative Text

Fig. 156 Measurementパネル（簡易測定モード）

簡易測定モードの機能は以下の通りである。

  • Run情報の閲覧

  • 装置管理サーバーへのコマンド送信

  • 測定終了条件の設定

  • コメントの編集

  • ユーザー持ち込み試料の選択

Run情報の閲覧

Run情報は自動的に定周期配信Jsonデータから取得され、パネル上に表示される。 更新間隔は Settings メニューの System タブにおける、 Polling Interval of Web Browser で設定する（adminでログインした場合のみ設定可能）。 表示されるRun情報を Table 38 に示す。

Table 72 User Accessタブでの設定項目

No.

項目

内容

1

Theme ID

実験課題番号

2

Theme Title

実験課題名

3

Inst

ビームライン番号と装置コード

4

Run No

ランナンバー

5

Status

測定状態

6

System User

予約ユーザー名

Note

装置管理サーバーにおいてユーザー持ち込み試料情報の取得設定を行っている場合、試料情報の表示/選択を行う項目が追加される。

装置管理サーバーへのコマンド送信

Measurement パネルには4つの制御ボタンが配置されており（ Fig. 130 の赤枠）、 それぞれのボタンを押下することで、ボタンに対応するコマンドが装置管理サーバーに送信される。 各ボタンの機能は次のとおりである。

  • Begin ボタン

    指定した終了条件（ 測定終了条件の設定 ）で、装置管理サーバーに測定開始命令を送信する。 測定状態（Run情報のStatus）がReservedの場合のみ使用可能になる。

  • Pause ボタン

    測定を開始すると使用可能になる。装置管理サーバーに測定の一時停止命令を送信する。 測定状態がMeasuringの場合に使用可能になる。

  • Resume ボタン

    測定の一時停止中に使用可能になる。装置管理サーバーに測定の再開命令を送信する。 測定状態がPausingの場合に使用可能になる。

  • End ボタン

    測定中または、一時停止中に使用可能になる。装置管理サーバーに測定終了命令を送信する。 測定状態がMeasuringまたはErrorの場合に使用可能になる。

測定終了条件の設定

測定を開始するときは、次の3つの中から測定終了条件を選択する（ Fig. 130 の緑枠）。

  • None

    測定終了条件を指定しない。測定終了命令を送信するまで測定が継続する。

  • Kicker

    測定を終了するkicker countを入力する。 指定したkicker countに達すると自動的に測定が終了する。

  • Time

    測定を行う時間を秒単位で入力する。測定開始から指定した時間が経過したのち、自動的に測定が終了する（一時停止中は経過時間に含まれない）。 Measurement パネルの下部に測定終了までの推定残り時間が表示される。

コメントの編集

RunInfoサマリーパネルと同様の機能を持つ。 Measurement パネルのコメント欄（ Fig. 130 の青枠）に、装置管理サーバーに設定されている測定のコメントが表示される。 コメントを編集後、Apply ボタンを押下することで、コメントを更新できる。 コメントを編集後、更新せずに Reset ボタンを押下すると、コメントを編集前の状態に戻すことができる。

ユーザー持ち込み試料の選択

統合制御サーバーにおける試料情報の入力インターフェースの使用方法 における説明を参照のこと。

シーケンスモード

シーケンスモードについては IROHA2シーケンス管理サーバー を参照のこと。

ユーザー持ち込み試料情報の入力I/F

連携データベースから実験課題番号およびそれに紐づいたユーザー持ち込み試料情報を取得し、 測定のメタデータとして保存する機能およびユーザーインターフェースについて説明する。 主な機能は以下の通りである。

  • 連携データベースから取得した実験課題番号を用いて実験ユーザーアカウントを作成する機能

  • 連携データベースから実験課題番号に紐づいたユーザー持ち込み試料情報を取得し、測定時に保存されるメタデータ（ params/run<Run No.>.xml ）に情報を追加する機能

連携データベースとの連携セットアップ

Oracleモジュールの入手

以下のOracleモジュールを入手する。

  • oracle-instantclient11.2-basic-11.2.0.4.0-1.x86_64.rpm

  • oracle-instantclient11.2-devel-11.2.0.4.0-1.x86_64.rpm

  • oracle-instantclient11.2-sqlplus-11.2.0.4.0-1.x86_64.rpm

tnsnames.oraの作成

db02-v3 =
    (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = 10.107.60.133)(PORT = 1521))
        (CONNECT_DATA =
            (SERVER = DEDICATED)
            (SERVICE_NAME = mlfbiz.MLFSERV.j-parc.jp)
        )
    )

Oracleモジュールインストール

$ sudo rpm -ihv oracle-instantclient11.2-basic-11.2.0.4.0-1.x86_64.rpm
$ sudo rpm -ihv oracle-instantclient11.2-devel-11.2.0.4.0-1.x86_64.rpm
$ sudo rpm -ihv oracle-instantclient11.2-sqlplus-11.2.0.4.0-1.x86_64.rpm
$ sudo mkdir /usr/lib/oracle/11.2/client64/network/
$ sudo mkdir /usr/lib/oracle/11.2/client64/network/admin
$ sudo cp tnsnames.ora /usr/lib/oracle/11.2/client64/network/admin/

/etc/hostsの修正

修正前） 127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4

修正後） 127.0.0.1 localhost localhost.localdomain ホスト名 ホスト名.intra.j-parc.jp

Pythonライブラリのインストール

$ sudo yum install cmake
$ sudo pip install -–upgrade pip
$ sudo pip uninstall pycrypto
$ sudo yum erase python-crypto
$ sudo yum install pycrypto
$ sudo pip install cx_Oracle

Python3の場合

$ source /opt/rh/rh-python36/enable
$ sudo yum install cmake
$ sudo /opt/rh/rh-python36/root/usr/bin/pip3 install -–upgrade pip
$ sudo /opt/rh/rh-python36/root/usr/bin/pip3 uninstall pycrypto
$ sudo yum erase python-crypto
$ sudo yum install pycrypto
$ sudo /opt/rh/rh-python36/root/usr/bin/pip3 install cx_Oracle

暗号キーの作成とディレクトリ指定

公開鍵 public.pem および秘密鍵 private.pem を作成する。

$ cd /opt/mlfsoft/iroha2/iroha-settings/management/key/
$ ./keygen.sh

iroha-settings/management/database/setting.xml に暗号キーのディレクトリ情報を追加する。

<keyDir>/opt/mlfsoft/iroha2/iroha-settings/management/key</keyDir>

装置管理サーバーにおける入力インターフェースの使用方法

連携データーベース接続情報の設定

初期設定：Settings において連携データベースの接続情報を設定する。 設定する項目は以下の通りである（ Table 68 を参照）。

  • infoSrv

  • infoSrvUsr

  • infoSrvPass

取得課題IDリストから未登録のIROHA2アカウントを作成

  1. 装置管理サーバーにadminでログインし、 Theme 画面を開く。

  2. 実験年度を選択し、 Get Proposal No. and Title of Experiment ボタンを押下する。

  3. アカウントを作成する課題IDを選択し、 Create User ボタンを押下する。

  4. ユーザーが作成されると Users 画面に遷移し、課題IDと同じ名前のユーザーが作成される（パスワードはユーザー名と同じである）。

Alternative Text

Fig. 157 Theme画面における実験ユーザーアカウント作成

課題IDに紐づいた試料IDおよび試料名から複数を選択

  1. 新規作成した実験ユーザーアカウントで装置管理サーバーにログインする。

  2. 画面上部の Not Reserved ボタンを押下し、予約ユーザーとなる。 ホーム画面にプロポーザル番号（課題ID）と実験タイトルが表示される（Fig. 158）。

  3. Measurement 画面に移動する。

  4. 表示された試料の一覧から測定対象とする試料をチェックボックスで選択し、画面下部の Save ボタンを押下する（Fig. 159）。 試料の情報が database/measurement.xml に記録される。

  5. Home 画面に移動すると試料情報が表示されるようになる（Fig. 160）。

  6. 予約を解除すると試料情報はクリアされる。

Alternative Text

Fig. 158 ホーム画面における実験課題名の表示

Alternative Text

Fig. 159 測定画面における試料の選択

Alternative Text

Fig. 160 ホーム画面における試料情報の表示

統合制御サーバーにおける試料情報の入力インターフェースの使用方法

測定サマリーパネルで課題IDに紐づいた試料IDおよび試料名から複数を選択する。

  1. 装置管理サーバーに実験ユーザーアカウントでログインし、予約ユーザーになる。

  2. 統合制御サーバーを起動し、実験ユーザーアカウントでログインする。 サマリーパネルに実験IDとタイトルおよび装置管理サーバーで設定した試料の一覧が表示される。

  3. 測定対象とする試料をチェックボックスで選択し、試料一覧の右にある Applyボタン を押下する。 確認ダイアログで OK ボタンを押下すると装置管理サーバーに選択した試料の情報が送信される。

Alternative Text

Fig. 161 統合制御サーバーにおける試料の選択