install script

作成したPythonスクリプトファイルを本装置にインストールします。常駐スクリプトおよびイベント起動スクリプトは，本コマンドでインストールしたスクリプトファイルを起動します。

インストールしたスクリプトファイルは/config/script/script.fileにコピーされます。スタック構成のときは，バックアップスイッチの同じディレクトリに同期します。

インストールできるスクリプトファイルの，ファイル数およびサイズの上限値は次のとおりです。

ファイル数：100ファイル
全ファイルの合計サイズ：4MB
1ファイルのサイズ：512KB

［入力形式］

install script {<file name> | sync | diff}

［入力モード］

装置管理者モード

［パラメータ］

{<file name> | sync | diff}

スクリプトファイルを指定，またはスクリプトファイルを対象とする操作を指定します。

<file name>

指定したスクリプトファイルをインストールします。ファイルパスとファイル名を指定してください。ファイルパスを省略すると，カレントディレクトリを参照します。

<file name>に指定できる最大文字数は，パスを含めて255文字です。そのうち，スクリプトファイルのファイル名に使用できる最大文字数は，拡張子を含めて99文字です。

スクリプトファイルのファイル名には，英数字とドット（.），ハイフン（-），アンダースコア（_），チルダ（~），ハット（^）を使用できます。

指定できるスクリプトファイルの拡張子は「.py」「.pyc」「.pyo」のどれかです。

インストール済みのスクリプトファイルと拡張子だけが異なるスクリプトファイルはインストールできません。

（例）"test.py"がインストール済みのときは，"test.pyc"や"test.pyo"をインストールできません。

sync

インストールされているすべてのスクリプトファイルを，マスタスイッチに合わせてほかのメンバスイッチへ同期します。マスタスイッチにインストールされていないスクリプトファイルは，ほかのメンバスイッチから削除されます。ファイルの内容が一致しない場合は，マスタスイッチの内容で上書きします。

diff

マスタスイッチとほかのメンバスイッチにインストールされているスクリプトファイルに対し，インストール数や内容を比較して差分の有無を表示します。比較対象となるメンバスイッチがない場合や，すべて一致している場合は，何も表示しません。

［スタック構成時の運用］

マスタスイッチからほかのメンバスイッチへ自動でスクリプトファイルのインストールを同期します。syncパラメータおよびdiffパラメータが実行できます。

［実行例］

図19‒4　カレントディレクトリにあるスクリプトファイル（testscript.py）を本装置にインストール
# install script testscript.py #

図19‒5　インストールされているスクリプトファイルを同期
# install script sync Do you want to synchronize all script files? (y/n): y #

図19‒6　スクリプトファイルの差分を確認
# install script diff Some script files differ. #

［表示説明］

なし

［通信への影響］

なし

［応答メッセージ］

表19‒4　install scriptコマンドの応答メッセージ一覧
メッセージ	内容
Can't execute this command in backup switch or transit switch.	バックアップスイッチまたはトランジットスイッチではコマンドを実行できません。
Can't execute.	コマンドを実行できません。再実行してください。
Permission denied. (file name = <file name>)	指定したスクリプトファイルの読み込み権限がありません。 <file name>：スクリプトファイル名
Some script files differ.	インストールされているスクリプトファイルに差分があります。install script syncコマンドを実行して同期してください。
The command cannot be executed because stack is not active.	スタック構成で運用していないため実行できません。
The command cannot be executed because the software versions do not match.	ソフトウェアバージョンが不一致のため実行できません。
The command cannot be executed because you are in user mode.	このコマンドは一般ユーザモードでは実行できません。
The number of script files exceeds the maximum.	スクリプトファイルのファイル数が上限値を超えています。
The script file exceeds the maximum size.	スクリプトファイルのサイズが上限値を超えています。
The script file name exceeds the maximum length.	スクリプトファイル名の長さが上限値を超えています。
The specified script file already exists.	指定したスクリプトファイルはすでにインストールされています。スクリプトファイルを変更したい場合は，削除してから再インストールしてください。
The specified script file does not exist. (file name = <file name>)	指定したスクリプトファイルが存在しません。 <file name>：スクリプトファイル名
The total size of the script files exceeds the maximum.	スクリプトファイルの合計サイズが上限値を超えています。

［注意事項］

すでにインストールされているスクリプトファイルは上書きできません。スクリプトファイルを変更したい場合は，削除してから再インストールしてください。
スタック構成時は，スクリプトファイルの同期に時間が掛かります。
スタック構成時にマスタスイッチとほかのメンバスイッチのソフトウェアバージョンが不一致の場合は，syncパラメータおよびdiffパラメータは実行できません。