この項では、pack
およびunpack
コマンドの目的、構文およびパラメータを説明します。
pack
は、ドメイン全体またはドメインのサブセットのスナップショットを含むテンプレート(.jar
アーカイブ・ファイル)を作成するコマンドです。ドメインのサブセットを含むテンプレートを使用して、リモート・マシン上に管理対象サーバー・ドメインのディレクトリ階層を作成できます。
表2-1は、pack
コマンドを使用して作成したテンプレートに含まれるファイルとディレクトリを説明しています。
表2-1 Packコマンドを使用して作成されたテンプレートに含まれるファイルおよびディレクトリ
テンプレート・タイプ | ファイルとディレクトリ |
---|---|
ドメイン |
次の例外を含めて、ソース・ドメインのすべてのファイルとディレクトリが組み込まれます。
WebLogic Server管理コンソールまたはその他のオンライン・ツールを使用して、ユーザー、グループ、ロールなどの追加のセキュリティ・データを構成した場合、そのセキュリティ・データはLDAPサーバーに格納されており、テンプレートには組み込まれません。最初にデータをエクスポートしてからターゲット・ドメインにインポートする必要があります。 |
管理対象サーバー |
次のファイルとディレクトリは、デフォルトで組み込まれます。
次のファイルとディレクトリは、デフォルトでは管理対象サーバー・テンプレートに組み込まれません。
テンプレート作成元のドメインの |
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
]
表2-2は、pack
コマンドのパラメータ一覧です。
表2-2 Packコマンドのパラメータ
パラメータ | 必須/オプション | 説明 |
---|---|---|
|
必須 |
テンプレートの作成元ドメインの絶対または相対パス。 |
|
必須 |
作成されるテンプレートのフル・パスまたは相対パス。テンプレート・ファイル名には、 注: |
|
必須 |
テンプレートを表す名前。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要があります。 |
|
オプション |
テンプレートの作成者の名前。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要があります。 |
|
オプション |
テンプレートの説明。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要があります。 |
|
オプション |
リモート・マシンに管理対象サーバーを作成するためにテンプレートを使用するかどうかを指定します。デフォルトは |
|
オプション |
ログ・ファイルの名前。 |
|
オプション |
ログ・ファイルの優先度の設定。log4j優先度文字列を使用します。 有効なlog4j優先度文字列は、 |
C:\oracle\user_projects\domains
ディレクトリに配置するmydomain
という既存のドメインを元にテンプレートを作成するには、以下のコマンドを実行します。
pack -domain=C:\oracle\user_projects\domains\mydomain -template=C:\oracle\user_templates\mydomain.jar -template_name="My WebLogic Domain"
mydomain.jar
というテンプレートが、C:\oracle\user_templates
ディレクトリに作成されます。テンプレートの名前は、My WebLogic Domain
です。
unpack
コマンドは、リモート・マシンの管理対象サーバー・ドメイン・ディレクトリに使用されるフル・ドメインまたはドメインのサブセットを作成します。
unpack
は、現在のインストール内容と互換性のあるテンプレートのみと併用してください。以下のものをテンプレートとして使用できます。
現在のインストールとパッケージ化されたドメイン・テンプレート
ドメイン・テンプレート・ビルダーまたはWLSTを使用して作成されたドメイン・テンプレート
packコマンドを使用して作成されたドメイン・テンプレート
packコマンドを使用して作成された管理対象サーバー・テンプレート
ドメイン・テンプレートでunpack
コマンドを使用すると、テンプレートに定義されているアプリケーション・ファイルとリソース・ファイルすべてを含むドメインが作成されます。また、起動スクリプトおよび特定のセキュリティ・ファイルと構成ファイルも作成されます。
管理対象サーバー・テンプレートでunpack
コマンドを使用すると、以下を含む管理対象サーバー・ドメイン・ディレクトリが作成されます。
ドメイン内の各管理対象サーバー用にカスタマイズされた起動スクリプト
config_bootstrap.xml
ファイル(テンプレート内のconfig.xml
に基づく)
nm_password.properties
ファイル
SerializedSystemIni.dat
ファイル
管理対象サーバー・ドメイン・ディレクトリ用のエントリもNM_HOME/nodemanager.domains
ファイルに作成されます。ここで、NM_HOME
は、リモート・マシンの製品インストール用のノード・マネージャ・インストール・ディレクトリを示します。デフォルトでは、このディレクトリはWLS_HOME/common/nodemanager
に存在します。
注意: デフォルトでは、アプリケーション・ファイルはpack コマンドを使用して作成された管理対象サーバー・テンプレートには含まれません。管理対象サーバー・テンプレートの作成元のドメインにアプリケーションが、external_stage モードによりデプロイされた場合、unpack コマンドを使用して作成する管理対象サーバー・ドメイン・ディレクトリには、外部でステージングされたアプリケーションは一切含まれません。管理対象サーバーを起動する前に、外部でステージングされたアプリケーション・ファイルにアクセス可能であることを確認する必要があります。
詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』ガイドの「ステージング・モードによるデプロイメント・ファイルのコピーの制御」を参照してください。 |
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]
表2-3は、pack
コマンドで使用可能なパラメータの一覧です。
表2-3 Unpackコマンドのパラメータ
パラメータ | 必須/オプション | 説明 |
---|---|---|
|
必須 |
ドメインの作成元テンプレートのフル・パスまたは相対パスおよびファイル名。 |
|
必須 |
作成するドメインの絶対または相対パス。 |
|
オプション |
テンプレートに現在定義されているデフォルトの管理者のユーザー名とパスワード。このユーザー名とパスワードの組合せは、管理サーバーの起動および管理サーバーとの接続に使用されます。デフォルトの管理者に新しいパスワードを指定した場合、パスワードは指定した値にリセットされます。 注: デフォルトの管理者のパスワードがテンプレートに定義されていない場合は、指定する必要があります。 管理ユーザーがテンプレートに定義されていない場合は、 デフォルトの管理者とパスワードが現在テンプレートに定義されている場合は、 値は、カンマ、タブまたは次のリストの文字を含んではなりません: < > # | & ? ( ) { }。ユーザー名では、大文字と小文字が区別されます。 有効なパスワードは8つ文字 以上 の文字列で、大文字と小文字が区別されます。 unpack コマンドではパスワード値が暗号化されます。 注: これらのパラメータは、管理対象サーバー・テンプレートを使用してドメインを作成する場合には使用できません。 |
|
オプション |
テンプレートに定義されているアプリケーションを格納するために使用するディレクトリのフルパス。 このパラメータは、テンプレートが個別のアプリケーション・ディレクトリをサポートしている場合にのみ使用できます。 |
|
オプション |
Javaホーム・ディレクトリのフルパス。設定した場合は、ドメインの管理サーバーによって使用されるデフォルトのJVMが識別されます。 このパラメータは、管理対象サーバー・テンプレートを基にドメインを作成する場合には使用できません。 |
|
オプション |
管理サーバーの起動モード(開発または本番)。 このパラメータは、管理対象サーバー・テンプレートを使用してドメインを作成する場合には使用できません。 |
|
オプション |
ログ・ファイルの名前。 |
|
オプション |
ログ・ファイルの優先度の設定。log4j優先度文字列を使用します。 有効なlog4j優先度文字列は、 |