Oracle® Fusion Middleware

PackおよびUnpackコマンドによるテンプレートとドメインの作成

12c (12.2.1.2)

E82910-02(原本部品番号:E77848-02)

2017年1月

このドキュメントは、管理者を対象に、packコマンドを使用してWebLogicドメイン・テンプレートを作成する方法、およびunpackコマンドを使用してWebLogicドメインを作成する方法について説明しています。

Oracle Fusion Middleware PackおよびUnpackコマンドによるテンプレートとドメインの作成, 12c (12.2.1.2)

E82910-02

Copyright © 2015, 2017, Oracle and/or its affiliates. All rights reserved.

原本著者: Geetha Savithriamma

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 PackおよびUnpackコマンドの概要

- 1.1 Packコマンドの概要

- 1.2 Unpackコマンドの概要

2 PackおよびUnpackコマンド・リファレンス

- 2.1 Packコマンド

- 2.1.1 ドメイン・テンプレートに組み込まれているファイルおよびディレクトリ

- 2.1.2 セキュリティ・プロバイダ・データの新しいドメインへの移植

- 2.1.3 管理対象サーバー・テンプレートに組み込まれているファイルおよびディレクトリ

- 2.1.4 ノード・マネージャの構成

- 2.1.5 Packコマンドの構文

- 2.1.6 Packコマンドのパラメータ

- 2.1.7 Packコマンドの例

- 2.2 Unpackコマンド

- 2.2.1 Unpackコマンドの構文

- 2.2.2 Unpackコマンドのパラメータ

- 2.2.3 Unpackコマンドの例

3 リモート・システムの管理対象サーバーの作成および起動

- 3.1 管理対象サーバー・テンプレートの作成

- 3.2 リモート・システムでの管理対象サーバーの作成

- 3.3 リモート・システムでの管理対象サーバーの起動

はじめに

このガイドでは、WebLogicのドメインおよびテンプレートの作成時にpackやunpackコマンドを使用する方法について説明します。

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

表記規則

このマニュアルでは次の表記規則を使用します。

表記規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

対象読者

このガイドは、Oracle Fusion Middlewareの管理者向けです。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティへの取り組みについては、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)にアクセスしてください。

Oracleサポートへのアクセス

サポートを購入したオラクル社のお客様は、My Oracle Supportを介して電子的なサポートにアクセスできます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info、聴覚に障害があるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連ドキュメント

