SolarSoftのメンテナンス@花山天文台

5. $SSW/site/setup/setup.ssw : サイト固有の環境変数設定スクリプト

SSWデフォルトの環境変数を上書きする際などに用いるcshスクリプト。

6. $SSW/site/setup/setup.<INSTR>_paths, <観測装置のディレクトリ>/setup/setup.<INSTR>, <観測装置のディレクトリ>/setup/setup.<INSTR>_env, $SSW/site/setup/setup.<INSTR>, $SSW/site/setup/setup.<INSTR>_env, ~/setup.<INSTR>, ~/setup.<INSTR>_env: 観測装置ごとの環境変数設定ファイル・スクリプト

<INSTR> は sxt, sot 等の観測装置・パッケージ名。$SSW_INSTR で指定された観測装置・パッケージのみ、その装置・パッケージの設定ファイルが処理される。各ディレクトリの setup.<INSTR>_env は、setup.<INSTR> が存在しない場合のみ読み込まれる。

$SSW/site/setup/setup.<INSTR>_paths は setenv_list2 で処理される設定ファイル。その他のファイルはcshスクリプト。

$SSW_INSTR に gen が含まれていない場合、$SSW_INSTR の先頭に gen が挿入される。

7. その他のスクリプト

最後に、$SSW/gen/setup/setup.ssw_device, $SSW/site/setup/setup.ssw_device, ~/setup.ssw_device (プリンタ・テープドライブ等のデバイスの設定スクリプト。花山では未使用), $SSW/gen/setup/setup.ssw_alias, $SSW/site/setup/setup.ssw_alias, ~/setup.ssw_alias (エイリアスの設定スクリプト)の各cshスクリプトが処理される。

sswidl ($SSW/gen/setup/ssw_idl) を実行したときに読み込まれるファイル (読み込まれる順に記載)

sswidlde ($SSW/gen/setup/ssw_idl/ssw_idlde) の場合も同様。

$SSW_INSTR に hidaを追加しないこと。もし追加した状態でアップデートを実行すると、$SSW/optical/hidaが削除されてしまう。

2. $SSW/site/setup/setup.sswdb_upgrade : SSWDBアップデート対象を指定

go_update_ssw.pro, sswdb_upgrade.pro による更新対象とするデータベースを指定する。親子関係にあるデータベースを両方とも指定すると、ファイルのダウンロードが複数回行われてネットワーク帯域と時間の無駄なので、どちらか一方のみ指定する。(例: soho/gen と soho/gen/spice の両方を指定すると、soho/gen/spice 以下のファイルは2回ダウンロードされるので、soho/gen のみを指定する)

デフォルトでは存在しないので $SSW/site/setup/setup.sswdb_upgrade_template をコピーして編集するか、SolarSoft Data Base (SSWDB) Configuration Form で作成することができる。

その他

1. $SSW/site/setup/ssw_site.config : インストール時に用いられた config ファイル

インストール時の設定が記載されている。インストール完了後は不要。

2. $SSW/site/setup/setup.ssw_env : サイト固有の環境変数設定ファイル

現在、Unix系OSでは原則として利用されない。Windows上でのSolarSoft起動時 ($SSW/gen/idl/ssw_system/IDL_STARTUP_WINDOWS.pro->ssw_setup_windows.pro)のみ利用されるように見える。set_logenv (またはfile_setenv)により処理されるためSETENV 以外の行は無視される。

