WebOTX Manual V11.1 (第6版) 目次を表示

---

4. ダウンローダ管理コマンドによる運用

この章では、ダウンローダ管理コマンドの使用方法とコマンドリファレンスについて説明します。

4.1. ダウンローダ管理コマンドの使用方法

ダウンローダ管理コマンド(webapcmd)は、パラメータに既存のwtdファイルを使用するため、事前にダウンローダ管理ツールでwtdファイルを作成する必要があります。

コマンドの入力方法は直接パラメータを指定する方法と、複数のコマンドをCSV形式のテキストに記述し、そのファイル名をパラメータとして渡す方法があります。それぞれの入力方法は次のようになります。

menu,add,"C:\Dev\foobar.wtd","C:\Dev\Files\foobar.exe"
menu,add,"C:\Dev\foobar.wtd","C:\Dev\Files\foobar.dll"
filep,dest,"C:\Dev\foobar.wtd","%{tpcomclient}\foobar\"
exec,module,"C:\Dev\foobar.wtd","%{tpcomclient}\foobar.exe"
menu,vercheck,"C:\Dev\foobar.wtd"
menu,tran,"C:\Dev\foobar.wtd"

4.2. コマンドリファレンス

以下に、ダウンローダ管理コマンドのコマンドリファレンスを示します。

4.3. ダウンローダ環境移行コマンドについて

クライアントモジュールが他のサーバに配置されるなどして、ダウンローダの運用環境に変更が生じた場合、wtdファイルに記述されている情報も同時に変更する必要があります。
ダウンローダ環境移行コマンドは、wtdファイル内の移行前のダウンローダ環境の情報を、移行後の情報に変換することで、ダウンローダ環境の移行作業を支援します。

ダウンローダ管理ツールをインストールすると、環境移行コマンドは、同じディレクトリにインストールされます。

4.3.1. コマンドの書式

コマンドの書式、および引数の設定方法について、以下に示します。

既にWebサーバに登録済みのクライアント配布環境を、他Webサーバへ移行するには、環境移行コマンドを使用します。

  5：wtdファイルに対するアクセス権限がありません。
112：ディスクの空き容量が足りません。

4.3.2. 移行手順

次のような環境を例にして、移行作業の手順を説明します。

1. 運用中のwtdファイル"sample.wtd"を、移行元のWebサーバ(web.nec.com)から、ダウンローダ環境移行コマンドがインストールされたマシンへコピーします。

2. コピーされたwtdファイルのあるマシンでコマンドプロンプトを開き、ダウンローダ環境移行コマンドのインストールされているディレクトリへ移動します。

3. 以下のようにダウンローダ環境移行コマンドを実行し、wtdファイルを変換します。

   > wowtdgen -u web.nec.com,otx.nec.com -d /web/wtd,/otx/wtd -s ap1.nec.com:5202,ap2.nec.com:5202 C:\Work\wtd\sample.wtd

4.3.3. ログについて

本コマンドは、実行時の状況をコンソールに出力すると同時に、起動したwowtdgenコマンドと同じディレクトリに、wowtdgen.logの名称でログファイルを出力します。
更新されたwtdファイル名ほか、変更された項目などの情報を出力します。

[ログ出力]

WOWTDGEN 1.1.0.0 booting...
Wed Feb 03 15:39:23 2010
 System    = ap1.nec.com:5202,ap2.nec.com:5202  ← 移行元と移行先APサーバ
 URL       = web.nec.com,otx.nec.com            ← 移行元と移行先Webサーバ
 Directory = /web/wtd,/otx/wtd                  ← 移行元と移行先FTPディレクトリ
  C:\Development\wtd\sample-01.wtd succeed.     ← wtdファイルの変更結果
  C:\Development\wtd\sample-02.wtd succeed.
  C:\Development\wtd\sample-03.wtd succeed.
  C:\Development\wtd\sub1\sub1_sample-01.wtd succeed.
  C:\Development\wtd\sub1\sub1_sample-02.wtd succeed.
  C:\Development\wtd\sub1\sub1_sample-03.wtd succeed.
  C:\Development\wtd\sub2\sub2_sample-01.wtd succeed.
  C:\Development\wtd\sub2\sub2_sample-02.wtd succeed.
  C:\Development\wtd\sub2\sub2_sample-03.wtd succeed.
WOWTDGEN terminated.
Wed Feb 03 15:39:23 2010

4.3.4. エラーについて

実行中に異常を検出した場合、環境変数%ERRORLEVEL%に1を残し異常終了します。異常終了時は、移行前の状態へロールバックします。

エラーが発生した場合、コンソールおよびログファイルに、エラーとなったwtdファイル名、およびエラー原因をWindowsシステムエラーコード(括弧内)で出力します。
以下は、wtdファイルに対するアクセス権限がない(エラーコード=5)場合の出力例です。

[コンソール表示]

C:\Work\wtd\sample.wtd failed. C:\Work\wtd\sample.wtd(5)

[ログ出力]

WOWTDGEN 1.1.0.0 booting...
Thu Feb 04 16:54:38 2010
 System    = ap1.nec.com:5202,ap2.nec.com:5202
 URL       = web.nec.com,otx.nec.com
 Directory = /otx/wtd,/home/wtd
C:\Work\wtd\sample.wtd failed. C:\Work\wtd\sample.wtd(5)
WOWTDGEN terminated.
Thu Feb 04 16:54:38 2010