- HULFT7 利用概説 - Windows編

2012/01/16

ﾍﾟｰｼﾞ：
1

HULFT7
HULFT7

利用概説書
Windows編
Windows編（HULFT7 Windows 教育資料より抜粋）

INDEX

1.

ページ

転送処理フロー
転送処理フロー・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・

1.1. HULFTの動作中-待機状態
1.2. 配信処理概要
1.3. 集信処理概要

2.

設定情報一覧

2
2
3
・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・

2.1. 主な設定情報
2.2. 通信相手と調整することが必要な情報
2.3. 配信管理情報の関係図
2.4. 集信管理情報の関係図

3.

コマンドラインによるコマンドラインによる配信要求
による配信要求

4.

誤変換

5.

ジョブ連携
ジョブ連携

6.

順番を順番を保った転送
った転送

7.

HULFTサービス
HULFTサービスのサービスのアカウント

2

4
4
4
5
5

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・

6

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・

7

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・

8

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・

9

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・

11© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

1.

2012/01/16

ﾍﾟｰｼﾞ：
2

転送処理フロー
転送処理フロー
1.1. HULFTの動作中-待機状態
HULFTサービスは、配信プロセス、集信プロセス、要求受付プロセス、HULFTサービスの4種で構成されています。

HULFTプロセス群の解説
プロセス名
HULFT上の名前
hulsrvc.exe
HULFTサービス
hulsdd.exe
配信プロセスhulrcv.exe
集信プロセスhulobs.exe
要求受付プロセス

役割
他の常駐プロセスを監督
データを送信するプロセス
データを受信するプロセス
他サーバからのHULFT制御情報を受け付けるプロセス

使用するポートなし
配信する毎に(OSから)動的に設定される。
(デフォルト)30000/TCPを使用する。
(デフォルト)31000/TCPを使用する。

© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

2012/01/16

ﾍﾟｰｼﾞ：
3

1.2. 配信処理概要
以下において、HULFTユーティリティ:utlsendによる配信要求(FTPでいうPUT)による配信処理の流れ(概略)を図示します。
HULFT7 Windows hostname=winsv01

HULFT7 Windows

hostname=

winsv02

utlsend.exe -f X1234567
X1234567 の条件で配信要求
hulsdd.exe

配信管理情報:FILEID= X1234567
ファイル名:C:\test\put.txt
転送グループ情報:ATESAKIATESAKI

転送グループ情報:ID=ATESAKIATESAKI
winsv02
ホスト名:winsv02

詳細ホスト情報 ID=winsv02
winsv02
ホスト種:WIN
漢字コード種:S-JIS

管理情報の解説
管理情報の種別
配信管理情報集信管理情報転送グループ情報
詳細ホスト情報

hulrcv.exe

C:\test\put.txt

集信管理情報:FILEID= X1234567
ファイル名:C:\tmp\rcv.dat

C:\tmp\rcv.dat

ip_addr

詳細ホスト情報 ID=winsv01
winsv01
ホスト種:WIN
漢字コード種:S-JIS

winsv02
名前解決

hosts

凡例
設定内容
ファイル名、宛先など配信処理の条件を設定します。
ファイル名、上書きor追記など集信処理の条件を設定します。
HULFTは、同時に複数の宛先に配信可能です。宛先が1件でも転送グループに設定します。

処理の流れ
ファイル転送の流れ
HULFT管理情報
プロセス

紫赤青
緑

:自ホスト名:通信相手ホスト名:集配信管理情報ファイルID:転送グループ情報

通信相手のホスト名とその属性を設定します。
(HULFTは、IPはなく、ホスト名により通信相手の属性を管理します。)© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

2012/01/16

ﾍﾟｰｼﾞ：
4

1.3. 集信処理概要
以下において、HULFTユーティリティ:utlrecvによる送信要求(FTPでいうGET)による集信処理の流れ(概略)を図示します。
HULFT7 Windows hostname=HULFT7 Windows

winsv01

utlrecv.exe -f Z000000

ip_addrwinsv02

hulobs.exe

Z00000 の送信要求

winsv02
名前解決hostname=Z00000 の配信要求

hosts
集信管理情報:FILEID= Z000000
ファイル名:C:\test\get.dat
転送グループ情報:ATESAKIATESAKI

転送グループ情報:ID=ATESAKIATESAKI
winsv02
ホスト名:winsv02

詳細ホスト情報 ID=winsv02
winsv02
ホスト種:WIN
漢字コード種:S-JIS

hulrcv.exe

C:\test\get.dat
集信管理情報:FILEID= Z000000
ファイル名:C:\test\get.dat

hulsdd.exe

D:\tmp\snd.dat

配信管理情報:FILEID= Z0000000
ファイル名:D:\tmp\snd.dat
転送グループ情報:ATESAKI2ATESAKI2

転送グループ情報:ID=ATESAKI2ATESAKI2
ホスト名:winsv01
winsv01

