JobCenter インポート・エクスポート機能 利用の手引き for JobCenter R12.4 第2版 変更履歴 形式→(A:追加、C:修正、D:削除) 項番 変更日付 1 2 3 4 5 6 2005/03/11 2005/07/01 2005/07/01 2005/07/01 2005/07/01 2005/07/04 項目 新規作成 改版 修正 修正 修正 追記 形式 − C C C C A 変更内容・理由 初版 JobCenter R12.4.1 リリースに伴い第 2 版に改版 誤植を修正 JNW エクスポートコマンドのオプションの説明を補足 JNW インポートの移行先マシン名一覧の説明を修正 各マニュアル間の関係に「JobCenter テンプレートガイド」 を追加 目次 1. はじめに............................................................................................................. 1 1.1. 本製品について .......................................................................................................1 1.2. 本マニュアルについて.............................................................................................1 1.3. 本マニュアルを読むにあたって ...............................................................................1 1.3.1. 用語の説明 ............................................................................................................................ 2 1.3.2. ファイルパスについて .......................................................................................................... 2 1.4. 各マニュアル間の関係.............................................................................................2 2. エクスポート...................................................................................................... 4 2.1. GUI による操作.......................................................................................................4 2.1.1. エクスポート画面.................................................................................................................. 4 2.1.1.1. JNW のエクスポート ...................................................................................................... 4 2.1.1.2. スケジュールのエクスポート......................................................................................... 6 2.1.1.3. カレンダのエクスポート ................................................................................................ 7 2.1.2. エクスポート実行中 .............................................................................................................. 8 2.1.3. エクスポートデータの保存 ................................................................................................... 8 2.1.4. エクスポートデータの転送 ................................................................................................... 9 2.1.5. エクスポート結果(エラー、警告)..................................................................................... 9 2.1.6. エクスポートデータについて ..............................................................................................11 2.1.7. 注意事項 .............................................................................................................................. 12 2.2. コマンドによる操作 ..............................................................................................12 2.2.1. エクスポートデータについて ............................................................................................. 12 2.2.2. 注意事項 .............................................................................................................................. 13 2.3. ログファイル ........................................................................................................13 3. インポート ....................................................................................................... 14 3.1. GUI による操作.....................................................................................................14 3.1.1. インポート画面 ................................................................................................................... 14 3.1.1.1. JNW のインポート........................................................................................................ 14 3.1.1.2. スケジュールのインポート .......................................................................................... 17 3.1.1.3. カレンダのインポート.................................................................................................. 19 3.1.2. インポート実行中................................................................................................................ 20 3.1.3. インポート結果(エラー、警告) ...................................................................................... 20 3.1.4. インポートで使用するエクスポートデータ選択について .................................................. 21 3.1.5. MG(SV)に転送したエクスポートデータについて............................................................... 22 3.1.6. 注意事項 .............................................................................................................................. 22 3.2. コマンドによる操作 ..............................................................................................22 3.2.1. 3.2.2. 3.2.3. 3.2.4. インポート対象選択エクスポートデータについて............................................................. 23 コマンドインタフェースで実行する場合のホスト名変換 .................................................. 23 ユーザ名の変換 ................................................................................................................... 23 注意事項 .............................................................................................................................. 24 3.3. ログファイル ........................................................................................................24 4. その他注意事項 ................................................................................................ 25 5. コマンドリファレンス...................................................................................... 26 5.1. JNW のエクスポートコマンド ...............................................................................26 5.2. JNW のインポートコマンド...................................................................................27 5.3. スケジュールエクスポートコマンド ......................................................................28 5.4. スケジュールインポートコマンド..........................................................................29 5.5. カレンダエクスポートコマンド .............................................................................29 5.6. カレンダインポートコマンド.................................................................................30 6. 付録.................................................................................................................. 31 6.1. コマンドオプションと対象部品の関係 ...................................................................31 6.1.1. エクスポート対象部品 ........................................................................................................ 31 6.1.2. インポート対象部品 ............................................................................................................ 32 6.1.3. エラー発生時の対処について ............................................................................................. 33 1. はじめに 1.1. 本製品について JobCenter はマルチプラットフォーム/マルチベンダによるネットワーク分散環境でのジョブの効率的 な自動運用を実現するジョブ管理製品です。 1. 2. 3. 4. マルチプラットフォーム/マルチベンダ対応 ジョブの実行は、Windows 2000/XP/2003, HP-UX, Solaris, AIX, RedHat Linux,Miracle Linux の主要プラットフォーム上で動作可能です。 また、IPF(Itanium Processor Family)サーバにも対応しています。 強力なジョブ自動実行機能のサポート ジョブの実行順序は、ジョブネットワークにより自動的に制御されます。 ジョブネットワークは、GUI 画面からドラッグ&ドロップの簡単な操作で定義できます。条件分岐、 待ち合わせなど、様々なジョブ実行条件も GUI から設定できます。また、ジョブネットワーク間 の連携定義により、大規模なジョブネットワークの構築も効率的に行えます。 また、稼働日カレンダとスケジュールの設定で、ジョブの確実な自動実行を実現します。 定義されたスケジュールに従ってジョブネットワークを自動的に起動できます。また稼働日のカ レンダを定義することで、休日を避けて実行するなど、業務に合ったスケジュールを作成できま す。 ジョブの実行状況の一元管理 ネットワーク分散環境でのジョブの実行状況を Widows ベースの GUI で一元的に監視できます。 ジョブの状態は色で区別されるため、障害発生も即座に認識することができます。監視画面と同 一の GUI からジョブの再実行などを行うことができるため、障害時の迅速なリカバリが可能です。 SAP R/3,BW 連携 ジョブネットワーク中に R/3 ジョブや BW ジョブを定義することができ、通常ジョブと同様にジョ ブ投入、結果の参照や制御を行なうことができます。 1.2. 本マニュアルについて 本書は、インポート・エクスポート機能の利用方法について説明したものです。 JobCenter インポート・エクスポート機能は、JobCenter 上の JNW 定義、スケジュール定義、カレ ンダ定義のインポート・エクスポートを実現する為の機能です。 なお、本書で使用されている画面と実際の画面は異なることがございます。 1.3. 本マニュアルを読むにあたって 本書「JobCenter インポート エクスポート利用の手引」では、次のような用語を用いて説明しています。 1 1.3.1. 用語の説明 用語 ジョブ job 単位ジョブ unit job ジョブネットワーク job network:JNW NQS エクスポートファイル キュー que トラッカ tracker 説明 一括して実行するバッチとして記述したシェルスクリプトと資源制限 値、実行日時、優先順位などの属性などの指定をしたリクエストが最小 単位のジョブになります。これを単位ジョブとも呼んでいます。 複数のリクエスト間の実行順序を定義した単位ジョブを構成したもので す。 Network Queuing System の略称。 リクエストを受け付けてキューイングし、順番に処理する機能です。 JNW、スケジュール、カレンダなどの部品の定義情報を格納した ZIP 形 式のエクスポートデータファイル(~.zip)と、エクスポート時の属性情報 を記述した属性定義ファイル(~.param)の二種類のファイルの総称です。 JobCenter が受け付けたリクエストをいったん、溜めておくものです。 JobCenter はこのキューに溜まっているリクエストを順番に実行してい きます。 投入されたリクエストがどのマシンに転送され、実行し、終了したかと いう情報を記録するそのリクエストを投入したマシン上のファイル(ト ラッキングファイル)です。 1.3.2. ファイルパスについて 本書では、UNIX のファイルパス表記を前提に記述しています。Windows で使用する場合は、次のよ うに読み替えて下さい。 ・JobCenter ユーザ環境 UNIX の場合 ログインユーザ/NetShepEUI/ Windows の場合 JobCenter インストールディレクトリ¥SV¥jnwexe¥spool¥ログインユーザ¥ ・コマンドパス UNIX の場合 /usr/lib/nqs/gui/bin Windows の場合 JobCenter インストールディレクトリ¥SV¥jnwexe¥lib¥ ・ UNIX の root ユーザは、Windows の場合 Administrator ユーザとして読み替えて下さい。 1.4. 各マニュアル間の関係 JobCenter R12.4 には以下のマニュアルが付随しております。 タイトル 概要 JobCenter クイックスタート編 GUI で JobCenter を起動し操作するための簡単な手順を紹介し ています。 2 JobCenter 環境構築ガイド JobCenter 基本操作ガイド JobCenter クラスタ機能利用の手引き JobCenter SAP 機能利用の手引き JobCenter インポート・エクスポート 機能利用の手引き JobCenter コマンドリファレンス JobCenter NQS 機能利用の手引き JobCenter テンプレートガイド JobCenter を利用するために必要な環境の構築、環境の移行や 他製品との連携などの各種設定方法について説明しています。 JobCenter の基本機能・操作方法について説明しています。 クラスタシステムで JobCenter を操作するための連携方法につ いて説明しています。 JobCenter を SAP と連携させるための方法について説明してい ます。 ユーザ環境のバックアップや環境の移行の際に必要な、 JobCenter 上の JNW 定義、スケジュール定義およびカレンダ定 義のインポート・エクスポート機能について説明しています。 GUI と同様にジョブネットワークの投入・実行状況の参照など をコマンドラインから行うために、JobCenter で用意されてい るコマンドについて説明しています。 JobCenter の基盤である NQS の機能を JobCenter から利用する 方法について説明しています。 JobCenter に標準添付されている各種テンプレートの利用方法 について説明しています。 3 2. エクスポート 2.1. GUI による操作 CL/Win でエクスポートしたいデータがあるマシンに接続し、ユーザフレーム、マネージャフレーム、 NQS フレームのいずれかのフレームウィンドウを開きます。 その後、次の操作によりエクスポートの画面をそれぞれ表示します。 (なお、接続するユーザにより実行できる機能が異なります。詳細は「2.1.7 注意事項」をご参照下さい) 2.1.1. エクスポート画面 2.1.1.1. JNW のエクスポート [NSCL]ウィンドウの[ファイル]メニュー−[エクスポート]−[JNW のエクスポート]を選択すると、 [JNW のエクスポート]ダイアログが表示されます。 4 パラメータ項目 全ユーザ全 JNW をエクスポート 全ユーザの全 JNW、全スケジュール、全共有 JNW、全カレンダが対象となります。 個別指定 共有 JNW をエクスポート 全共有 JNW が対象となります。 ユーザ指定 ユーザ一覧 (”全ユーザ”選択時) 全ユーザの全 JNW が対象となります。 ユーザ一覧 (ユーザ選択時) 全ての JNW をエクスポート ユーザ一覧で指定したユーザの全 JNW が対象となります。 指定したグループの JNW をエクスポート 「JNW のエクスポート」画面中に表示されたグループのリストから選択したグループ に属する JNW が対象となります。指定したグループ配下のグループに属する JNW は 全て対象となります。 指定した JNW をエクスポート 「JNW のエクスポート」画面中に表示された JNW のリストから選択した JNW が対象と なります。 Sub JNW をエクスポート エクスポート対象の JNW に Sub JNW が定義されている場合に、その Sub JNW をエク スポート対象に「する」、 「しない」を選択します。 関連するスケジュールをエクスポート エクスポート対象の JNW にカレンダ分岐部品が定義されている場合に、カレンダ分 岐部品で指定されたスケジュールをエクスポート対象に「する」、「しない」を選択 します。 (ただし当該 JNW があるスケジュールで関連 JNW に指定されている場合、そ のスケジュールは対象になりません) 関連するカレンダをエクスポート エクスポート対象のスケジュールに適用されているカレンダがある場合、そのカレ ンダをエクスポート対象に「する」 、「しない」を選択します。 5 2.1.1.2. スケジュールのエクスポート [NSCL]ウィンドウの[ファイル]メニュー−[エクスポート]−[スケジュールのエクスポート]を選択する と、[スケジュールのエクスポート]ダイアログが表示されます。 パラメータ項目 全ユーザのスケジュールエクスポート 全ユーザの全スケジュールが対象となります。 ユーザ指定 ユーザ一覧 エクスポート対象のユーザを選択します。 全スケジュールエクスポート ユーザ一覧で選択したユーザの全スケジュールが対象となります。 個別指定 「スケジュールのエクスポート」画面中に表示されたスケジュールのリストから選択したスケ ジュールが対象となります。 6 2.1.1.3. カレンダのエクスポート [NSCL]ウィンドウの[ファイル]メニュー−[エクスポート]−[カレンダのエクスポート]を選択すると、 [カレンダのエクスポート]ダイアログが表示されます。なお、カレンダのエクスポートは、接続ユーザ が root, nsumsmgr の場合のみ選択可能です。 パラメータ項目 全カレンダのエクスポート 全カレンダが対象となります。 個別指定 「カレンダのエクスポート」画面中に表示されたカレンダのリストから選択したカレンダが対象と なります。 7 2.1.2. エクスポート実行中 エクスポートする対象を選択して実行ボタンをクリックすると、MG(SV)でエクスポート処理を実行し ます。MG(SV)でのエクスポート処理中は以下の画面が表示されます。 正常に処理が終了すると、「2.1.3. エクスポートデータの保存」の画面が表示されます。 2.1.3. エクスポートデータの保存 エクスポートが完了すると、CL/Win の動作する PC 上の任意の場所にエクスポートデータを保存する ことができます。エクスポート先の確定画面で、エクスポートデータの保存先フォルダを指定してく ださい。任意の名前のフォルダを指定すると、エクスポートデータがそのフォルダ内に保存されます。 (保存されるデータの種類については「2.1.6 エクスポートデータについて」をご参照下さい) なお、すでに同名のフォルダが存在していた場合はエラーになります。 8 2.1.4. エクスポートデータの転送 エクスポートデータの保存先フォルダを指定し[OK]をクリックすると、MG(SV)で作成したエクスポー トデータを転送します。 エクスポートデータの転送中は以下の画面が表示されます。 ファイルの転送が終わると画面を閉じます。続いてエラー、警告メッセージの表示が無ければ正常終 了です。 2.1.5. エクスポート結果(エラー、警告) 次のダイアログは、MG(SV)上のエクスポート実行中、又はエクスポートファイル転送中に処理続行不 可のエラーが発生した場合に表示されます。詳細は「6.1.3 エラー発生時の対処について」をご参照く ださい。 次のダイアログは、指定した条件ではエクスポート対象となる JNW、スケジュール、カレンダが1件 もない場合に表示されます。指定を見直して下さい。 9 次のダイアログは、JNW の依存関係に矛盾がある場合に表示されます。 (例:カレンダ分岐部品で設定されたスケジュールが無い、定義された Sub JNW の実体が無い等) “ ログインユーザ/NetShepEUI/exportfile/”に表示された“.log”ファイルが作成されています。 ログファイルのメッセージを確認し、JNW 定義の矛盾点を修正してから再度エクスポートを実施して 下さい。 10 2.1.6. エクスポートデータについて GUI による操作の場合、エクスポートを実行すると MG(SV)上で、まず ログインユーザ/NetShepEUI/exportfile/ 配下に次のようにテンポラリファイルを作成します。 JNW のエクスポート JNW_HOSTNAME_YYYYMMDDHHMMxxx ディレクトリを作成し、以下のファイル名で格納 JNW_HOSTNAME_YYYYMMDDHHMMxxx.zip : エクスポートデータファイル JNW_HOSTNAME_YYYYMMDDHHMMxxx.param : 属性定義ファイル スケジュールのエクスポート SCH_HOSTNAME_YYYYMMDDHHMMxxx ディレクトリを作成し、以下のファイル名で格納 SCH_HOSTNAME_YYYYMMDDHHMMxxx.zip : エクスポートデータファイル SCH_HOSTNAME_YYYYMMDDHHMMxxx.param : 属性定義ファイル カレンダのエクスポート CAL_HOSTNAME_YYYYMMDDHHMMxxx ディレクトリを作成し、以下のファイル名で格納 CAL_HOSTNAME_YYYYMMDDHHMMxxx.zip : エクスポートデータファイル CAL_HOSTNAME_YYYYMMDDHHMMxxx.param : 属性定義ファイル 注) HOSTNAME : 実行ホスト名 YYYYMMDDHHMM : コマンド起動時刻(年月日時分) xxx : 0 から 999 までの番号 ユーザのホームディレクトリに上記エクスポートデータとテンポラリファイルが一時的に格納出来る 容量が確保出来ない場合、エラーになります。 これらのファイルは CL/Win の操作でエクスポートファイルを保存し正常終了した場合、またはエクス ポート操作をキャンセルし[MG(SV)上のエクスポートファイルを削除しますか?]ダイアログで[はい] を選択した場合に削除されます。 エクスポート操作キャンセルで[MG(SV)上のエクスポートファイルを削除しますか?]ダイアログで [いいえ]を選択した場合、データは削除されず MG(SV)上にそのまま残ります。その場合、不要になっ た時点で随時削除して下さい。 11 2.1.7. 注意事項 ・ root および nsumsmgr で接続してエクスポートを実行した場合は全ての機能が利用出来ますが、 一般ユーザで実行した場合はログインユーザの JNW、スケジュールのみがエクスポート対象と なります。一般ユーザで操作する場合、利用出来ない機能については画面上でグレーアウトし、 操作出来ません。 ・ ユーザ一覧や部品の個別指定では、選択できる対象は1つのみです。複数選択はできません。 2.2. コマンドによる操作 MG(SV)にログインし、コマンドライン上でそれぞれ次のコマンドを実行します。 JNW のエクスポート /usr/lib/nqs/gui/bin/jnw_export スケジュールのエクスポート /usr/lib/nqs/gui/bin/sch_export カレンダのエクスポート(root ユーザのみ) /usr/lib/nqs/gui/bin/cal_export CL/Win へのエクスポートデータ転送機能を除いて、基本的に「2.1. GUI による操作」の GUI 操作と同 等の機能を提供します。 コマンド起動時のエクスポート対象選択に関してはコマンドラインのオプション指定で行います。詳 細は「5. コマンドリファレンス」および「6.付録」をご参照下さい。 2.2.1. エクスポートデータについて GUI による操作と同様、 ログインユーザ/NetShepEUI/exportfile/ 配下にテンポラリファイルを作成します。詳細は「2.1.6 エクスポートデータについて」をご参照下さ い。 12 2.2.2. 注意事項 (1) root でログインしてコマンドを実行した場合は全てのオプションが利用出来ますが、その他のユ ーザ(nsumsmgr を含む)で実行する場合、UNIX の実行ユーザ権限に依存します。 全ユーザ JNW エクスポート 共有 JNW エクスポート カレンダエクスポート などを行なう場合は必ず root でログインしてください。 (2) エクスポート対象ユーザについて UNIX の場合、次の 2 つの条件を同時に満たしたユーザがエクスポート対象になります。 SV のユーザホームディレクトリ配下に NetShepEUI ディレクトリが存在する。 環境構築後 Win/CL から接続され、/usr/spool/nqs/gui 配下に該当ユーザ名でシンボリックリ ンクが作成されている。 Windows の場合、次の条件を満たしたユーザがエクスポート対象になります。 ¥JobCenter¥SV¥jnwexe¥spool フォルダ配下に該当ユーザ名でフォルダが作成されている事。 2.3. ログファイル 実行時ログファイルは、 ログインユーザ/NetShepEUI/exportfile/ 配下に、JNW_HOSTNAME_YYYYMMDDHHMMxxx.log として格納します。 このファイルはエラーログファイルはコマンド起動毎に 1 ファイル作成します。単調増加ファイルで はなく、コマンドが終了すればそれ以上サイズが増加することはありません。 インポート・エクスポート機能では削除しませんので、不要になったログファイルは随時削除して下 さい。 13 3. インポート 3.1. GUI による操作 CL/Win でデータをインポートしたいマシンに接続し、ユーザフレーム、マネージャフレーム、NQS フ レームのいずれかのフレームウィンドウを開きます。 その後、次の操作によりインポートの画面をそれぞれ表示します。 (なお、接続するユーザにより実行できる機能が異なります。詳細は「3.1.6 注意事項」をご参照下さい) 3.1.1. インポート画面 3.1.1.1. JNW のインポート [NSCL]ウィンドウの[ファイル]メニュー−[インポート]−[JNW のインポート]を選択すると、[JNW の インポート]ダイアログが表示されます。 パラメータ項目 全ユーザインポート エクスポートファイル中の、全ユーザの全 JNW、全ユーザの全スケジュール、全共有 JNW、全カレ ンダが対象となります。 共有 JNW エクスポートファイル中の、共有 JNW が対象となります。 ユーザ指定 ユーザ一覧で選択したユーザが対象となります。エクスポート時、ユーザ指定で実行したエ クスポートファイルの場合で、エクスポート時と違うユーザを指定しインポートした場合、 インポート時指定したユーザのデータに変換しながらインポートします。 14 インポートの指定後、[OK]を押すとインポート元フォルダの指定画面が表示されます。 インポートするファイルが存在するフォルダを指定し[OK]を押して下さい。 無効なフォルダを指定した場合は、以下の“指定したファイルが存在しません”のメッセージが表示 されます。[OK]を押し再度フォルダの指定を行って下さい。 15 パラメータ項目 移行元マシン名一覧 エクスポートファイル中の、JNW、スケジュール中に存在するホスト名を表示します。 移行先マシン名一覧 接続マシンの MG(SV)のマシン一覧に登録されたマシン名を表示します。 追加ボタン 移行元マシン、移行先マシンを選択し、追加ボタンを押すと マシン名変更の一覧に追加されま す。 すでに登録済みの場合は“指定したマシンは既に存在しています。 ”のメッセージが表示されます。 削除ボタン マシン名変更の一覧から削除したい行を選択し、削除ボタンを押すとマシン名変更の一覧から選択し たマシン名が削除されます。 16 3.1.1.2. スケジュールのインポート [NSCL]ウィンドウの[ファイル]メニュー−[インポート]−[スケジュールのインポート]を選択すると、 [スケジュールのインポート]ダイアログが表示されます。 パラメータ項目 全ユーザのスケジュールインポート エクスポートファイル中の、全ユーザの全スケジュールが対象となります。 ユーザ指定 ユーザ一覧で選択したユーザが対象となります。エクスポート時、ユーザ指定で実行したエクス ポートファイルの場合で、エクスポート時と違うユーザを指定しインポートした場合、インポー ト時指定したユーザのデータに変換しながらインポートします。 インポートの指定後、[OK]を押すとインポート元フォルダの指定画面が表示されます。 インポートするファイルが存在するフォルダを指定し[OK]を押して下さい。 17 無効なフォルダを指定した場合は、以下の“指定したファイルが存在しません”のメッセージが表示 されます。[OK]を押し再度フォルダの指定を行って下さい。 18 3.1.1.3. カレンダのインポート [NSCL]ウィンドウの[ファイル]メニュー−[インポート]−[カレンダのインポート]を選択すると、[フォ ルダの参照]ダイアログが表示されます。 なお、カレンダのインポートは、 接続ユーザが root, nsumsmgr の場合のみ選択可能です。 無効なフォルダを指定した場合は、以下の“指定したファイルが存在しません”のメッセージが表示 されます。[OK]を押し再度フォルダの指定を行って下さい。 19 3.1.2. インポート実行中 インポートする対象を選択して実行ボタンをクリックすると、MG(SV)へインポートするデータの転送 に続き、インポート処理を実行します。ファイル転送中、MG(SV)でのインポート処理中は以下の画面 が表示されます。正常に処理が終了すると、画面が消えます。 続いてエラー、警告メッセージの表示が無ければ正常終了です。 各画面が表示されたら CL/Win が動作する PC 上の任意のフォルダを選択し、実行ボタンを選択して下 さい。インポートが完了すると、[表示]-[最新表示]によりインポートした部品を確認することができま す。 3.1.3. インポート結果(エラー、警告) 次のダイアログは、MG(SV)上のインポート実行中、又は、インポートファイル転送中に処理続行不可 のエラーが発生した場合に表示されます。詳細は「6.1.3. エラー発生時の対処について」をご参照くだ さい。 次のダイアログは、インポート処理自体は正常終了しているが JNW の依存関係に矛盾があるという場 合に表示されます。 (例:カレンダ分岐部品で設定されたスケジュールが無い、定義された Sub JNW の実体が無い等) “ ログインユーザ/NetShepEUI/exportfile/”に表示された“.log”ファイルが作成されています。 ログファイルのメッセージを確認し、JNW 定義の矛盾点を修正してから再度エクスポートを実施して 下さい。 20 3.1.4. インポートで使用するエクスポートデータ選択について インポート対象を選択し、[OK]を選択するとインポート元フォルダの指定画面が表示されます。イン ポート対象フォルダを選択し、[OK]ボタンを選択すると[マシン名変更]画面が表示されます。データに 含まれるマシン名を変更しながらインポートしたい場合は、それぞれの変換規則を追加してから実行 してください。 インポート元フォルダとして、任意の名前を付けることができます。ただし、インポート元フォルダ とそのフォルダに格納したデータファイルは、次の規則に従ったファイル名が付けられている必要が あります。 ・ ファイル名(*.zip, *.param)と格納フォルダ名は、拡張子以外は同じ名前であること (例) D:¥JNW_import¥JNW_import.zip JNW_import.param のように格納し、GUI で D:¥JNW_import を選択する。 21 3.1.5. MG(SV)に転送したエクスポートデータについて インポート実行でエクスポートデータを MG(SV)に転送し、 ログインユーザ/NetShepEUI/exportfile/ 配下にテンポラリファイル(import.zip, import.param, import.rule)を作成します。 MG(SV)上のユーザのホームディレクトリに上記エクスポートデータとテンポラリファイルが一時的 に格納出来る容量が確保出来ない場合、エラーになります。 3.1.6. 注意事項 root および nsumsmgr で接続してインポートを実行した場合は全ての機能が利用出来ますが、一般ユー ザで実行した場合はログインユーザの JNW、スケジュールのみがインポート対象となります。一般ユ ーザで操作する場合、利用出来ない機能については画面上でグレーアウトし、操作出来ません。 また、何らかの原因でインポートがエラーになった場合、MG(SV)に転送されたエクスポートデータは 自動的には削除されませんのでご注意ください。 3.2. コマンドによる操作 MG(SV)にログインし、コマンドライン上でそれぞれ次のコマンドを実行します。 JNW のインポート /usr/lib/nqs/gui/bin/jnw_import スケジュールのインポート /usr/lib/nqs/gui/bin/sch_import カレンダのインポート(root ユーザのみ) /usr/lib/nqs/gui/bin/cal_import CL/Win からのエクスポートデータ転送機能を除き、基本的に「2.1. GUI による操作」と同等の機能を 提供します。 22 3.2.1. インポート対象選択エクスポートデータについて コマンド起動時のインポート対象選択に関してはコマンドラインの -d オプションで絶対パス、また は相対パスでデータ格納ディレクトリを指定します。任意のディレクトリに任意のエクスポートデー タを格納する規則については「3.1.4. インポートで使用するエクスポートデータ選択について」をご参 照下さい。 -d オプションを指定しない場合は ログインユーザ/NetShepEUI/exportfile/temp/import.zip import.param import.rule (3.2.2 参照) のディレクトリとデータが既定値となります。 3.2.2. コマンドインタフェースで実行する場合のホスト名変換 JNW の中に記述してあるホスト名の変換が必要な場合、import.rule ファイルを作成して下さい。 (ファイル名は「3.1.4. インポートで使用するエクスポートデータ選択について」の規則に従い、最後 に識別子 .rule を付けて下さい) フォーマット 移行元ホスト名 移行元ホスト名 移行先ホスト名 移行先ホスト名 ・ ・ 移行元ホスト名 + 半角ブランク + 移行先ホスト名で 1 レコードとし、全体をダブルクォートで 囲んだテキスト形式のファイルを作成します。変換規則が複数ある場合は、改行して複数行指定 して下さい。 3.2.3. ユーザ名の変換 管理者で接続してユーザ指定でエクスポートしたデータ(あるいは一般ユーザで接続してログインユ ーザをエクスポートしたデータ)を、ユーザ指定(あるいはログインユーザ)でインポートする場合、 エクスポート時と違うユーザ名を指定すると、各部品を指定したユーザ名に変換しながらインポート します。 23 3.2.4. 注意事項 1) root でログインしてコマンドを実行した場合は全てのオプションが利用出来ますが、その他の ユーザ(nsumsmgr を含む)で実行する場合、UNIX の実行ユーザ権限に依存します。 ・全ユーザ JNW インポート ・共有 JNW インポート ・カレンダインポート などを行なう場合は必ず root でログインしてください。 2) root も含めて、インポート対象となるユーザで必ず最低 1 度は CL/Win で MG(SV)に接続し、ユ ーザのホームディレクトリ配下に NetShepEUI 環境が構築されていることを確認してください。 NetShepEUI 配下の環境が無いユーザでコマンドによる操作を行なうとエラーになります。 3.3. ログファイル 実行時ログファイルは、 ログインユーザ/NetShepEUI/exportfile/ 配下に、JNW_HOSTNAME_YYYYMMDDHHMMxxx.log として格納します。 エラーログファイルはコマンド起動毎に 1 ファイル作成します。単調増加ファイルではなく、コマン ドが終了すればそれ以上サイズが増加することはありません。 このファイルはインポート・エクスポート機能では削除しません。不要になったログファイルについ て随時削除して下さい。 24 4. その他注意事項 ・ インポートは他の GUI 接続による操作や、ジョブが実行中で無いことを確認した上で実行して 下さい。また、インポート実行中にジョブが投入されるようなスケジュールが設定されていない 事を確認して下さい。他のユーザが GUI 操作により JNW 定義やスケジュール、カレンダを修正 中にインポートを実行しますと、思わぬ依存性関係の不具合を起こす場合があります。 ・ インポート時にすでに MG(SV)上に同名の JNW、スケジュール、カレンダが存在した場合、元 のデータを消去してからインポートします。上書きされると困る部品についてはあらかじめ名前 を変更するか、エクスポートにより別途バックアップを取っておいてください。 ・ クラスタ環境においてインポート・エクスポート機能を使用する場合は、他の JobCenter コマン ドの利用方法に準じます。詳細は「JobCenter クラスタ機能利用の手引き」をご参照下さい。 ・ JNW 数や単位ジョブスクリプトのサイズなど、エクスポート、インポートに要する時間は環境 により大きく異なります。GUI I/F で実行する場合は、CL/Win の[設定]-[通信タイムアウト時間設定]の 値を環境に合わせて適切に変更してください。事前に MG (SV)上でコマンドライン I/F により同 条件で処理を実行した際の時間を計測して目安とするのが確実です。(例:HP rp2470-650MHz で単位ジョブ 1000 件、10MB のファイル容量の条件で、MG (SV)上の処理時間はエクスポート で約 10-12 秒、インポートで約 27 秒) ・ 各ユーザの JobCenter 環境配下の、 JNW ファイル格納ディレクトリ( /NetShepEUI/nsjnw)に、 JNW と関係の無い不要なファイル、ディレクトリを作成しないで下さい。スケジュール格納ディレク トリ( /NetShepEUI/indcal)、共有 JNW 格納ディレクトリ(/usr/spool/nqs/gui/cmn.d.C)、カレ ンダ格納ディレクトリ((/usr/spool/nqs/gui/wkcal.d)についても同様です) ・ グループ指定でエクスポートしたデータをインポートする場合、データに含まれるグループの階 層構造はそのまま復元されますが、インポート先の既存のグループ名との表示順序は順不同にな ります。表示順序の変更は、ユーザフレームの右側でグループ名を右クリックして[順序の変更] により行なってください。 ・ ショートカットしか含まないグループを指定したエクスポートはできません。必ず JNW を最低 1 つ含むグループを作成して指定してください。 25 5. コマンドリファレンス 5.1. JNW のエクスポートコマンド 【形式】 jnw_export [{ -a │ -j │ -ua }] [-sj] [-s] [-c] jnw_export [-u username { -ja │ -g groupname │ -j jnwname }] [-sj] [-s] [-c] 【機能説明】 指定したパラメータにより、JNW をエクスポートします。各オプションとエクスポートされる部品 との関係は、「66.1.1 エクスポート対象部品」を参照してください。 【オプション】 オプション無し ログインユーザのすべての JNW をエクスポートします。 -a すべてのユーザの JNW、共有 JNW、スケジュール、カレンダをエクスポートします。 このオプションはルートユーザのみ使用できます。 -j すべての共有 JNW をエクスポートします。 このオプションはルートユーザのみ使用できます。 -ua すべてのユーザの JNW をエクスポートします。 このオプションはルートユーザのみ使用できます。 -u エクスポートしたい定義ファイルを持つユーザ名を指定します。 -ja -u オプションとともに使用し、指定したユーザがもつすべての JNW をエクスポートしま す。 -g -u オプションとともに使用し、指定したユーザがもつ指定したグループの JNW をエクス ポートします。 -j -u オプションとともに使用し、指定したユーザがもつ指定した JNW をエクスポートしま す。 -sj -ua または-u オプションとともに使用し、対象となる JNW の Sub JNW をエクスポートします。 -s -ua または-u オプションとともに使用し、対象となる JNW 中のカレンダ分岐部品で指定され ているスケジュールをエクスポートします。 -c -ua または-u オプションとともに使用し、対象となる JNW に関連するカレンダをエクスポー トします。 26 username エクスポート対象の JobCenter のユーザ名を指定します。(複数指定はできません。) groupname エクスポート対象のグループ名を指定します。(複数指定はできません。)なお、グループ名 は、ドット(.)で始まり, .GroupName1 の形式で指定します。また、階層化されたグループの 場 合 は 、 親 グ ル ー プ 名 か ら 順 に ド ッ ト (.) で 各 階 層 の グ ル ー プ 名 を 連 結 し て、.GroupName1.GroupName2 の形式で指定します。 jnwname エクスポート対象の JNW 名を指定します。(複数指定はできません。) 【戻り値】 0:正常終了 1:異常終了 【エラーメッセージ】 エ ラ ー メ ッ セ ー ジ は 、 “ /usr/spool/nqs/gui/ ユ ー ザ 名 /exportfile/JNW_HOST_YYYYMMDDHHMMxxx.log” (xxx は 001 から 999 の順で作成します)に出力しま す。 “YYYYMMDDHHMM”の部分は JNW エクスポートコマンド起動時刻となります。 5.2. JNW のインポートコマンド 【形式】 jnw_import [-a │ -j] [-d dirname] jnw_import [-u username] [-d dirname] 【機能説明】 エクスポートした JNW のデータファイルから JNW をインポートします。 【オプション】 オプション無し ログインユーザに JNW をインポートします。 -a インポート用データファイルにあるすべての JNW、共有 JNW、スケジュール、カレンダをイン ポートします。ただし、インポート先に存在しないユーザに関連するものはインポートしま せん。このオプションはルートユーザのみ使用できます。 -j 全共有 JNW をインポートします。このオプションはルートユーザのみ使用できます。 -u 指定したユーザにインポートします。 -d エクスポートしたデータファイルがあるディレクトリを指定します。指定するディレクトリ の詳細は、 「3.1.4 インポートで使用するエクスポートデータ選択について」を参照してくだ さい。 username インポート対象の JobCenter のユーザ名を指定します。(複数指定はできません。) 【戻り値】 27 0:正常終了 1:異常終了 【エラーメッセージ】 エ ラ ー メ ッ セ ー ジ は 、 “ /usr/spool/nqs/gui/ ユ ー ザ 名 /exportfile/JNW_HOST_YYYYMMDDHHMMxxx.log” (xxx は 001 から 999 の順で作成します)に出力しま す。 “YYYYMMDDHHMM”の部分は JNW インポートコマンド起動時刻となります。 5.3. スケジュールエクスポートコマンド 【形式】 sch_export -a sch_export -u username {-sa │ -s schedule} 【機能説明】 スケジュールをエクスポートします。 【オプション】 オプション無し ログインユーザの全スケジュールをエクスポートします。 -a 全ユーザのスケジュールをエクスポートします。このオプションはルートユーザのみ使用で きます。 -u エクスポート対象となるユーザを指定します。 -sa -u オプションとともに使用し、指定したユーザのスケジュールをエクスポートしま す。 -s -u オプションとともに使用し、指定したユーザの指定したスケジュールをエクスポ ートします。 username エクスポート対象の JobCenter のユーザ名を指定します。(複数指定はできません。) schedule エクスポート対象のスケジュール名を指定します。(複数指定はできません。) 【戻り値】 0:正常終了 1:異常終了 【エラーメッセージ】 エ ラ ー メ ッ セ ー ジ は 、 “ /usr/spool/nqs/gui/ ユ ー ザ 名 /exportfile/ SCH_HOST_YYYYMMDDHHMMxxx.log” (xxx は 001 か ら 999 の 順 で 作 成 し ま す ) に 出 力 し ま す 。 “YYYYMMDDHHMM”の部分はスケジュールエクスポートコマンド起動時刻となります。 28 5.4. スケジュールインポートコマンド 【形式】 sch_import [-a] [-d dirname] sch_import [-u username] [-d dirname] 【機能説明】 エクスポートしたデータファイルから、スケジュールをインポートします。 【オプション】 オプション無し ログインユーザにすべてのスケジュールをインポートします。 -a すべてのユーザのスケジュールをインポートします。このオプションはルートユーザのみ使 用できます。 -u 指定したユーザにインポートします。 -d エクスポートしたデータファイルがあるディレクトリを指定します。指定するディレクトリ の詳細は、 「3.1.4 インポートで使用するエクスポートデータ選択について」を参照してくだ さい。 username インポート対象の JobCenter のユーザ名を指定します。(複数指定はできません。) 【戻り値】 0:正常終了 1:異常終了 【エラーメッセージ】 エ ラ ー メ ッ セ ー ジ は 、 “ /usr/spool/nqs/gui/ ユ ー ザ 名 /exportfile/ SCH_HOST_YYYYMMDDHHMMxxx.log” (xxx は 001 か ら 999 の 順 で 作 成 し ま す ) に 出 力 し ま す 。 “YYYYMMDDHHMM”の部分はスケジュールインポートコマンド起動時刻となります。 5.5. カレンダエクスポートコマンド 【形式】 cal_export [-c calendar] 【機能説明】 カレンダをエクスポートします。 【オプション】 オプション無し すべてのカレンダをエクスポートします。 -c 指定したカレンダをエクスポートします。 29 calendar エクスポートするカレンダを指定します。 【戻り値】 0:正常終了 1:異常終了 【エラーメッセージ】 エ ラ ー メ ッ セ ー ジ は 、 “ /usr/spool/nqs/gui/ ユ ー ザ 名 /exportfile/ CAL_HOST_YYYYMMDDHHMMxxx.log” (xxx は 001 か ら 999 の 順 で 作 成 し ま す ) に 出 力 し ま す 。 “YYYYMMDDHHMM”の部分はカレンダエクスポートコマンド起動時刻となります。 5.6. カレンダインポートコマンド 【形式】 cal_import [-d dirname] 【機能説明】 カレンダをインポートします。 【オプション】 -d エクスポートしたデータファイルがあるディレクトリを指定します。指定するディレクトリ の詳細は、 「3.1.4 インポートで使用するエクスポートデータ選択について」を参照してくだ さい。 【戻り値】 0:正常終了 1:異常終了 【エラーメッセージ】 エ ラ ー メ ッ セ ー ジ は 、 “ /usr/spool/nqs/gui/ ユ ー ザ 名 /exportfile/ CAL_HOST_YYYYMMDDHHMMxxx.log” (xxx は 001 か ら 999 の 順 で 作 成 し ま す ) に 出 力 し ま す 。 “YYYYMMDDHHMM”の部分はカレンダインポートコマンド起動時刻となります。 30 6. 付録 6.1. コマンドオプションと対象部品の関係 6.1.1. エクスポート対象部品 エクスポート時のオプション -a -j -ua -u username -ja -u username -g groupname -u username -j jnwname オプションなし JNW ○ ○ ○ ○ ○ ○ 対象部品 共有JNW スケジュール ○ ○ ○ ○ ○ 31 備考 カレンダ ○ 全ユーザ対象 全ユーザ対象 6.1.2. インポート対象部品 エクスポート時の インポート時の オプション オプション -a -a -j -u username オプションなし -j -a -j -u username オプションなし -ua -a -j -u username オプションなし -u username -ja -a -j -u username オプションなし -u username -a -g groupname -j -u username オプションなし -u username -a -j jnwname -j -u username オプションなし オプションなし -a -j -u username オプションなし JNW ○ 対象部品 共有JNW スケジュール ○ ○ ○ ○ ○ 備考 カレンダ ○ 全ユーザ対象 ○ ○ 指定ユーザ ログインユーザ ○ ○ なし なし 全ユーザ対象 なし 指定ユーザ ログインユーザ ○ ○ ○ ○ ○ ○ なし ユーザ名変換 ユーザ名変換 ○ ○ ○ なし ○ ○ ○ なし ○ ○ ○ ○ なし ○ ○ ○ ○ 32 6.1.3. エラー発生時の対処について 処理続行不可のエラーが発生した場合、ログファイルのエラーメッセージの内容により障害内容をそ の都度判断して必要なオペレーションを実行し、障害を解消する必要があります。 また*.zip ファイルや*.param ファイルの転送に失敗してエラーで停止した場合は、SV 上にこれらの ファイルが残ります。(データ保存の観点より、正常終了の時と違いエラー発生時には自動で削除され ません) 必要であればエラー発生後の再実行の前にこれらのファイルの存在を確認し、削除してください。 また、インポート・エクスポート処理実行中に処理続行不可のエラーが発生した場合“ ログインユー ザ/NetShepEUI/exportfile/temp”にファイルが残る場合があります。(障害解析に必要なため)処理 続行不可のエラー発生時には“ ログインユーザ/NetShepEUI/exportfile/temp”以下およびログファ イルをバックアップしたのち、消去してください。 33
© Copyright 2024 Paperzz