実験ステータス情報の公開
==========================

.. contents:: 目次:
    :depth: 3

統合制御サーバーおよびシーケンス管理サーバーは画面を静的HTMLとして出力することが可能である。
それらをステータス収集システムに登録することで、Webサイト上で実験ステータスを公開することができる。

* 内部公開：http://mlf-intra.j-parc.jp/expStatus/status.html
* 外部公開：https://mlfexpdb.j-parc.jp

各サーバーでの設定方法およびステータス収集システムへの登録について説明する。

.. note::
    シーケンス管理サーバーの実験ステータス公開するには、前提条件として統合制御サーバーを公開する必要がある。

統合制御サーバーの設定
#####################################

.. _intsrv_system_sec:

システム設定
*************************************

adminとしてログインして設定を行う。

メニューから :guilabel:`Settings` 画面へ移動し、:guilabel:`System` タブを選択する。
設定項目のうち、 :numref:`intsrv_system` の赤枠で囲まれた項目（ :numref:`intsrv_system_items` ）を設定する。

.. figure:: images/expstatus/intsrv_system.jpg
    :scale: 40
    :alt: Alternative Text
    :name: intsrv_system

    統合制御サーバーのシステム設定

.. csv-table:: 統合制御サーバーの静的HTML出力に関するシステム設定項目
   :header-rows: 1
   :widths: 8, 25, 67
   :name: intsrv_system_items

   項番, 項目名, 説明
   1, Static HTML Output, 静的HTMLの出力機能を有効にするかどうかを切り替える。**この設定を有効にしただけでは静的HTMLは出力されない。** :ref:`intsrv_user_sec` を参照のこと。
   2, Static HTML Output Directory, 静的HTMLを出力するディレクトリを指定する。
   3, Status Base URL, 外部公開サイトのベースURLを指定する。
   4, Server Name of Static HTML, 静的HTMLのステータスバーのBrandリンクに表示するサーバー名（未指定時はServer Nameを使用する）。
   5, Maximum Page Number of Device Log, 静的HTMLにおいて書き出されるデバイスログの最大ページ数を指定する（未指定時は可能な限り出力する）。
   6, Shortest Output Interval (sec), 静的HTMLの出力インターバルの最小値を指定する。ユーザーはこの値以下の出力インターバルを指定できない。

.. _intsrv_user_sec:

ユーザー設定
*************************************

装置管理サーバーを予約しているユーザーとしてログインして設定を行う。

メニューから :guilabel:`Settings` 画面へ移動し、 :guilabel:`User Access` タブを選択する。
設定項目のうち、 :numref:`intsrv_user` の赤枠で囲まれた項目（ :numref:`intsrv_user_items` ）を設定する。

.. figure:: images/expstatus/intsrv_user.jpg
    :scale: 40
    :alt: Alternative Text
    :name: intsrv_user

    統合制御サーバーのユーザーアクセス設定

.. csv-table:: 統合制御サーバーの静的HTML出力に関するシステム設定項目
    :header-rows: 1
    :widths: 8, 25, 67
    :name: intsrv_user_items
 
    項番, 項目名, 説明
    1, Experimant (Theme id), 実験課題番号を指定する。 :ref:`intsrv_system_sec` において設定したHTML Output Directory下にこの名前のディレクトリが作成され、静的HTMLがそこに出力される。この項目が未入力の場合は静的HTMLの出力ができない。また、装置管理サーバーで実験課題番号を設定している場合、この入力欄はReadonlyとなる。
    2, Static HTML Output, ユーザーが装置管理サーバーを予約している場合に静的HTMLを出力するかどうかを指定する。 :ref:`intsrv_system_sec` においてStatic HTML Outputの設定がOffの場合、ユーザー設定に関わらず静的HTMLは出力されない。
    3, Output Interval (sec), 静的HTMLを出力するインターバルを指定する。 :ref:`intsrv_system_sec` における最小インターバル値未満の場合、その値で動作する。

シーケンス管理サーバーの設定
#####################################

.. _seqsrv_system_sec:

システム設定
*************************************

adminとしてログインして設定を行う。

メニューから :guilabel:`System Settings` 画面へ移動し、 :guilabel:`System` タブを選択する。
設定項目のうち、 :numref:`seqsrv_system` の赤枠で囲まれた項目（ :numref:`seqsrv_system_items` ）を設定する。

.. figure:: images/expstatus/seqsrv_system.jpg
    :scale: 40
    :alt: Alternative Text
    :name: seqsrv_system

    シーケンス管理サーバーのシステム設定