詳細ホスト情報 ID=winsv01
winsv01
ホスト種:WIN
漢字コード種:S-JIS© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

2.

2012/01/16

ﾍﾟｰｼﾞ：
5

設定情報一覧
2.1. 主な設定情報
主な設定情報設定情報の名前
配信管理情報

設定内容
転送するファイル名、宛先等、各配信個別の設定となります。

集信管理情報

出力先ファイル名、上書きor追加書き等、各集信個別の設定となります。

ジョブ起動情報

配信前または集配信後に起動したいコマンド/スクリプトを登録します。

詳細ホスト情報

通信相手の通信相手 の プラットフォーム(
プラットフォーム ( OS種別
OS 種別)
種別 ) 、 漢字コード
漢字 コード等を登録します。本設定に誤りがあると誤変換を引き起こします。
コード

転送グループ情報

HULFTは、同時に複数の宛先に配信可能です。宛先が1件でも転送グループに設定します。

システム動作環境設定

上記設定情報は、各転送個別の設定です。本設定は、1システムのHULFT全体的な設定となります。

2.2. 通信相手と調整することが必要な情報
基本的な転送において、通信相手と交換する情報
区分

設定情報の名前
配信管理情報ファイルID

調整内容
通信相手と合意
合意

設定内容
通信相手側の集信管理情報ファイルIDと統一します。

HULFT管理情報

集信管理情報ファイルID

通信相手と合意合意

通信相手側の配信管理情報ファイルIDと統一します。

OS関連

通信相手のプラットフォーム(OS種別)

通信相手の情報取得

詳細ホスト情報に[OSの種別]を設定する箇所があります。

OS関連

ホスト名(クラスタ 仮想ホスト名)

通信相手の情報取得

自ホスト側の詳細ホスト情報、hostsに登録します。

OS関連

IPアドレス(クラスタ 仮想IP)

通信相手の情報取得

hostsに登録します。

データの属性漢字コード種通信相手の情報取得

自ホスト側の詳細ホスト情報に登録します。

HULFT管理情報© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

2012/01/16

ﾍﾟｰｼﾞ：
6

2.3. 配信管理情報の関係図※ 数字は、新規登録する場合の順番です。
① 詳細ホスト情報

ID=通信相手のホスト名

・通信相手の漢字コード種を登録② 転送グループ情報

ID=転送グループID③ ジョブ起動情報

ID=ジョブID③ ジョブ起動情報

ID=ジョブID

・通信相手のホスト名を登録④ 配信管理情報

ID=ファイルID

・ 配信宛先・ ジョブ連携(ジョブ連携時のみ指定)

2.4. 集信管理情報の関係図※ 数字は、新規登録する場合の順番です。
① 詳細ホスト情報

ID=通信相手のホスト名・通信相手の漢字コード種を登録② 転送グループ情報

ID=転送グループID

・通信相手のホスト名を登録④ 集信管理情報

ID=ファイルID・ 通信相手(送信要求時指定)・ ジョブ連携(ジョブ連携時のみ指定)© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

3.

2012/01/16

ﾍﾟｰｼﾞ：
7

コマンドラインによるコマンドラインによる配信要求
による配信要求
C:\HULFT Family\hulft7\binnt>utlsend -f LPBK -file C:\tmp\xxx.txt -sync
C:\HULFT Family\hulft7\binnt>echo %ERRORLEVEL%
0

直前のコマンドの終了
ステータスを表示

C:\HULFT Family\hulft7\binnt>
C:\HULFT Family\hulft7\binnt>utlsend -f LPBK -file C:\tmp\xxxxxx.txt-sync-syncオプション有

utlsend: All Failure(133).
C:\HULFT Family\hulft7\binnt>echo %ERRORLEVEL%
133

存在しないファイル名

配信失敗なので、終了ステータスが、133-syncオプション無C:\HULFT Family\hulft7\binnt>utlsend -f LPBK -file C:\tmp\xxxxxx.txt
C:\HULFT Family\hulft7\binnt>echo %ERRORLEVEL%
0

配信失敗でも、終了ステータスが、0© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

4.

2012/01/16

ﾍﾟｰｼﾞ：8

誤変換
通信相手は、Windowsですが、故意に誤った設定を行います。

転送は、成功しますが、変換が出来ていません。

© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

5.

2012/01/16

ﾍﾟｰｼﾞ：
9

ジョブ連携
ジョブ連携
バッチジョブを作成し、HULFTのジョブ起動情報に登録します。
@echo offpause
echo %TIME% %$FILENM% >> C:\test\hullog.txt
echo %TIME% %$MSG0% >> C:\test\hullog.txt
pause
exit

HULFT以外から起動した際の C:\test\hullog.txt"utlsend -f LPBK -file C:\test\log.txt -msg0 message01"で配信要求実行、HULFTの後続ジョブとして19:52:46

19:54:47.53 C:\test\log.txt.0009

19:52:46

19:54:47.54 message01© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

6.

2012/01/16

