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

12c リリース1 (12.1.1)

B65928-02(原本部品番号:E24487-02)

目次

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

はじめに

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

- 表記規則

1 概要とロードマップ

- ドキュメントのスコープと対象読者

- このドキュメントの手引き

- 関連ドキュメント

- このリリースでの新機能と変更点

2 Oracle WebLogic Server Javaユーティリティの使い方

- appc

- AppletArchiver

- 構文

- autotype (非推奨)

- BuildXMLGen

- CertGen

- 構文

- 例

- ClientDeployer

- clientgen

- Conversion (非推奨)

- dbping

- dbpingを使用してDB2パッケージの作成

- 構文

- 例

- ddcreate (非推奨)

- DDInit

- WebInit

- EarInit (非推奨)

- Deployer

- der2pem

- 構文

- 例

- Derby

- ejbc (非推奨)

- EJBGen

- Encrypt

- 構文

- 例

- getProperty

- 構文

- 例

- host2ior

- 構文

- ImportPrivateKey

- 構文

- 例

- jhtml2jsp

- 構文

- jspc (非推奨)

- logToZip

- 構文

- 例

- MBeanコマンド

- MulticastTest

- 構文

- 例

- myip

- 構文

- 例

- pem2der

- 構文

- 例

- rmic

- Schema

- 構文

- 例

- servicegen (非推奨)

- SearchAndBuild

- 例

- source2wsdd (非推奨)

- system

- 構文

- 例

- ValidateCertChain

- verboseToZip

- 構文

- 例

- wlappc

- wlcompile

- wlconfig

- wldeploy

- wlpackage

- wlserver

- wsdl2Service

- wsdlgen (非推奨)

- wspackage (非推奨)

3 weblogic.Serverコマンド・ライン・リファレンス

- weblogic.Serverユーティリティの環境要件と構文

- 環境

- クラスパスの変更

- 構文

- デフォルト動作

- weblogic.Server構成オプション

- JVMパラメータ

- 構成データの場所

- 例

- サーバーの構成をオーバーライドするオプション

- サーバー通信

- SSL

- セキュリティ

- メッセージの出力とロギング

- クラスタ

- デプロイメント

- 他のサーバー構成のオプション

- weblogic.Serverコマンド・ラインを使用したサーバー・インスタンスの起動

- weblogic.Serverコマンド・ラインを使用したWebLogic Server実行時フット・プリントの制限

- weblogic.Serverコマンド・ラインを使用したドメインの作成

- コマンド・ラインで設定した属性値の確認

4 WebLogic SNMPエージェント・コマンド・ライン・リファレンス(非推奨)

- SNMPコマンド・ライン・インタフェースの環境要件

- SNMPコマンド・ライン・インタフェースの構文と共通の引数

- WebLogic Server管理対象オブジェクトを取得するためのコマンド

- snmpwalk

- 構文

- 例

- snmpgetnext

- 構文

- 例

- snmpget

- 構文

- 例

- トラップをテストするためのコマンド

- snmptrapd

- 構文

- 例

- snmpv1trap

- 構文

- 例

- 例: snmpv1trapによるトラップ・デーモンへのトラップの送信

- 例: WebLogic SNMPエージェントによるトラップ・デーモンへのトラップの送信

Oracle® Fusion Middleware

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

12c リリース1 (12.1.1)

B65928-02(原本部品番号:E24487-02)

2012年1月

このドキュメントでは、Oracle WebLogic Serverのコマンド・ライン・リファレンス機能とJavaユーティリティ、またそれらを使用してOracle WebLogic Serverを管理する方法について説明します。

Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンス, 12c リリース1 (12.1.1)

B65928-02

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

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

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

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

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

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

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

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

はじめに

ここでは、このガイド『Oracle WebLogic Serverコマンド・リファレンス』で使用されているドキュメントのアクセシビリティ機能と規則について説明します。

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

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

Oracleサポートへのアクセス

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を参照してください。

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

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

斜体

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

固定幅フォント

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

1 概要とロードマップ

この項では、このガイド『Oracle WebLogic Serverコマンド・リファレンス』の内容と構成について説明します。

- ドキュメントのスコープと対象読者

- このドキュメントの手引き

- 関連ドキュメント

- このリリースでの新機能と変更点

ドキュメントのスコープと対象読者

このドキュメントでは、Oracle WebLogic Serverのコマンド・ライン・リファレンス機能とJavaユーティリティ、またそれらを使用してOracle WebLogic Serverを管理する方法について説明します。

このドキュメントは、Java Platform、Enterprise Edition (Java EE)を使用してe- コマース・アプリケーションをデプロイするシステム管理者およびアプリケーション開発者を対象としています。読者は、Webテクノロジ、およびOracle WebLogic Serverがインストールされているオペレーティング・システムとプラットフォームに精通していることが前提となっています。

このドキュメントの手引き

このドキュメントの構成は次のとおりです。

- この章「概要とロードマップ」では、このドキュメントの構成および関連ドキュメントについて説明します。

- 第2章「Oracle WebLogic Server Javaユーティリティの使い方」では、Oracle WebLogic Serverドメインの管理とトラブルシューティングを行うための様々なJavaユーティリティについて説明します。

- 第3章「weblogic.Serverコマンド・ライン・リファレンス」では、Oracle WebLogic Serverインスタンスをコマンド・シェルまたはスクリプトから起動する方法について説明します。

- 第4章「WebLogic SNMPエージェント・コマンド・ライン・リファレンス(非推奨)」では、Simple Network Management Protocol (SNMP)を使用して企業全体の管理システムと通信する方法について説明します。

関連ドキュメント

- 『Oracle WebLogic Serverアプリケーションの開発』のAntタスクを使用したWebLogic Serverドメインの構成と使用に関する項。

- 『Oracle WebLogic Scripting Tool』

- 『Oracle WebLogic Serverサーバー環境の構成』

- Oracle WebLogic Server管理コンソール・ヘルプ

このリリースでの新機能と変更点

このリリースで導入されたWebLogic Serverの新機能の一覧については、『Oracle WebLogic Serverの新機能』を参照してください。

2 Oracle WebLogic Server Javaユーティリティの使い方

Oracle WebLogic Serverには、管理およびプログラミング・タスクを行うためのJavaユーティリティとAntタスクが用意されています。この章では、それらのJavaユーティリティとAntタスクについて説明します。

これらのユーティリティとタスクを使用するには、CLASSPATHを正しく設定する必要があります。詳細については、「クラスパスの変更」を参照してください。

Oracle WebLogic Serverには、インストールおよび構成タスクを簡素化したり、サービスを提供したり、便利なショートカットを提供したりするJavaプログラムが用意されています。以下では、Oracle WebLogic Serverに付属のすべてのJavaユーティリティについて説明します。ここでは、すべてのユーティリティのコマンド・ライン構文を示し、一部のユーティリティについては使用例を紹介します。

