ナビゲーションをスキップ

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

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

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

WebLogic Server には、管理およびプログラミング タスクを行うための Java ユーティリティと Ant タスクが用意されています。

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

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

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

 


appc

appc コンパイラは、EJB および JSP を WebLogic Server にデプロイするのに必要なクラスを生成し、コンパイルします。また、個別のモジュール レベルとアプリケーション レベルの両方で、現在の仕様に準拠しているかどうかデプロイメント記述子を検証します。『WebLogic エンタープライズ JavaBeans (EJB) プログラマーズ ガイド』の「appc」を参照してください。

 


AppletArchiver

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

構文

$ java utils.applet.archiver.AppletArchiver URL filename

引数

定義

URL

アプレットの URL。

filename

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


 

 


autotype (非推奨)

autotype Ant タスクは、Web サービス用の非組み込みデータ型コンポーネント (シリアライゼーション クラスなど) を生成するために使用します。autotype Ant タスクの完全修飾名は、weblogic.ant.taskdefs.webservices.javaschema.JavaSchema です。『WebLogic Web サービス プログラマーズ ガイド』の「Ant タスク リファレンス」を参照してください。

 


BuildXMLGen

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

 


CertGen

CertGen ユーティリティは、プロダクション環境用ではなくデモまたはテスト目的専用の証明書を生成します。

構文

$ java utils.CertGen
[-cacert <ca_cert_file-name>] [-cakey <ca_key_filename>]
[-cakeypass <ca_key_password>] [-selfsigned]
[-certfile <certfile>] [-keyfile <privatekeyfile>]
[-keyfilepass <keyfilepassword>] [-strength <keystrength>]
[-cn <commonname>] [-ou <orgunit>] [-o <organization>]
[-l <locality>] [-s <state>] [-c <countrycode>]
[-subjectkeyid <subjectkeyidentifier>]
[-subjectkeyidformat UTF-8|BASE64]

引数

定義

ca_cert_filename

発行者の CA 公開証明書のファイル名。

ca_key_filename

発行者の CA プライベート キーのファイル名。

ca_key_password

発行者の CA プライベート キーのパスワード。

selfsigned

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

certfile

生成される証明書ファイルの名前。

privatekeyfile

生成されるプライベート キー ファイルの名前。

keyfilepassword

プライベート キーのパスワード。

keystrength

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

commonname

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

orgunit

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

organization

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

locality

市町村の名前。

state

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

countrycode

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

subjectkeyidentifier

コマンド ラインで指定したサブジェクト キー識別子拡張と ID 値を持つ証明書を生成する。

UTF-8|BASE64

subjectkeyid 値の形式。有効値は UTF-8 または BASE64。デフォルト値は UTF-8。


 

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

次のコマンドを入力すると、testcert という名前の証明書ファイルと testkey という名前のプライベート キー ファイルが生成されます。

$ java utils.CertGen mykeypass testcert testkey
Creating Domestic Key Strength - 1024
Encoding
................................................................
................................................................
................................................................
Created Private Key files - testkey.der and testkey.pem
Encoding
................................................................
................................................................
................................................................
Created Certificate files - testcert.der and testcert.pem
................................................................

 


ClientDeployer

J2EE 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 にパッケージ化された J2EE クライアントを格納する 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 は、クライアント JAR ファイルを生成するために使用します。『WebLogic Web サービス プログラマーズ ガイド』の「Ant タスク リファレンス」を参照してください。

 


Conversion (非推奨)

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

 


der2pem

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

構文

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

引数

説明

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
................................................................

 


dbping

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

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

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

デフォルトの DB2 パッケージには 200 の動的セクションが含まれます。-d オプションを使用して、異なる動的セクション数を指定して DB2 パッケージに作成できます。また、-d オプションは、接続テストで使用される接続に対し、CreateDefaultPackage=true および ReplacePackage=true も設定します。これにより、DB2 ドライバによって DB2 サーバ上の DB2 パッケージが強制的に置き換えられます (詳細については「DB2 接続プロパティ」を参照)。動的セクション数が 200 に設定された -d オプションを使用することで、DB2 サーバ上でデフォルトのパッケージを強制的に再作成できます。

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

DB2 パッケージを作成するには、指定するユーザがデータベースに対する CREATE PACKAGE 特権を持っていなければなりません。

構文

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

引数

定義

DBMS

DBMS および JDBC ドライバによって異なる。

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

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

