pack および unpack コマンドを使用したテンプレートとドメインの作成

pack および unpack コマンドの説明

以下の節では、pack および unpack コマンドについて説明します。

• pack
• unpack

 

---

pack

ドメイン全体またはドメインのサブセットのスナップショットを含むテンプレート アーカイブ (.jar) ファイルを作成します。ドメインのサブセットを含むテンプレートを使用すると、リモート マシン上に管理対象サーバ ドメインのディレクトリ階層を作成できます。

ドメイン テンプレートを作成するとき、ソース ドメインには以下の例外を除き、すべてのファイルとディレクトリが含まれます。

• サーバの起動時に作成される一時ファイル。
• servers ディレクトリ。

注意 : WebLogic Server Administration Console またはその他のオンライン ツールを使用して、ユーザ、グループ、ロールなどの追加のセキュリティ データをコンフィグレーションした場合、そのセキュリティ データは LDAP サーバに格納されており、テンプレートには組み込まれません。最初にデータをエクスポートしてから対象ドメインにインポートする必要があります。

• -managed=true オプションを使用して管理対象サーバ テンプレートを作成すると、デフォルトにより次のファイルとディレクトリが組み込まれます。
• ルート ディレクトリにある、次の拡張子を持つすべてのファイル : .cmd、.sh、.xml、.properties、.ini
• ドメインの SSL コンフィグレーションに定義されている、拡張子 .pem を持つ任意のファイル
• bin ディレクトリ
• lib ディレクトリ
• security ディレクトリにある、テンプレート作成時に自動的に作成されないすべてのファイル。たとえば、DefaultAuthenticatorInit.ldift と DefaultRoleMapperInit.ldift は、デフォルトでは組み込まれません。
• config ディレクトリ内のすべてのファイルとサブディレクトリ

注意 : アプリケーションと特定のアプリケーション初期化ファイル、サーバの起動時に作成される一時ファイル、および servers ディレクトリは、デフォルトでは管理対象サーバ テンプレートには組み込ませません。

構文

pack -domain=domain -template=template -template_name="template_name"
[-template_author="author"][-template_desc="description"]
[-managed={true|false}][-log=log_file] [-log_priority=log_priority]

パラメータの説明

次の表では、pack コマンドで使用できるパラメータについて説明します。

表 2-1 pack コマンドのパラメータ 

パラメータ	説明
必要なパラメータ
-domain=domain	テンプレートの作成元ドメインの絶対パス。
-template=template	作成するテンプレートの絶対パスとファイル名。テンプレート ファイル名には .jar 拡張子を付ける必要がある。
-template_name="template_name"	テンプレートを表す名前。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要がある。
省略可能なパラメータ
-template_author="author"	テンプレートの作成者の名前。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要がある。
-template_desc="description"	テンプレートの説明。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要がある。
-managed={true|false}	リモート マシンに管理対象サーバを作成するためにテンプレートを使用するかどうかを指定する。デフォルトは false。 このパラメータが true に設定されているときは、SerializedSystemIni.dat、config.xml、nm_password.properties などの最小限のファイルを含む管理対象サーバ テンプレートが作成される。アプリケーションと特定のアプリケーション初期化ファイルは組み込まれない。作成されたテンプレートは、リモート マシンに管理対象サーバを作成するために使用できる。
-log=log_file	ログ ファイルの名前。
-log_priority=log_priority	ログ ファイルの優先順位の設定。log4j 優先順位文字列を使用する。有効な log4j 優先順位文字列には、debug、info、warn、error、fatal がある。優先順位文字列の値は、Level クラスに定義されているレベルに対応している。詳細については、http://logging.apache.org/log4j/docs/api/org/apache/log4j/Level.html を参照。

 

例 :

C:\bea\user_projects\domains ディレクトリ内の mydomain というドメインを使用して次のコマンドを実行すると、C:\bea\user_templates ディレクトリに mydomain.jar というテンプレート ファイルが作成されます。テンプレートの名前は、My WebLogic Domain として指定されています。

pack -domain=C:\bea\user_projects\domains\mydomain
-template=C:\bea\user_templates\mydomain.jar -template_name="My WebLogic Domain"

関連トピック

• リモート マシンにおける管理対象サーバの作成と起動 : 主な手順
• pack を使用して管理対象サーバ テンプレートを作成

 

---

unpack

リモート マシンの管理対象サーバ ドメイン ディレクトリに使用されるドメイン全体またはドメインのサブセットを作成します。unpack は、現在のインストールと互換性のあるテンプレートのみで使用できます。テンプレートは以下のいずれかです。

• BEA によって提供され、現在のインストールと一緒にパッケージ化されているドメイン テンプレート
• Domain Template Builder または WLST Offline を使用して作成されたドメイン テンプレート
• pack コマンドを使用して作成されたドメイン テンプレート
• pack コマンドを使用して作成された管理対象サーバ テンプレート。デフォルトでは、管理対象サーバ テンプレートには、管理対象サーバ ドメイン ディレクトリの作成に必要なファイルのみが組み込まれています。