また、Oracle WebLogic Serverには、一般的なサーバー・プログラミング・タスクを自動化するAntタスクも用意されています。Apache Webサイトでは、その他の便利なAntタスク(EAR、WAR、およびJARファイルのパッケージ化など)が提供されています。詳細については、(http://jakarta.apache.org/ant/manual/)を参照してください。

- appc

- AppletArchiver

- autotype (非推奨)

- BuildXMLGen

- CertGen

- ClientDeployer

- clientgen

- Conversion (非推奨)

- dbping

- ddcreate (非推奨)

- DDInit

- Deployer

- der2pem

- Derby

- ejbc (非推奨)

- EJBGen

- Encrypt

- getProperty

- host2ior

- ImportPrivateKey

- jhtml2jsp

- jspc (非推奨)

- logToZip

- MBeanコマンド

- MulticastTest

- myip

- pem2der

- rmic

- Schema

- servicegen (非推奨)

- SearchAndBuild

- source2wsdd (非推奨)

- system

- ValidateCertChain

- verboseToZip

- wlappc

- wlcompile

- wlconfig

- wldeploy

- wlpackage

- wlserver

- wsdl2Service

- wsdlgen (非推奨)

- wspackage (非推奨)

appc

appcコンパイラは、EJBおよびJSPをOracle WebLogic Serverにデプロイするのに必要なクラスを生成し、コンパイルします。また、個別のモジュール・レベルとアプリケーション・レベルの両方で、現在の仕様に準拠しているかどうかデプロイメント記述子を検証します。『Oracle WebLogic Server Enterprise JavaBeansバージョン2.1のプログラミング』のappcリファレンスに関する項を参照してください。

AppletArchiver

AppletArchiverユーティリティは、別のフレームにあるアプレットを実行し、ダウンロードされたクラスと、そのアプレットによって使用されたリソースの記録をすべて保持し、.jarファイルまたは.cabファイルにパッケージ化します(cabarcユーティリティはMicrosoftから入手できます)。

構文

$ java utils.applet.archiver.AppletArchiver URL filename

表2-1に、AppletArchiverユーティリティに渡される引数を示します。

表2-1 AppletArchiverの引数

引数

定義

URL

アプレットのURL。

filename

.jar/.cabアーカイブの宛先であるローカル・ファイル名。

autotype (非推奨)

autotype Antタスクは、Webサービス用の非組込みデータ型コンポーネント(シリアライゼーション・クラスなど)を生成するために使用します。autotype Antタスクの完全修飾名は、weblogic.ant.taskdefs.webservices.javaschema.JavaSchemaです。

WebサービスAntタスクの詳細なリストについては、『Oracle WebLogic Server WebLogic Webサービス・リファレンス』のAntタスク・リファレンスの項を参照してください。

BuildXMLGen

BuildXMLGenは、分割ディレクトリ構造のエンタープライズ・アプリケーション用のbuild.xmlファイルを生成するために使用します。このユーティリティの詳細は、『Oracle WebLogic Serverアプリケーションの開発』の分割開発ディレクトリでのアプリケーションのビルドに関する項を参照してください。

CertGen

CertGenユーティリティによって生成される証明書は、デモまたはテスト専用のもので、本番環境では使用できません。

構文

$ java utils.CertGen
-certfile <cert_file> -keyfile <private_key_file>
-keyfilepass <private_key_password>
[-cacert <ca_cert_file>][-cakey <ca_key_file>]
[-cakeypass <ca_key_password>]
[-selfsigned][-strength <key_strength>]
[-e <email_address>][-cn <common_name>]
[-ou <org_unit>][-o <organization>]
[-l <locality>][-s <state>][-c <country_code>]
[-keyusage [digitalSignature,nonRepudiation,keyEncipherment,
dataEncipherment,keyAgreement,keyCertSign,
cRLSign,encipherOnly,decipherOnly]]
[-keyusagecritical true|false]
[-subjectkeyid <subject_key_identifier>]
[-subjectkeyidformat UTF-8|BASE64]
[-help]

表2-2に、CertGenユーティリティに渡される引数を示します。

表2-2 CertGenの引数

引数

定義

-certfile cert_file
-keyfile private_key_file

生成されるパブリック証明書用と秘密鍵用の、拡張子を付けない出力ファイル名。pemおよびderファイルの作成時に適切な拡張子が付加されます。

-keyfilepass private_key_password

生成される秘密鍵のパスワード。

-cacert ca_cert_file
-cakey ca_key_file
-cakeypass ca_key_password

生成される証明書の発行者として使用されるCAのパブリック証明書、秘密鍵ファイル、秘密鍵パスワード。これらのオプションのうち1つまたは複数が指定されていない場合、関連するデモCAファイルCertGenCA.derおよびCertGenCAKey.derが使用されます。CertGenユーティリティは、最初に現在の作業ディレクトリ、次にWL_HOME/libディレクトリを検索します。

-selfsigned

信頼性のあるCA証明書として使用できる自己署名証明書を生成します。この引数を指定する場合は、ca_cert_filename、ca_key_filename、およびca_key_password引数を指定しないでください。

-strength key_strength

生成するキーの長さ(ビット単位)。キーが長くなるほど、暗号の解読が難しくなります。

-e email_address

生成される証明書に関連付ける電子メール・アドレス。

-cn common_name

生成される証明書に関連付ける名前。

-ou org_unit

生成される証明書に関連付ける組織単位名。

-o organization

生成される証明書に関連付ける組織名。

-l locality

市町村の名前。

-s state

組織が米国またはカナダにある場合は、その組織が活動している州の名前。省略不可です。

-c country_code

ISOの2文字の国コード。米国のコードはUS。

-keyusage [digitalSignature,
nonRepudiation,keyEncipherment,
dataEncipherment,keyAgreement,
keyCertSign,cRLSign,
encipherOnly,decipherOnly]

キー用途の拡張機能、およびビット名のカンマ区切りのリストに応じたビット・セットを付加して証明書を生成します。

複数の処理に使用される可能性のあるキーに対して、処理を制限する場合は、キー用途を指定します。

-keyusagecritical true|false

デフォルトでは、キー用途拡張機能は「重要」とマークされます。拡張が「重要」でない証明書を生成するには、-keyusagecritical falseを使用します。

-subjectkeyid subject_key_identifier

指定されたサブジェクト・キー識別子を持つ証明書を生成します。

-subjectkeyidformat UTF-8|BASE64

subjectkeyid値のフォーマット。デフォルトはUTF-8です。

例

デフォルトでは、CertGenユーティリティは現在のディレクトリまたはWL_HOMEディレクトリからCertGenCA.derおよびCertGenCAKey.derファイルを検索します。これは、weblogic.homeシステム・プロパティまたはCLASSPATHで指定します。かわりに、コマンド・ラインでCAファイルを指定することもできます。

次のコマンドを入力すると、testcertという名前の証明書ファイルとtestkeyという名前の秘密鍵ファイルが生成されます。

$ java utils.CertGen -keyfilepass mykeypass
-certfile testcert -keyfile testkey
Generating a certificate with common name return and key strength 1024
issued by CA with certificate from CertGenCA.der file and key from CertGenCAKey.der file

ClientDeployer

Java EE EARファイルからクライアント側JARファイルを展開して、デプロイ可能なJARファイルを作成するには、weblogic.ClientDeployerを使用します。weblogic.ClientDeployerクラスは、Javaコマンド・ラインで次の構文を使用して実行します。

java weblogic.ClientDeployer ear-file client

ear-file引数は、1つまたは複数のクライアント・アプリケーションJARファイルが格納されている展開されたディレクトリ か、または拡張子.earを持つJavaアーカイブ・ファイルです。

例:

java weblogic.ClientDeployer app.ear myclient

上記の例で、app.earは、myclient.jarにパッケージ化されたJava EEクライアントを格納するEARファイルです。

EARファイルからクライアント側のJARファイルが展開されたら、weblogic.j2eeclient.Mainユーティリティを使用してクライアント側アプリケーションをブート・ストラップし、次のようにWebLogic Serverインスタンスを示すようにします。

java weblogic.j2eeclient.Main clientjar URL [application args]

例:

java weblogic.j2eeclient.Main helloWorld.jar t3://localhost:7001 Greetings

clientgen

clientgenを使用して、Webサービスを呼び出すために必要なクライアント側のアーティファクト(JAX-RPCスタブなど)を生成します。『Oracle WebLogic Server WebLogic Webサービス・リファレンス』のAntタスク・リファレンスの項を参照してください。

Conversion (非推奨)

WebLogic Server 9.0は、6.0より前のバージョンのOracle WebLogic Serverからの変換またはアップグレードをサポートしていません。バージョン6.1以降からのアップグレードについては、『Oracle WebLogic Serverアップグレード・ガイド』を参照してください。

dbping

dbpingコマンド・ライン・ユーティリティを使用すると、JDBCドライバを使用したDBMSとクライアント・マシンの間の接続をテストできます。このユーティリティを使用する前に、ドライバをインストールしておく必要があります。ドライバのインストール方法の詳細は、ドライバ・ベンダーのドキュメントを参照してください。また、『Oracle WebLogic Server JDBCのプログラミング』のWebLogic Serverでのサード・パーティ・ドライバの使用方法に関する項も参照してください。

dbpingを使用してDB2パッケージの作成

DB2用のWebLogicタイプ4 JDBCドライバを使用する場合は、dbpingユーティリティを使用して、DB2サーバー上にパッケージを作成することもできます。dbpingユーティリティを使用してデータベースに対してpingを実行すると、データベース・サーバー上にデフォルトのパッケージがドライバによって自動的に作成されます(まだ存在していない場合)。データベース・サーバー上にデフォルトのパッケージがすでに存在している場合、dbpingユーティリティでは既存のパッケージが使用されます。

デフォルトのDB2パッケージには200の動的セクションが含まれます。-dオプションを使用して、DB2パッケージに作成する動的セクションの異なる数を指定できます。また、-dオプションは、接続テストで使用される接続に対し、CreateDefaultPackage=trueおよびReplacePackage=trueも設定します。これにより、DB2ドライバはDB2サーバー上のDB2パッケージの置き換えるよう強制されます。(詳細は、『Oracle WebLogic Server JDBCのプログラミング』のDataDirectドキュメントの使用に関する項を参照してください。)動的セクション数を200に設定して-dオプションを使用することで、DB2サーバー上でデフォルトのパッケージを強制的に再作成できます。

注意:

-dオプションを指定すると、dbpingユーティリティによってデフォルトのパッケージが再作成され、動的セクション数として指定する値が使用されます。既存のパッケージが変更されるわけではありません。

DB2パッケージを作成するには、指定するユーザーはデータベースに対してCREATE PACKAGE権限を持っている必要があります。

構文

$ java utils.dbping DBMS [-d dynamicSections] user password DB

表2-3に、dbpingコマンド・ライン・ユーティリティに渡される引数を示します。

表2-3 dbpingの引数

引数

定義

DBMS

DBMSおよびJDBCドライバによって異なります。

DB2B - DB2用のWebLogicタイプ4 JDBCドライバ

DERBY: 組込みのDerbyドライバ

JCONN2 - Sybase JConnect 5.5 (JDBC 2.0)ドライバ

JCONN3 - Sybase JConnect 6.0 (JDBC 2.0)ドライバ

JCONNECT - Sybase JConnectドライバ

INFORMIXB - Informix用のWebLogicタイプ4 JDBCドライバ

MSSQLSERVER4 - WebLogic jDriver for Microsoft SQL Server

MSSQLSERVERB - Microsoft SQL Server用のWebLogicタイプ4 JDBCドライバ

MYSQL - MySQLのタイプ4ドライバ

ORACLE - WebLogic jDriver for Oracle

ORACLEB - Oracle用のWebLogicタイプ4 JDBCドライバ

ORACLE_THIN - Oracle Thinドライバ

POINTBASE - PointBase Universal Driver

SYBASEB - Sybase用のWebLogicタイプ4 JDBCドライバ

[-d dynamicSections]

DB2パッケージに作成する動的セクション数を指定します。このオプションは、DB2用のWebLogicタイプ4 JDBCドライバを使用する場合のみ使用します。

-dオプションが指定されると、ドライバによって、接続に対してCreateDefaultPackage=trueおよびReplacePackage=trueが自動的に設定され、指定する動的セクション数でDB2パッケージが作成されます。

user

ログインに使用する有効なデータベース・ユーザー名。isql、sqlplusなどのSQLコマンド・ライン・ツールで使用する値と同じ値を使用します。

-dオプションが指定されているDB2の場合、ユーザーはデータベースに対してCREATE PACKAGE権限を持っている必要があります。

password

ユーザーの有効なデータベース・パスワード。isqlまたはsqlplusで使用する値と同じ値を使用します。

DB

データベースの名前と場所。使用するJDBCドライバに応じて次の形式で指定します。

DB2B - Host:Port/DBName

DERBY: Host:Port/DBName

JCONN2 - Host:Port/DBName

JCONN3 - Host:Port/DBName

JCONNECT - Host:Port/DBName

INFORMIXB - Host:Port/DBName/InformixServer

MSSQLSERVER4 - Host:Port/DBNameまたは[DBName@]Host[:Port]

MSSQLSERVERB - Host:Port/DBName

MYSQL - Host:Port/DBName

ORACLE - DBName (tnsnames.oraに表示されているもの)

ORACLEB - Host:Port/DBName

ORACLE_THIN - Host:Port/DBName

POINTBASE - Host[:Port]/DBName

SYBASEB - Host:Port/DBName

説明:

- Hostは、DBMSのホスト・マシンの名前です。

- Portは、DBMSが接続をリスニングするデータベース・ホストのポートです。

- DBNameは、DBMSのデータベースの名前です。

- InformixServerは、Informix DBMSサーバーを識別するInformix固有の環境変数です。

例

Oracle Thinドライバの使用例を次に示します。

C:\>java utils.dbping ORACLE_THIN scott tiger dbserver1:1561:demo

**** Success!!! ****

You can connect to the database in your app using:

java.util.Properties props = new java.util.Properties();
props.put("user", "scott");
props.put("password", "tiger");
props.put("dll", "ocijdbc9");
props.put("protocol", "thin");
java.sql.Driver d =
Class.forName("oracle.jdbc.driver.OracleDriver").newInstance();
java.sql.Connection conn =
Driver.connect("jdbc:oracle:thin:@dbserver1:1561:demo", props);

Derbyドライバの使用例を次に示します。Derbyは、WebLogic Serverにバンドルされているオープン・ソースのリレーショナル・データベース管理システムです。サンプル・アプリケーションとサンプル・コードでデモ用のデータベースとして使用されます。

$ java utils.dbping DERBY examples examples localhost:1527/demo
**** Success!!! ****
You can connect to the database in your app using:

java.util.Properties props = new java.util.Properties();
props.put("user", "examples");
props.put("password", "examples");
java.sql.Driver d =
Class.forName("org.apache.derby.jdbc.ClientDriver").newInstance();
java.sql.Connection conn =
Driver.connect("jdbc:derby://localhost:1527/demo", props);

ddcreate (非推奨)

このAntタスクは、EARInitを呼び出します。EARInitは、EAR用のapplication.xmlおよびweblogic-application.xmlファイルを生成します。詳細については、「EarInit (非推奨)」を参照してください。

DDInit

DDInitは、Oracle WebLogic Serverにデプロイされるアプリケーションのデプロイメント記述子を生成するためのユーティリティです。モジュールのアーカイブまたはフォルダをターゲットとし、DDInitはモジュールのクラス・ファイルにある情報を使用して、適切なデプロイメント記述子ファイルを作成します。

そのコマンド・ライン版であるDDInitは、新しいファイルを記述して既存の記述子ファイルを上書きします。META-INFまたはWEB-INFが存在しない場合は、DDInitによって作成されます。

以下のように、そのタイプに固有のDDInitコマンドを使用することで、デプロイメント記述子を生成するJava EEデプロイ可能ユニットのタイプ(Webアプリケーションまたはエンタープライズ・アプリケーション)を指定します。

WebInit

WARファイル、またはWARファイルとしてアーカイブするファイルが格納されたフォルダをターゲットとし、WebInitはモジュールのweb.xmlおよびweblogic.xmlファイルを作成します。

prompt> java weblogic.marathon.ddinit.WebInit <module>

EarInit (非推奨)

EarInitツールは、このリリースのOracle WebLogic Serverで非推奨になりました。したがって、以下の操作は行わないようにしてください。

- DDInitユーティリティを使用してエンタープライズ・アプリケーションのデプロイメント記述子を生成します。

- ddcreate Antタスクを使用します。このタスクはEarInitを呼び出します。

このコマンドを使用して、EARのapplication.xmlおよびweblogic-application.xmlファイルを生成します。既存のEAR、またはEARファイルにアーカイブするJARまたはWARファイルが格納されたフォルダをターゲットとします。

prompt> java weblogic.marathon.ddinit.EarInit <module>

Deployer

weblogic.Deployerツールを使用すると、コマンド・ラインまたはスクリプト環境で、Java EEアプリケーションおよびコンポーネントをWebLogic Serverにデプロイできます。このツールの使用方法の詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』のweblogic.Deployerコマンド・ライン・リファレンスの項を参照してください。

weblogic.Deployerユーティリティは、非推奨となったweblogic.deployユーティリティにかわるものです。

der2pem

der2pemユーティリティを使用すると、X509証明書をDER形式からPEM形式に変換できます。.pemファイルは、変換元の.derファイルと同じディレクトリに書き込まれ、同じファイル名になります。

構文

$ java utils.der2pem derFile [headerFile] [footerFile]

表2-4に、der2pemユーティリティに渡される引数を示します。

表2-4 der2pemの引数

引数

説明

derFile

変換するファイルの名前。ファイル名は.der拡張子で終わり、ファイルには.der形式の有効な証明書が含まれている必要があります。

headerFile

PEMファイルに配置されるヘッダー。デフォルトのヘッダーは、"-----BEGIN CERTIFICATE-----"です。

変換中のDERファイルが秘密鍵ファイルの場合は、ヘッダー・ファイルを使用します。以下のいずれかを含むヘッダー・ファイルを作成します。

- "-----BEGIN RSA PRIVATE KEY-----" (暗号化されていない秘密鍵の場合)

- "-----BEGIN ENCRYPTED PRIVATE KEY-----" (暗号化されている秘密鍵の場合)

注意: ファイル内のヘッダー行の最後には、改行が必要になります。

footerFile

PEMファイルに配置されるヘッダー。デフォルトのヘッダーは、"-----END CERTIFICATE-----"です。

変換中のDERファイルが秘密鍵ファイルの場合は、フッター・ファイルを使用します。ヘッダーに以下のいずれかを含むフッター・ファイルを作成します。

- "-----END RSA PRIVATE KEY-----" (暗号化されていない秘密鍵の場合)

- "-----END ENCRYPTED PRIVATE KEY-----" (暗号化されている秘密鍵の場合)

注意: ファイル内のヘッダー行の最後には、改行が必要になります。

例

$ java utils.der2pem graceland_org.der
Decoding
................................................................

Derby

Derbyは、Java、JDBCおよびSQLの標準に基づいたオープン・ソースのリレーショナル・データベース管理システムです。WebLogic Serverにバンドルされており、サンプル・アプリケーションとサンプル・コードでデモ用のデータベースとして使用されます。Derbyの詳細は、http://db.apache.org/derbyを参照してください。

ejbc (非推奨)

『Oracle WebLogic Server Enterprise JavaBeansバージョン2.1のプログラミング』のappcリファレンスに関する項を参照してください。

EJBGen

EJBGenは、Enterprise JavaBeans 2.0のコード・ジェネレータです。Beanクラス・ファイルにjavadocタグでアノテーションを付けて、EJBGenでリモート・クラスとホーム・クラス、およびEJBアプリケーションのデプロイメント記述子ファイルを生成し、編集および管理する必要があるEJBファイルの数を1つに減らすことができます。

『Oracle WebLogic Server Enterprise JavaBeansバージョン2.1のプログラミング』のEJBGenリファレンスに関する項を参照してください。

Encrypt

weblogic.security.Encryptユーティリティは、クリア・テキストの文字列をOracle WebLogic Server用に暗号化します。このユーティリティは、現在のディレクトリの暗号化サービス、または指定されたOracle WebLogic Serverドメインのルート・ディレクトリの暗号化サービスを使用します。

注意:

文字列は、暗号化した文字列が使用されるOracle WebLogic Serverドメインの暗号化サービスを使って暗号化しなければなりません。そうしないと、サーバーはその文字列を復号化できません。

Oracle WebLogic Serverドメインに少なくとも1つのサーバー・インスタンスがあるマシン上でのみ、weblogic.security.Encryptユーティリティを実行できます。クライアントからは実行できません。

注意:

このユーティリティは、管理サーバーのドメイン・ディレクトリから実行するか、または管理サーバーをホストするマシン上で実行し、ドメイン・ルート・ディレクトリを指定することをお薦めします。

構文

java [-Dweblogic.RootDirectory=dirname]
[-Dweblogic.management.allowPasswordEcho=true]
weblogic.security.Encrypt [password]

表2-5に、weblogic.security.Encryptユーティリティに渡される引数を示します。

表2-5 Encryptの引数

引数

定義

dirname

省略可能。暗号化した文字列が使用されるOracle WebLogic Serverドメイン・ディレクトリ。指定しない場合、デフォルトのドメイン・ルート・ディレクトリは現在のディレクトリ(ユーティリティを実行するディレクトリ)になります。

weblogic.management.allowPasswordEcho

省略可能。コマンド・ラインで入力した文字が表示されるようにします。weblogic.security.Encryptでは表示されないことを想定しているため、表示する場合は、このプロパティをtrueに設定します。

password

省略可能。暗号化するクリア・テキストの文字列。コマンド・ラインで省略した場合は、パスワードの入力を求められます。

例

ユーティリティは、現在のディレクトリにある暗号化サービスを使用して暗号化した文字列を返します。

java weblogic.security.Encrypt xxxxxx
{AES}yWv/i0qhfM4/IvzoghzjHj/xpJUkQPF8OWuSfh0f0Ss=

ユーティリティは、指定されたドメインの場所にある暗号化サービスを使用して暗号化した文字列を返します。

java -Dweblogic.RootDirectory=./mydomain weblogic.security.Encrypt xxxxxx
{AES}wr86u9Z5DHr+5p7WIbzTDSy4M/sl7EYnX/K5xzcarDQ=

ユーティリティは、現在のディレクトリで暗号化した文字列を返します。このときにパスワードは表示されません。

java weblogic.security.Encrypt
Password:
{AES}LIX8hoiStcAhph0PGCpveouw/0UO0lciODuj+TQh/bs=

getProperty

getPropertyユーティリティを使用すると、Javaの設定およびシステムに関する詳細情報を表示できます。引数はありません。

構文

$ java utils.getProperty

例

$ java utils.getProperty
-- listing properties --
user.language=en
java.home=c:\java11\bin\..
awt.toolkit=sun.awt.windows.WToolkit
file.encoding.pkg=sun.io
java.version=1.1_Final
file.separator=\
line.separator=
user.region=US
file.encoding=8859_1
java.vendor=Sun Microsystems Inc.
user.timezone=PST
user.name=mary
os.arch=x86
os.name=Windows NT
java.vendor.url=http://www.sun.com/
user.dir=C:\weblogic
java.class.path=c:\weblogic\classes;c:\java\lib\cla...
java.class.version=45.3
os.version=4.0
path.separator=;
user.home=C:\

host2ior

host2iorユーティリティはOracle WebLogic Serverのインターオペラブル・オブジェクト参照(IOR)を取得します。

構文

$ java utils.host2ior hostname port

ImportPrivateKey

ImportPrivateKeyユーティリティを使用すると、プライベート・キーストア・ファイルに秘密鍵をロードできます。

構文

$ java utils.ImportPrivateKey
-certfile <cert_file> -keyfile <private_key_file>
[-keyfilepass <private_key_password>]
-keystore <keystore> -storepass <storepass> [-storetype <storetype>]
-alias <alias> [-keypass <keypass>]
[-help]

表2-6に、ImportPrivateKeyユーティリティに渡される引数を示します。

表2-6 ImportPrivateKeyの引数

引数

定義

cert_file

秘密鍵に関連付けられている証明書の名前。

private_key_file

生成される秘密鍵ファイルの名前。

private_key_password

秘密鍵のパスワード。

keystore

キーストア・ファイルの名前。キーストアが存在しない場合は、新しいキーストアが作成されます。

storepass

キーストアのパスワード。

storetype

キーストアのタイプ(フォーマット)。

keytoolコマンドで使用される引数と同様に、storetype引数はJavaキーストアのタイプを指定します。デフォルトのstoretypeはjksであり、java.securityファイルのkeystore.typeプロパティで次のように定義されています。

keystore.type=jks

構成済みのセキュリティ・プロバイダでサポートされている場合は、別のstoretype (pcks12やnCipher.SWorldなど)を指定できます。

alias

キーストアにインポートされている証明書および秘密鍵のルックアップに使用する名前。

keypass

キーストアにインポートされている秘密鍵エントリのパスワード。keypassは指定されていない場合、最初のデフォルトはprivate_key_passwordで、2番目のデフォルトはstorepassです。

注意:

CertGenを使用して、パスワードで保護された秘密鍵ファイルを作成した場合(-keyfilepass private_key_password)、そのパスワードは、ImportPrivateKeyがキー・ファイルからキーを抽出し、新規作成されたキーストアにキーを挿入するために必要になります(キーストアには、cert_fileの証明書とprivate_key_fileの秘密鍵の両方が格納されます)。

例

次の操作を行うには、以下の手順に従います。

- CertGenユーティリティで証明書および秘密鍵を生成する

- ImportPrivateKeyユーティリティでキーストアを作成して秘密鍵を格納する

注意:

デフォルトでは、CertGenユーティリティは現在のディレクトリまたはWL_HOME/server/libディレクトリからCertGenCA.derおよびCertGenCAKey.derファイルを検索します。これは、weblogic.homeシステム・プロパティまたはCLASSPATHで指定します。

かわりに、コマンド・ラインでCAファイルを指定することもできます。デフォルトの設定を使用する場合、コマンド・ラインでCAファイルを指定する必要はありません。

証明書を生成するには、次の手順に従います。

1. 次のコマンドを入力すると、testcertという名前の証明書ファイルとtestkeyという名前の秘密鍵ファイルが生成されます。

$ java utils.CertGen -keyfilepass mykeyfilepass
-certfile testcert -keyfile testkey
Generating a certificate with common name return and key strength 1024
issued by CA with certificate from CertGenCA.der file and key from CertGenCAKey.der file

2. 証明書をDER形式からPEM形式に変換します。

$ java utils.der2pem CertGenCA.der

3. 証明書と認証局(CA)を連結します。

$ cat testcert.pem CertGenCA.pem >> newcerts.pem

4. mykeystoreという名前のキーストアを新たに作成し、testkey.pemファイルにある秘密鍵をロードします。

$ java utils.ImportPrivateKey -keystore mykeystore -storepass mypasswd
-keyfile mykey -keyfilepass mykeyfilepass -certfile newcerts.pem -keyfile
testkey.pem -alias passalias

No password was specified for the key entry
Key file password will be used

Imported private key testkey.pem and certificate newcerts.pem
into a new keystore mykeystore of type jks under alias passalias

jhtml2jsp

JHTMLファイルをJSPファイルに変換します。結果を慎重に調べてください。JHTMLコードには予測できない部分があるため、jhtml2jspは必ずしも完璧な変換結果を生成しません。

出力は、元のファイルに基づいた名前の新しいJSPファイルです。

JSPページから自動生成されるHTTPサーブレットは、JHTMLから生成される通常のHTTPサーブレットとは異なります。JSPサーブレットはweblogic.servlet.jsp.JspBaseを拡張したものであり、通常のHTTPサーブレットで使用できるメソッドにアクセスできません。

JHTMLページでこれらのメソッドを参照してサーブレットのcontextまたはconfigオブジェクトにアクセスする場合は、これらの暗黙的オブジェクトを表すJSPの予約語でメソッドを置き換える必要があります。

JHTMLでJSPの予約語と同じ名前の変数を使用している場合、ツールは警告を出力します。生成されたJSPページのJavaコードを編集して、変数名を予約語とは違う名前に変更する必要があります。

構文

$ java weblogic.utils.jhtml2jsp [-d directory] filename.jhtml

表2-7に、jhtml2jspツールに渡される引数を示します。

表2-7 html2jspの引数

引数

定義

-d directory

省略可能。ターゲット・ディレクトリ。ターゲット・ディレクトリを指定しない場合、出力はカレント・ディレクトリに書き込まれます。

jspc (非推奨)

JSP固有のコンパイラ・タスク。「appc」を使用してください。

logToZip

logToZipユーティリティは、HTTPサーバー・ログ・ファイルの内容を検索し、その中でサーバーによってロードされるJavaクラスを検出してから、それらのJavaクラスを含む非圧縮の.zipファイルを作成します。このユーティリティは、HTTPサーバーのドキュメント・ルート・ディレクトリから実行します。

このユーティリティを使用するには、HTTPサーバーによって作成されたログ・ファイルへのアクセスが必要です。

構文

$ java utils.logToZip logfile codebase zipfile

表2-8に、logToZipユーティリティに渡される引数を示します。

表2-8 logToZipの引数

引数

定義

logfile

必須。ログ・ファイルの完全修飾パス名。

codebase

必須。アプレットのコード・ベース、またはコード・ベースがない場合は""です。コード・ベースをアプレットの完全パッケージ名と連結することで、HTTPドキュメント・ルートからアプレットへのフル・パスを取得します。

zipfile

必須。作成する.zipファイルの名前。.zipファイルは、プログラムを実行しているディレクトリ内に作成されます。指定するファイルのパス名は、相対パスでも絶対パスでもかまいません。例では、相対パス名が使用されているので、.zipファイルはカレント・ディレクトリに作成されます。

例

次の例に、ドキュメント・ルート自体に存在するアプレット用の.zipファイルの作成方法を示します(コード・ベースなしの例)。

$ cd /HTTP/Serv/docs
$ java utils.logToZip /HTTP/Serv/logs/access "" app2.zip

次の例に、ドキュメント・ルートのサブディレクトリに存在するアプレット用の.zipファイルの作成方法を示します。

C:\>cd \HTTP\Serv
C:\HTTP\Serv>java utils.logToZip \logs\applets\classes app3.zip

MBeanコマンド

MBeanコマンド(CREATE、DELETE、GET、INVOKEおよびSET)は、MBeanを管理するために使用します。『WebLogic Scripting Toolコマンド・リファレンス』の編集コマンドに関する項を参照してください。

MulticastTest

MulticastTestユーティリティは、WebLogicクラスタの構成時にマルチキャストに関する問題をデバッグする場合に便利です。このユーティリティは、マルチキャスト・パケットを送信し、ネットワーク上で、マルチキャストがどのくらい効果的に機能しているかについての情報を返します。特に、MulticastTestは標準出力を通して以下のタイプの情報を表示します。

1. 現在のサーバーが送信する各メッセージの確認およびシーケンスID

2. 現在のサーバーを含む、任意のクラスタリングされたサーバーから受信した各メッセージのシーケンスと送信者ID

3. メッセージを受信したがシーケンスがない場合は、シーケンス紛失警告

4. 予期されていたメッセージが受信されなかった場合は、メッセージ紛失警告

MulticastTestを使用するには、まず、マルチキャスト・トラフィックのテストを行う各ノードにこのユーティリティをコピーします。

ヒント:

現在実行しているWebLogicクラスタのアドレスと同じマルチキャスト・アドレス(-aパラメータ)を指定してMulticastTestユーティリティを実行しないでください。このユーティリティは、クラスタリングされたWebLogic Serverを起動する前に、マルチキャストが正しく機能するかどうかの確認を目的としています。

マルチキャストの設定については、WebLogic Serverホスト・マシンのオペレーティング・システムおよびハードウェアの構成に関するドキュメントを参照してください。クラスタの構成の詳細は、『Oracle WebLogic Serverクラスタの使用』を参照してください。

構文

$ java utils.MulticastTest -n name -a address [-p portnumber]
[-t timeout] [-s send]

表2-9に、MulticastTestユーティリティに渡される引数を示します。

表2-9 MulticastTestの引数

引数

定義

-n name

必須。シーケンスされたメッセージの送信者を示す名前。開始するテスト・プロセスごとに、異なる名前を使用してください。

-a address

シーケンスされたメッセージがブロードキャストされるマルチキャスト・アドレス。または、クラスタ内のサーバーが互いに通信するマルチキャスト・アドレス。(デフォルトは237.0.0.1)。

-p portnumber

省略可能。クラスタ内のすべてのサーバーが通信するマルチキャスト・ポート。(マルチキャスト・ポートは、WebLogic Serverに設定されたリスニング・ポートと同じで、設定されていない場合のデフォルトは7001です。)

-t timeout

省略可能。マルチキャスト・メッセージが受け取れない場合のアイドル・タイムアウト(秒単位)。この引数を設定しない場合、デフォルトは600秒(10分)です。タイムアウトを経過すると、タイムアウトの確認情報がstdoutに出力されます。

-s send

省略可能。送信間の時間間隔(秒単位)。この引数を設定しない場合、デフォルトは2秒です。送信された各メッセージの確認情報が、stdoutに出力されます。

例

$ java utils.MulticastTest -N server100 -A 237.155.155.1
Set up to send and receive on Multicast on Address 237.155.155.1 on port 7001
Will send a sequenced message under the name server100 every 2 seconds.
Received message 506 from server100
Received message 533 from server200
I (server100) sent message num 507
Received message 507 from server100
Received message 534 from server200
I (server100) sent message num 508
Received message 508 from server100
Received message 535 from server200
I (server100) sent message num 509
Received message 509 from server100
Received message 536 from server200
I (server100) sent message num 510
Received message 510 from server100
Received message 537 from server200
I (server100) sent message num 511
Received message 511 from server100
Received message 538 from server200
I (server100) sent message num 512
Received message 512 from server100
Received message 539 from server200
I (server100) sent message num 513
Received message 513 from server100

myip

myipユーティリティを使用すると、ホストのIPアドレスを取得できます。

構文

$ java utils.myip

例

$ java utils.myip
Host toyboat.toybox.com is assigned IP address: 192.0.0.1

pem2der

pem2derユーティリティを使用すると、X509証明書をPEM形式からDER形式に変換できます。.derファイルは、変換元の.pemファイルと同じディレクトリに書き込まれます。

構文

$ java utils.pem2der pemFile

表2-10に、pem2derユーティリティに渡される引数を示します。

表2-10 pem2derの引数

引数

説明

pemFile

変換するファイルの名前。ファイル名は.pem拡張子で終わり、ファイルには.pem形式の有効な証明書が含まれている必要があります。

例

$ java utils.pem2der graceland_org.pem
Decoding
................................................................
................................................................
................................................................
................................................................
................................................................

rmic

WebLogic RMIコンパイラは、リモート・オブジェクトを生成してコンパイルするためのコマンド・ライン・ユーティリティです。weblogic.rmicは、クライアント側でアプリケーションのカスタム・リモート・オブジェクト・インタフェースに対して動的プロキシを生成し、サーバー側オブジェクトにホット・コード生成を提供します。『Oracle WebLogic Server RMIのプログラミング』のWebLogic RMIコンパイラの使用方法に関する項を参照してください。

Schema

Schemaユーティリティを使用すると、WebLogic JDBCドライバを使用してデータベースにSQL文をアップロードできます。データベース接続の詳細は、『Oracle WebLogic Server JDBCのプログラミング』を参照してください。

構文

$ java utils.Schema driverURL driverClass [-u username]
[-p password] [-verbose] SQLfile

表2-11に、Schemaユーティリティに渡される引数を示します。

表2-11 Schemaの引数

引数

定義

driverURL

必須。JDBCドライバのURL。

driverClass

必須。JDBCドライバ・クラスのパス名。

-u username

省略可能。有効なユーザー名。

-p password

省略可能。ユーザーの有効なパスワード。

-verbose

省略可能。SQL文とデータベースのメッセージを出力します。

SQLfile

必須。SQL文を記述したテキスト・ファイル。

例

次のコードでは、examples.utilsパッケージのSchemaコマンド・ラインを示します。

$ java utils.Schema
"jdbc:derby://localhost:1527/demo"
"org.apache.derby.jdbc.ClientDriver" -u examples
-p examples examples/utils/ddl/demo.ddl

utils.Schema will use these parameters:
url: jdbc:derby://localhost:1527/demo
driver: org.apache.derby.jdbc.ClientDriver
user: examples
password: examples
SQL file: examples/utils/ddl/demo.ddl

servicegen (非推奨)

servicegen Antタスクは、EJB JARファイルまたはJavaクラス・リストを入力として取り、必要なすべてのWebサービス・コンポーネントを作成してそれらをデプロイ可能なEARファイルにパッケージ化します。

WebLogic Webサービスの8.1と9.0の間で多くの点が変更され、WebサービスがJava EE標準になりました。

WebサービスAntタスクの詳細なリストについては、『Oracle WebLogic Server WebLogic Webサービス・リファレンス』のAntタスク・リファレンスの項を参照してください。

SearchAndBuild

このAntタスクは、FileSetに含まれているbuild.xmlファイルを実行します。このタスクは、FileSetに定義されているすべてのファイルが有効なビルド・ファイルであると見なし、それぞれのファイルに対してAntタスクを実行します。

FileSetのフィルタ処理が正確であることを確認してください。SearchAndBuildTaskの呼出し元となるbuild.xmlファイルが含まれている場合、このタスクは最上位のビルド・ファイル(それ自身)を永久に実行することになるため、無限ループとなります。

例

<project name="all_modules" default="all" basedir=".">
<taskdef name="buildAll"
classname="weblogic.ant.taskdefs.build.SearchAndBuildTask"/>
<target name="all">
<buildAll>
<fileset dir="${basedir}">
<include name="**\build.xml"/>
<exclude name="build.xml"/>
</fileset>
</buildAll>
</target>
</project>

source2wsdd (非推奨)

Javaクラスを使用して実装されるWebLogic WebサービスのJavaソース・ファイルからweb-services.xmlデプロイメント記述子ファイルを生成します。

WebLogic Webサービスの8.1と9.0の間で多くの点が変更され、WebサービスがJava EE標準になりました。

WebサービスAntタスクの詳細なリストについては、『Oracle WebLogic Server WebLogic Webサービス・リファレンス』のAntタスク・リファレンスの項を参照してください。

system

systemユーティリティを使用すると、コンピュータの操作環境に関する基本的な情報を表示できます。この情報には、JDKの製造メーカーとバージョン、CLASSPATH、オペレーティング・システムに関する情報などがあります。

構文

$ java utils.system

例

$ java utils.system
* * * * * * * java.version * * * * * * *
1.5.0_03
* * * * * * * java.vendor * * * * * * *

* * * * * * * java.class.path * * * * * * *
C:\Oracle\Middleware\wlserver_10.3\server\classes;
C:\dev\src\build\JROCKI~2.0_0\lib\tools.jar;
...
* * * * * * * os.name * * * * * * *
Windows 2000
* * * * * * * os.arch * * * * * * *
x86
* * * * * * * os.version * * * * * * *
5.0

ValidateCertChain

WebLogic Serverには、既存の証明書チェーンがWebLogic Serverによって拒否されるかどうかをチェックするためのValidateCertChainユーティリティが用意されています。このユーティリティは、PEMファイル、PKCS-12ファイル、PKCS-12キーストア、およびJKSキーストアの証明書チェーンを使用します。このユーティリティでは、証明書チェーン全体が使用される必要があります。以下は、ValidateCertChainユーティリティの構文です。

java utils.ValidateCertChain -file pemcertificatefilenamejava
utils.ValidateCertChain -pem pemcertificatefilenamejava
utils.ValidateCertChain -pkcs12store pkcs12storefilenamejava
utils.ValidateCertChain -pkcs12file pkcs12filename passwordjava
utils.ValidateCertChain -jks alias storefilename [storePass]

有効な証明書チェーンの例:

java utils.ValidateCertChain -pem zippychain.pemCert[0]: CN=zippy,
OU=FORTESTINGONLY,O=MyOrganization,L=MyTown,ST=MyState,C=USCert[1]:
CN=CertGenCAB,OU=FOR TESTINGONLY,O=MyOrganization,L=MyTown,ST=MyState,C=US

Certificate chain appears valid

無効な証明書チェーンの例:

java utils.ValidateCertChain -jks mykey mykeystoreCert[0]: CN=corba1,
OU=FOR TESTING ONLY, O=MyOrganization,L=MyTown,ST=MyState,C=US

CA cert not marked with critical BasicConstraint indicating it is a
CACert[1]: CN=CACERT,OU=FOR TESTING ONLY,
O=MyOrganization,L=MyTown,ST=MyState,C=USCertificate chain is invalid

verboseToZip

verboseToZipユーティリティは、HTTPサーバーのドキュメント・ルート・ディレクトリから実行されると、verboseモードで実行されているJavaアプリケーションから標準出力を取得し、参照されているJavaクラスを検出してから、それらのJavaクラスを含む非圧縮の.zipファイルを作成します。

構文

$ java utils.verboseToZip inputFile zipFileToCreate

表2-12に、verboseToZipユーティリティに渡される引数を示します。

表2-12 verboseToZipの引数

引数

定義

inputFile

必須。verboseモードで実行されているアプリケーションの出力が含まれる一時ファイル。

zipFileToCreate

必須。作成する.zipファイルの名前。.zipファイルは、プログラムを実行しているディレクトリ内に作成されます。

例

$ java -verbose myapplication > & classList.tmp
$ java utils.verboseToZip classList.tmp app2.zip

wlappc

このユーティリティは、デプロイメント用のJava EE EARファイル、EJB JARファイル、またはWARファイルをコンパイルおよび検証します。

詳細は、『Oracle WebLogic Serverアプリケーションの開発』のwlappcを使用したモジュールおよびアプリケーションのビルドに関する項を参照してください。

wlcompile

wlcompile Antタスクは、javacコンパイラを呼び出して、アプリケーションのJavaファイルを分割開発ディレクトリ構造にコンパイルするために使用します。『Oracle WebLogic Serverアプリケーションの開発』の分割開発ディレクトリでのアプリケーションのビルドに関する項を参照してください。

wlconfig

wlconfig Antタスクを使用すると、動作中の管理サーバー・インスタンス上でMBeanの作成、問合せ、変更を行うことで、WebLogic Serverドメインを構成できます。このAntタスクの詳細は、『Oracle WebLogic Serverアプリケーションの開発』のAntタスクを使用したWebLogic Serverドメインの構成に関する項を参照してください。

wldeploy

wldeploy Antタスクでは、Antタスクで指定した属性を使用してデプロイヤの機能を実行できます(「デプロイヤ」を参照)。『Oracle WebLogic Serverアプリケーションの開発』の分割開発ディレクトリからのデプロイメントとパッケージ化に関する項を参照してください。

wlpackage

wlpackage Antタスクは、分割開発ディレクトリ・アプリケーションを、WebLogic Serverにデプロイ可能な従来のEARファイルとしてパッケージ化するのに使用します。『Oracle WebLogic Serverアプリケーションの開発』の分割開発ディレクトリからのデプロイメントとパッケージ化に関する項を参照してください。

wlserver

wlserver Antタスクを使用すると、WebLogic Serverインスタンスを起動、再起動および停止したり、WebLogic Serverインスタンスへ接続したりできます。サーバー・インスタンスは、構成済のWebLogic Serverドメインにすでに存在している場合もありますが、存在しない場合は、generateconfig=true属性を使用して開発用の新しい単一サーバー・ドメインを作成できます。このAntタスクの詳細は、『Oracle WebLogic Serverアプリケーションの開発』のwlserver Antタスクを使用したサーバーの起動とドメインの作成に関する項を参照してください。

wsdl2Service

wsdl2Service Antタスクは、既存のWSDLファイルを入力として取り、目的のWebサービスの実装を表現するJavaインタフェースと、Webサービスを記述するweb-services.xmlファイルを生成するWebサービス・ツールです。『Oracle WebLogic Server JAX-WS Webサービス・スタート・ガイド』のWSDLファイルから開始するWebLogic Webサービスの開発: 主な手順に関する項を参照してください。

wsdlgen (非推奨)

wsdlgen Antタスクは、Webサービスを実装するEARおよびWARファイルからWSDLファイルを生成するWebサービス・ツールです。

WebLogic Webサービスの8.1と9.0の間で多くの点が変更され、WebサービスがJava EE標準になりました。

WebサービスAntタスクの詳細なリストについては、『Oracle WebLogic Server WebLogic Webサービス・リファレンス』のAntタスク・リファレンスの項を参照してください。

wspackage (非推奨)

Web Services wspackage Antタスクは、WebLogic Webサービスの各種コンポーネントをデプロイ可能な新規EARファイルにパッケージ化し、既存のEARファイルにコンポーネントを追加するために使用します。

WebLogic Webサービスの8.1と9.0の間で多くの点が変更され、WebサービスがJava EE標準になりました。

WebサービスAntタスクの詳細なリストについては、『Oracle WebLogic Server WebLogic Webサービス・リファレンス』のAntタスク・リファレンスの項を参照してください。

3 weblogic.Serverコマンド・ライン・リファレンス

この章では、weblogic.Serverクラスの使用方法について説明します。

weblogic.Serverクラスは、WebLogic Serverインスタンスのメイン・クラスです。Javaコマンドでweblogic.Serverを呼び出すことで、サーバー・インスタンスを起動します。クラスは、コマンド・プロンプト(シェル)で直接呼び出すことも、スクリプトまたはノード・マネージャから間接的に呼び出すこともできます。

以下の理由から、java weblogic.Serverは主に初期の開発時に使用し、本番システムを起動する標準のメカニズムとしては使用しないことをお薦めします。

- MW_HOMEディレクトリの外部にある製品ディレクトリを選択した場合、java weblogic.Serverは機能しません。

- java weblogic.Serverを実行した場合、WebLogic Serverの実行時にパッチが認識されません。

ここでは、以下の項目について説明します。

- weblogic.Serverユーティリティの環境要件と構文

- デフォルト動作

- weblogic.Server構成オプション

- weblogic.Serverコマンド・ラインを使用したサーバー・インスタンスの起動

- weblogic.Serverコマンド・ラインを使用したWebLogic Server実行時フット・プリントの制限

- weblogic.Serverコマンド・ラインを使用したドメインの作成

- コマンド・ラインで設定した属性値の確認

スクリプトを使用してWebLogic Serverインスタンスを起動する方法については、『Oracle WebLogic Serverサーバーの起動と停止の管理』の起動スクリプトによる管理サーバーの起動に関する項と起動スクリプトによる管理対象サーバーの起動に関する項を参照してください。

ノード・マネージャを使用してWebLogic Serverインスタンスを起動する方法については、『Oracle WebLogic Serverノード・マネージャ管理者ガイド』のノード・マネージャを使用したサーバーの制御に関する項を参照してください。

weblogic.Serverユーティリティの環境要件と構文

この節では、サーバー・インスタンスを起動する前に設定する必要のある環境について説明します。次に、weblogic.Serverを呼び出すための構文を示します。

環境

weblogic.Serverコマンドの環境を設定するには、次の手順に従います。

1. 『Oracle WebLogic Serverインストレーション・ガイド』の説明に従って、WebLogic Serverソフトウェアをインストールおよび構成します。

2. 必要な場合は、「クラスパスの変更」の説明に従って、CLASSPATH環境変数を変更します。

3. Java仮想マシン(JVM)をPATH環境変数に追加します。「サポート対象の構成」のリストにある任意のJVMを使用できます。
PATH環境変数にJVMを追加しない場合は、JVMが提供するJava実行可能ファイルのパス名を指定する必要があります。

クラスパスの変更

インストール後、WebLogic Serverのクラスパスはすでに設定されていますが、WebLogic Serverにパッチを追加する、使用するDerbyのバージョンを更新する、Log4jロギングのサポートを追加するなどの理由でクラスパスを変更することもできます。

クラスパスを変更せずにすべてのWebLogic Serverドメインにパッチを適用するには、パッチのJARファイルにweblogic_sp.jarという名前を付け、そのファイルをWL_HOME/server/libディレクトリにコピーします。commEnv.cmd/shスクリプトによって、JARファイルのweblogic_spがクラスパスに自動的に組み込まれます。

パッチ・ファイルにweblogic_sp.jarという名前を付けない場合、または以下に示すようなJARファイルをクラスパスでweblogic.jarの前に確実に追加したい場合、次の手順に従います。

- すべてのドメインで、WL_HOME/common/binのcommEnv.cmd/shスクリプトを編集し、使用するJARファイルをWEBLOGIC_CLASSPATH環境変数の先頭に追加します。

- 特定のWebLogic Serverドメインにパッチを適用するには、そのドメインのbinディレクトリにあるsetDomainEnv.cmd/shスクリプトを編集し、そのJARファイルをPRE_CLASSPATH環境変数の先頭に追加します。

注意:

setDomainEnvは、startWebLogicスクリプトなどの他のスクリプトがソースとなるように設計されています。setDomainEnvは、インタラクティブ・シェル内から直接呼び出さないでください。そうすることにより、使用するドメインで予期できない問題が発生する可能性があります。

Oracle WebLogic Serverに付属しているオープン・ソースかつ100% Javaのデータベース管理システムであり、サンプル・アプリケーションやサンプル・コードで使用されるDerbyを使用する場合は、次のファイルをクラスパスに指定します。

- WL_HOME/common/derby/lib/derbyclient.jar: クライアント側のドライバ用

- WL_HOME/common/derby/lib/derbynet.jarおよびWL_HOME/common/derby/lib/derby.jar: Derbyネットワーク・サーバー実行用

WebLogic Enterprise Connectivityを使用している場合は、以下のファイルをクラスパスに指定します。

WL_HOME/server/lib/wlepool.jar

WL_HOME/server/lib/wleorb.jar

Log4jロギングを使用する場合、以下のファイルをクラスパスに指定します。

WL_HOME/server/lib/log4j.jar

サーバーを実行するシェル環境によって、パス要素を区切るための文字が決まります。Windowsでは、通常はセミコロン(;)を使用します。BASHシェルでは、通常はコロン(:)を使用します。

構文

weblogic.Serverを呼び出すための構文は次のとおりです。

java [options] weblogic.Server [-help]

java weblogic.Server -helpコマンドは、よく使用されるオプションのリストを返します。

デフォルト動作

「環境」のとおりに必要な環境を設定してから、オプションを指定せずにコマンドjava weblogic.Serverを入力すると、WebLogic Serverは次のように動作します。

1. domain_name/configディレクトリ内でconfig.xmlというファイルを探します。

2. domain_name/configディレクトリにconfig.xmlが存在する場合、WebLogic Serverは次のように動作します。

1. config/config.xmlでサーバー・インスタンスが1つだけ定義されている場合、そのサーバー・インスタンスを起動します。
たとえば、WL_HOME\samples\domains\medrecからjava weblogic.Serverを発行すると、WebLogic ServerはMedRecサーバーを起動します。

2. config/config.xmlで複数のサーバー・インスタンスが定義されている場合、

- 管理サーバーが定義されている場合は、その名前のサーバーを探します。

- 管理サーバーが定義されていない場合は、myserverというサーバー構成を探します。サーバー構成が見つかった場合は、myserverインスタンスを起動します。

- myserverというサーバーが見つからない場合、WebLogic Serverはweblogic.Serverプロセスを終了してエラー・メッセージを生成します。

3. カレント・ディレクトリにconfig.xmlファイルがない場合、WebLogic Serverは作成するかどうかを尋ねます。yと回答すると、WebLogic Serverは次のように動作します。

1. myserverという名前のサーバー構成を作成して、config/config.xmlファイルにその構成を格納します。
指定するオプションはすべてconfig.xmlファイルに保持されます。たとえば、-Dweblogic.ListenPort=8001と指定すると、WebLogic Serverはconfig.xmlファイルに8001を保存します。指定しないオプションについては、サーバー・インスタンスはデフォルト値を使用します。

構成ファイルのバックアップ・コピーを作成するようにWebLogic Serverを構成できます。そうすることで、構成の変更を元に戻す必要がある場合や、万一構成ファイルが破損した場合に、リカバリしやすくなります。詳細は、『Oracle WebLogic Serverドメイン構成の理解』の構成ファイルのアーカイブに関する項を参照してください。

2. 指定されたユーザー名とパスワードを使用して、管理者権限を持つユーザーを作成します。このユーザーの定義を、他の基本的なセキュリティ関連のデータと一緒にdomain_name/securityのDefaultAuthenticatorInit.ldift、DefaultRoleMapperInit.ldift、およびSerializedSystemIni.datファイルに格納します。
WebLogic Serverはユーザー名とパスワードを暗号化してserver_name/security/boot.propertiesファイルに格納します。これにより、以後サーバーをインスタンス化するときにはログイン・プロンプトが回避されます。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の起動IDファイルに関する項を参照してください。

3. 以後サーバーをインスタンス化するときに使用できる2つのスクリプト、bin/startWebLogic.cmdおよびbin/startWebLogic.shを作成します。テキスト・エディタを使用して、サーバーを本番モードと開発モードのどちらで起動するかなどの起動オプションを変更することができます。startWebLogicスクリプトには、各オプションを説明するコメントが含まれています。

サーバーは新しいドメインの管理サーバーとして起動されます。このドメインには他のサーバーはなく、また、デプロイメントもサード・パーティ製ソリューションもありません。それらは任意のWebLogicドメインに追加するのと同じように追加できます。

weblogic.Server構成オプション

weblogic.Serverオプションを使用すると、サーバー・インスタンスの属性を構成できます。サーバー・インスタンスの起動時には、一般に以下の属性が使用されます。

- JVMパラメータ

- 構成データの場所

- サーバーの構成をオーバーライドするオプション

WebLogic Serverには、サーバーの保存済み構成を一時的にオーバーライドするための起動オプションも用意されています。これらの起動オプションについては、「サーバーの構成をオーバーライドするオプション」を参照してください。

「weblogic.Serverコマンド・ラインを使用したドメインの作成」で説明するとおりに新しいドメインを作成する場合以外は、すべての起動オプションが現在のサーバーのインスタンス化に適用され、既存のconfig.xmlファイルに保持されている値は変更されません。config.xmlファイルを変更するには、管理コンソールまたはWebLogic Scripting Tool (WLST)を使用します。『Oracle WebLogic Scripting Tool』のWLSTオフラインを使用したドメインの作成に関する項を参照してください。

設定したWebLogic Server属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

JVMパラメータ

表3-1に、サーバー・インスタンスが動作するJava仮想マシン(JVM)を構成するために、よく使用されるオプションを示します。JVMオプションの完全なリストについては、ご使用のJVMのドキュメントを参照してください。WebLogic Serverで使用されるJVMのリストについては、「サポート対象の構成」を参照してください。

表3-1 JVMパラメータを設定するためのよく使用されるオプション

オプション

説明

-Xms and -Xmx

Javaヒープ・メモリーの最小値と最大値を指定します(MB単位)。

たとえば、デフォルトの256MBのJavaヒープ・メモリーをWebLogic Serverに割り当ててサーバーを起動するとします。そのためには、java -Xms256mおよび-Xmx512mオプションを使用してサーバーを起動します。

パラメータに割り当てられたこれらの値は、WebLogic Serverのパフォーマンスに大きく影響する可能性があり、ここでは一般的なデフォルト値としてのみ紹介しています。本番環境では、実際のアプリケーションや環境に合った適切なメモリー・ヒープ・サイズを慎重に判断する必要があります。

-classpath

このオプションで指定する最低限の内容は、「クラスパスの変更」で説明されています。

この引数を使用するかわりに、CLASSPATH環境変数を使用してクラスパスを指定できます。

-client
-server

一部のJVMがHotSpot仮想マシンを起動するために使用します。この機能を使用するとパフォーマンスが向上します。WebLogic Serverで使用されるJVMのリストについては、「サポート対象の構成」を参照してください。

-Dfile.encoding=Canonical Name weblogic.Server

Linuxブラウザで特殊文字を表示するには、JVMのfile.encodingシステム・プロパティをISO8859_1に設定します。例:

java -Dfile.encoding=ISO8859_1 weblogic.Server

詳細なリストについては、Java SE 1.6の「Supported Encodings」 (http://download.oracle.com/javase/6/docs/technotes/guides/intl/encoding.doc.html)を参照してください。

構成データの場所

すべてのサーバー・インスタンスは、構成データにアクセスできる必要があります。表3-2に、このデータの場所を指定するためのオプションを示します。

表3-2 構成データの場所を指定するためのオプション

オプション

説明

-Dweblogic.home=WL_HOME

WebLogicホーム・ディレクトリの場所を指定します。WebLogicホーム・ディレクトリには必要不可欠な情報が格納されています。

デフォルトでは、weblogic.Serverはクラスパス内の値に基づいてWebLogicホーム・ディレクトリの場所を判別します。

-Dweblogic.RootDirectory=path

サーバーのルート・ディレクトリを指定します。『Oracle WebLogic Serverドメイン構成の理解』のサーバーのルート・ディレクトリに関する項を参照してください。

デフォルトでは、ルート・ディレクトリは起動コマンドを発行するディレクトリ。

-Dweblogic.management.GenerateDefaultConfig=true

config.xmlファイルの作成時にweblogic.Serverクラスが確認を求めないようにします。

weblogic.Serverを空のディレクトリで呼び出した場合にだけ有効。「デフォルト動作」を参照してください。

-Dweblogic.Domain=domain

ドメインの名前を指定します。

weblogic.Serverを使用してドメインを作成する場合、このオプションを使用するとドメインに特定の名前を指定できます。

また、このオプションでは、7.0より前のリリースのWebLogic Serverで要求され、現在のリリースでも引続きサポートされるディレクトリ構造をサポートします。7.0より前のリリースでは、構成ファイルが以下のパス名に格納されている必要がありました。

.../config/domain_name/config.xml

ここで、domain_nameは、ドメインの名前です。

ドメインの構成ファイルがそのパス名に準拠していて、config/domain_name以外のディレクトリからweblogic.Serverコマンドを呼び出す場合、-Dweblogic.Domain=domain引数を指定すると、WebLogic Serverはconfig/domain_name/config.xmlに一致するパス名内でconfig.xmlファイルを探します。

管理対象サーバーが構成データを取得する方法については、表3-3の-Dweblogic.management.serverエントリを参照してください。

管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

例

以下の例では、SimpleManagedServerという名前の管理対象サーバー・インスタンスを起動します。管理対象サーバーはその構成データを管理サーバーに問い合せるため、config.xmlファイルの指定は有効ではありません。WebLogic Serverの複数のインスタンスで、同じルート・ディレクトリを使用することもできます。ただし、サーバー・インスタンスでルート・ディレクトリを共有する場合、すべての相対ファイル名は一意でなければなりません。この例では、SimpleManagedServerはSimpleServerとルート・ディレクトリを共有しています。コマンドは、WL_HOME\server\bin\setWLSEnv.cmdの実行後にD:\ディレクトリから発行されます。

D:\> java -Dweblogic.Name=SimpleManagedServer
-Dweblogic.management.server=http://localhost:7001
-Dweblogic.RootDirectory=c:\my_domains\SimpleDomain weblogic.Server

サーバーの構成をオーバーライドするオプション

ほとんどの場合、ドメインのconfig.xmlファイルに保存されている構成を起動オプションでオーバーライドする必要はありません。ただし、その必要が生じる場合もまれにあります。

ヒント:

起動オプションを使用して構成値をオーバーライドした場合、サーバー・インスタンスはそのライフ・サイクルにわたってその値を使用します。管理コンソール、WebLogic Scripting Tool、または他のユーティリティを使用してこの値を変更しても、変更した値は、オーバーライド・オプションを使用せずにサーバーを再起動するまでオーバーライドされたままになります。

たとえば、本番環境で、ドメインのconfig.xmlファイルの変更を禁止するポリシーが設定されているにもかかわらず、一時的なリスニング・ポートを使用して管理サーバーを再起動する必要があるとします。この場合、weblogic.Serverコマンドを使用して管理サーバーを起動するときに、-Dweblogic.ListenPort=7501という起動オプションを指定することで現在のサーバー・セッションのリスニング・ポートを変更できます。サーバー・インスタンスは、config.xmlファイルからその構成MBeanを初期化しますが、リスニング・ポートの値として7501を使用します。その後、起動オプションを渡さずに管理サーバーを再起動すると、サーバー・インスタンスはconfig.xmlファイルの値である8010を再び使用します(図3-1を参照)。

図3-1 config.xml値のオーバーライド

「図3-1 config.xml値のオーバーライド」の説明

以下のオブジェクトを使用して、サーバーの構成を一時的にオーバーライドします。

- サーバー通信

- SSL

- セキュリティ

- メッセージの出力とロギング

- 他のサーバー構成のオプション

- クラスタ

- デプロイメント

サーバー通信

表3-3に、サーバーの通信方法を構成するためのオプションを示します。

表3-3 サーバー通信を構成するためのオプション

オプション

説明

-Dweblogic.management.server=
[protocol://]Admin-host:port

サーバー・インスタンスを管理対象サーバーとして起動し、そのサーバー・インスタンスを構成および管理する管理サーバーを指定します。

ドメインの構成ファイルでは、サーバー構成が管理サーバーと管理対象サーバーのどちらであるかを指定しません。サーバー・インスタンスが管理サーバーと管理対象サーバーのどちらの役割を果たすかについては、インスタンスの起動に使用するオプションで決定します。起動コマンドで-Dweblogic.management.serverオプションを省略した場合、サーバーは管理サーバーとして起動されます(ただし、特定のドメイン内でアクティブな管理サーバー・インスタンスは1つのみです)。管理サーバーを実行したら、他のすべてのサーバー構成は、起動コマンドに-Dweblogic.management.serverオプションを指定して、管理対象サーバーとして起動する必要があります。

protocolには、HTTP、HTTPS、T3、またはT3Sを指定します。T3SおよびHTTPSプロトコルの場合は、管理対象サーバーと管理サーバーでSSLを有効にして、管理サーバーのSSLリスニング・ポートを指定する必要があります。

注意: 指定するプロトコルに関係なく、管理対象サーバーの構成を最初にダウンロードするときはHTTPまたはHTTPSが使用されます。RMIサブシステムが初期化されると、サーバー・インスタンスはT3またはT3Sプロトコルを使用できます。

Admin-hostには、localhostまたは管理サーバーが動作するマシンのDNS名またはIPアドレスを指定します。

portには、管理サーバーのリスニング・ポートを指定します。ドメイン全体の管理ポートを設定した場合は、portにはドメイン全体の管理ポートを指定する必要があります。

管理サーバーへの接続を構成する方法の詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の管理対象サーバーから管理サーバーへの接続の構成に関する項を参照してください。

-Dweblogic.ListenAddress=host

このサーバー・インスタンスがリクエストをリスニングするアドレスを指定します。hostの値は、サーバー・インスタンスをホストするコンピュータのDNS名またはIPアドレスのいずれかでなければなりません。

この起動オプションは、config.xmlファイルで指定されたリスニング・アドレス値をオーバーライドします。オーバーライドは現在のサーバーのインスタンス化に適用され、config.xmlファイルの値は変更されません。管理コンソールまたはWLSTを使用してconfig.xmlファイルを変更します。

詳細は、Oracle WebLogic Server管理コンソール・ヘルプのリスニング・アドレスの構成に関する項および『Oracle WebLogic Scripting Tool』のWLSTオフラインを使用したドメインの作成に関する項を参照してください。

-Dweblogic.ListenPort=portnumber

サーバー・インスタンスのプレーン・テキスト(非SSL)リスニング・ポートを指定し、有効にします。

この起動オプションは、config.xmlファイルで指定されたリスニング・ポート値をオーバーライドします。オーバーライドは現在のサーバーのインスタンス化に適用され、config.xmlファイルの値は変更されません。管理コンソールまたはWLSTを使用してconfig.xmlファイルを変更します。

デフォルトのリスニング・ポートは7001です。

詳細は、Oracle WebLogic Server管理コンソール・ヘルプのリスニング・ポートの構成に関する項および『Oracle WebLogic Scripting Tool』のWLSTオフラインを使用したドメインの作成に関する項を参照してください。

-Dweblogic.ssl.ListenPort=portnumber

WebLogic ServerインスタンスがSSL接続リクエストをリスニングするポートを指定し、有効にします。

この起動オプションは、config.xmlファイルで指定されたSSLリスニング・ポート値をオーバーライドします。オーバーライドは現在のサーバーのインスタンス化に適用され、config.xmlファイルの値は変更されません。管理コンソールまたはWLSTを使用してconfig.xmlファイルを変更します。

デフォルトのSSLリスニング・ポートは7002です。

詳細は、Oracle WebLogic Server管理コンソール・ヘルプのリスニング・ポートの構成に関する項および『Oracle WebLogic Scripting Tool』のWLSTオフラインを使用したドメインの作成に関する項を参照してください。

-Dweblogic.management.discover={true|false}

注意:このオプションはWebLogic Server 9.0で削除されました。

管理サーバーに障害が発生し、再起動された後、そのサーバーがドメインの管理を回復するかどうかを指定します。

true値の場合、管理サーバーはすべての管理対象サーバーと通信し、管理サーバーが動作していることを通知します。

false値の場合、管理サーバーは、ドメインで現在アクティブな管理対象サーバーと通信できません。

ヒント: falseの値は、単一サーバーの開発環境でのみ指定してください。falseを指定すると、ドメイン内のサーバー・インスタンスが持つデプロイ済みモジュールのセットに整合性がなくなる可能性があります。

WebLogic Server 9.0では、このコマンドは非推奨になりました。管理サーバーが実行を停止して、そのドメインの管理対象サーバーが実行を続けた場合、各管理対象サーバーは、ServerMBean属性のAdminReconnectIntervalSecsで指定される間隔で管理サーバーに定期的に再接続しようとするからです。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の管理対象サーバーと再起動された管理サーバーに関する項を参照してください。

管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

SSL

各WebLogic Serverインスタンスではweblogic.management.configuration.SSLMBeanのインスタンスを使用して、SSL構成を表現します。

次の表で、-Dweblogic.security.SSLで始まるすべてのオプションは、サーバーのSSLMBeanの構成を変更します。たとえば、-Dweblogic.security.SSL.ignoreHostnameVerificationオプションでは、SSLMBeanのignoreHostnameVerification属性の値を設定します。

表3-4に、Secure Sockets Layer (SSL)を使用して通信するようにサーバーを構成するためのオプションを示します。

注意:

WebLogic Serverバージョン12.1.1の時点で、JSSEはサポートされるSSL実装のみです。CerticomベースのSSL実装は削除され、WebLogic Serverでサポートされません。

表3-4 SSLを構成するためのオプション

オプション

説明

-Dweblogic.security.SSL.
ignoreHostnameVerification=true

ホスト名検証を無効にします。これによって、WebLogic Serverに付属のデモ用デジタル証明書を使用できるようになります。

デフォルトでは、WebLogic ServerインスタンスがSSLクライアントである場合(SSLを介して他のサーバーやアプリケーションに接続しようとする場合)、WebLogic Serverは、SSLサーバーから返されるデジタル証明書のホスト名が、SSLサーバーへ接続するときに使用するURLのホスト名と一致していることを検証します。ホスト名が一致しない場合は接続が中断されます。

このオプションを使用するか、またはconfig.xmlファイル内のサーバーの構成を変更することで、ホスト名検証を無効にすると、サーバー・インスタンスはSSLクライアントである場合にホスト名を検証しません。

注意: 本番環境ではデモ用のデジタル証明書の使用やホスト名検証の無効化はお薦めしません。

この起動オプションは、config.xmlファイルで設定されたホスト名検証をオーバーライドします。オーバーライドは現在のサーバーのインスタンス化に適用され、config.xmlファイルの値は変更されません。管理コンソールまたはWLSTを使用してconfig.xmlファイルを変更します。

詳細は、『Oracle WebLogic Serverの保護』のホスト名検証の使用に関する項を参照してください。

-Dweblogic.security.SSL.HostnameVerifier=
hostnameverifierimplementation

カスタム・ホスト名検証クラスの名前を指定します。このクラスはweblogic.security.SSL.HostnameVerifierインタフェースを実装する必要があります。

-Dweblogic.security.SSL.sessionCache.ttl=
sessionCacheTimeToLive

SSLセッション・キャッシングに対するサーバー・セッションのデフォルトの存続時間を変更します。

sessionCacheTimeToLive値で、SSLセッションの存続時間(ミリ秒単位)を指定します。デフォルト値は90000ミリ秒(90秒)。つまり、クライアントが90秒以内に(同じセッションIDを使用して)サーバーに再びアクセスすると、WebLogic Serverは既存のSSLセッションを使用します。サーバーの起動スクリプトで -Dweblogic.security.SSL.sessionCache.ttlを設定するとこの値を変更できます。

sessionCache.ttlの場合、

- 最小値は1

- 最大値はInteger.MAX_VALUE

- デフォルト値は90000

-Dweblogic.security.SSL.CertificateCallback=callback-handler

証明書のコールバック・ハンドラのクラスを指定します。このクラスでは、WebLogic Serverへのセキュアな接続リクエストで渡されたエンドユーザー証明書を含む詳細を評価します。

証明書に含まれる詳細に応じて、コールバック・ハンドラは、認証が成功したかどうかを判定するtrueまたはfalseを返します。

注意: WebLogic Serverでの証明書のコールバック実装を使用する場合、セキュア・ポートを介してリクエストを受信するたびにコールバックが生成されます。その結果、証明書コールバックを使用することで、考慮の必要があるパフォーマンス・オーバーヘッドが発生する可能性があります。詳細は、『Oracle WebLogic Serverの保護』のエンド・ユーザー証明書の妥当性の確認に関する項を参照してください。

-Dweblogic.management.pkpassword=pkpassword

暗号化されたフラット・ファイルからSSL秘密鍵を取得するためのパスワードを指定します。

このオプションは、秘密鍵を暗号化されたフラット・ファイルに格納する場合に使用します。

-Dweblogic.security.SSL.trustedCAKeyStore=
path

非推奨。

WebLogic Server 8.1より前のリリースで利用可能だったSSL機能を使用するようにサーバー・インスタンスを構成する場合、この引数を使用してサーバーまたはクライアントで信頼される認証局を指定します。pathの値は、Sun JKSキーストア・ファイル(キーおよび証明書のリポジトリを格納)への相対パス名または絶対パス名でなければなりません。

8.1より前のリリースで利用可能だったSSL機能をサーバー・インスタンスで使用し、この引数を指定しない場合は、WebLogic Serverまたはクライアントは、JAVA_HOME\jre\lib\securityで指定されているすべての証明書を信頼します。

オラクル社は本番デプロイメントでのデモ用証明権限の使用はお薦めしません。

詳細は、『Oracle WebLogic Serverの保護』のSSLの構成に関する項を参照してください。

-Dweblogic.security.SSL.protocolVersion=protocol

SSL接続に使用するプロトコルを指定します。

protocol値には、次のいずれかを指定できます。

- SSL3 - SSL V3.0メッセージのみが送信され、受け付けられます。

- TLS1 - TLS V1メッセージのみが送信され、受け付けられます。

- ALL — SSL V3.0またはTLS V1(あるいはその両方)のメッセージのみが送信されて受理されます。(これがデフォルトです。)

詳細は、『Oracle WebLogic Serverの保護』のweblogic.security.SSL.protocolVersionシステム・プロパティの使用に関する項を参照してください。

-Dweblogic.security.SSL.minimumProtocolVersion=protocol

SSL接続に使用する最小プロトコル・バージョンを指定します。

protocol値には、次のいずれかを指定できます。

- SSLv3 — SSL接続で有効化される最小プロトコル・バージョンとして、SSL V3.0を指定します。

- TLSv1 — SSL接続で有効化される最小プロトコル・バージョンとして、TLS V1.0を指定します。

- TLSvx.y — SSL接続で有効化される最小プロトコル・バージョンとして、TLS Vx.yを指定します。ここで、xは1以上9以下の値、yは0以上9以下の値となります。

詳細は、『Oracle WebLogic Serverの保護』のweblogic.security.SSL.minimumProtocolVersionシステム・プロパティの使用に関する項を参照してください。

管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

追加のSSL属性を設定する

起動コマンドから追加のSSL属性を設定するには、次の手順に従います。

1. 起動オプションから構成できるSSL属性を確認するには、Oracle WebLogic Server MBeanリファレンスのSSLMBeanに関する項およびServerMBeanに関する項を参照してください。Javadocには、各属性の有効な値も示されています。
SSLMBeanおよびServerMBeanがセッター・メソッドとして公開している各属性は、起動オプションで設定できます。

2. SSLMBeanに属性を設定するには、起動コマンドに次のオプションを追加します。

-Dweblogic.ssl.attribute-name=value

ここで、attribute-nameは、MBeanのセッター・メソッドの名前からset接頭辞を除いたものです。

3. ServerMBeanに属性を設定するには、起動コマンドに次のオプションを追加します。

-Dweblogic.server.attribute-name=value

ここで、attribute-nameは、MBeanのセッター・メソッドの名前からset接頭辞を除いたものです。

たとえば、SSLMBeanは次のセッター・メソッドでそのEnabled属性を公開します。

setEnabled()

MedRecServerというサーバー・インスタンスでSSLを有効にするには、MedRecServerの起動時に次のコマンドを使用します。

java -Dweblogic.Name=MedRecServer
-Dweblogic.ssl.Enabled=true weblogic.Server

管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

セキュリティ

表3-5に、一般的なセキュリティ・パラメータを構成するためのオプションを示します。

表3-5 一般的なセキュリティ・パラメータのオプション

オプション

説明

-Dweblogic.management.username=username

サーバー・インスタンスを実行するユーザー名を指定します。

WebLogic Server 12.1.1以降、起動ユーザー名・プロパティweblogic.management.usernameは非推奨になっており、今後のリリースでは削除されます。WebLogic Serverを本番モードで起動するためのコマンドで、ユーザー名を指定することはできなくなりました。

かわりに、boot.propertiesファイルを使用してWebLogic Serverの起動ユーザー名を指定することをお薦めします。boot.propertiesファイルの詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の起動IDファイルに関する項を参照してください。

ユーザー資格証明を指定するためのその他の方法の詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動と停止を行うためのユーザー資格証明の指定に関する項を参照を参照してください。

-Dweblogic.management.password=password

ユーザー・パスワードを指定します。

WebLogic Server 12.1.1以降、起動パスワード・システム・プロパティweblogic.management.passwordは非推奨になっており、今後のリリースでは削除されます。WebLogic Serverを本番モードで起動するためのコマンドで、パスワードを指定することはできなくなりました。

かわりに、boot.propertiesファイルを使用してWebLogic Serverの起動パスワードを指定することをお薦めします。boot.propertiesファイルの詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の起動IDファイルに関する項を参照してください。

ユーザー資格証明を指定するためのその他の方法の詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動と停止を行うためのユーザー資格証明の指定に関する項を参照を参照してください。

-Dweblogic.system.StoreBootIdentity=true

サーバーのルート・ディレクトリにboot.propertiesファイルを作成します。このファイルには、サーバーの起動に使用したユーザー名とパスワードの暗号化バージョンが格納されます。

この引数をサーバーのServerStartMBeanで指定しないでください。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のノード・マネージャを使用してサーバーを起動するときのユーザー資格証明の指定に関する項を参照してください。

この引数を起動スクリプトに追加しないことを推奨します。そうではなく、boot.propertiesファイルを作成する場合にのみ使用してください。

詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の起動IDファイルに関する項を参照してください。

-Dweblogic.system.
BootIdentityFile=filename

ユーザー名とパスワードを格納する起動IDファイルを指定します。

filenameの値は、有効な起動IDファイルの完全修飾のパス名である必要があります。例:

-Dweblogic.system.BootIdentityFile=
WL_HOME\mydomain\servers\myserver\security
\boot.properties

ファイル名、サーバー・インスタンス、またはWLST SHUTDOWNコマンドを指定しない場合は、サーバーのルート・ディレクトリにあるboot.propertiesファイルを使用します。

起動IDファイルがない場合は、サーバーの起動時にユーザー名とパスワードの入力を求められます。

-Dweblogic.system.RemoveBootIdentity=true

サーバーの起動後に起動IDファイルを削除します。

-Dweblogic.security.anonymous
UserName=name

匿名ユーザーにユーザーIDを割り当てます。デフォルトでは、すべての匿名ユーザーは<anonymous>という文字列で識別されます。

WebLogic Server 6.xのセキュリティ動作をエミュレートするには、nameの値にguestを指定して、セキュリティ・レルムにguestという名前のユーザーを作成します。

詳細は、『Oracle WebLogic Serverロールおよびポリシーによるリソースの保護』のユーザー、グループおよびセキュリティ・ロールに関する項を参照してください。

-Djava.security.manager
-Djava.security.policy[=]=filename

Javaセキュリティ・マネージャを有効にして、Java 2セキュリティ・ポリシーが含まれるファイル名を(相対パスまたは完全修飾パス名を使用して)指定する標準Java EEオプション。

WebLogic Serverのサンプル・ポリシー・ファイルを使用するには、WL_HOME\server\lib\weblogic.policyを指定します。

-Djava.security.policy==filename (二重の等号記号(==)に注意)を使用すると、ポリシー・ファイルはデフォルトのセキュリティ・ポリシーをオーバーライドします。この結果、JACCが有効にされるときにサーブレットおよびEJB認可に使用されるポリシー・ファイルが無視されます。単一の等号記号(=)を使用すると、ポリシー・ファイルは既存のセキュリティ・ポリシーに付加されます。

詳細は、『Oracle WebLogic Serverセキュリティのプログラミング』のJavaセキュリティ・マネージャを使用したWebLogicリソースの保護に関する項を参照してください。

-Dweblogic.security.
fullyDelegateAuthorization=true

デフォルトでは、EJBまたはWebアプリケーションのデプロイメント記述子でセキュリティ制約が定義されている場合を除いて、管理コンソールから、EJBまたはWebアプリケーションに対してロールとセキュリティ・ポリシーを設定することはできません。

WebLogic Serverの起動時にこのオプションを使用すると、この問題はオーバーライドされます。

この起動オプションは、<unchecked>タグまたは<restricted>タグを使用するEJBまたはEJBメソッド、または<auth-constraint>タグにrole-nameが指定されていないWebアプリケーションでは機能しません。

-Dweblogic.management.
anonymousAdminLookupEnabled=true

ユーザー資格証明を指定しないでMBeanHomeインタフェースを取得できるようにします。MBeanHomeインタフェースはWebLogic Server JMX APIの一部です。

ユーザー資格証明を指定しないでMBeanHomeを取得すると、インタフェースは、WebLogic Server MBeanの認可プロセスで保護されるように明示的にマークされていないMBean属性の値に対する読取り専用アクセスをユーザーに付与します。

この起動オプションは、管理コンソールの「domain_name 」>「 セキュリティ 」>「 全般」ページにある「匿名Adminのルックアップを有効化」設定をオーバーライドします。

デフォルトでは、MBeanHome APIは、デフォルトのセキュリティ・ロールのいずれかを持つWebLogicユーザーに対してのみMBeanへのアクセスを許可します。詳細は、『Oracle WebLogic Serverロールおよびポリシーによるリソースの保護』のユーザー、グループおよびセキュリティ・ロールに関する項を参照してください。

-Dweblogic.security.
identityAssertionTTL=seconds

IDアサーション・キャッシュがサブジェクトを格納する秒数を構成します。

IDアサーション・プロバイダ(X.509証明書またはその他のトークン)を使用する場合、サブジェクトはサーバーにキャッシュされます。この結果、<run-as>タグを使用したサーブレットとEJBメソッドのパフォーマンスと、IDアサーションが使用されるがキャッシュされないその他の場所のパフォーマンス(XMLドキュメントの署名と暗号化など)が大幅に向上します。このキャッシングにより、目的のセマンティクスに違反する場合もあります。

デフォルトでは、サブジェクトはキャッシュに300秒間保持されます(最大許容値)。-1に設定するとキャッシュを無効化できます。

値を大きくするとIDアサーションのパフォーマンスが大幅に向上しますが、構成済み認証プロバイダの変更に対するIDアサーション・プロバイダの応答が遅くなります。たとえば、ユーザーのグループの変更は、サブジェクトがキャッシュからフラッシュされて再作成されるまで反映されなくなります。

-Djava.security.manager
-Djava.security.policy=
<insert the location of your policy file here>

-Djavax.security.jacc.PolicyConfigurationFactory
.provider=weblogic.security.jacc.simpleprovider
.PolicyConfigurationFactoryImpl

-Djavax.security.jacc.policy.provider=
weblogic.security.jacc.simpleprovider
.SimpleJACCPolicy

-Dweblogic.security.jacc.RoleMapperFactory.provider=
weblogic.security.jacc.simpleprovider
.RoleMapperFactoryImpl

セキュリティ・レルムでJACCプロバイダを使用するには、この5つのシステム・プロパティを定義する必要があります。これらのプロバイダを使用する場合、JACCは外部アプリケーションに対するEJBおよびサーブレット・コンテナの認可決定を処理します。内部アプリケーションに対する認可決定は、WebLogicセキュリティ・フレームワークの認可によって処理されます。JACC認可ではJava SEセキュリティを使用する必要があるので、Java EEセキュリティ・マネージャとポリシー・ファイル(サーバー起動プロパティのjava.security.managerとjava.security.policyで指定する)を使用してWebLogic Serverを起動する必要があります。詳細は、『Oracle WebLogic Serverセキュリティのプログラミング』のJavaセキュリティ・マネージャを使用したWebLogicリソースの保護に関する項を参照してください。

WebLogic JACC実装は、ポリシー・オブジェクトがデフォルトのsun.security.provider.PolicyFileクラスであると予測します。

起動時に、WebLogic ServerはJACC起動プロパティで指定されたクラスを検索してインスタンス化しようとし、それらを検索またはインスタンス化できない場合(起動プロパティで指定されたファイルが無効なクラスである場合など)は起動に失敗します。

-Dweblogic.security.ldap.
maxSize=<max bytes>

組込みLDAPサーバーで使用されるデータ・ファイルのサイズを制限します。データ・ファイルが指定されたサイズを超えると、削除済みのエントリによって占有されていたスペースがデータ・ファイルから削除されます。

-Dweblogic.security.ldap.
changeLogThreshold=<number of entries>

組込みLDAPサーバーで使用される変更ログ・ファイルのサイズを制限します。変更ログ・ファイルのエントリ数が指定されたエントリ数を超えると、すべての管理対象サーバーに送信されたエントリをすべて削除することによって変更ログが切り詰められます。

-Dweblogic.security.providers.authentication.ldap.socketTimeout=seconds

LDAPサーバーへのLDAP認証プロバイダ接続のタイムアウト値を設定します。複数のLDAPサーバーがLDAPServerMBean.Host属性に指定されている場合、ソケット・タイムアウトは、実行される各LDAPサーバー接続試行に個別に適用されます。デフォルト値は0で、これは接続ときにソケット・タイムアウトが設定されないことを意味します。

注意: LDAPServerMBean.ConnectTimeout属性によって、実行されるすべての接続試行に対してタイムアウト制限が設定されます。通常、ソケット・タイムアウトは、接続タイムアウトと並列接続遅延と連動して使用されます。詳細は、『Oracle WebLogic Serverの保護』のLDAP認証プロバイダのフェイルオーバーの構成に関する項を参照してください。

管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

メッセージの出力とロギング

表3-6に、サーバー・インスタンスのメッセージの出力を構成するためのオプションを示します。

表3-6 メッセージの出力を構成するためのオプション

オプション

説明

-Dweblogic.Stdout="filename"

サーバーとJVMの標準出力ストリームをファイルにリダイレクトします。パス名を、完全修飾で指定するか、WebLogic Serverのルート・ディレクトリからの相対で指定します。

詳細は、Oracle WebLogic Server管理コンソール・ヘルプのJVMの出力のリダイレクトに関する項を参照してください。

-Dweblogic.Stderr="filename"

サーバーとJVMの標準エラー・ストリームをファイルにリダイレクトします。パス名を、完全修飾で指定するか、WebLogic Serverのルート・ディレクトリからの相対で指定します。

詳細は、『Oracle WebLogic Serverログ・ファイルの構成とログ・メッセージのフィルタ処理』のJVMの出力のリダイレクトに関する項を参照してください。

-Dweblogic.
AdministrationMBeanAuditingEnabled=
{true | false}

ユーザーが構成を変更したときやドメイン内のリソースの管理操作を呼び出したときに、管理サーバーから構成監査ログ・メッセージが送信されるようにするかどうかを指定します。

デフォルトによって、管理サーバーは構成監査メッセージを送信しません。

Oracle WebLogic Server管理コンソール・ヘルプの構成監査の有効化に関する項を参照してください。

管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

ロギング属性を設定する

各WebLogic Serverインスタンスではweblogic.management.configuration.LogMBeanのインスタンスを使用して、ロギング・サービスの構成を表現します。

起動コマンドからLogMBean属性の値を設定するには、次の手順に従います。

1. 起動オプションから構成できるログ属性を確認するには、Oracle WebLogic Server MBeanリファレンスのLogMBeanに関する項を参照してください。Javadocには、各属性の有効な値も示されています。
LogMBeanがセッター・メソッドとして公開している各属性は、起動オプションで設定できます。

2. 起動コマンドに次のオプションを追加します。

-Dweblogic.log.attribute-name=value

ここで、attribute-nameは、MBeanのセッター・メソッドの名前からset接頭辞を除いたものです。

LogMBeanは次のセッター・メソッドでそのFileName属性を公開します。

setFileName()

MedRecServerインスタンスのローカル・ログ・ファイルの名前を指定するには、MedRecServerの起動時に次のコマンドを使用します。

java -Dweblogic.Name=MedRecServer
-Dweblogic.log.FileName="C:\logfiles\myServer.log"
weblogic.Server

管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

クラスタ

表3-7に、クラスタの追加属性を構成するためのオプションを示します。

表3-7 クラスタ属性を構成するためのオプション

オプション

説明

-Dweblogic.cluster.multicastAddress

クラスタリングされたサーバーが、クラスタ関連の通信の送信および受信に使用するマルチキャスト・アドレスを指定します。デフォルトでは、クラスタリングされたサーバーはconfig.xmlファイルで定義されたマルチキャスト・アドレスを参照します。このオプションを使用してconfig.xmlの値をオーバーライドします。

注意: 管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

マルチキャスト・アドレスの設定方法に関係なく、クラスタ内のすべてのサーバーは同じマルチキャスト・アドレスで通信する必要があります。

デプロイメント

表3-8に、デプロイメントの追加属性を構成するためのオプションを示します。

表3-8 デプロイメント属性を構成するためのオプション

オプション

説明

-Dweblogic.deployment.IgnorePrepareStateFailures=true

静的デプロイメントPrepareの失敗に関係なく、サーバーのRunningへの遷移を許可することにより、デフォルトのデプロイメント動作がオーバーライドされます。

注意: このサーバー・レベルのフラグは、HttpSessionReplicationまたはSFSBレプリケーションの問題のように、クラスタ内に矛盾したデプロイメントの動作をする場合があります。

他のサーバー構成のオプション

表3-9に、サーバー・インスタンスの追加属性を構成するためのオプションを示します。

表3-9 サーバー属性を構成するためのオプション

オプション

説明

-DserverType={"wls" | "wlx"}

サーバーの種類を指定します。これによってサーバー実行時に起動する一連のサービスが確認されます。

デフォルトは「wls」です。これによってEJB、JMS、コネクタ、クラスタリング、デプロイメント、および管理を含むすべてのWebLogic Serverサービスが起動されます。

「wlx」オプションでは、次のサービスを除いてサーバー・インスタンスを開始します。これによって軽量な実行時フット・プリントになります。

- Enterprise JavaBeans (EJB)

- Java EEコネクタ・アーキテクチャ(JCA)

- Java Message Service (JMS)

WebLogicドメインで軽量なランタイム・インスタンスを開始する例については、「weblogic.Serverコマンド・ラインを使用したWebLogic Server実行時フット・プリントの制限」を参照してください。ランタイムの軽量化の詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のWebLogic Server起動時のランタイム範囲の制限に関する項を参照してください。

-Dweblogic.Name=servername

起動するサーバー・インスタンスの名前を指定します。指定する名前は、ドメインのconfig.xmlファイルで定義されているサーバーの名前を参照していなければなりません。

-Dweblogic.ProductionModeEnabled=
{true | false}

この属性はWebLogic Server 9.0で非推奨になりました。

サーバーが本番モードで起動するかどうかを決定します。

trueを指定すると、WebLogic Serverはdomain_name/autodeployディレクトリにあるアプリケーションを自動的にデプロイおよび更新できなくなります。

このオプションを指定しない場合、値はfalseと見なされます。

本番モードを有効にするには、WLSTを使用してDomainMBean.isProductionModeEnabledをtrueに設定するか、管理コンソールを使用します。Oracle WebLogic Server管理コンソール・ヘルプの本番モードへの変更に関する項を参照してください。

注意: 本番モードは、管理コンソールまたはconfig.xmlで、あるいはstartWebLogicスクリプトにproduction引数を指定して(startWebLogic.cmd productionなど)、有効化してください。管理サーバーの場合は、コマンド・ラインからは本番モードのみを有効にします。

注意: 管理サーバーのコマンド・ラインからProductionModeEnabledを設定すると、この値はすべての管理対象サーバーに伝播されますので注意してください。

-Dweblogic.management.startupMode=MODE

MODEの引数は、次のいずれかを表します。

- STANDBY: サーバーを起動してスタンバイ(STANDBY)状態にします。『Oracle WebLogic Serverサーバーの起動と停止の管理』のSTANDBY状態に関する項を参照してください。
この起動引数を使用するには、ドメイン全体の管理ポートを使用するようにドメインを構成する必要があります。

管理ポートの詳細は、『Oracle WebLogic Serverサーバー環境の構成』の管理ポートと管理チャネルに関する項およびOracle WebLogic Server管理コンソール・ヘルプのドメイン全体の管理ポートの構成に関する項を参照してください。

- ADMIN: サーバーを起動して管理(ADMIN)状態にします。『Oracle WebLogic Serverサーバーの起動と停止の管理』のADMIN状態に関する項を参照してください。

この起動モード・オプションを指定すると、config.xmlファイルのすべての起動モード設定がオーバーライドされます。オーバーライドは現在のサーバーのインスタンス化に適用され、config.xmlファイルの値は変更されません。管理コンソールまたはWLSTを使用してconfig.xmlファイルを変更します。

コマンド・ラインまたはconfig.xmlのいずれかで、この値を指定しない場合、デフォルトでは実行中(RUNNING)状態で起動されます。

-Dweblogic.apache.xerces.maxentityrefs=
numerical-value

WebLogic XMLパーサーが解決するXMLドキュメント内のエントリ数を制限します。

このオプションを指定しない場合、WebLogic ServerでインストールされるXMLパーサーは、XMLドキュメントに含まれているエントリ数に関係なく、XMLドキュメント内の10,000エントリの参照を解決します。

-Dweblogic.jsp.windows.caseSensitive=true

Windows上のJSPコンパイラが、出力ファイル名の作成時に大文字小文字を保持します。

『Oracle WebLogic Server Webアプリケーション、サーブレット、JSPの開発』のWebLogic JSPコンパイラの使用に関する項を参照してください。

-Dweblogic.servlet.optimisticSerialization=
true

optimistic-serializationが有効になっている場合、リクエストがサーブレット・コンテキストを超えてディスパッチされるときにgetAttribute(name)のコンテキストとリクエスト属性がシリアライズおよびデシリアライズされません。

つまり、複数のWebアプリケーションに共通する属性は、共通の親クラスローダーにスコープ指定(アプリケーション・スコープ指定)するか、2つのWebアプリケーションが同じアプリケーションに属していない場合はシステムのクラスパスに配置する必要があります。

optimistic-serializationがオフ(デフォルト値)になっている場合、WebLogic ServerはClassCastExceptionの発生を回避するためにgetAttribute(name)のコンテキストおよびリクエストの属性をシリアライズおよびデシリアライズします。

optimistic-serialization値は、WebAppContainerMBeanでドメイン・レベルで指定することもできます。この値は、すべてのWebアプリケーションに適用されます。weblogic.xmlに値を指定した場合、その値によってドメイン・レベルの値がオーバーライドされます。

デフォルト値はfalseです。

-Dweblogic.jdbc.qualifyRMName=false

設定すると、WebLogic Server 11 g R1 (10.3.1)より前のJTA登録名をドメイン名で修飾しないという動作を復元します。

-Dweblogic.ScatteredReadsEnabled=true

および

-Dweblogic.GatheredWritesEnabled=true

それぞれがTrueに設定されている場合、ネットワーク・スループットの高い環境のI/Oで効率が向上します。

これらのコマンド・オプションを一緒に使用して、Oracle Exalogicと併用するためにWebLogic Serverのパフォーマンスを最適化します。詳細は、『Oracle Exalogicエンタープライズ・デプロイメント・ガイド』のOracle WebLogic Server 11gリリース1(10.3.4)でのExalogic固有の拡張機能の有効化に関する項を参照してください。

-Dweblogic.replication.enableLazyDeserialization=true

Trueに設定されている場合、セッションのレプリケーションの効率が向上します。

このコマンド・オプションを使用して、Oracle Exalogicと併用するためにWebLogic Serverのパフォーマンスを最適化します。詳細は、『Oracle Exalogicエンタープライズ・デプロイメント・ガイド』のOracle WebLogic Server 11gリリース1(10.3.4)でのExalogic固有の拡張機能の有効化に関する項を参照してください。

-Dweblogic.resourcepool.max_test_wait_secs=seconds

接続テストが失敗したとWebLogic Server が判断するまでの待機する時間(秒単位)。デフォルトでは、10秒の値はサーバー・インスタンスに割り当てられます。0に設定すると、サーバー・インスタンスは、無限に待機します。

-Dweblogic.wsee.client.ssl.usejdk=true

Trueに設定されている場合、WlsSSLAdapterをJdkSSLAdapterに切り替えます。

デフォルトでは、WebLogic Server Webサービスは、SSLアダプタのweblogic.wsee.connection.transport.https.WlsSSLAdapterクラスを使用します。このフラグをTrueに設定すると、weblogic.wsee.connection.transport.https.JdkSSLAdapterではなくJdkSSLAdapterを強制的に使用します。

USE_JDK_SSL_PROPERTYを定義するweblogic.wsee.connection.transport.https.HTTPSClientTransportクラスはJAX-RPCでのみ使用されます。このプロパティはJAX-WSでは現在サポートされていません。

管理コンソールには、コマンド・ラインで設定した値は表示されません。設定した属性値の確認方法については、「コマンド・ラインで設定した属性値の確認」を参照してください。

weblogic.Serverコマンド・ラインを使用したサーバー・インスタンスの起動

サーバー・インスタンスを起動する簡単な方法は次のとおりです。

1. コマンド・シェルで、次のスクリプトを実行して必要な環境を設定します。
WL_HOME\server\bin\setWLSEnv.cmd (Windowsの場合)

WL_HOME/server/bin/setWLSEnv.sh (UNIXの場合)

ここで、WL_HOMEは、WebLogic Serverのインストール先ディレクトリです。

2. コマンド・シェルで、ドメイン・ディレクトリのルート(通常はMW_HOME\user_projects\domains\DOMAIN_NAME)に移動します。たとえば、WL_HOME\samples\domains\medrecディレクトリに移動します。

3. 管理サーバーを起動するには、以下のコマンドを入力します。

java weblogic.Server

注意:

使用するパスワードは8文字以上の文字列である必要があります(大文字と小文字は区別されます)。スペース文字は使用できません。詳細は、『構成ウィザードによるドメインの作成』のWebLogicドメインの作成に関する項を参照してください。

4. ドメインの管理サーバーがすでに動作していて、config.xmlファイルで管理対象サーバーをすでに定義している場合は、管理対象サーバーを次のように起動できます。

java -Dweblogic.Name=managed-server-name
-Dweblogic.management.server=url-for-Administration-Server
weblogic.Server

たとえば、MedRecドメインでMedRecManagedServerという管理対象サーバーを作成する場合、次のコマンドを入力できます。

java -Dweblogic.Name=MedRecManagedServer
-Dweblogic.management.server=localhost:7011
weblogic.Server

注意:

マルチサーバー・ドメインでデモ用の証明書を使用している場合、引数url-for-Administration Serverのように管理サーバーのホスト・マシンの完全修飾DNS名を指定すると、管理対象サーバー・インスタンスの起動が失敗します。制限事項とその解決策については、『Oracle WebLogic Serverの保護』のCertGen使用方法の制限事項に関する項を参照してください。

weblogic.Serverコマンド・ラインを使用したWebLogic Server実行時フット・プリントの制限

WebLogic Serverには、次のサービスのサブセットを起動の対象から除外することで実行時フット・プリントを軽量化する起動オプションが用意されています。除外されるサービスは次のとおりです。

- Enterprise JavaBeans (EJB)

- Java EEコネクタ・アーキテクチャ(JCA)

- Java Message Service (JMS)

軽量なランタイム・インスタンスが任意のWebLogicドメインで開始されます。軽量なランタイム・インスタンスを開始する簡単な方法は次のとおりです。

1. コマンド・シェルで、ドメインのbinディレクトリに移動します。例:

cd DOMAIN_HOME\bin

2. setDomainEnvスクリプトを実行します。

3. 軽量なランタイム・インスタンスを開始するには、次のコマンドを入力します。

java weblogic.Server -DserverType="wlx"

詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のWebLogic Server起動時のランタイム範囲の制限に関する項を参照してください。

weblogic.Serverコマンド・ラインを使用したドメインの作成

weblogic.Serverを使用して、単一のサーバー・インスタンスを含むドメインを作成できます。weblogic.Serverを使用してドメインに管理対象サーバー・インスタンスを追加したり、既存のドメインを変更したりすることはできません。

「デフォルト動作」で説明されているように、weblogic.Serverはconfig.xmlファイルが見つからない場合、新しいファイルを作成するかどうかを尋ねます。指定するコマンド・オプションは、該当する属性がある場合はconfig.xmlファイルに保持されます。たとえば、-Dweblogic.Nameおよび-Dweblogic.Domainオプションでは、サーバー構成の名前とドメインの名前を指定します。weblogic.Serverがconfig.xmlファイルを見つけられない場合、これらの両方の値はconfig.xmlに保持されます。一方、-Dweblogic.system.BootIdentityFileオプションは、サーバー・インスタンスを起動するためのユーザー資格証明が含まれるファイルを指定しますが、config.xmlファイルに保持される属性ではありません。

簡単なサンプル・ドメインとサーバーを作成してインスタンス化するには、次の手順に従います。

1. コマンド・シェルで、次のスクリプトを実行して必要な環境を設定します。
WL_HOME\server\bin\setWLSEnv.cmd (Windowsの場合)

WL_HOME/server/bin/setWLSEnv.sh (UNIXの場合)

ここで、WL_HOMEは、WebLogic Serverのインストール先ディレクトリです。

2. コマンド・シェルで、空のディレクトリを作成します。

3. 空のディレクトリで、次のコマンドを入力します。

java -Dweblogic.Domain=SimpleDomain -Dweblogic.Name=SimpleServer
-Dweblogic.management.username=weblogic  -Dweblogic.management.password=welcome1
-Dweblogic.ListenPort=7001 weblogic.Server

このコマンドを入力すると、WebLogic Serverは新しいconfig.xmlファイルを作成するかどうかをたずねてきます。yと入力すると、SimpleDomainというドメインがインスタンス化されます。ドメインの管理サーバーは次のように構成されます。

- 管理サーバーの名前はSimpleServer。

- ドメインのセキュリティ・レルムには、管理ユーザーweblogicが1つ定義されます(パスワードはwelcome1)。

- 管理サーバーのリスニング・アドレスには、localhost、ホスト・コンピュータのIPアドレス、またはホスト・コンピュータのDNS名を使用できます。リスニング・アドレスの設定の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのリスニング・アドレスの構成に関する項を参照してください。

- 管理サーバーはポート7001でリスニングします。

この節で説明したようにweblogic.Serverコマンドを入力すると、次のファイルが作成されます。

- config.xml

- DefaultAuthenticatorInit.ldift、DefaultRoleMapperInit.ldift、およびSerializedSystemIni.dat。基本的なセキュリティ関連データを格納します。

- boot.propertiesファイル。暗号化された形式でユーザー名とパスワードを格納します。このファイルを使用すると、サーバー起動時のユーザー名とパスワードのプロンプトを回避できます。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の起動IDファイルに関する項を参照してください。

- startWebLogic.cmdおよびstartWebLogic.sh。以後サーバーのインスタンス化に使用できます。

注意:

weblogic.Serverを空のディレクトリで呼び出すと、WLSTオフラインおよび構成ウィザードと同じ構成プロセスによってドメインが暗黙的に作成されます。これにより、常に共通のドメインを参照できるようになります。weblogic.Serverを使用して空のディレクトリにドメインを暗黙的に作成するまで、約15秒かかります。

コマンド・ラインで設定した属性値の確認

起動オプションではサーバーのローカル構成MBeanの属性値を設定するため、管理コンソールにはコマンド・ラインで設定した値は表示されません。サーバーのローカル構成MBeanの値を表示するには、次のようにWLSTを使用します。

1. 『Oracle WebLogic Scripting Tool』で対話モードまたはスクリプト・モードでWLST使用の主な手順に関する項に説明されている手順を実行します。

>java weblogic.WLST

2. WebLogic Serverインスタンスを起動し(『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動と停止に関する項を参照)、connectコマンドを使用してWLSTをサーバーに接続します。connectコマンドの詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のconnectに関する項を参照してください。

wls:/(offline)> connect('username','password','t3s://localhost:7002')
Connecting to weblogic server instance running at t3s://localhost:7002 as username weblogic ...

wls:/mydomain/serverConfig>

3. たとえば、あるクラスタ・メンバーが使用しているマルチキャスト・アドレスを調べるには、WLSTをそのサーバー・インスタンスに接続して、以下のコマンドを入力します。

wls:/mydomain/serverConfig> cd('Clusters/cluster_name')
wls:/mydomain/serverConfig/Clusters/mycluster> cmo.getMulticastAddress()

'239.192.0.0'

4. サーバー・インスタンスが標準出力に出力するメッセージの重大度レベルを調べるには、WLSTをそのサーバー・インスタンスに接続して、以下のコマンドを入力します。

wls:/mydomain/serverConfig> cd('Servers/server_name/Log/server_name')
wls:/mydomain/serverConfig/Servers/myserver/Log/myserver>cmo.getStdoutSeverity()

'Notice'

WLSTの使用の詳細は、『Oracle WebLogic Scripting Tool』を参照してください。構成MBeanの詳細は、『Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』のWebLogic Server MBeansの理解に関する項を参照してください。

4 WebLogic SNMPエージェント・コマンド・ライン・リファレンス(非推奨)

この章では、WebLogic SNMPエージェントを取り扱う方法について説明します。

注意:

このドキュメントで説明するコマンド・ライン・ユーティリティは、WebLogic Server 10.0で非推奨になりました。かわりに、『Oracle WebLogic Server SNMP管理ガイド』のWebLogic SNMPコマンド・ライン・ユーティリティに関する項で説明されているコマンド・ライン・ユーティリティを使用してください。

WebLogic ServerではSimple Network Management Protocol (SNMP)を使用して、企業全体の管理システムとの通信を実現できます。WebLogic管理データ(管理対象オブジェクト)を収集し、このデータをSNMP通信モジュール(トラップ通知)に変換し、このトラップ通知をサード・パーティのSNMP管理システムに転送するWebLogic Serverサブシステムを、WebLogic SNMPエージェントと呼びます。WebLogic SNMPエージェントは管理サーバー上で動作し、ドメイン内のすべての管理対象サーバーから管理対象オブジェクトを収集します。

WebLogic SNMPエージェントには、次のことを実行できるコマンド・ライン・インタフェースが用意されています。

- WebLogic Server管理対象オブジェクトを検索する

- テスト目的のためにWebLogic Serverトラップを生成および受信する

以下の節では、コマンド・ライン・インタフェースからWebLogic SNMPエージェントを操作する方法について説明します。

- SNMPコマンド・ライン・インタフェースの環境要件

- SNMPコマンド・ライン・インタフェースの構文と共通の引数

- WebLogic Server管理対象オブジェクトを取得するためのコマンド

- トラップをテストするためのコマンド

WebLogic ServerでSNMPを使用する方法については、次を参照してください:

- 『Oracle WebLogic Server SNMP管理ガイド』

- SNMP MIB ANS1ファイル(zip)

SNMPコマンド・ライン・インタフェースの環境要件

WebLogic SNMPエージェントのコマンド・ライン・インタフェース用に環境を設定するには、次の手順に従います。

1. 『Oracle WebLogic Serverインストレーション・ガイド』の説明に従って、WebLogic Serverソフトウェアをインストールおよび構成します。

2. WebLogic Server管理対象オブジェクトを検索する場合、Oracle WebLogic Server管理コンソール・ヘルプのSNMPを使用したWebLogic Serverのモニターに関する項の説明に従ってWebLogic SNMPエージェントを有効にします。

3. コマンド・プロンプト(シェル)を開いて、次のスクリプトを呼び出します。
WL_HOME\server\bin\setWLSEnv.sh (WindowsではsetWLSEnv.cmd)

ここで、WL_HOMEは、WebLogic Serverのインストール先ディレクトリです。

このスクリプトを実行すると、シェルのPATH環境変数にはサポートされるJDKが追加され、CLASSPATH変数にはWebLogic Serverクラスが追加されます。

SNMPコマンド・ライン・インタフェースの構文と共通の引数

すべてのWebLogic SNMPエージェント・コマンドは次の形式を取ります。

java command-name arguments

表4-1では、ほとんどのWebLogic SNMPエージェント・コマンドに共通する引数について説明します。

表4-1 共通のコマンド・ライン引数

引数

定義

-d

コマンド出力にデバッグ情報とパケット・ダンプを含めます。

-v {v1 | v2}

SNMPエージェントとの通信にSNMPv1とSNMPv2のどちらを使用するのかを指定します。

SNMPエージェントを構成するときに「トラップ・バージョン」フィールドで設定したものと同じSNMPバージョンを指定する必要があります(Oracle WebLogic Server管理コンソール・ヘルプのSNMPエージェントの作成に関する項を参照)。

値を指定しない場合、コマンドは-v v1であると仮定します。

-c snmpCommunity
[@server_name | @domain_name

WebLogic SNMPエージェント用に設定するコミュニティ名、および必要であれば対話するオブジェクトをホストするサーバー・インスタンスを指定します。

管理サーバー上の管理対象オブジェクトをリクエストするには、次のように指定します。

snmpCommunity

ここで、snmpCommunityは、SNMPエージェントを構成するときに「コミュニティ接頭辞」フィールドで設定したSNMPコミュニティ名です(Oracle WebLogic Server管理コンソール・ヘルプのSNMPエージェントの作成に関する項を参照)。

1つの管理対象サーバー上の管理対象オブジェクトをリクエストするには、次のように指定します。

snmpCommunity@server_name

ここで、server_nameは、管理対象サーバーの名前です。

ドメイン内のすべてのサーバー・インスタンスの管理対象オブジェクトをリクエストするには、次の形式でコミュニティ文字列を指定します。

snmpCommunity@domain_name

ここで、domain_nameは、WebLogic Serverドメインの名前です。

この引数の値を指定しない場合、値は-c public (デフォルトのコミュニティ名を使用)と見なされ、指定された管理対象オブジェクトが管理サーバーに存在すると見なされます。

-p snmpPort

WebLogic SNMPエージェントがリクエストをリスニングするポート番号です。

値を指定しない場合、コマンドは-p 161であると仮定します。

-t timeout

コマンドがSNMPエージェントに正常に接続するのを待機するミリ秒数。

値を指定しない場合、コマンドは-t 5000であると仮定します。

-r retries

SNMPエージェントへの接続の試行が失敗した場合に、コマンドが再試行する回数。

値を指定しない場合、コマンドは最初に試行が失敗した時点で終了します。

host

WebLogic SNMPエージェントが動作しているWebLogic Serverの管理サーバーをホストするコンピュータのDNS名またはIPアドレス。

WebLogic Server管理対象オブジェクトを取得するためのコマンド

表4-2に、WebLogic Server管理対象オブジェクトとオブジェクト・インスタンスを検索するコマンドの概要を示します。

表4-2 WebLogic Server管理対象オブジェクトからデータを取得するためのコマンドの概要

コマンド

説明

snmpwalk

MIB内の指定されたノード以下にあるすべての管理対象オブジェクトとインスタンスを返します。

「snmpwalk」を参照してください。

snmpgetnext

指定するOIDの直後にある管理対象オブジェクトまたはインスタンスを返します。

「snmpgetnext」を参照してください。

snmpget

1つまたは複数のOIDに対応する管理対象オブジェクトを返します。

「snmpget」を参照してください。

snmpwalk

MIB内の指定されたノード以下にあるすべての管理対象オブジェクトまたはインスタンスを返します。

表形式のオブジェクトOIDを指定すると、コマンドはそのすべてのオブジェクト・インスタンスと、関連するすべての子オブジェクトおよびインスタンスを返します。

構文

java snmpwalk [-d] [-v (v1,v2)] [-c snmpCommunity] [-p snmpPort]
[-t timeout] [-r retries] host OID

表4-3に、snmpwalkに渡されるOIDの引数を示します。

表4-3 snmpwalkの引数

引数

定義

OID

子オブジェクトおよびインスタンスのセットを取得するノードのオブジェクトID。

値は「.」で始めます。そうしない場合、参照はWebLogic Server MIBではなく標準MIB (.1.3.6.1.2.1)に対して相対的であると見なされます。

例

以下の例では、管理サーバーにデプロイされているすべてのアプリケーションの名前を取得します。アプリケーション名の管理対象オブジェクトは、applicationRuntimeTableオブジェクトの子であるapplicationRuntimeNameです。(http://download.oracle.com/docs/cd/E24329_01/apirefs.1211/e24404/BEA-WEBLOGIC-MIB.asn1.zipを参照してください。)

java snmpwalk localhost .1.3.6.1.4.1.140.625.105.1.15

サンプルのMedRecServerを実行するコンピュータからこのコマンドを呼び出す場合、コマンドは以下の抜粋のような出力を返します。出力には、applicationRuntimeNameオブジェクトのインスタンスごとに完全なOIDが含まれています。

Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.49.102.98.97.100.97.102.99.57.48.50.
102.48.98.53.54.100.100.49.54.50.54.99.54.99.49.97.97.98.53.100.97
STRING: MedRecServer_uddiexplorer

Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.54.98.49.101.57.56.54.98.98.50.57.10
0.54.55.48.100.56.98.101.101.97.55.48.53.57.99.49.51.56.98.97.99
STRING: MedRecServer_StartupEAR

Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.56.48.97.53.50.52.99.101.53.54.57.54
.52.52.99.54.48.55.54.100.102.49.54.97.98.52.48.53.98.100.100.49
STRING: MedRecServer_wl_management_internal2
...

以下の例では、medrecドメインのすべてのサーバーにデプロイされている、すべてのアプリケーションの名前を取得します。

java snmpwalk -c public@medrec localhost .1.3.6.1.4.1.140.625.105.1.15

以下の例では、管理対象サーバーMS1にデプロイされているすべてのアプリケーションの名前を取得します。

java snmpwalk -c public@MS1 localhost .1.3.6.1.4.1.140.625.105.1.15

snmpgetnext

指定する1つまたは複数のOIDの直後にある管理対象オブジェクトまたはオブジェクト・インスタンスの説明を返します。表形式のオブジェクトを指定した場合、最初の子管理対象オブジェクトが返されます。スカラー・オブジェクトを指定した場合、オブジェクトの最初のインスタンスが返されます。

snmpwalkコマンドが提供する再帰的なリストとは異なり、このコマンドでは、OIDの順序が次となる管理対象オブジェクトまたはインスタンス1つのみに関する説明を返します。一連のsnmpgetnextコマンドを並べて指定すると、snmpwalkコマンドと同じ結果が得られます。

構文

java snmpgetnext [-d] [-v (v1,v2)] [-c snmpCommunity] [-p snmpPort]
[-t timeout] [-r retries] host OID [OID]...

表4-4に、snmpgetnextコマンドに渡されるOIDの引数を示します。

表4-4 snmpgetnextの引数

引数

定義

OID [OID]...

1つまたは複数のオブジェクトID。複数のOIDを区切るには、スペースを使用します。オブジェクトまたはインスタンスのOIDを指定できます。

値は「.」で始めます。そうしない場合、参照はWebLogic Server MIBではなく標準MIB (.1.3.6.1.2.1)に対して相対的であると見なされます。

例

以下の例では、管理サーバーにデプロイされているアプリケーションの名前を取得します。アプリケーション名の管理対象オブジェクトは、applicationRuntimeNameです。これはスカラー・オブジェクトであり、applicationRuntimeTableオブジェクトの子です。(http://download.oracle.com/docs/cd/E24329_01/apirefs.1211/e24404/BEA-WEBLOGIC-MIB.asn1.zipを参照してください。)

java snmpgetnext localhost .1.3.6.1.4.1.140.625.105.1.15

サンプルのMedRecServerを実行するコンピュータからこのコマンドを呼び出す場合、コマンドは以下のような出力を返します。

Response PDU received from /127.0.0.1, community: public
Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.49.102.98.97.100.97.102.99.57.48.50.
102.48.98.53.54.100.100.49.54.50.54.99.54.99.49.97.97.98.53.100.97
STRING: MedRecServer_uddiexplorer

管理サーバーにデプロイされている他のアプリケーションがあるかどうかを調べるには、snmpgetnextコマンドの出力を追加のsnmpgetnextコマンドの入力として使用できます。

java snmpgetnext localhost .1.3.6.1.4.1.140.625.105.1.15.32.49.102.98.97.100.97.102.99.57.48.50.102.
48.98.53.54.100.100.49.54.50.54.99.54.99.49.97.97.98.53.100.97

コマンドは以下のような出力を返します。

Response PDU received from /127.0.0.1, community: public
Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.54.98.49.101.57.56.54.98.98.50.57.10
0.54.55.48.100.56.98.101.101.97.55.48.53.57.99.49.51.56.98.97.99
STRING: MedRecServer_StartupEAR

以下の例では、2つのOIDを指定して、管理サーバーにデプロイされているアプリケーションの名前、および JDBC接続プールの名前を取得します。コマンド例のOIDは、アプリケーション名のapplicationRuntimeNameオブジェクトとJDBC接続プール名のjdbcConnectionPoolRuntimeNameです。

java snmpgetnext localhost .1.3.6.1.4.1.140.625.105.1.15.1.3.6.1.4.1.140.625.190.1.15

サンプルのMedRecServerを実行するコンピュータからこのコマンドを呼び出す場合、コマンドは以下のような出力を返します。

Response PDU received from /127.0.0.1, community: public
Object ID:
.1.3.6.1.4.1.140.625.105.1.15.32.49.102.98.97.100.97.102.99.57.48.50.
102.48.98.53.54.100.100.49.54.50.54.99.54.99.49.97.97.98.53.100.97
STRING: MedRecServer_uddiexplorer
Object ID:
.1.3.6.1.4.1.140.625.190.1.15.32.53.53.49.48.50.55.52.57.57.49.99.102
.55.48.98.53.50.54.100.48.100.53.53.52.56.49.57.49.49.99.99.99
STRING: MedRecPool-PointBase

snmpget

1つまたは複数のオブジェクト・インスタンスの値を取得します。このコマンドでは、管理対象オブジェクトのOIDは使用できません。

構文

java snmpget [-d] [-v (v1,v2)] [-c snmpCommunity] [-p snmpPort]
[-t timeout] [-r retries] host object-instance-OID
[object-instance-OID]...

表4-5に、snmpgetコマンドに渡されるobject-instance-OID引数を示します。

表4-5 snmpgetの引数

引数

定義

object-instance-OID [object-instance-OID]...

オブジェクト・インスタンスのオブジェクトID。このコマンドでは、管理対象オブジェクトのOIDは使用できません。

値は「.」で始めます。そうしない場合、参照はWebLogic Server MIBではなく標準MIBに対して相対的であると見なされます。

例

以下の例では、管理サーバーのserverRuntimeStateおよびserverRuntimeListenPort管理対象オブジェクト・インスタンスを取得します。これらのオブジェクトは、どちらもserverRuntimeTableオブジェクトの子です(http://download.oracle.com/docs/cd/E24329_01/apirefs.1211/e24404/BEA-WEBLOGIC-MIB.asn1.zipを参照してください。)

java snmpget localhost .1.3.6.1.4.1.140.625.360.1.60.32.102.100.48.98.101.102.100.99.102.52.98.
97.48.48.49.102.57.53.51.50.100.102.53.55.97.101.52.56.99.99.97.99
.1.3.6.1.4.1.140.625.360.1.35.32.102.100.48.98.101.102.100.99.102.52.
98.97.48.48.49.102.57.53.51.50.100.102.53.55.97.101.52.56.99.99.97.99

サンプルのMedRecServerを実行するコンピュータからこのコマンドを呼び出す場合、コマンドは以下のような出力を返します。

Response PDU received from /127.0.0.1, community: public
Object ID:
.1.3.6.1.4.1.140.625.360.1.60.32.102.100.48.98.101.102.100.99.102.52.
98.97.48.48.49.102.57.53.51.50.100.102.53.55.97.101.52.56.99.99.97.99
STRING: RUNNING
Object ID:
.1.3.6.1.4.1.140.625.360.1.35.32.102.100.48.98.101.102.100.99.102.52.
98.97.48.48.49.102.57.53.51.50.100.102.53.55.97.101.52.56.99.99.97.99
INTEGER: 7001

トラップをテストするためのコマンド

表4-6は、テスト目的でトラップを生成および受信するコマンドの概要です。

表4-6 WebLogic Serverに関する情報を取得するためのコマンドの概要

コマンド

説明

snmptrapd

トラップを受信してトラップについての情報を出力するデーモンを起動します。

「snmptrapd」を参照してください。

snmpv1trap

SNMPv1トラップを作成して、指定したホスト上で動作し、指定したポート番号でリスニングするSNMPマネージャまたはトラップ・デーモンに、そのトラップを配信します。

「snmpv1trap」を参照してください。

snmptrapd

トラップを受信してトラップについての情報を出力するデーモンを起動します。

構文

java snmptrapd [-d] [-c snmpCommunity] [-p TrapDestinationPort]

表4-7に、snmptrapdコマンドに渡される引数を示します。

表4-7 snmptrapdの引数

引数

定義

-c snmpCommunity

SNMPエージェント(またはsnmpv1trapコマンド)がトラップを生成するために使用したコミュニティ名。

値を指定しない場合、コマンドは-c publicであると仮定します。

-p TrapDestinationPort

トラップ・デーモンがトラップを受信するポート番号。

値を指定しない場合、コマンドは-p 162であると仮定します。

例

以下のコマンドでは、トラップ・デーモンを起動して、リクエストをポート165でリスニングするように指示します。デーモンは、プロセスを強制終了するかシェルを終了するまで、そのシェルで実行されます。

java snmptrapd -p 165

コマンドが成功すると、トラップ・デーモンはカーソルのある空白行を返します。トラップ・デーモンは、トラップを出力する位置で、トラップを受信するまでこの状態で待機します。

snmpv1trap

SNMPv1トラップを作成して、指定したホスト上で動作し、指定したポート番号でリスニングするSNMPマネージャまたはトラップ・デーモンに、そのトラップを配信します。

このコマンドの呼出しの一部として、送信するトラップ・パケット内のフィールドの値を指定します。指定する値は、WebLogic Server MIBで定義されているトラップに解決される必要があります。WebLogic Serverトラップとトラップ・パケットに必要なフィールドの詳細は、『Oracle WebLogic Server SNMP管理ガイド』のWebLogic Server通知のOIDに関する項を参照してください。

構文

java snmpv1trap [-d] [-c snmpCommunity] [-p TrapDestinationPort]
TrapDestinationHost .1.3.6.1.4.140.625
agent-addr generic-trap specific-trap timestamp
[OID {INTEGER | STRING | GAUGE | TIMETICKS | OPAQUE |
IPADDRESS | COUNTER} value] ...

表4-8に、snmpv1trapコマンドに渡される引数を示します。

表4-8 snmpv1trapの引数

引数

定義

-c snmpCommunity

トラップのコミュニティ名。SNMPマネージャ(またはトラップ・デーモン)は、このコミュニティ名を使用するように構成されている場合にのみトラップにアクセスできます。

値を指定しない場合、コマンドは-c publicであると仮定します。

-p TrapDestinationPort

SNMPマネージャまたはトラップ・デーモンがリスニングするポート番号。

値を指定しない場合、コマンドは-p 162であると仮定します。

TrapDestinationHost

SNMPマネージャまたはトラップ・デーモンをホストするコンピュータのDNS名またはIPアドレス。

.1.3.6.1.4.140.625

トラップのenterpriseフィールドの値。このフィールドには、すべてのWebLogic ServerトラップのOIDの最初の部分が含まれます。

agent-addr

トラップのagent addressフィールドの値。

このフィールドは、トラップが生成されたコンピュータを示します。

snmpv1trapコマンドを使用してトラップを生成する場合、有効なDNS名またはIPアドレスを指定できます。

generic-trap

トラップのgeneric trap typeフィールドの値。

有効な値のリストについては、『Oracle WebLogic Server SNMP管理ガイド』のWebLogic Server通知のOIDに関する項を参照してください。

specific-trap

トラップのspecific trap typeフィールドの値。

有効な値のリストについては、『Oracle WebLogic Server SNMP管理ガイド』のWebLogic Server通知のOIDに関する項を参照してください。

timestamp

トラップのtimestampフィールドの値。

このフィールドは、SNMPエージェントが最後に再初期化した時からトラップが発行された時までの時間を示します。

snmpv1trapコマンドを使用してトラップを生成する場合、任意の秒数を指定できます。

OID {INTEGER | STRING |
GAUGE | TIMETICKS | OPAQUE |
IPADDRESS | COUNTER} value

(オプション)トラップの「variable bindings」フィールドの値。このフィールドは、トラップ通知をより詳細に記述するための名前と値の組合せで構成されます。

名前と値の組合せごとに、OID、値のタイプ、値を指定します。

たとえば、ログ・メッセージ・トラップには、トラップが生成される時刻を示すためにtrapTimeバインドが含まれます。生成するテスト・トラップにこの変数バインドを含めるには、trapTime変数バインドのOID、STRINGキーワード、および時刻を表す文字列を指定します。

.1.3.6.1.4.1.140.625.100.5 STRING "2:00 pm"

例

以下の例では、trapTimeおよびtrapServerName変数バインドを含むログ・メッセージ・トラップを生成します。ポート165からトラップをブロードキャストします。例:

java snmpv1trap -p 165 localhost .1.3.6.1.4.140.625 localhost 6 60 1000
.1.3.6.1.4.1.140.625.100.5 STRING "2:00 pm" .1.3.6.1.4.1.140.625.100.10
STRING localhost

上記の例で注目すべき点は以下のとおりです。

- 6は「他のWebLogic Serverトラップ」を指定するgeneric trap値。

- 60はWebLogic Serverがログ・メッセージ・トラップの識別に使用するspecific trap値。

- .1.3.6.1.4.1.140.625.100.5はtrapTime変数バインドのOID。.1.3.6.1.4.1.140.625.100.10は、trapServerName変数バインドのOID。

ポート番号165でリスニングするSNMPマネージャ(またはトラップ・デーモン)がトラップを受信します。トラップ・デーモンが165でリスニングしている場合は、次のように返します。

Trap received from: /127.0.0.1, community: public
Enterprise: .1.3.6.1.4.140.625
Agent: /127.0.0.1
TRAP_TYPE: 6
SPECIFIC NUMBER: 60
Time: 1000
VARBINDS:
Object ID: .1.3.6.1.4.1.140.625.100.5
STRING: 2:00 pm
Object ID: .1.3.6.1.4.1.140.625.100.10
STRING: localhost

例: snmpv1trapによるトラップ・デーモンへのトラップの送信

snmpv1trapコマンドを使用してWebLogic Serverトラップを生成し、トラップ・デーモンを介してそれらを受信するには、次の手順に従います。

1. コマンド・プロンプト(シェル)を開いて、次のスクリプトを呼び出します。
WL_HOME\server\bin\setWLSEnv.sh (WindowsではsetWLSEnv.cmd)

ここで、WL_HOMEは、WebLogic Serverのインストール先ディレクトリです。

2. トラップ・デーモンを起動するには、次のコマンドを入力します。

java snmptrapd

3. 別のシェルを開いて、次のスクリプトを呼び出します。
WL_HOME\server\bin\setWLSEnv.sh (WindowsではsetWLSEnv.cmd)

4. トラップを生成するには、次のコマンドを入力します。

java snmpv1trap localhost .1.3.6.1.4.140.625 localhost 6 60 1000

snmpv1trapコマンドはserverStartトラップを生成して、ポート162からブロードキャストします。

トラップ・デーモンが動作するシェルでは、デーモンが次のように出力します。

Trap received from: /127.0.0.1, community: public
Enterprise: .1.3.6.1.4.140.625
Agent: /127.0.0.1
TRAP_TYPE: 6
SPECIFIC NUMBER: 60
Time: 1000
VARBINDS:

例: WebLogic SNMPエージェントによるトラップ・デーモンへのトラップの送信

WebLogic SNMPエージェントを使用してWebLogic Serverトラップを生成し、トラップ・デーモンを介してそれらを受信するには、次の手順に従います。

1. ドメインの管理サーバーを起動し、SNMPエージェントを有効にします。
Oracle WebLogic Server管理コンソール・ヘルプのSNMPエージェントの作成に関する項を参照してください。

2. トラップ・デーモンを表すトラップ宛先を作成します。トラップ宛先がポート165を使用するように構成します。管理コンソールのその他のデフォルト値はそのままにしておきます。
Oracle WebLogic Server管理コンソール・ヘルプのトラップ宛先の作成に関する項を参照してください。

3. コマンド・プロンプト(シェル)を開いて、次のスクリプトを呼び出します。
WL_HOME\server\bin\setWLSEnv.sh (WindowsではsetWLSEnv.cmd)

ここで、WL_HOMEは、WebLogic Serverのインストール先ディレクトリです。

4. トラップ・デーモンを起動するには、次のコマンドを入力します。

java snmptrapd -p 165

5. 管理サーバーを再起動します。

管理サーバーが起動すると、SNMPエージェントはserverStartトラップを生成して、ポート165からそれをブロードキャストします。

トラップ・デーモンが動作するシェルでは、デーモンが次のように出力します。

Trap received from: /127.0.0.1, community: public
Enterprise: .1.3.6.1.4.140.625
Agent: /127.0.0.1
TRAP_TYPE: 6
SPECIFIC NUMBER: 65
Time: 1000
VARBINDS:

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