ユーザアプリケーションによるネットワークドライブへの接続･切断･アクセス失敗への対応

Windowsサーバにおける、WebOTX上で動作するアプリケーションがネットワークドライブにアクセスできるようにするための設定方法を説明します。この設定にはWebOTXのスクリプトマネージャ機能を使用します。スクリプトマネージャ機能自体の詳細な使用方法については、[ ドメイン構築・基本設定ガイド > 3. ドメイン > 3.14. ドメイン起動時/停止時スクリプト設定方法 (スクリプトマネージャ機能) ] を参照してください。

スクリプトファイルへの記述方法

スクリプトマネージャ機能はスクリプトファイル(bat)を作成し、ドメイン起動時と停止時にそれらを実行します。ネットワークドライブを使う場合、ドメインの起動時に実行するスクリプトに接続処理を、ドメインの停止時に実行するスクリプトに切断処理を記述します。

以下にネットワークドライブの接続･切断処理を以下に記載します。

ネットワークドライブの接続処理
net useコマンドを用いて、起動時実行スクリプトとして指定するスクリプトファイルに対して以下のように記述します。停止時実行スクリプトへのネットワークドライブの切断処理と必ずセットで記述するようにしてください。
```
net use [デバイス名|*] [\\コンピュータ名\共有名[\ボリューム名]] [パスワード] [/user:コンピュータ名\ユーザー名]
```

ネットワークドライブの切断処理
net useコマンドを用いて、停止時実行スクリプトとして指定するスクリプトファイルに対して以下のように記述します。起動時実行スクリプトへのネットワークドライブへの接続処理と必ずセットで記述するようにしてください。
```
net use [デバイス名|*]: /delete
```

接続情報の出力処理
ネットワークドライブの接続状態をチェックするためにnet useコマンドを用いて、接続情報をファイル出力する方法を説明します。起動時・停止時実行スクリプトとして指定するスクリプトファイルに記述すれば、接続前後または切断前後の接続情報を出力して、接続状況を確認することができます。接続情報を出力したい箇所に以下を記述します。
```
net use > [ドライブ名]:\[情報を出力するファイル名]
```

起動時実行スクリプト記述例

以下の例のようなbatファイルを作成して、起動時･停止時実行スクリプトファイルとしてスクリプトマネージャ機能で使用する。

起動時実行スクリプト記述例

　domainstart_script.bat

rem ServerAマシン の共有フォルダ share を Z: ドライブとして接続。認証情報が必要な場合はコメントアウトする
net use Z: \\ServerA\share

rem 認証情報を使用する場合に有効にする。認証情報が不要な場合はコメントアウトする
rem net use Z: \\ServerA\share password /user:compname1\username1


rem 認証情報を使用し、ドライブレターとして Y: を指定しない場合はコメントアウトする
rem net use Y: \\ServerA\share password /user:compname1\username1


rem 接続した Z: ドライブにconnectinfo.logを作成し接続情報を出力。使用するドライブレターによってコメントアウトする
net use > Z:\connectinfo.log

rem 接続した Y: ドライブにconnectinfo.logを作成し接続情報を出力。使用するドライブレターによってコメントアウトする
rem net use > Y:\connectinfo.log

停止時実行スクリプト記述例

　domainstop_script.bat

rem 接続中のネットワークドライブ Z: ドライブ を切断。使用するドライブレターによってコメントアウトする
net use Z: /delete

rem 接続中のネットワークドライブ Y: ドライブ を切断する場合に有効にする。使用するドライブレターによってコメントアウトする
rem net use Y: /delete

スクリプトファイル実行失敗時のドメイン起動処理継続の指定方法

スクリプトマネージャ機能では、スクリプトファイルの実行に失敗した際にドメイン起動を継続するかどうかを選択可能です。運用管理ツールで選択する場合、設定対象のドメインを選択し[設定項目(Configurations)]－[起動時実行スクリプト失敗時処理]で「ドメインの起動継続」(既定値)を選択します。

また、運用管理コマンドを用いる場合は以下のコマンドを実行します。