このガイドに記載されているドキュメントは、Oracle Technology Network (http://www.oracle.com/technology)で参照できます。

- Oracle WebLogic ServerおよびCoherenceのインストールと構成

- Oracle WebLogic Serverノード・マネージャの管理

- Oracle WebLogic Serverへのアプリケーションのデプロイ

- Oracle WebLogic Serverサーバーの起動と停止の管理

- WebLogic Server WLSTコマンド・リファレンス

1 PackおよびUnpackコマンドの概要

packおよびunpackコマンドを使用すると、コマンド・ラインからWebLogicドメインやテンプレートを1つの手順で作成できます。これらのコマンドは、ORACLE_HOME/oracle_common/common/binディレクトリにあります。

注意:

これらのコマンドを使用して、他のツールと同じようにWebLogicドメインやテンプレートのコンテンツをカスタマイズすることはできません。

packおよびunpackコマンドのほかに、構成ウィザード、ドメイン・テンプレート・ビルダーまたはWebLogic Scripting Toolを使用して、WebLogicドメインおよびテンプレートを作成できます。

packコマンドを使用して、次の種類のテンプレートを作成します。作成したテンプレートをunpackコマンドで使用して、WebLogicドメインまたは管理対象サーバー・ドメインのいずれかを作成します。

- ドメイン・テンプレート: このタイプのテンプレートは、インフラストラクチャ・コンポーネント、アプリケーション、サービス、セキュリティ・オプション、一般環境およびオペレーティング・システムのオプションを含む、WebLogicドメイン内のリソースの完全なセットを定義します。ドメイン・テンプレートは、新しいWebLogicドメインのベースとして使用することができます。

- 管理対象サーバー・テンプレート: このタイプのテンプレートは、リモート・システムに管理対象サーバー・ドメインのディレクトリを作成するために必要なWebLogicドメイン内のリソースのサブセットを定義します。管理対象サーバー・テンプレートは、packコマンドと-managed=trueオプションを使用して作成できます。
その後、unpackコマンドを指定して管理対象サーバー・テンプレートを使用すると、リモート・システムで管理対象サーバーを起動するための十分なブートストラップ情報が含まれた管理対象サーバー・ドメイン・ディレクトリが作成されます。リモート・システムで管理対象サーバーを起動するには、ノード・マネージャを使用するか、リモート・システムでテンプレートをアンパックするときに作成されたカスタマイズ起動スクリプトを使用できます。

この章の内容は次のとおりです。

- packコマンドの概要
packコマンドは、1つのステップでコマンド・ラインからテンプレートを作成する手段を提供します。ただし、ドメイン・テンプレート・ビルダーを使用することによりカスタマイズできる方法で、テンプレートのコンテンツをカスタマイズすることはできません。

- unpackコマンドの概要
unpackコマンドでは、テンプレートに定義されたデフォルトの設定を使用して、既存テンプレートからワンステップで素早くWebLogicドメインを作成できます。

1.1 Packコマンドの概要

packコマンドは、1つのステップでコマンド・ラインからテンプレートを作成する手段を提供します。ただし、ドメイン・テンプレート・ビルダーを使用することによりカスタマイズできる方法で、テンプレートのコンテンツをカスタマイズすることはできません。

packコマンドにより、次のタスクをすばやく実行できます。

- WebLogicドメイン全体のスナップショットを含むドメイン・テンプレートの作成。
このテンプレートは、unpackコマンド、構成ウィザードまたはWLSTを使用して作成される新しいWebLogicドメインのベースとして使用することができます。

- リモート・システムに管理対象サーバー・ドメインのディレクトリ階層を作成するために必要な、WebLogicドメイン内のファイルのサブセットを含む管理対象サーバー・テンプレートの作成。
unpackコマンドを使用して、リモート・システムに管理対象サーバーのドメイン・ディレクトリを作成できます。

1.2 Unpackコマンドの概要

unpackコマンドでは、テンプレートに定義されたデフォルトの設定を使用して、既存テンプレートからワンステップで素早くWebLogicドメインを作成できます。

WebLogicドメインを作成する場合、unpackでは、構成ウィザードやWLSTと同様のカスタマイズ・オプションは提供されません。ただし、ドメイン・テンプレートでunpackコマンドを使用すると、次の操作が可能です。

- テンプレートに定義されているデフォルトの管理ユーザーのパスワードを変更します。

- デフォルトの管理ユーザーのパスワードがテンプレートにすでに指定されている場合に、管理ユーザーを追加します。

- WebLogicドメインのJDKと起動モードを指定します。

- アプリケーション・ディレクトリがテンプレートによってサポートされている場合、そのディレクトリを指定します。

unpackを使用して、packコマンドで作成された管理対象サーバー・テンプレートに基づいて管理対象サーバー・ドメイン・ディレクトリを作成することもできます。管理対象サーバーは、管理サーバーに定義されている設定を使用します。したがって、JDKまたは起動モードの変更、管理ユーザーの追加、管理者パスワードの変更はできません。

注意:

unpackを使用してWebLogicドメインを拡張することはできません。

2 PackおよびUnpackコマンド・リファレンス

packコマンドとunpackコマンドには、独自の構文とパラメータがあります。これらのコマンドは、ORACLE_HOME/oracle_common/common/binディレクトリにあります。

この章の内容は次のとおりです。

- packコマンド
packコマンドにより、WebLogicドメイン全体またはWebLogicドメインのサブセットのスナップショットを含むテンプレート(.jarアーカイブ・ファイル)を作成できます。

- Unpackコマンド
unpackコマンドでは、リモート・システムの管理対象サーバー・ドメイン・ディレクトリに使用されるフルWebLogicドメインまたはドメインのサブセットを作成できます。

2.1 Packコマンド

packコマンドにより、WebLogicドメイン全体またはWebLogicドメインのサブセットのスナップショットを含むテンプレート(.jarアーカイブ・ファイル)を作成できます。

WebLogicドメインのサブセットを含むテンプレートを使用して、リモート・マシン上に管理対象サーバー・ドメインのディレクトリ階層を作成できます。

次の各項では、packコマンドを使用して作成するドメインおよび管理対象サーバーのテンプレートに組み込まれる、ファイルおよびディレクトリについて説明します。

- ドメイン・テンプレートに組み込まれているファイルおよびディレクトリ

- セキュリティ・プロバイダ・データの新しいドメインへの移植

- 管理対象サーバー・テンプレートに組み込まれているファイルおよびディレクトリ

- ノード・マネージャの構成

- Packコマンドの構文

- Packコマンドのパラメータ

- Packコマンドの例

2.1.1 ドメイン・テンプレートに組み込まれているファイルおよびディレクトリ

次の例外を除いて、ソースWebLogicドメインのすべてのファイルとディレクトリが組み込まれます。

- サーバーの起動時に作成される一時ファイル

- サーバー・ディレクトリ

- WebLogicドメインの作成時に自動的に作成されるセキュリティ・ディレクトリ内のファイル。DefaultAuthenticatorInit.ldiftおよびXACMLRoleMapperInit.ldiftなど。

- 永続ファイル・ストア(ドメインに配置されている場合も含む)。JMS用に定義されたか他のファイル・システム用に定義されたかにかかわらず、ファイル・ストアは除外されます。ファイル・ストアがドメイン内に配置されている場合、空のファイル・ストア・ディレクトリがターゲット・システムに作成されます。

ドメイン・ディレクトリ内のファイルに加え、外部ディレクトリに配置されたデプロイメント・プランもpackで作成されたテンプレートに組み込まれます。これらのリソースはunpackによって、次のドメイン内の標準の場所にコピーされます。

domain_home/config/deployments/deployment_name/plan

注意:

ドメイン内にすでに存在するプランは再配置されません。

外部ディレクトリには、Oracleホーム・ディレクトリ、ドメイン・ホーム、およびORACLE_HOME/oracle_common/common/lib/internalpaths.txtファイルで定義されている場所以外のディレクトリが含まれます。

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

2.1.2 セキュリティ・プロバイダ・データの新しいドメインへの移植

packコマンドは、オフライン・コマンドであるため、組込みLDAPデータなどのセキュリティ・プロバイダ・データをドメイン・テンプレートにエクスポートしません。unpackを使用して新しいドメインを作成後、手動でセキュリティ・プロバイダ・データを新しいドメインに移植する必要があります。これを行うには、次の手順を実行します。

1. 必要に応じて、元のドメインの管理サーバーを起動し、元のドメインの管理コンソールにログインします。

2. Oracle WebLogic Server管理コンソール・オンライン・ヘルプのセキュリティ・プロバイダからのデータのエクスポートに関する項の説明に従い、元のドメインからデータをエクスポートします。

3. 必要に応じて、新しいドメインの管理サーバーを起動し、新しいドメインの管理コンソールにログインします。

4. Oracle WebLogic Server管理コンソール・オンライン・ヘルプのセキュリティ・プロバイダへのデータのインポートに関する項の説明に従い、新しいドメインにデータをインポートします。

2.1.3 管理対象サーバー・テンプレートに組み込まれているファイルおよびディレクトリ

次のファイルとディレクトリは、デフォルトで組み込まれます。

- 次の拡張子を持つ、ルート・ディレクトリのすべてのファイル: .cmd、.sh、.xml、.propertiesおよび.ini

- WebLogicドメインのSSL構成に定義されている、拡張子.pemを持つファイル

- config.xmlを除き、configディレクトリにあるすべてのファイルとサブディレクトリ

- binディレクトリ

- libディレクトリ

次のファイルとディレクトリは、デフォルトでは管理対象サーバー・テンプレートに組み込まれません。

- アプリケーションと特定のアプリケーション初期化ファイル

- config.xmlファイル

- サーバーの起動時に作成される一時ファイル

- サーバー・ディレクトリ

- WebLogicドメインの作成時に自動的に作成されるセキュリティ・ディレクトリ内のファイル。DefaultAuthenticatorInit.ldiftおよびXACMLRoleMapperInit.ldiftなど

ドメイン内のサーバーの特定の名前やポートが指定されているかどうかにかかわらず、あらゆるドメインのパックが可能です。その後、任意のシステム上にドメインをアンパックできますが、config.xmlファイルで特定のシステムおよびポートを使用するように定義されているサーバーは、他のシステムでは動作しません。したがって、該当するノードおよびシステム上でサーバーを正常に起動するには、すべてのサーバーの各リモート・ノード上に同一のテンプレートをアンパックする必要があります。

2.1.4 ノード・マネージャの構成

packコマンドとunpackコマンドでは、管理対象モードでも管理対象外モードでも、ノード・マネージャ構成が維持されません。デフォルトでは、アンパックされたドメインでは、ノード・マネージャ・タイプがデフォルトで常にPerDomainNodeManagerに設定されます。

元のドメインのノード・マネージャ・タイプがCustomLocationNodeManagerであった場合、ドメインをアンパックするときにunpackコマンドで-nodeManagerTypeおよび-nodeManagerHomeパラメータを使用して、構成を保持する必要があります。

元のドメインのノード・マネージャ・タイプがManualNodeManagerSetupであった場合は、各リモート・システム上にドメインをアンパックした後に、ノード・マネージャを手動で再構成する必要があります。

元のドメインでManualNodeManagerSetup構成が使用されていた場合、ノード・マネージャの構成情報は、packで作成されるテンプレートから切り捨てられます。ドメインをアンパックするときには、-nodeManagerTypeパラメータを使用してManualNodeManagerSetupを指定します。ドメインのアンパック後は、ノード・マネージャを手動で構成する必要があります。

ノード・マネージャ・タイプについては、『Oracle WebLogic Serverノード・マネージャの管理』のデフォルトのノード・マネージャの構成に関する項を参照してください。

ノード・マネージャ資格証明は、パックされたドメインからアンパックされたドメインへコピーされます。これらの資格証明は、config.xmlファイルに格納されます。

2.1.5 Packコマンドの構文

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

2.1.6 Packコマンドのパラメータ

表2-1は、packコマンドのパラメータ一覧です。

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

パラメータ

必須またはオプション

説明

-domain=domain

必須

テンプレートの作成元WebLogicドメインの絶対パスまたは相対パス。

-template=template

必須

作成されるテンプレートのフル・パスまたは相対パス。テンプレート・ファイル名には、.jar拡張子を含める必要があります。

注: packコマンドは既存のファイルを上書きしません。指定したファイル名が指定フォルダの既存ファイルと一致する場合、packコマンドは失敗します。

-template_name="template name"

必須

テンプレートを表す名前。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要があります。

-template_author="author"

オプション

テンプレートの作成者の名前。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要があります。

-template_desc="description"

オプション

テンプレートの説明。このパラメータの値にスペースが含まれている場合にのみ、引用符で囲む必要があります。

-managed=true|false

オプション

リモート・システムに管理対象サーバーを作成するためにテンプレートを使用するかどうかを指定します。デフォルトは、falseです。このパラメータがtrueに設定されているときは、SerializedSystemIni.datおよびnm_password.propertiesなどの最小限のファイルを含む管理対象サーバー・テンプレートが作成されます。管理対象サーバー・テンプレートに対して一意のdomain.propertiesファイルも含まれています。アプリケーションと特定のアプリケーション初期化ファイルは含まれていません。作成されたテンプレートは、リモート・システムに管理対象サーバーを作成するために使用できます。

注意: WebLogic Server 12.1.2と同様、WLSTのwriteTemplateコマンドはオンライン・モードで使用できます。この機能により、リモート管理対象サーバーのドメインの作成または更新が容易になります。詳細は、『WebLogic Server WLSTコマンド・リファレンス』のwriteTemplateに関する項を参照してください。

-log=log_file

オプション

ログ・ファイルの名前。

-log_priority=log_priority

オプション

ログ・ファイルの優先度の設定。log4j優先度文字列を使用します。

有効なlog4j優先度文字列は、debug、info、warn、error、fatalです。優先度文字列の値は、Levelクラスで定義されたレベルに対応します。詳細は、http://logging.apache.org/log4j/を参照してください。

2.1.7 Packコマンドの例

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です。

2.2 Unpackコマンド

unpackコマンドでは、リモート・システムの管理対象サーバー・ドメイン・ディレクトリに使用されるフルWebLogicドメインまたはドメインのサブセットを作成できます。

unpackは、現在のインストール内容と互換性のあるテンプレートのみと併用する必要があります。現在のインストール・バイナリが、unpackコマンドを実行するシステムに存在している必要があります。以下のものをテンプレートとして使用できます。

- 現在のインストールとパッケージ化されたドメイン・テンプレート

- ドメイン・テンプレート・ビルダーまたはWLSTを使用して作成されたドメイン・テンプレート

- packコマンドを使用して作成されたドメイン・テンプレート

- packコマンドを使用して作成された管理対象サーバー・テンプレート

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

注意:

ソース・ドメインは、ドメイン用に定義した管理者ユーザー名と管理者パスワードの両方を持つ必要があります。そうでない場合、unpackコマンドの実行時にはエラーが表示されます。unpackコマンドのwalletDirオプションによって指定されるウォレットで、ソース・ドメインの管理者パスワードを定義できます。

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

- WebLogicドメイン内の各管理対象サーバー用にカスタマイズされた起動スクリプト

- config_bootstrap.xmlファイル(テンプレート内のconfig.xmlファイルに基づく)

- nm_password.propertiesファイル

- SerializedSystemIni.datファイル

管理対象サーバー・ドメイン・ディレクトリのエントリは、NM_HOME /nodemanager.domainsファイルにも作成されます。NM_HOMEは、リモート・システム上の製品インストールのためのノード・マネージャのホーム・ディレクトリです。このディレクトリの場所は、ノード・マネージャ・タイプによって異なります。ノード・マネージャ・タイプおよびノード・マネージャ・ホームの詳細は、表2-2を参照してください。

注意:

デフォルトでは、アプリケーション・ファイルはpackコマンドを使用して作成された管理対象サーバー・テンプレートには含まれません。管理対象サーバー・テンプレートの作成元のWebLogicドメインにアプリケーションが、external_stageモードによりデプロイされた場合、unpackコマンドを使用して作成する管理対象サーバー・ドメイン・ディレクトリには、外部でステージングされたアプリケーションは一切含まれません。管理対象サーバーを起動する前に、外部でステージングされたアプリケーション・ファイルにアクセス可能であることを確認する必要があります。

詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』ガイドの「ステージング・モードによるデプロイメント・ファイルのコピーの制御」を参照してください。

- Unpackコマンドの構文

- Unpackコマンドのパラメータ

- Unpackコマンドの例

2.2.1 Unpackコマンドの構文

unpack [-initialize] -template=template -domain=domain [-walletDir=directory]
[-user_name=username] [-password=password] [-app_dir=application_directory]
[-nodemanager_type=type] [-nodemanager_home=nodemanager_home_directory]
[-java_home=java_home_directory] [-server_start_mode=dev|prod]
[-overwrite_domain] [-log=log_file] [-log_priority=log_priority]

2.2.2 Unpackコマンドのパラメータ

表2-2は、unpackコマンドで使用可能なパラメータの一覧です。

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

パラメータ

必須またはオプション

説明

-initialize

オプション

このパラメータは、Fusion Middleware製品がインストールされているWebLogicドメインにのみ適用されます。

注意:

このパラメータをtrueに設定する場合は、ソース・データベースが実行されていることを確認してください。実行されていない場合、unpackコマンドは失敗します。

このパラメータがtrueで、ドメインをパックしたときにpackのmanagedパラメータがfalseに設定されていた場合は、config-mapping.xmlのエンティティに対するreprocess属性の設定にかかわらず、サービス表およびOracle Web Services Manager (OWSM)データ・ストアにあるすべてのconfig-mapping.xmlの値が初期化されます。

このパラメータがtrueで、ドメインをパックしたときにpackのmanagedパラメータがtrueに設定されていた場合は、サービス表およびOracle Web Services Manager (OWSM)データ・ストアにあるconfig-mapping.xmlの値で、config-mapping.xmlのエンティティに対するreprocess属性の設定がtrueのもののみ初期化されます。

このパラメータがfalseの場合、config-mapping.xmlの値は初期化されません。

サービス表の詳細は、『Oracle Fusion Middlewareの管理』のサービス表の理解に関する項を参照してください。

-template=template

必須

WebLogicドメインの作成元テンプレートのフル・パスまたは相対パスおよび名前。

-domain=domain

必須

作成するWebLogicドメインの絶対または相対パス。

-walletDir

オプション

管理者ユーザー・アカウントのパスワードを含むウォレット・ファイルのディレクトリ。このディレクトリは、configWallet.shコマンドを使用してウォレット・ファイルを作成したときに使用したディレクトリと同じです。次に例を示します。

-walletDir $HOME/wallet

アンパックするドメインに異なる管理者ユーザーを作成する場合は、次の手順を実行します。

1. createWallet.shコマンドで、管理者ユーザー名を定義するために-create admin_nameパラメータを含めます。

2. unpackコマンドで、createWalletコマンドで使用した同じadmin_nameを使用して-user_name=admin_nameパラメータを含めます。

注意:

別の管理者ユーザーを使用するかどうかにかかわらず、managedパラメータにfalseを設定する場合でも、walletDirオプションを使用する必要があります。

-user_name=username

オプション

テンプレートで、またはWalletDirディレクトリを通じて現在定義されているデフォルトの管理者のユーザー名。このユーザー名は、管理サーバーを起動して接続するときに使用します。デフォルトの管理者に新しいパスワードを指定した場合、パスワードは指定した値にリセットされます。

管理ユーザーがテンプレートに定義されていない場合は、createWallet.shおよび-user_nameパラメータを使用するか、-user_nameと-passwordパラメータを指定して新しいデフォルトの管理者を作成できます。

デフォルトの管理者とパスワードが現在テンプレートに定義されている場合は、createWallet.shおよび-user_nameパラメータを使用するか、-user_nameと-passwordパラメータを使用して新しい管理ユーザーを追加できます。

ユーザー名は一意にする必要があります。WebLogic認証プロバイダ(デフォルト認証)では、ユーザー名の大文字と小文字は区別されません。ユーザー名にタブまたは次の文字を含めないようにしてください。

- セミコロン(;)

- カンマ(,)

- プラス記号(+)

- 等号(=)

- 一重バックスラッシュ文字(\)

注意:

二重連続のバックスラッシュを使用できます。たとえば、smith\\などです。

さらに、ユーザー名の最初の文字に次の文字を使用することはできません。

- ポンド記号(#)

- 二重引用符(")

注意:

先行する無効な文字を使用してユーザーを作成すると、WebLogicドメインが破損する可能性があります。

有効なパスワードは8文字以上の文字列です。unpackコマンドではパスワード値が暗号化されます。

注意:

このパラメータは、管理対象サーバー・テンプレートを使用してWebLogicドメインを作成する場合には使用されません。

-password=password

オプション

このパラメータは非推奨です。セキュリティの向上のため、walletDirパラメータを使用して、管理者ユーザーのパスワードを指定してください。このパラメータを使用する場合:

- デフォルトの管理者に新しいパスワードを指定した場合、パスワードは指定した値にリセットされます。

- デフォルトの管理者のパスワードがテンプレートに定義されていない場合は、指定する必要があります。

有効なパスワードは8文字以上の文字列で、大文字と小文字が区別されます。unpackコマンドではパスワード値が暗号化されます。

注意:

管理対象オプションを使用して作成されたテンプレートをアンパックする場合、パスワードは変更できません。-passwordオプションは無視されます。

-app_dir=application_directory

オプション

テンプレートに定義されているアプリケーションを格納するために使用されるディレクトリのフルパス。

注意:

テンプレートに、製品インストール・ディレクトリ外で、別のアプリケーション・ディレクトリにあるアプリケーションが含まれる場合、そのアプリケーションをテンプレートからコピーするかどうかを、このオプションに指定します。テンプレートに、このようなアプリケーションが含まれない場合は、app_dirオプションを指定しても効果はなく、無視されます。

-nodemanager_type=type

オプション

作成中のドメインに、ノード・マネージャ・タイプを設定します。次のいずれかのタイプを指定します。

- PerDomainNodeManager: このタイプを指定した場合、ドメイン内にノード・マネージャ・ホームが<domain_name>/nodemanagerとして定義されます。各ドメインのノード・マネージャは、このディレクトリ内のファイルの指定に従って、異なる構成にできます。

- CustomLocationNodeManager: 特定の場所にノード・マネージャの構成ファイルを作成する場合に、このタイプを指定します。このタイプを指定した場合、ノード・マネージャのホーム・ディレクトリの指定にnodemanager_home引数を追加する必要があります。指定するディレクトリは空である必要があります。

- ManualNodeManagerSetup: 既存のノード・マネージャの構成を使用する場合、このタイプを指定します。このタイプを指定すると、ドメインに対するノード・マネージャの構成は無視されるため、ノード・マネージャの構成を手動で構成する必要があります。

デフォルト値はPerDomainNodeManagerです。

-nodemanager_home=home

条件付き

指定したノード・マネージャ・タイプがCustomLocationNodeManagerの場合、この引数が必要です。使用するノード・マネージャの場所のフルパスを入力します。

指定したノード・マネージャ・タイプがCustomLocationNodeManagerではない場合、この引数は不要です。追加された場合は、無視されます。

-java_home=java_home_directory

オプション

Javaホーム・ディレクトリのフルパス。設定した場合は、WebLogicドメインの管理サーバーによって使用されるデフォルトのJava仮想マシン(JVM)が識別されます。

このパラメータは、管理対象サーバー・テンプレートを基にWebLogicドメインを作成する場合には使用できません。

-server_start_mode=dev|prod

オプション

管理サーバーの起動モード: devまたはprod。デフォルト値はdevです。

注意:

アンパックされたドメインを本番モードで動作させる場合、このパラメータをunpackコマンドに追加して、prodを指定する必要があります。そうしないと、unpackコマンドが開発モードで作成されます。

このパラメータは、管理対象サーバー・テンプレートを使用してWebLogicドメインを作成する場合には使用できません。

devモードを指定した場合、またはこのパラメータを省略した場合は、ドメイン用にboot.propertiesファイルが作成されます。prodモードを指定した場合、boot.propertiesファイルがドメインに対して作成されません。

overwrite_domain

オプション

指定したドメイン・ディレクトリがすでに存在し、空でない場合、ディレクトリにあるファイルが警告なしに自動的に上書きされます。ローカル・カスタマイズのマージまたは保持は試行されません。

注意:

ドメイン生成を開始した後システム・エラーが発生した場合に、ドメイン・ディレクトリは不明な状態にあります。

-log=log_file

オプション

ログ・ファイルの名前。

-log_priority=log_priority

オプション

ログ・ファイルの優先度の設定。log4j優先度文字列を使用します。

有効なlog4j優先度文字列は、debug、info、warn、error、fatalです。優先度文字列の値は、Levelクラスで定義されたレベルに対応します。詳細は、http://logging.apache.org/log4j/を参照してください。

2.2.3 Unpackコマンドの例

C:/oracle/user_templatesディレクトリにあるmydomain.jarテンプレートを使用してC:/oracle/user_projects/domainsディレクトリにmynewdomainというWebLogicドメインを作成するには、次のコマンドを実行します。

unpack -template=C:/oracle/user_templates/mydomain.jar
-domain=C:/oracle/user_projects/domains/mynewdomain

3 リモート・システムの管理対象サーバーの作成および起動

packコマンドとunpackコマンドを使用して、リモート・システム上で管理対象サーバーを作成および起動できます。

一部のWebLogicドメインで、WebLogicドメインの管理サーバーからリモートのシステムで管理対象サーバーを実行する必要がある場合には、次の手順を実行します。

1. packコマンドを使用して管理対象サーバー・テンプレートを作成します。デフォルトでは、管理対象サーバー・テンプレートには、リモート・システムで管理対象サーバーの作成に必要なファイルのみが含まれます。

2. リモート・システムに管理対象サーバー・テンプレートをコピーして復元し、管理対象サーバー・ドメイン・ディレクトリを作成します。

3. リモート・システムの管理対象サーバーを起動します。

この章の内容は次のとおりです。

- 管理対象サーバー・テンプレートの作成
管理対象サーバー・テンプレートを作成するには、1つ以上の管理対象サーバーが定義され、管理対象サーバーの定義がconfig.xmlファイルに記述された既存WebLogicドメインでpackコマンドを実行します。

- リモート・システムでの管理対象サーバーの作成
リモート・システムに管理対象サーバーを作成する前に、リモート・システムのIPアドレスとポート番号が、管理対象サーバー・テンプレートに指定されている管理対象サーバー定義に一致することを確認します。

- リモート・システムでの管理対象サーバーの起動
unpackコマンドを使用して管理対象サーバーのWebLogicドメイン・ディレクトリを作成すると、そのディレクトリには、現在のリモート・システムをターゲットとする各管理対象サーバーのカスタム起動スクリプトが含まれます。これらのカスタマイズ起動スクリプトを使用して、関連する管理対象サーバーを起動できます。

3.1 管理対象サーバー・テンプレートの作成

管理対象サーバー・テンプレートは、1つ以上の管理対象サーバーが定義され、管理対象サーバーの定義がconfig.xmlファイルに記述された既存のWebLogicドメインでpackコマンドを実行することにより作成できます。

管理対象サーバーのテンプレートを作成するには:

1. ローカル・マシン(管理サーバー、および管理対象サーバーの定義を含むマシン)のコマンド行で、ORACLE_HOME/oracle_common/common/binディレクトリに移動します。

2. 次のコマンドを実行します。

pack -managed=true -domain=domain -template=template.jar -template_name="template_name"

コマンドの説明は次のとおりです。

- domainは、テンプレートの作成元WebLogicドメインの絶対パスまたは相対パスです。

- template.jarは、作成されるテンプレートのファイル名まで含めた、テンプレートのフル・パスまたは相対パスです。

- template_nameは、引用符で囲まれたテンプレートを表す名前です。

たとえば、次のコマンドを実行すると、mydomainというWebLogicドメインから、mydomain_managed.jarという管理対象サーバー・テンプレートが作成されます。

pack -managed=true -domain=C:/oracle/user_projects/domains/mydomain -template=C:/oracle/user_templates/mydomain_managed.jar -template_name="My Managed Server Domain"

3.2 リモート・システムでの管理対象サーバーの作成

リモート・システムに管理対象サーバーを作成する前に、リモート・システムのIPアドレスとポート番号が、管理対象サーバー・テンプレートに指定されている管理対象サーバー定義に一致することを確認します。

1. WebLogicドメインの管理対象サーバーをホストするシステムにWebLogic Serverをインストールします。

注意:

WebLogicドメイン内のすべてのWebLogic Serverインスタンスで、同じバージョンのWebLogic Serverソフトウェアを実行する必要があります。WebLogic Serverのインストールの詳細は、『Oracle WebLogic ServerおよびCoherenceのインストールと構成』のOracle WebLogic ServerとCoherenceのソフトウェアのインストールに関する項を参照してください。

2. リモート・システムとのセッションを確立します。そのためには、Telnetなどの任意の有効なメソッドを使用できます。

3. リモート・システムに管理対象サーバー・テンプレートをコピーします。

4. リモート・システムで、ORACLE_HOME\oracle_common\common\binディレクトリに移動します。

5. 次のコマンドを実行します。

unpack -domain=domain -template=template.jar

コマンドの説明は次のとおりです。

- domainは、作成するドメインのフル・パスまたは相対パスです。

- template.jarは、手順3でシステムにコピーした管理対象サーバーのフル・パスまたは相対パスです。

たとえば、次のコマンドでは、myManagedDomainというWebLogicドメインが作成されます。

unpack -domain=C:\oracle\user_projects\domains\myManagedDomain -template=C:\oracle\user_templates\mydomain_managed.jar

3.3 リモート・システムでの管理対象サーバーの起動

unpackコマンドを使用して管理対象サーバーのWebLogicドメイン・ディレクトリを作成すると、そのディレクトリには、現在のリモート・システムをターゲットとする各管理対象サーバーのカスタム起動スクリプトが含まれます。これらのカスタマイズ起動スクリプトを使用して、関連する管理対象サーバーを起動できます。

たとえば、my_managed_server1およびmy_managed_server2という2つの管理対象サーバーを含むWebLogicドメインを作成し、サーバーをシステムm1にターゲット指定した場合は、システムm1に管理対象サーバー・ドメインのディレクトリを作成したときに、startmy_managed_server1.cmd、startmy_managed_server1.sh、startmy_managed_server2.cmdおよびstartmy_managed_server2.shという4つのカスタム起動スクリプトが作成されます。これらのスクリプトを使用して、対応する管理対象サーバーを起動できます。あるいは、startManagedWebLogicスクリプトを必要なパラメータと共に使用することもできます。

1. 『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動と停止に関する項の説明に従って、WebLogicドメインの管理サーバーを起動します。

2. リモート・システムで、「リモート・システムでの管理対象サーバーの作成」で作成したWebLogicドメインのディレクトリに移動します。

3. リモート・システムの管理対象サーバーを起動します。

- Windowsシステムのコマンド・プロンプトで、次のいずれかのコマンドを実行します。
startmy_managed_server

startManagedWebLogic my_managed_server admin-url

- UNIXの場合、以下のいずれかのコマンドを実行します。
./startmy_managed_server.sh

./startManagedWebLogic.sh my_managed_server admin-url

上記のコマンドで、my_managed_serverは起動する管理対象サーバーの名前、admin-urlは管理サーバーをホストするシステムのリスニング・アドレス(ホスト名またはIPアドレス)およびポート番号です。必要に応じて、startManagedWebLogic_Readme.txtファイルに提供された、WebLogicドメインのすべての管理対象サーバーおよびadmin-urlのリストを参照してください。

注意:

管理対象サーバーは、ノード・マネージャを使用して起動することもできます。詳細は、『Oracle WebLogic Serverノード・マネージャの管理』のノード・マネージャを使用した管理対象サーバーの起動に関する項を参照してください。

Oracleの法律上の注意点

コピーライト

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

このドキュメントはPre-General Availability (一般提供前)版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のPre-General Availability Trial Agreement (Pre-GAトライアル契約)のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティ

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。