.. csv-table:: シーケンス管理サーバーの静的HTML出力に関するシステム設定項目
   :header-rows: 1
   :widths: 8, 25, 67
   :name: seqsrv_system_items

   項番, 項目名, 説明
   1, Static HTML Output, 静的HTMLの出力機能を有効にするかどうかを切り替える。**この設定を有効にしただけでは静的HTMLは出力されない。** :ref:`seqsrv_user_sec` を参照のこと。
   2, Static HTML Output Directory, 静的HTMLを出力するディレクトリを指定する。 **統合制御サーバーと同じディレクトリを指定する必要がある。**
   3, Server Name of Static HTML, 静的HTMLのステータスバーのBrandリンクに表示するサーバー名（未指定時はServer Nameを使用する）。
   4, Shortest Output Interval (sec), 静的HTMLの出力インターバルの最小値を指定する。ユーザーはこの値以下の出力インターバルを指定できない。

.. _seqsrv_user_sec:

ユーザー設定
*************************************

装置管理サーバーを予約しているユーザーとしてログインして設定を行う。

メニューから :guilabel:`System Settings` 画面へ移動し、 :guilabel:`User Access` タブを選択する。
設定項目のうち、 :numref:`seqsrv_user` の赤枠で囲まれた項目（ :numref:`seqsrv_user_items` ）を設定する。


.. figure:: images/expstatus/seqsrv_user.jpg
    :scale: 40
    :alt: Alternative Text
    :name: seqsrv_user

    シーケンス管理サーバーのユーザーアクセス設定

.. csv-table:: シーケンス管理サーバーの静的HTML出力に関するシステム設定項目
    :header-rows: 1
    :widths: 8, 25, 67
    :name: seqsrv_user_items
 
    項番, 項目名, 説明
    1, Experimant (Theme id), 実験課題番号を指定する。 :ref:`seqsrv_system_sec` において設定したHTML Output Directory下にこの名前のディレクトリが作成され、静的HTMLがそこに出力される。この項目が未入力の場合は静的HTMLの出力ができない。また、装置管理サーバーで実験課題番号を設定している場合、この入力欄はReadonlyとなる。
    2, Static HTML Output, ユーザーが装置管理サーバーを予約している場合に静的HTMLを出力するかどうかを指定する。 :ref:`seqsrv_system_sec` においてStatic HTML Outputの設定がOffの場合、ユーザー設定に関わらず静的HTMLは出力されない。
    3, Output Interval (sec), 静的HTMLを出力するインターバルを指定する。 :ref:`seqsrv_system_sec` における最小インターバル値未満の場合、その値で動作する。

ステータス収集システムへの登録
#####################################

ステータス収集システムでは各実験装置の計算機から実験ステータス情報を収集し、Webサイトで公開している。
収集している情報はDAQシステムの情報とIROHA2の静的HTMLである。

ステータス収集システムへ登録はシステム管理者が行うため、各実験装置の担当者は必要な情報をシステム管理者へ伝えて登録を依頼する。

.. csv-table:: システム登録に必要な情報（DAQシステム）
    :header-rows: 1
    :widths: 10, 90
    :name: regist_info_daq

    項番, 項目
    1, 計算機のIPアドレス
    2, DAQ-MWバージョン

.. csv-table:: システム登録に必要な情報（統合制御サーバーおよびシーケンス管理サーバー）
    :header-rows: 1
    :widths: 10, 90
    :name: regist_info_iroha2

    項番, 項目
    1, 計算機のIPアドレス
    2, 静的HTMLの出力ディレクトリ
    3, 静的HTMLの出力ディレクトリにアクセスできるユーザー名（ssh公開鍵の登録が必要）
    4, 実験課題番号（シーケンス管理サーバーも公開する場合に必要）

以下のひな型に必要事項を記入してシステム担当者にメールを送る。

.. code-block::

    DAQシステム
      計算機のIPアドレス:
      DAQ-MWバージョン: v1l5/v1l6/v2009
    IROHA2
      計算機のIPアドレス:
      静的HTMLの出力ディレクトリ:
      ユーザー名:
      実験課題番号:


システム担当者
*************************************

* 長谷美 宏幸（共通技術開発セクション）
* E-mail: hiroyuki.hasemi@j-parc.jp
* 内線: 3158


外部公開サイトのユーザーアカウント
#####################################

外部公開サイトにアクセスするためにはMLF統合認証システムのユーザーアカウントを取得する必要がある。

以下のひな型に必要事項を記入して担当者にメールを送る。

.. code-block::

    氏名（漢字、ローマ字）:
    JLANニモニック（お持ちの方）:
    メールアドレス(JLAN・JAEA・KEK・CROSS):
    所属（セクション、実験装置）:
    連絡先（PHSまたは内線）:

担当者
*************************************

* 共通技術開発セクション 計算環境チーム
* E-mail：mlf-ce-mgr@ml.j-parc.jp