ドメインの起動継続を指定する場合

otxadmin > login --user <管理ドメインのユーザ名> ---password <管理ドメインのパスワード> --port <管理ドメインのポート番号>
otxadmin > set domain.start-script-on-failure=continue

ドメインの停止を指定する場合

otxadmin > login --user <管理ドメインのユーザ名> ---password <管理ドメインのパスワード> --port <管理ドメインのポート番号>
otxadmin >set domain.start-script-on-failure=stop

接続や切断、アクセスに失敗する場合のチェックポイント

接続や切断、ネットワークドライブへのアクセスに失敗する場合は、以下の点を確認してください。

既に使用されているドライブレターを指定した場合
起動時実行スクリプトへnet useコマンドを記述する際に、既にそのサーバマシンで使用しているドライブレターを指定してしまっている場合は接続に失敗します。使用していないドライブレターを指定してください
接続先のパスや接続ユーザ名やパスワードに誤りがある場合
起動時実行スクリプトへnet useコマンドを記述する際に、接続先のパスや接続ユーザ名やパスワードに誤りがある場合は接続に失敗します。指定が正しいか確認してください。
ネットワークが不正な場合
ネットワーク障害やネットワーク設定が不適切など、ネットワークが不正な状態になっている場合はネットワークドライブへの接続や切断に失敗します。接続・切断対象のネットワークドライブがネットワーク上正しく認識できているか確認してください。
ネットワークドライブへのアクセス権限を満たしていない場合
ネットワークドライブで共有やセキュリティのアクセスを制限している場合、WebOTX上のアプリケーションもこのアクセス制限が適用されます。ネットワークドライブのフォルダのプロパティなどを確認し、アクセス制限が適切に設定されているか確認してください。WebOTX上のアプリケーションは"WebOTX AS Agent Service"サービスのログオンで指定したユーザで実行されます。
スクリプトマネージャ機能以外で接続処理を行った場合
起動･停止時スクリプトを用いた、スクリプトマネージャ機能によるネットワークドライブ接続処理を行わなかった場合、WebOTXからそのドライブにアクセスできないことがあります。WebOTXからアクセスしたい場合は必ずスクリプトマネージャ機能で接続･切断を行ってください。
他のドメインから切断されてしまっている場合
ドメインの起動･停止に合わせて起動時･停止時スクリプトが実行されることを利用してネットワークドライブの接続･切断を行うため、管理ドメインで接続･切断する場合とユーザドメインで接続･切断する場合でアクセス可能な区間が異なります。管理ドメインで接続･切断をする場合は常に接続した状態となりますが、ユーザドメインで接続･切断する場合はそのユーザドメインの起動～停止までがアクセス可能な区間となります。また、ネットワークドライブはWebOTX上の全プロセスで共有可能であるため、特定のユーザドメインで切断を行うと他のユーザドメインに属するプロセスからもアクセスができない状況が起こります。複数ドメインからアクセスする場合、管理ドメインで接続･切断するように設定してください。
ユーザアプリケーションに削除権限がない場合
ユーザアプリケーションからネットワークドライブ上のファイルやディレクトリの削除を行うためにはユーザアプリケーションへの削除権限の付与が必要です。
具体的には ${com.nec.webotx.instanceRoot}/config/server.policy の for User Applications部分へ以下のように記述します。
セキュリティ例外の詳細については [ トラブルシューティングガイド > 2.障害解析 > 2.5. 機能別リンク > 2.5.12. Webコンテナ > セキュリティ例外が発生する場合の対処] を参照してください。
なお、削除権限の付与であるため、パス指定など誤らないように十分に注意が必要です。

例）Zドライブにネットワークドライブを割り当て、配下のtempフォルダにあるすべてのファイルを削除可能とする場合
```
// for User Applications
grant codeBase "file:${com.nec.webotx.instanceRoot}/applications/-" {
    permission java.util.logging.LoggingPermission "control", "";
    permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
    permission java.io.FilePermission "Z:\\temp\\*", "delete"; //ユーザアプリケーションへの削除権限付与
};		
```