Oracle® Fusion Middleware

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

リリース12.2.1.1

E77384-01(原本部品番号:E74870-01)

2016年6月

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

Oracle Fusion Middleware WebLogic Server PackおよびUnpackコマンドによるテンプレートとドメインの作成, リリース12.2.1.1

E77384-01

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

原本著者: Geetha Savithriamma、Peter LaQuerre

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

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

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

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コマンドについて説明します。packおよびunpackコマンドを使用すると、コマンド・ラインからWebLogicドメインやテンプレートを簡単に1つの手順で作成できます。packおよびunpackコマンドは、ORACLE_HOME/oracle_common/common/binディレクトリにあります。

注意:

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

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

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

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

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

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

- Packコマンドの概要

- Unpackコマンドの概要

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コマンド

- Unpackコマンド

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コマンドの実行時にはエラーが表示されます。管理者のパスワードは、managedパラメータをfalseに設定したpackコマンドによって作成されたテンプレートに対して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

オプション

管理ユーザーに使用するunpackのパスワードを含むウォレット・ファイルのあるディレクトリ。これは、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パラメータを指定して新しい管理ユーザーを追加できます。

値は、カンマ、タブまたは次のリストの文字を含んではなりません: < > # | & ? ( ) { }。ユーザー名では、大文字と小文字が区別されます。

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

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

-password=password

オプション

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

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

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

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

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

-app_dir=application_directory

オプション

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

このパラメータは、テンプレートが個別のアプリケーション・ディレクトリをサポートしている場合にのみ使用できます。

-nodemanager_type=type

オプション

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

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

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

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

デフォルト値はPerDomainNodeManagerです。

-nodemanager_home=home

条件付き

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

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

-java_home=java_home_directory

オプション

Javaホーム・ディレクトリのフルパス。設定した場合は、WebLogicドメインの管理サーバーによって使用されるデフォルトの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. リモート・マシンの管理対象サーバーを起動します。
詳細は、「リモート・マシンでの管理対象サーバーの起動」を参照してください。

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

- リモート・マシンでの管理対象サーバーの作成

- リモート・マシンでの管理対象サーバーの起動

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 リモート・マシンでの管理対象サーバーの作成

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

注意:

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

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

リモート・マシンのIPアドレスおよびポート番号は、管理対象サーバー・テンプレートで指定した管理対象サーバーの定義と一致する必要があります。

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システムのDOSプロンプトで、以下のいずれかのコマンドを実行します。
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ノード・マネージャの管理』を参照してください。

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2016, 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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

アルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが試作版の場合:

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

非公開のアルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが非公開の試作版の場合:

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

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork 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を参照してください。