JCONNECT - Sybase JConnect ドライバ

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

MSSQLSERVER4 - WebLogic jDriver for Microsoft SQL Server

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

ORACLE - WebLogic jDriver for Oracle

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

ORACLE_THIN - Oracle Thin ドライバ

POINTBASE - PointBase Universal Driver

SYBASEB - Sybase 用の BEA WebLogic Type 4 JDBC ドライバ

[-d dynamicSections]

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

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

user

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

-d オプションが指定されている DB2 の場合、ユーザはデータベースに対する CREATE PACKAGE 特権を持っていなければならない。

password

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

DB

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

DB2B - Host:Port/DBName

JCONN2 - Host:Port/DBName

JCONNECT - Host:Port/DBName

INFORMIXB - Host:Port/DBName/InformixServer

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

MSSQLSERVERB - 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 固有の環境変数


 

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);

 


ddcreate

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

 


DDInit

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

デプロイメント記述子を生成および編集するためのグラフィカル ユーザ インタフェースである WebLogic Builder は、DDInit を実行してデプロイメント記述子を生成します。詳細については、WebLogic Builder を参照してください。

WebLogic Builder とは異なり、そのコマンドライン版である DDInit は、新しいファイルを記述して既存の記述子ファイルを上書きします。META-INF (EAR または EJB の場合)、または WEB-INF (Web アプリケーションの場合) が存在しない場合は、DDInit が作成します。

以下のように、DDInit コマンドとタイプに固有のコマンドを使用して、デプロイメント記述子を生成する J2EE デプロイ可能モジュールのタイプを指定します。

EJBInit

JAR ファイル、または JAR ファイルとしてアーカイブするファイルが格納されたフォルダを対象とし、EJBInt はモジュールの ejb-jar.xml および weblogic-ejb-jar.xml ファイルを生成します。

java weblogic.marathon.ddinit.EJBInit <module>

EJBInit は対象以下のフォルダを検索して EJB (Bean クラス、ローカルまたはリモート ホーム、リモートまたはローカル インタフェース) を見つけます。インタフェースと Bean を照合して、その結果からどのホームがどの Bean に属するのかを判別します。Bean 内の CMP フィールドを検索して、エンティティ Bean 間の関係を見つけます。このように収集した情報から、EJBInit はデプロイメント記述子を記述します。

DDInit は EJB 2.0 をサポートします。DDInit は、1.1 のセッション Bean に対しては正確な結果を提供しますが、EJB 1.1 のエンティティ Bean に対しては機能しない可能性があります。

WebInit

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

java weblogic.marathon.ddinit.WebInit <module>

EarInit

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

java weblogic.marathon.ddinit.EarInit <module>

WebLogic Builder では、EarInit が対象のモジュール以下のツリー全体を繰り返し検索します。コマンドラインでは、EAR に含まれるモジュールの記述子がすでに用意されている必要があります。application.xml はモジュール群を説明するものです。生成される weblogic-application.xml は空のプレースホルダとなります。

制限

この例の出力では、ejb_st.jar のデプロイメント記述子ファイルのビルドについて示しています。

D:¥dev¥smarticket5¥smarticket¥bin>java weblogic.marathon.ddinit.EJBInit ejb_st.jar

Found 4 classes that implement the EnterpriseBean interface

Discovered module type for D:¥dev¥smarticket5¥smarticket¥bin¥ejb_st.jar

Found EJB components.Initializing descriptors

Creating desc for bean com.sun.j2ee.blueprints.smarticket.ejb.customer.CustomerEJB

*** found remote home: com.sun.j2ee.blueprints.smarticket.ejb.customer.CustomerHome

*** found remote interface: com.sun.j2ee.blueprints.smarticket.ejb.customer.Customer

Setting prim-key-class to 'java.lang.String'

Adding Entity bean 'CustomerEJB'

Creating desc for bean com.sun.j2ee.blueprints.smarticket.ejb.localeinfo.LocaleInfoEJB

*** found remote home: com.sun.j2ee.blueprints.smarticket.ejb.localeinfo.LocaleInfoHome

*** found remote interface: com.sun.j2ee.blueprints.smarticket.ejb.localeinfo.LocaleInfo

LocaleInfoEJB is a Stateless Session bean

Adding Session bean 'LocaleInfoEJB'

Creating desc for bean com.sun.j2ee.blueprints.smarticket.ejb.movieinfo.MovieInfoEJB