3. $SSW/optical/hida/* : 飛騨のデータ解析用プログラム

飛騨の共通解析用ツールを置く。現在はメンテナンスされていないので、利用する際は要注意。

2. 起動用スクリプト

ユーザーの利便性のため、SSW 起動用スクリプト SSWidl と IDLDE(開発環境)版のSSW 起動用スクリプト SSWidlde を用意している。各マシンの /opt/bin に置く。歴史的経緯とユーザーの利便性のため、sswidl と idlh コマンドで SSWidl が、sswidlde コマンドで SSWidlde が起動される。

SSWidlの中身は以下のようになっている。

#!/bin/csh

if (! $?IDL_DIR)   setenv IDL_DIR   /opt/idl/idl
if (! -x "$IDL_DIR/bin/idl") then
        echo incorrect value for IDL_DIR environment variable.
        exit
endif

if (! $?SSW)       setenv SSW   /opt/ssw
if (! -f "$SSW/gen/setup/setup.ssw") then
        echo incorrect value for SSW environment variable.
        exit
endif

if (! $?SSW_INSTR) then
        setenv SSW_INSTR "aia hmi sot xrt eis iris secchi lasco eit hessi xray spex chianti"
endif

source $SSW/gen/setup/setup.ssw

onintr -
sswidl $argv[*]

SSWidldeの中身は以下のようになっている。

#!/bin/csh

if (! $?IDL_DIR)   setenv IDL_DIR   /opt/idl/idl
if (! -x "$IDL_DIR/bin/idlde") then
	echo incorrect value for IDL_DIR environment variable.
	exit
endif

if (! $?SSW)       setenv SSW   /opt/ssw
if (! -f "$SSW/gen/setup/setup.ssw") then
	echo incorrect value for SSW environment variable.
	exit
endif

if (! $?SSW_INSTR) then
	setenv SSW_INSTR "aia hmi sot xrt eis iris secchi lasco eit hessi xray spex chianti"
endif

source $SSW/gen/setup/setup.ssw

onintr -
$SSW/gen/setup/ssw_idlde $argv[*] &
set pid=$!
wait
set temp_startup=~/ssw_idlde.$pid
if (-e $temp_startup) rm -f $temp_startup

$IDL_DIR 環境変数を起動スクリプト中で設定していることに注意。

sswidl を起動する直前で onintr - としているのは、ユーザーがSSW使用中に Ctrl + C を押下すると、ユーザーがログアウトした後もIDLのプロセスがバックグラウンドで残り続けてライセンスを浪費するという現象が発生していたため。(Ctrl + C で idl の親プロセスの SSWidl が終了した結果、孤児になりバックグラウンドで実行中のidlに対しては、ログアウト・回線切断時にも SIGHUP が送出されない)

特定のバージョンのIDL上でSSWを起動する SSWidl85 (IDL 8.5を利用)～SSWidl90 (IDL 9.0を利用)、SSWidlde85～SSWidlde90 などもある。

/opt/etc/profile.d/idl.sh, /opt/etc/profile.d/idl.csh でIDLの一般的な環境設定を行っている。例えば、IDLが用いるスレッド数(IDL_CPU_TPOOL_NTHREADS)を各マシンのNUMAノードごとの物理コア数に設定している。

3. SSW, SSWDB をまとめて update

2019年8月からアップデートにFTPを使えなくなったので、それ以降一度もSSWのアップデートを行っていない場合には、以下の操作を行う前にあらかじめ SSWのダウンロードページからアップグレード用スクリプトをダウンロードし実行することで、ssw_upgrade.pro 等をwget対応版に更新しておく必要がある。

以下のファイルでアップデート対象を指定する。

$SSW/site/setup/setup.ssw_upgrade : SSWアップデート対象を指定

$SSW/site/setup/setup.sswdb_upgrade : SSWDBアップデート対象を指定

IDLで以下のコマンドを実行する。

IDL> .run go_update_ssw

go_update_ssw は、setup.ssw_upgrade を読み込み SSW_INSTR 環境変数をセットした上で、ssw_upgrade.pro と sswdb_upgrade.pro を呼び出している。

ssw_upgrade.pro を直接実行した場合には、実行の時点での SSW_INSTR 環境変数の値が使われる。(setup.ssw_upgrade は参照されない)

パーミッションが 444 (書き込み保護)などのファイルや、更新日時が未来となっているファイルがあると、当該ファイルは以後更新されない場合があるので修正しておく。また、他のユーザーが読み込み不可、または書き込み可能となっているファイル・ディレクトリがあれば、ついでにパーミッションを修正しておく。

現在のssw_upgrade.pro では、シンボリックリンクは考慮されくなったため、アップデート前にローカルのシンボリックリンクは削除しておくほうが安全かもしれない。latestfile -> oldfile.dat というシンボリックリンクがサーバー・ローカルの両方にあったとして、サーバー側のシンボリックリンクが latestfile -> newfile.dat と変更された場合、ローカルでは oldfile.dat の内容が newfile.dat の内容に置き替わってしまう可能性がある。(具体例としては $SSW/stereo/gen/data/spice/other/bc_mpo_fcp_latest.bsp)

SSW treeの外を指しているシンボリックリンク (例: $SSW/soho/gen/data/attitude/nominal_roll_attitude.dat -> ../../../../../soho/public/data/ancillary/attitude/roll/nominal_roll_attitude.dat) は削除しておく。リンク切れの無効なシンボリックリンクは find $SSW -xtype l で探すことができる。

cron で自動的に実行する

$SSW/gen/bin/ssw_batch go_update_ssw $SSW/site/logs/update_ssw.log

4. SSW の手動 update

IDL でパラメータなしで
IDL> ssw_upgrade,/spawn
を実行すれば SSW_INSTR 環境変数で指定された観測装置・パッケージのファイルをアップデートしてくれる。(setup.ssw_upgrade は参照されない)