BEA ホーム | 製品 | dev2dev | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > WebLogic Server > 管理者ガイド > WebLogic Java ユーティリティの使い方 |
管理者ガイド
|
WebLogic には、インストールおよびコンフィグレーション タスクを簡素化したり、サービスを提供したり、便利なショートカットを提供したりする Java プログラムが用意されています。以下の節では、WebLogic Server に用意されている各 Java ユーティリティについて説明します。ここでは、すべてのユーティリティのコマンドライン構文を示し、一部のユーティリティについては使用例を紹介します。
これらのユーティリティを使用するには、CLASSPATH を正しく設定する必要があります。詳細については、「クラスパスの設定」を参照してください。
AppletArchiver ユーティリティは、別のフレームにあるアプレットを実行し、ダウンロードされたクラスと、そのアプレットによって使用されたリソースの記録をすべて保持し、.jar ファイルまたは .cab ファイルにパッケージ化します (cabarc ユーティリティは、Microsoft から入手できます)。
$ java utils.applet.archiver.AppletArchiver URL filename
CertGen ユーティリティは、プロダクション環境用ではなくデモまたはテスト目的専用の証明書を生成します。
$ java utils.CertGen password certfile keyfile [export]
$ 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
................................................................
J2EE EAR ファイルからクライアントサイド JAR ファイルを展開して、デプロイ可能な JAR ファイルを作成するには、weblogic.ClientDeployer を使用します。 weblogic.ClientDeployer クラスは、Java コマンド ラインで次の構文を使用して実行します。
java weblogic.ClientDeployer ear-file client
ear-file 引数は、1 つまたは複数のクライアント アプリケーション JAR ファイルが格納されている展開されたディレクトリか、または拡張子 .ear を持つ Java アーカイブ ファイルです。
EAR ファイルからクライアントサイドの JAR ファイルが展開されたら、weblogic.j2eeclient.Main ユーティリティを使用してクライアントサイド アプリケーションをブートストラップし、次のように WebLogic Server インスタンスを示すようにします。
以前のバージョンの WebLogic を使用していた場合は、weblogic.properties ファイルを変換する必要があります。変換スクリプトを使用してファイルを変換する手順については、Administration Console オンライン ヘルプの「変換」を参照してください。
der2pem ユーティリティを使用すると、X509 証明書を DER 形式から PEM 形式に変換できます。.pem ファイルは、変換元の .der ファイルと同じディレクトリに書き込まれます。
$ java utils.der2pem derFile [headerFile] [footerFile]
$ java utils.der2pem graceland_org.der
Decoding
................................................................
dbping コマンドライン ユーティリティを使用すると、JDBC ドライバを使用した DBMS とクライアント マシンの間の接続をテストできます。このユーティリティを使用する前に、ドライバをインストールしておく必要があります。ドライバのインストール方法の詳細については、「WebLogic jDrivers」を参照してください。
$ java -Dbea.home=license_location utils.dbping DBMS user password DB
$ C:¥bea¥weblogic700b¥samples¥server¥config¥examples>java utils.dbping ORACLE_THIN scott tiger lcdbsol1:1561:lcs901
**** 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");
java.sql.Driver d = (java.sql.Driver)Class.forName("oracle.jdbc.driver.OracleD
river").newInstance();
java.sql.Connection conn = d.connect("jdbc:oracle:thin:@lcdbsol1:1561:lcs901",
props);
// 特にサーバサイド クラスでは、こちらのモードの方が適している。これは、
// DriverManager 呼び出しでクラスの同期を回避できるためである。ただし、
// 接続済みの状態でも、サーバ内の他の JDBC ドライバのボトルネックになる
// 可能性がある。これは、すべての JDBC ドライバが DriverManager.println() を使用して、
// 情報および例外のログを記録し、その呼び出しでもクラスの同期が取られるためである
// 接続を繰り返す場合、1 つのドライバ インスタンスを再利用できる
**** or ****
Class.forName("oracle.jdbc.driver.OracleDriver").newInstance();
java.sql.Connection conn =
Driver.connect("jdbc:oracle:thin:@lcdbsol1:1561:lcs901", "scott", "tiger");
**** or ****
java.util.Properties props = new java.util.Properties();
props.put("user", "scott");
props.put("password", "tiger");
Class.forName("oracle.jdbc.driver.OracleDriver").newInstance();
java.sql.Connection conn =
Driver.connect("jdbc:oracle:thin:@lcdbsol1:1561:lcs901", props);
weblogic.Deployer は、J2EE アプリケーションおよびコンポーネントを WebLogic Server にデプロイします。詳細については、「デプロイメント ツールおよび手順」を参照してください。
weblogic.Deployer ユーティリティは、WebLogic Server 7.0 で新たに導入され、非推奨になっている従来の weblogic.deploy ユーティリティに代わるものです。非推奨の weblogic.deploy ユーティリティの詳細については、『管理者ガイド』の「アプリケーションのデプロイメント」を参照してください。
% java weblogic.Deployer [options] [-activate|-deactivate|-remove|-cancel|-list] [files]
以下に、weblogic.Deployer コマンドの例を示します。
java weblogic.Deployer -adminurl http://admin:7001 -name app -source /myapp/app.ear -targets server1,server2 -activate
java weblogic.Deployer -adminurl http://admin:7001 -name app -activate
java weblogic.Deployer -adminurl http://admin:7001 -name appname -targets server1,server2 -activate jsps/*.jsp
java weblogic.Deployer -adminurl http://admin:7001 -name app -targets server1 -deactivate
java weblogic.Deployer -adminurl http://admin:7001 -name app -targets server -remove -id tag
java weblogic.Deployer -adminurl http://admin:7001 -cancel -id tag
java weblogic.Deployer -adminurl http://admin:7001 -list
EJBGen は、エンタープライズ JavaBean 2.0 コード ジェネレータです。Bean クラス ファイルに javadoc タグでコメントを記述して、EJBGen でリモート クラスとホーム クラス、および EJB アプリケーションのデプロイメント記述子ファイルを生成することができます。これにより、編集および管理する必要のある EJB ファイルを 1 つに減らすことができます。
BEA WebLogic 7.0 のサンプルをインストールしている場合、EJBGen を使用したサンプル アプリケーションについては、SAMPLES_HOME¥server¥src¥examples¥ejb20¥ejbgen¥ を参照してください。
このツールの完全なマニュアルについては、「WebLogic Server EJB のユーティリティ」の「EJBGen」を参照してください。
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:¥
ImportPrivateKey ユーティリティを使用すると、プライベート キーストア ファイルにプライベート キーをロードできます。
$ java utils.ImportPrivateKey keystore keystorepass alias keypass certfile keyfile
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
................................................................
D:¥bea2¥weblogic700¥samples¥server¥src>java utils.der2pem CertGenCA.der
Encoding
................................................................
................................................................
D:¥bea2¥weblogic700¥samples¥server¥src>type testcert.pem CertGenCA.pem >> newcerts.pem
D:¥bea2¥weblogic700¥samples¥server¥src>java utils.ImportPrivateKey mykeystore mypasswd mykey mykeypass newcerts.pem testkey.pem
Keystore file not found, creating it
logToZip ユーティリティは、HTTP サーバ ログ ファイルの内容 (共通ログ形式) を検索し、その中でサーバによってロードされる Java クラスを検出してから、それらの Java クラスを含む非圧縮の .zip ファイルを作成します。このユーティリティは、HTTP サーバのドキュメント ルート ディレクトリから実行します。
このユーティリティを使用するには、HTTP サーバによって作成されたログ ファイルへのアクセスが必要です。
$ java utils.logToZip logfile codebase zipfile
次の例に、ドキュメント ルート自体に存在するアプレット用の .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
MulticastTest ユーティリティは、WebLogic クラスタのコンフィグレーション時にマルチキャストに関する問題をデバッグする場合に便利です。このユーティリティは、マルチキャスト パケットを送信し、ネットワーク上で、マルチキャストがどのくらい効果的に機能しているかについての情報を返します。特に、MulticastTest は標準出力を通して以下のタイプの情報を表示します。
MulticastTest を使用するには、まず、マルチキャスト トラフィックのテストを行う各ノードにこのユーティリティをコピーします。
警告: 現在実行している WebLogic クラスタのアドレスと同じマルチキャスト アドレス (-a パラメータ) を指定して MulticastTest ユーティリティを実行しないでください。このユーティリティは、クラスタ化された WebLogic Server を起動する前に、マルチキャストが正しく機能することを確認することを目的にしています。
マルチキャストの設定に関する情報については、WebLogic Server ホストの特定のオペレーティング システムまたはハードウェアのコンフィグレーションに関するドキュメントを参照してください。クラスタの詳細については、『WebLogic Server クラスタ ユーザーズ ガイド』を参照してください。
$ java utils.MulticastTest -n name -a address [-p portnumber]
[-t timeout] [-s send]
$ 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 ユーティリティを使用すると、ホストの IP アドレスを取得できます。
$ java utils.myip
$ java utils.myip
Host toyboat.toybox.com is assigned IP address: 192.0.0.1
pem2der ユーティリティを使用すると、X509 証明書を PEM 形式から DER 形式に変換できます。.der ファイルは、変換元の .pem ファイルと同じディレクトリに書き込まれます。
$ java utils.pem2der pemFile
$ java utils.pem2der graceland_org.pem
Decoding
................................................................
................................................................
................................................................
................................................................
................................................................
Schema ユーティリティを使用すると、WebLogic JDBC ドライバを使用してデータベースに SQL 文をアップロードできます。データベース接続の詳細については、『WebLogic JDBC プログラマーズ ガイド』を参照してください。
$ java utils.Schema driverURL driverClass [-u username]
[-p password] [-verbose] SQLfile
次のコードでは、examples.utils パッケージの Schema コマンドラインを示します。
D:¥bea¥weblogic700¥samples¥server¥src>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
showLicenses ユーティリティを使用すると、このマシンにインストールされている BEA 製品に関するライセンス情報を表示できます。
$ java -Dbea.home=license_location utils.showLicenses
$ java -Dbea.home=d:¥bea utils.showLicense
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
verboseToZip ユーティリティは、HTTP サーバのドキュメント ルート ディレクトリから実行されると、verbose モードで実行されている Java アプリケーションから標準出力を取得し、参照されている Java クラスを検出してから、それらの Java クラスを含む非圧縮の .zip ファイルを作成します。
$ java utils.verboseToZip inputFile zipFileToCreate
$ java -verbose myapplication > & classList.tmp
$ java utils.verboseToZip classList.tmp app2.zip
$ java -verbose myapplication > classList.tmp
$ java utils.verboseToZip classList.tmp app3.zip
version ユーティリティは、インストールされている WebLogic に関する情報を stdout を介して表示します。
$ java weblogic.Admin -url host:port -username username -password password VERSION
$ java weblogic.Admin
-url localhost:7001 -username system -password foo VERSION
writeLicense ユーティリティを使用すると、WebLogic ライセンスすべてに関する情報を、カレント ディレクトリにある writeLicense.txt というファイルに書き込むことができます。このファイルは、たとえば WebLogic のテクニカル サポートなどへ電子メールで送信できます。
$ java utils.writeLicense -nowrite -Dweblogic.system.home=path
$ java utils.writeLicense -nowrite
* * * * * * 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
...
* * * * * * * 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
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |