Oracle WebLogic Serverには、管理タスクとプログラミング・タスクの実行、WebLogic Server環境のインストールと構成、アプリケーションの作成とデプロイ、開発環境用証明書の生成、便利なショートカットの提供など、一連のJavaユーティリティとAntのタスクを提供します。
これらのユーティリティとタスクを使用するには、CLASSPATH
を正しく設定する必要があります。詳細については、「クラスパスの変更」を参照してくださいここでは、すべてのユーティリティのコマンド行構文を示し、一部のユーティリティについては使用例を紹介します。
Apache Webサイトでは、その他の便利なAntタスク(EAR、WAR、およびJARファイルのパッケージ化など)が提供されています。詳細については、(http://jakarta.apache.org/ant/manual/
)を参照してください。
appc
コンパイラは、EJBおよびJSPをOracle WebLogic Serverにデプロイするのに必要なクラスを生成し、コンパイルします。また、個別のモジュール・レベルとアプリケーション・レベルの両方で、現在の仕様に準拠しているかどうかデプロイメント記述子を検証します。『Oracle WebLogic Server Enterprise JavaBeansバージョン2.1の開発』の「appcリファレンス」を参照してください。AppletArchiver
ユーティリティは、別のフレームにあるアプレットを実行し、ダウンロードされたクラスと、そのアプレットによって使用されたリソースの記録をすべて保持し、.jar
ファイルまたは.cab
ファイルにパッケージ化します。(cabarc
ユーティリティはMicrosoftから入手できます。)
$ java utils.applet.archiver.AppletArchiver URL filename
表2-1に、AppletArchiver
ユーティリティに渡される引数を示します。
表2-1 AppletArchiverの引数
引数 | 定義 |
---|---|
URL
|
アプレットのURL。 |
filename
|
|
autotype
Antタスクは、Webサービス用の非組込みデータ型コンポーネント(シリアライゼーション・クラスなど)を生成するために使用します。autotype
Antタスクの完全修飾名は、weblogic.ant.taskdefs.webservices.javaschema.JavaSchema
です。
Web Services Antタスクの完全なリストは、『Oracle WebLogic Server WebLogic Webサービス・リファレンス』の「Antタスク・リファレンス」を参照してください。
build.xml
ファイルを生成するために使用します。 このユーティリティの詳細は、『Oracle WebLogic Serverアプリケーションの開発』の「分割開発ディレクトリでのアプリケーションのビルド」を参照してください。CertGen
ユーティリティによって生成される証明書は、デモまたはテスト専用のもので、本番環境では使用できません。
バージョン12.1.2のWebLogic Serverでは、デフォルトでCertGen
ユーティリティによって次の属性を持つ証明書が作成されます。
2048ビット公開鍵。
SHA256メッセージ・ダイジェスト・アルゴリズム。
サブジェクト・キー識別子拡張機能。
認証局キー識別子拡張機能(CA証明書にサブジェクト・キーIDが含まれる場合。)
$ 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>] [-digestalgorithm] <message digest algorithm> [-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] [-noskid] [-subjectkeyid <subject_key_identifier>] [-subjectkeyidformat UTF-8|BASE64] [-help]
表2-2に、CertGen
ユーティリティに渡される引数を示します。
表2-2 CertGenの引数
引数 | 定義 |
---|---|
-certfile cert_file -keyfile private_key_file |
生成されるパブリック証明書用と秘密鍵用の、拡張子を付けない出力ファイル名。 |
-keyfilepass private_key_password
|
生成される秘密鍵のパスワード。 |
-cacert ca_cert_file -cakey ca_key_file -cakeypass ca_key_password |
生成される証明書の発行者として使用されるCAのパブリック証明書、秘密鍵ファイル、秘密鍵パスワード。これらのオプションのうち1つまたは複数が指定されていない場合、関連するデモCAファイル |
-selfsigned |
信頼性のあるCA証明書として使用できる自己署名証明書を生成します。この引数を指定する場合は、 |
|
証明書に著名するために著名アルゴリズムとともに使用されるメッセージ・ダイジェスト・アルゴリズム。デフォルトはSHA256です。 サポートされる値は、MD5、SHA1、SHA256、SHA384およびSHA512です。 |
-strength key_strength
|
生成するキーの長さ(ビット単位)。デフォルトは2048ビットです。キーが長くなるほど、暗号の解読が難しくなります。 RSAキーの長さが1024ビットより短い証明書を生成すると、JDK 7u40以降で使用できない可能性があります。詳細は、 |
-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 |
デフォルトでは、キー用途拡張機能は「重要」とマークされます。拡張が「重要」でない証明書を生成するには、 |
|
証明書の中でサブジェクト・キー識別子拡張機能が生成されないようにします。 |
-subjectkeyid subject_key_identifier
|
指定されたサブジェクト・キー識別子を持つ証明書を生成します。 |
-subjectkeyidformat UTF-8|BASE64 |
|
デフォルトでは、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 machine-name
and key strength 2048
issued by CA with certificate from CertGenCA.der file and key from CertGenCAKey.der file
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
を使用して、Webサービスを呼び出すために必要なクライアント側のアーティファクト(JAX-RPCスタブなど)を生成します。『Oracle WebLogic Server WebLogic Webサービス・リファレンス』の「Antタスク・リファレンス」を参照してください。dbping
コマンド行ユーティリティを使用すると、JDBCドライバを使用したDBMSとクライアント・マシンの間の接続をテストできます。このユーティリティを使用する前に、ドライバをインストールしておく必要があります。 ドライバをインストールするには、ドライバ・ベンダーのドキュメントを参照してください。また、『Oracle WebLogic Server JDBCアプリケーションの開発』のWebLogic Serverでのサード・パーティ・ドライバの使用に関する項も参照してください。
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ドライバによって異なります。
|
[-d dynamicSections]
|
DB2パッケージに作成する動的セクション数を指定します。このオプションは、DB2用のWebLogicタイプ4 JDBCドライバを使用する場合のみ使用します。
|
user
|
ログインに使用する有効なデータベース・ユーザー名。
|
password
|
ユーザーの有効なデータベース・パスワード。 |
DB
|
データベースの名前と場所。使用するJDBCドライバに応じて次の形式で指定します。
説明:
|
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);
EAR
用のapplication.xml
およびweblogic-application.xml
ファイルを生成します。EarInit (非推奨)を参照してください。DDInit
は、Oracle WebLogic Serverにデプロイされるアプリケーションのデプロイメント記述子を生成するためのユーティリティです。モジュールのアーカイブまたはフォルダをターゲットとし、DDInit
はモジュールのクラス・ファイルにある情報を使用して、適切なデプロイメント記述子ファイルを作成します。
そのコマンド行版であるDDInit
は、新しいファイルを記述して既存の記述子ファイルを上書きします。META-INF
またはWEB-INF
が存在しない場合は、DDInit
によって作成されます。
以下のように、そのタイプに固有のDDInit
コマンドを使用することで、デプロイメント記述子を生成するJava EEデプロイ可能ユニットのタイプ(Webアプリケーションまたはエンタープライズ・アプリケーション)を指定します。
WAR
ファイル、またはWAR
ファイルとしてアーカイブするファイルが格納されたフォルダをターゲットとし、WebInit
はモジュールのweb.xml
およびweblogic.xml
ファイルを作成します。
prompt> java weblogic.marathon.ddinit.WebInit <module>
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>
weblogic.Deployer
ユーティリティは、非推奨となったweblogic.deploy
ユーティリティにかわるものです。
der2pem
ユーティリティを使用すると、X509証明書をDER形式からPEM形式に変換できます。.pem
ファイルは、変換元の.der
ファイルと同じディレクトリに書き込まれ、同じファイル名になります。
$ java utils.der2pem derFile [headerFile] [footerFile]
表2-4に、der2pem
ユーティリティに渡される引数を示します。
表2-4 der2pemの引数
引数 | 説明 |
---|---|
derFile
|
変換するファイルの名前。ファイル名は |
headerFile
|
PEMファイルに配置されるヘッダー。デフォルトのヘッダーは、"-----BEGIN CERTIFICATE-----"です。 変換中のDERファイルが秘密鍵ファイルの場合は、ヘッダー・ファイルを使用します。以下のいずれかを含むヘッダー・ファイルを作成します。
注意: ファイル内のヘッダー行の最後には、改行が必要になります。 |
footerFile
|
PEMファイルに配置されるヘッダー。デフォルトのヘッダーは、"-----END CERTIFICATE-----"です。 変換中のDERファイルが秘密鍵ファイルの場合は、フッター・ファイルを使用します。ヘッダーに以下のいずれかを含むフッター・ファイルを作成します。
注意: ファイル内のヘッダー行の最後には、改行が必要になります。 |
http://db.apache.org/derby
を参照してください。ejbc
は、コマンド行で指定されたデプロイメント記述子または.jar
ファイルにあるデプロイメント記述子ごとに、対応するEJBeanクラスのラッパー・クラスを作成します。次に、これらはRMIコンパイラで実行されて、クライアント側スタブとサーバー側スケルトンを生成します。『Oracle WebLogic Server Enterprise JavaBeansバージョン2.1の開発』の「appcリファレンス」を参照してください。EJBGenは、Enterprise JavaBeans 2.0のコード・ジェネレータです。Beanクラス・ファイルにjavadocタグでアノテーションを付けて、EJBGenでリモート・クラスとホーム・クラス、およびEJBアプリケーションのデプロイメント記述子ファイルを生成し、編集および管理する必要があるEJBファイルの数を1つに減らすことができます。
『Oracle WebLogic Server Enterprise JavaBeansバージョン2.1の開発』の「EJBGenリファレンス」を参照してください。
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 |
省略可能。コマンド行で入力した文字が表示されるようにします。 |
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
ユーティリティを使用すると、Javaの設定およびシステムに関する詳細情報を表示できます。引数はありません。
$ 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:\
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
|
キーストアのタイプ(フォーマット)。
keystore.type=jks 構成済みのセキュリティ・プロバイダでサポートされている場合は、別の |
alias
|
キーストアにインポートされている証明書および秘密鍵のルックアップに使用する名前。 |
keypass
|
キーストアにインポートされている秘密鍵エントリのパスワード。 |
注意:
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ファイルを指定する必要はありません。
証明書を生成するには、次の手順に従います。
次のコマンドを入力すると、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
証明書をDER形式からPEM形式に変換します。
$ java utils.der2pem CertGenCA.der
証明書と認証局(CA)を連結します。
$ cat testcert.pem CertGenCA.pem >> newcerts.pem
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
|
省略可能。ターゲット・ディレクトリ。ターゲット・ディレクトリを指定しない場合、出力はカレント・ディレクトリに書き込まれます。 |
logToZip
ユーティリティは、HTTPサーバー・ログ・ファイルの内容を検索し、その中でサーバーによってロードされるJavaクラスを検出してから、それらのJavaクラスを含む非圧縮の.zip
ファイルを作成します。 このユーティリティは、HTTPサーバーのドキュメント・ルート・ディレクトリから実行します。このユーティリティを使用するには、HTTPサーバーによって作成されたログ・ファイルへのアクセスが必要です。
$ java utils.logToZip logfile codebase zipfile
表2-8に、logToZip
ユーティリティに渡される引数を示します。
表2-8 logToZipの引数
引数 | 定義 |
---|---|
logfile
|
必須。ログ・ファイルの完全修飾パス名。 |
codebase
|
必須。アプレットのコード・ベース、またはコード・ベースがない場合は |
zipfile
|
必須。作成する |
CREATE
、DELETE
、GET
、INVOKE
およびSET
)は、MBeanを管理するために使用します。 詳細は、WebLogic Server WLSTコマンド・リファレンスの編集コマンドに関する項を参照してください。MulticastTest
ユーティリティは、WebLogicクラスタの構成時にマルチキャストに関する問題をデバッグする場合に便利です。 このユーティリティは、マルチキャスト・パケットを送信し、ネットワーク上で、マルチキャストがどのくらい効果的に機能しているかについての情報を返します。特に、MulticastTest
は標準出力を通して以下のタイプの情報を表示します。現在のサーバーが送信する各メッセージの確認およびシーケンスID
現在のサーバーを含む、任意のクラスタリングされたサーバーから受信した各メッセージのシーケンスと送信者ID
メッセージを受信したがシーケンスがない場合は、シーケンス紛失警告
予期されていたメッセージが受信されなかった場合は、メッセージ紛失警告
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
|
(a) シーケンスされたメッセージがブロードキャストされ、(b) クラスタ内のサーバーが互いに通信するマルチキャスト・アドレス。(デフォルトは237.0.0.1です。) |
-p portnumber
|
省略可能。クラスタ内のすべてのサーバーが通信するマルチキャスト・ポート。(マルチキャスト・ポートは、WebLogic Serverに設定されたリスニング・ポートと同じで、設定されていない場合のデフォルトは7001です。) |
-t timeout
|
省略可能。マルチキャスト・メッセージが受け取れない場合のアイドル・タイムアウト(秒単位)。設定しない場合、デフォルトは600秒(10分)です。タイムアウトを経過すると、タイムアウトの確認情報が |
-s send
|
省略可能。送信間の時間間隔(秒単位)。設定しない場合、デフォルトは2秒です。送信された各メッセージの確認情報が、 |
$ 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
pem2der
ユーティリティを使用すると、X509証明書をPEM形式からDER形式に変換できます。.der
ファイルは、変換元の.pem
ファイルと同じディレクトリに書き込まれます。$ java utils.pem2der pemFile
表2-10に、pem2der
ユーティリティに渡される引数を示します。
表2-10 pem2derの引数
引数 | 説明 |
---|---|
pemFile
|
変換するファイルの名前。ファイル名は |
$ java utils.pem2der
graceland_org.pem
Decoding
................................................................
................................................................
................................................................
................................................................
................................................................
weblogic.rmic
は、クライアント側でアプリケーションのカスタム・リモート・オブジェクト・インタフェースに対して動的プロキシを生成し、サーバー側オブジェクトにホット・コード生成を提供します。『Oracle WebLogic Server RMIアプリケーションの開発』の「WebLogic RMIコンパイラの使い方」を参照してください。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
Antタスクは、EJB JARファイルまたはJavaクラス・リストを入力として取り、必要なすべてのWebサービス・コンポーネントを作成してそれらをデプロイ可能なEARファイルにパッケージ化します。
WebLogic Webサービスの8.1と9.0の間で多くの点が変更され、WebサービスがJava EE標準になりました。
WebサービスAntタスクの詳細なリストは、『Oracle WebLogic Server WebLogic Webサービス・リファレンス』の「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
ユーティリティを使用すると、コンピュータの操作環境に関する基本的な情報を表示できます。この情報には、JDKの製造メーカーとバージョン、CLASSPATH
、オペレーティング・システムに関する情報などがあります。
$ java utils.system * * * * * * * java.version * * * * * * * 1.8.0_121 * * * * * * * java.vendor * * * * * * * Oracle Corporation * * * * * * * java.class.path * * * * * * * C:\Oracle\wlserver\samples\server\examples\build\serverclasses;C:\Java\JDK18~1.0_7\lib\tools.jar; C:\Oracle\wlserver\server\lib\weblogic.jar;C:\Oracle\oracle_common\modules\net.sf.antcontrib_1.1.0.0_1-0b3\lib \ant-contrib.jar;C:\Oracle\wlserver\modules\features\oracle.wls.common.nodemanager.jar; C:\Oracle\wlserver\common\derby\lib\derbynet.jar;C:\Oracle\wlserver\common\derby\lib\derbyclient.jar; C:\Oracle\wlserver\common\derby\lib\derby.jar;C:\Oracle\wlserver\samples\server\examples\build\clientclasses * * * * * * * os.name * * * * * * * Windows 7 * * * * * * * os.arch * * * * * * * amd64 * * * * * * * os.version * * * * * * * 6.1
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
ユーティリティは、HTTPサーバーのドキュメント・ルート・ディレクトリから実行されると、verboseモードで実行されているJavaアプリケーションから標準出力を取得し、参照されているJavaクラスを検出してから、それらのJavaクラスを含む非圧縮の.zip
ファイルを作成します。
$ java utils.verboseToZip inputFile zipFileToCreate
表2-12に、verboseToZip
ユーティリティに渡される引数を示します。
表2-12 verboseToZipの引数
引数 | 定義 |
---|---|
inputFile
|
必須。verboseモードで実行されているアプリケーションの出力が含まれる一時ファイル。 |
zipFileToCreate
|
必須。作成する |
WebLogicMBeanMaker
ユーティリティは、XML MBean記述ファイル(MDF)を受け取り、MBeanインタフェース、MBean実装、および関連MBean情報ファイルなどのいくつかのJava中間ファイルを出力します。これらの中間ファイルが合わさって、カスタム・セキュリティ・プロバイダのMBeanタイプになります『Oracle WebLogic Serverセキュリティ・プロバイダの開発』のWebLogic MBeanMakerからの出力の理解に関する項を参照してください。
$ java -DMDF=xmlfile -DFiles=filesdir -DcreateStubs=true|false weblogic.management.commo.WebLogicMBeanMaker
表2-13に、WebLogicMBeanMaker
に渡される引数を示します。
表2-13 WebLogicMBeanMakerの引数
引数 | 説明 |
---|---|
-DMDF=xmlfile
|
|
-DFiles=filesdir
|
WebLogic MBeanMakerユーティリティがMBeanタイプの中間ファイルを配置する、 |
-DcreateStubs=true|false |
WebLogic MBeanMakerユーティリティで既存のMBean実装ファイルをすべて上書きするかどうかを指定します。 |
wlappc
ユーティリティは、デプロイメント用のJava EE EARファイル、EJB JARファイル、またはWARファイルをコンパイルおよび検証します。
詳細は、Oracle WebLogic Serverアプリケーションの開発のwlappcを使用したモジュールとアプリケーションのビルドを参照してください。
wlconfig
Antタスクを使用すると、動作中の管理サーバー・インスタンス上でMBeanの作成、問合せ、変更を行うことで、WebLogic Serverドメインを構成できます。
このAntタスクの詳細は、『Oracle WebLogic Serverアプリケーションの開発』のAntタスクを使用したWebLogic Serverドメインの構成に関する項を参照してください。
wldeploy
Antタスクでは、Antタスクに指定する属性を使用してweblogic.Deployer
ツールの機能を実行できます。
Deployerを参照してください。wldeploy
の詳細は、『Oracle WebLogic Serverアプリケーションの開発』の分割開発ディレクトリからのデプロイメントとパッケージ化に関する項を参照してください。
wlpackage
Antタスクは、分割開発ディレクトリ・アプリケーションを、WebLogic Serverにデプロイ可能な従来のEARファイルとしてパッケージ化するのに使用します。
『Oracle WebLogic Serverアプリケーションの開発』の「分割開発ディレクトリからのデプロイメントとパッケージ化」を参照してください。
wlserver
Antタスクを使用すると、WebLogic Serverインスタンスを起動、再起動および停止したり、WebLogic Serverインスタンスへ接続したりできます。
サーバー・インスタンスは、構成済のWebLogic Serverドメインにすでに存在している場合もありますが、存在しない場合は、generateconfig=true
属性を使用して開発用の新しい単一サーバー・ドメインを作成できます。このAntタスクの詳細は、『Oracle WebLogic Serverアプリケーションの開発』のwlserver Antタスクを使用したサーバーの起動とドメインの作成に関する項を参照してください。
wsdl2Service
Antタスクは、既存のWSDLファイルを入力として取り、目的のWebサービスの実装を表現するJavaインタフェースと、Webサービスを記述するweb-services.xml
ファイルを生成するWebサービス・ツールです。
『Oracle WebLogic Server JAX-WS Webサービスの開発』のWSDLファイルから開始するWebLogic Webサービスの開発: 主な手順に関する項を参照してください。
wsdlgen
Antタスクは、Webサービスを実装するEARおよびWARファイルからWSDLファイルを生成するWebサービス・ツールです。
WebLogic Webサービスの8.1と9.0の間で多くの点が変更され、WebサービスがJava EE標準になりました。
WebサービスAntタスクの詳細なリストは、『Oracle WebLogic Server WebLogic Webサービス・リファレンス』の「Antタスク・リファレンス」を参照してください。