*** found remote home: com.sun.j2ee.blueprints.smarticket.ejb.movieinfo.MovieInfoHome

*** found remote interface: com.sun.j2ee.blueprints.smarticket.ejb.movieinfo.MovieInfo

MovieInfoEJB is a Stateless Session bean

Adding Session bean 'MovieInfoEJB'

Creating desc for bean com.sun.j2ee.blueprints.smarticket.ejb.ticketsales.TicketSalesEJB

*** found remote home: com.sun.j2ee.blueprints.smarticket.ejb.ticketsales.TicketSalesHome

*** found remote interface: com.sun.j2ee.blueprints.smarticket.ejb.ticketsales.TicketSales

TicketSalesEJB is a Stateful Session bean

Adding Session bean 'TicketSalesEJB'

Writing descriptors

Building module with newly created descriptors

Finished building module

 


Deployer

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

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

 


ejbc

非推奨。『WebLogic エンタープライズ JavaBeans (EJB) プログラマーズ ガイド』の「ejbc」を参照してください。

 


EJBGen

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

『WebLogic エンタープライズ JavaBeans (EJB) プログラマーズ ガイド』の「EJBGen リファレンス」を参照してください。

 


Encrypt

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

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

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

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

構文

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

引数

定義

weblogic.RootDirectory

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

weblogic.management.allowPasswordEcho

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

password

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


 

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

java weblogic.security.Encrypt xxxxxx
{3DES}Rd39isn4LLuF884Ns

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

java -Dweblogic.RootDirectory=./mydomain weblogic.security.Encrypt xxxxxx
{3DES}hsikci118SKFnnw

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

java weblogic.security.Encrypt
Password:
{3DES}12hsIIn56KKKs3

 


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 ユーティリティは WebLogic Server のインターオペラブル オブジェクト参照 (IOR) を取得します。

構文

$ java utils.host2ior hostname port

 


ImportPrivateKey

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

構文

$ java utils.ImportPrivateKey keystore storepass storetype keypass alias certfile keyfile keyfilepass

引数

定義

keystore

キーストアの名前。キーストアが存在しない場合は、新しいキーストアが作成される。

storepass

キーストアを開くためのパスワード。

storetype

使用するキーストアのタイプ。以下のオプションがある。

  • [デモ ID とデモ信頼] - WL_HOME\server\lib ディレクトリに配置され、デフォルトでコンフィグレーションされているデモ用 ID キーストアと信頼キーストア、およびJAVA_HOME\jre\lib\security ディレクトリの cacerts ファイルを使用する。

  • [カスタム ID と Java 標準信頼] - ユーザが作成する ID キーストアと、JAVA_HOME\jre\lib\security ディレクトリの cacerts ファイルで定義されている信頼された CA を使用する。

  • [カスタム ID とカスタム信頼] - ユーザが作成する ID キーストアと信頼キーストアを使用する。

  • [Custom Identity and Command Line Trust] - ユーザが作成する ID キーストアと、信頼キーストアの場所を指定するコマンドライン引数を使用する。このオプションは、プロダクション環境で、管理ポートが有効であり、管理対象サーバがノード マネージャではなくコマンドラインで起動されている場合に使用する。

keypass

プライベート キー ファイルをキーストアから取得するためのパスワード。

alias

キーストア内の証明書およびキーのルックアップに使用する名前。

certfile

プライベート キーに関連付けられている証明書の名前。

keyfile

保護されたプライベート キーを保持するファイルの名前。

keyfilepass

キーストアにあるプライベート キー ファイルのロック解除、およびプライベート キーの保護に使用するパスワード。


 

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

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

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

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

  1. 次のコマンドを入力すると、testcert という名前の証明書ファイルと testkey という名前のプライベート キー ファイルが生成されます。
$ java utils.CertGen mykeypass testcert testkey
Creating Domestic Key Strength - 1024
Encoding
................................................................
................................................................
................................................................
Created Private Key files - testkey.der and testkey.pem
Encoding
................................................................
................................................................
................................................................
Created Certificate files - testcert.der and testcert.pem
................................................................
  1. 証明書を DER 形式から PEM 形式に変換します。
$ java utils.der2pem CertGenCA.der Encoding
................................................................
................................................................
  1. 証明書と認証局 (CA) を連結します。
$ type testcert.pem CertGenCA.pem >> newcerts.pem
  1. mykeystore という名前のキーストアを新たに作成し、testkey.pem ファイルにあるプライベート キーをロードします。