ドメイン テンプレートで unpack コマンドを使用すると、テンプレートに定義されているアプリケーション ファイルとリソース ファイルすべてを含むドメインが作成されます。また、起動スクリプトおよび特定のセキュリティ ファイルとコンフィグレーション ファイルも作成されます。

管理対象サーバ テンプレートで unpack コマンドを使用すると、以下を含む管理対象サーバ ドメイン ディレクトリが作成されます。

• ドメイン内の各管理対象サーバ用にカスタマイズされた起動スクリプト
• config_bootstrap.xml ファイル (テンプレート内の config.xml に基づく)
• nm_password.properties ファイル
• SerializedSystemIni.dat ファイル

管理対象サーバ ドメイン ディレクトリ用のエントリも NM_HOME/nodemanager.domains ファイルに作成されます。ここで、NM_HOME は、リモート マシンの製品インストール用のノード マネージャ インストール ディレクトリを示します。デフォルトでは、このディレクトリはたとえば C:\bea\weblogic90\common\nodemanager\nodemanager.domains などの WL_HOME/common/nodemanager にあります。

pack および unpack コマンドを使用して管理対象サーバ ドメイン ディレクトリを作成する方法の詳細については、「リモート マシンにおける管理対象サーバの作成と起動 : 主な手順」を参照してください。

構文

unpack -template=template -domain=domain [-user_name=username]
[-password=password] [-app_dir=application_directory]
[-java_home=java_home_directory] [-server_start_mode={dev|prod}]
[-log=log_file] [-log_priority=log_priority]

パラメータの説明

次の表では、unpack コマンドで使用できるパラメータについて説明します。

表 2-2 unpack コマンドのパラメータ 

パラメータ	説明
必要なパラメータ
-template=template	ドメインの作成に使用しているテンプレートの絶対パスとファイル名。
-domain=domain	作成するドメインの絶対パス。
省略可能なパラメータ
-user_name=username -password=password	テンプレートに現在定義されているデフォルトの管理者のユーザ名とパスワード。このユーザ名とパスワードの組み合わせは、管理サーバの起動および管理サーバとの接続に使用される。デフォルトの管理者に新しいパスワードを指定した場合、パスワードは指定した値にリセットされる。 注意 : デフォルトの管理者のパスワードがテンプレートに定義されていない場合は、指定する必要がある。 管理ユーザがテンプレートに定義されていない場合は、-user_name と -password のパラメータを指定して新しいデフォルトの管理者を作成できる。 デフォルトの管理者とパスワードが現在テンプレートに定義されている場合は、-user_name と -password のパラメータを指定して新しい管理ユーザを追加できる。 有効なユーザ名に、カンマ、タブ、< >、#、|、&、?、( )、{ } を含めることはできない。ユーザ名では、大文字と小文字が区別される。 有効なパスワードは 8 文字以上の文字列で、大文字と小文字が区別される。unpack コマンドではパスワード値が暗号化される。 注意 : これらのパラメータは、管理対象サーバ テンプレートを使用してドメインを作成している場合には無効になる。
-app_dir=application_directory	テンプレートに定義されているアプリケーションを格納するために使用するディレクトリの絶対パス。 注意 : このパラメータは、テンプレートが個別のアプリケーション ディレクトリをサポートしている場合にのみ有効である。
-java_home=java_home_directory	Java ホーム ディレクトリの絶対パス。設定した場合は、ドメインの管理サーバによって使用されるデフォルトの JVM が識別される。 注意 : このパラメータは、管理対象サーバ テンプレートを使用してドメインを作成している場合には無効になる。
-server_start_mode={dev|prod}	管理サーバの起動モード (開発またはプロダクション)。 注意 : このパラメータは、管理対象サーバ テンプレートを使用してドメインを作成している場合には無効になる。
-log=log_file	ログ ファイルの名前。
-log_priority=log_priority	ログ ファイルの優先順位の設定。log4j 優先順位文字列を使用する。有効な log4j 優先順位文字列には、debug、info、warn、error、fatal がある。優先順位文字列の値は、Level クラスに定義されているレベルに対応している。詳細については、http://logging.apache.org/log4j/docs/api/org/apache/log4j/Level.html を参照。

 

例 :

C:\bea\user_templates ディレクトリ内の mydomain.jar というテンプレートを使用して次のコマンドを実行すると、C:\bea\user_projects\domains ディレクトリに my_new_domain というドメインが作成されます。

unpack -template=C:\bea\user_templates\mydomain.jar -domain=C:\bea\user_projects\domains\my_new_domain

関連トピック

• リモート マシンにおける管理対象サーバの作成と起動 : 主な手順
• unpack を使用してリモート マシンに管理対象サーバを作成