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