$ java utils.ImportPrivateKey mykeystore mypasswd mykey
mykeypass newcerts.pem testkey.pem
Keystore file not found, creating it

 


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

または

$ java weblogic.utils.jhtml2jsp filename.jhtml

引数

定義

-d

対象ディレクトリを指定する。対象ディレクトリを指定しない場合、出力はカレント ディレクトリに書き込まれる。

 


jspc

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

 


logToZip

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

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

構文

$ java utils.logToZip logfile codebase zipfile

引数

定義

logfile

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

codebase

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

zipfile

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


 

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

$ 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 コマンド (CREATEDELETEGETINVOKEQUERY、および SET) は、MBean を管理するために使用します。「weblogic.Admin コマンドライン リファレンス」の「WebLogic Server MBean を管理するためのコマンド」を参照してください。

 


MulticastTest

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

  1. 現在のサーバが送信する各メッセージの確認およびシーケンス ID
  2. 現在のサーバを含む、任意のクラスタ化されたサーバから受信した各メッセージのシーケンスと送信者 ID
  3. メッセージを受信したがシーケンスがない場合は、シーケンス紛失警告
  4. 予期されていたメッセージが受信されなかった場合は、メッセージ紛失警告

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

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

マルチキャストの設定に関する情報については、WebLogic Server ホスト マシンの特定のオペレーティング システムまたはハードウェアのコンフィグレーションに関するドキュメントを参照してください。クラスタの詳細については、『WebLogic Server クラスタ ユーザーズ ガイド』を参照してください。

構文

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

引数

定義

-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

引数

説明

pemFile

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


 

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

 


pointbase

PointBase は、サンプル データベースとして WebLogic Server にバンドルされています。WL_HOME\common\eval\pointbase\docs (WL_HOME は WebLogic Server のインストール ディレクトリ) にドキュメントがあります。

PointBase のドキュメントは http://www.pointbase.com/support/docs/overview.html でも参照できます。

 


rmic

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

 


Schema

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

構文

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

引数

定義

driverURL

必須。JDBC ドライバの URL。

driverClass

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

-u username

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

-p password

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

-verbose

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

SQLfile

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


 

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

$ java utils.Schema
"jdbc:pointbase:server://localhost/demo"
"com.pointbase.jdbc.jdbcUniversalDriver" -u "examples"
-p "examples" examples/utils/ddl/demo.ddl
utils.Schema will use these parameters:
url: jdbc:pointbase:server://localhost/demo
driver: com.pointbase.jdbc.jdbcUniversalDriver
dbserver: null
user: examples
password: examples
SQL file: examples/utils/ddl/demo.ddl

 


servicegen (非推奨)

servicegen Ant タスクは、EJB JAR ファイルまたは Java クラス リストを入力として取り、必要なすべての Web サービス コンポーネントを作成してそれらをデプロイ可能な EAR ファイルにパッケージ化します。『WebLogic Web サービス プログラマーズ ガイド』の「Ant タスク リファレンス」を参照してください。

 


SearchAndBuild

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

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

<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>

 


showLicenses

showLicenses ユーティリティを使用すると、このマシンにインストールされている BEA Products に関するライセンス情報を表示できます。

構文

$ java -Dbea.home=license_location utils.showLicenses

引数

説明

license_location

license.bea ファイルがあるディレクトリの完全修飾名。


 

$ java -Dbea.home=d:¥bea utils.showLicense

 


source2wsdd (非推奨)

Java クラスを使用して実装される WebLogic Web サービスの Java ソース ファイルから web-services.xml デプロイメント記述子ファイルを生成します。『WebLogic Web サービス プログラマーズ ガイド』の「Ant タスク リファレンス」を参照してください。

 


system

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

構文

$ java utils.system

$ java utils.system
* * * * * * * java.version * * * * * * *
1.1.6

* * * * * * * java.vendor * * * * * * *
Sun Microsystems Inc.

* * * * * * * java.class.path * * * * * * *
¥java¥lib¥classes.zip;¥weblogic¥classes;
¥weblogic¥lib¥weblogicaux.jar;¥weblogic¥license
...

* * * * * * * os.name * * * * * * *
Windows NT

* * * * * * * os.arch * * * * * * *
x86

* * * * * * * os.version * * * * * * *
4.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=FOR TESTINGONLY,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

引数

定義

inputFile

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