ﾍﾟｰｼﾞ：
10

順番を順番を保った転送
った転送[-sync]が無い場合、順番が前後する可能性があります。
@echo offC:
cd "C:\HULFT Family\hulft7\binnt"
REM utlsend.exeが、失敗した場合のみ、日時とutlsend.exe終了ステータスをログに追加書き
utlsend.exe -f FILEID1
set RC=%ERRORLEVEL%
if "%RC%" == "0" goto NEXTecho %DATE% %TIME% utlsend.exe FILEID1 status = %RC% >> C:\test\hul.log
exit %RC%:NEXT
utlsend.exe -f FILEID2
set RC=%ERRORLEVEL%
if "%RC%" == "0" goto END
echo %DATE% %TIME% utlsend.exe FILEID2 status = %RC% >> C:\test\hul.log
exit %RC%:END
exit %RC%

先に実行したFILEID1が後に終了しています。

© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

2012/01/16

ﾍﾟｰｼﾞ：
11[-sync]付きの場合、順番が前後しません。
@echo offC:
cd "C:\HULFT Family\hulft7\binnt"
REM utlsend.exeが、失敗した場合のみ、日時とutlsend.exe終了ステータスをログに追加書き
utlsend.exe -f FILEID1 -sync -w 300
set RC=%ERRORLEVEL%
if "%RC%" == "0" goto NEXTecho %DATE% %TIME% utlsend.exe FILEID1 status = %RC% >> C:\test\hul.log
exit %RC%:NEXTutlsend.exe -f FILEID2 -sync -w 300
set RC=%ERRORLEVEL%
if "%RC%" == "0" goto END
echo %DATE% %TIME% utlsend.exe FILEID2 status = %RC% >> C:\test\hul.log
exit %RC%:END
exit %RC%

順番の追い抜き無しで先に実行したFILEID1が後に終了しています。
FILEID1が先に終了しています。

© CEC Customer Service Ltd.

- HULFT7 利用概説 - Windows編

7.

2012/01/16

ﾍﾟｰｼﾞ：
12

HULFTサービス
HULFTサービスのサービスのアカウント
・ HULFTサービス起動アカウントは、デフォルト "ローカル システム アカウント"です。

上記以外のアカウントでHULFTサービスを動作させるには下記条件が必要です。
1) ローカルマシンのAdministratorsグループに所属している。
2) 次に示すユーザ権利を与えられている。※
・オペレーティングシステムの一部として機能・クォータの増加(WindowsXP Professionalの場合はプロセスのメモリクォータの増加)・プロセスレベルトークンの置き換え・ファイルとフォルダの復元・ファイルとフォルダのバックアップ
3) 最低一回ログオンする。(新規アカウント用のフォルダが必要です。クラスタの場合、特に注意！)※ 「 コントロールパネル」
コントロールパネル 」 → 「 管理ツール
管理 ツール」
ツール 」 → 「 ローカルセキュリティポリシー」
ローカルセキュリティポリシー 」 → 「 セキュリティのセキュリティ の 設定」
設定 」 → 「 ローカルポリシー」
ローカルポリシー 」 → 「 ユーザ権利
ユーザ 権利の権利 の 割 り 当 て 」
から [ 2 )]に)] に 記述された
記述 された５
された ５ つの項目
つの 項目を項目 を 新規HULFT
新規 HULFTユーザ
HULFT ユーザでユーザ で 使用と使用 と 可能としてください
可能 としてください。としてください 。 ( Windows Server 2008の2008 の 場合)
場合 )・ 複数のジョブを指定した場合は順にジョブを実行します。(並行に実行しません。)
・ ジョブが終了ステータス=0以外で終了すると、以降のジョブは実行しません。
・ ジョブ起動権限、環境変数は、HULFTから起動する方法/タイミングによって異なります。

● 配信前ジョブ- utlsend.exeによる配信要求発行時、utlsend.exeの子プロセスとして動作→utlsend.exe実行ユーザの権限、環境変数を引き継ぎます。
- 上記以外、要求受付プロセス(hulobs.exe)の子プロセスとして動作→要求受付プロセス実行ユーザの権限、環境変数を引き継ぎます。(カレントフォルダは、HULFTのbinnt)● 配信正常時ジョブ、配信異常時ジョブ- 配信プロセス(hulsdd.exe)の子プロセスとして動作→配信プロセス実行ユーザの権限、環境変数を引き継ぎます。(カレントフォルダは、HULFTのbinnt)● 集信正常時ジョブ、集信異常時ジョブ- 集信プロセス(hulrcv.exe)の子プロセスとして動作→集信プロセス実行ユーザの権限、環境変数を引き継ぎます。(カレントフォルダは、HULFTのbinnt)● リモートジョブ- 要求受付プロセス(hulobs.exe)の子プロセスとして動作→要求受付プロセス実行ユーザの権限、環境変数を引き継ぎます。(カレントフォルダは、HULFTのbinnt)
以上© CEC Customer Service Ltd.