zipFileToCreate

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


 

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

 


wlappc

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

詳細については、「appc」を参照してください。

 


wlcompile

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

 


wlconfig

wlconfig Ant タスクを使用すると、動作中の管理サーバ インスタンス上で MBean の作成、クエリ、変更を行うことで、WebLogic Server ドメインをコンフィグレーションできます。この Ant タスクの詳細については、『WebLogic Server アプリケーションの開発』の「Ant タスクを使用した WebLogic Server ドメインのコンフィグレーション」を参照してください。

 


wldeploy

wldeploy Ant タスクでは、Ant タスクに指定する属性を使用して Deployer の機能を実行できます。『WebLogic Server アプリケーションの開発』の「Deploying and Packaging from a Split Development Directory」を参照してください。

 


wlpackage

wlpackage Ant タスクは、分割開発ディレクトリ アプリケーションを、WebLogic Server にデプロイ可能な従来の EAR ファイルとしてパッケージ化するのに使用します。『WebLogic Server アプリケーションの開発』の「Deploying and Packaging from a Split Development Directory」を参照してください。

 


wlserver

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

 


writeLicense

writeLicense ユーティリティを使用すると、WebLogic ライセンスすべてに関する情報を、カレント ディレクトリにある writeLicense.txt というファイルに書き込むことができます。このファイルは、たとえば WebLogic のテクニカル サポートなどへ電子メールで送信できます。

構文

$ java utils.writeLicense -nowrite -Dbea.home=path

引数

定義

-nowrite

必須。writeLicense.txt ではなく、stdout に出力を送る。

-Dbea.home

必須。WebLogic システム ホーム (インストールされている WebLogic Server のルート ディレクトリ) を設定する。


 

$ java utils.writeLicense -nowrite

UNIX の出力例

* * * * * * System properties * * * * * *

* * * * * * * java.version * * * * * * *
1.1.7

* * * * * * * java.vendor * * * * * * *
Sun Microsystems Inc.

* * * * * * * java.class.path * * * * * * *
c:\weblogic\classes;c:\weblogic\lib\weblogicaux.jar;
c:\java117\lib\classes.zip;c:\weblogic\license
...

Windows NT の出力例

* * * * * * * os.name * * * * * * * 
Windows NT

* * * * * * * os.arch * * * * * * *
x86

* * * * * * * os.version * * * * * * *
4.0

* * * * * * IP * * * * * *
Host myserver is assigned IP address: 192.1.1.0

* * * * * * Location of WebLogic license files * * * * * *
No WebLogicLicense.class found

No license.bea license found in
weblogic.system.home or current directory

Found in the classpath: c:/weblogic/license/license.bea
Last Modified: 06/02/1999 at 12:32:12

* * * * * * Valid license keys * * * * * *
Contents:
Product Name : WebLogic
IP Address : 192.1.1.0-255
Expiration Date: never
Units : unlimited
key : b2fcf3a8b8d6839d4a252b1781513b9
...

* * * * * * All license keys * * * * * *
Contents:
Product Name : WebLogic
IP Address : 192.1.1.0-255
Expiration Date: never
Units : unlimited
key : b2fcf3a8b8d6839d4a252b1781513b9
...

* * * * * * WebLogic version * * * * * *
WebLogic Build: 4.0.x xx/xx/1999 10:34:35 #xxxxx

 


wsdl2Service

wsdl2Service Ant タスクは、既存の WSDL ファイルを入力として取り、目的の Web サービスの実装を表現する Java インタフェースと Web サービスを記述する web-services.xml ファイルを生成する Web サービス ツールです。『WebLogic Web サービス プログラマーズ ガイド』の「wsdl2Service」を参照してください。

 


wsdlgen (非推奨)

wsdlgen Ant タスクは、Web サービスを実装する EAR および WAR ファイルから WSDL ファイルを生成する Web サービス ツールです。『WebLogic Web サービス プログラマーズ ガイド』の「Ant タスク リファレンス」を参照してください。

 


wspackage (非推奨)

Web Services wspackage Ant タスクは、WebLogic Web サービスの各種コンポーネントをデプロイ可能な新規 EAR ファイルにパッケージ化し、既存の EAR ファイルにコンポーネントを追加するために使用します。『WebLogic Web サービス プログラマーズ ガイド』の「Ant タスク リファレンス」を参照してください。

 

フッタのナビゲーションのスキップ  ページの先頭 前 次