|
|
|
|
|
|
| | | |
WebLogic には、インストールおよびコンフィグレーション タスクを簡素化したり、サービスを提供したり、便利なショートカットを提供したりする Java プログラムが用意されています。以下の節では、WebLogic Server に用意されている各 Java ユーティリティについて説明します。ここでは、すべてのユーティリティのコマンドライン構文を示し、一部のユーティリティについては使用例を紹介します。
これらのユーティリティを使用するには、CLASSPATH を正しく設定する必要があります。詳細については、「クラスパス オプションの設定」を参照してください。
AppletArchiver
AppletArchiver ユーティリティは、別のフレームにあるアプレットを実行し、ダウンロードされたクラスと、そのアプレットによって使用されたリソースの記録をすべて保持し、.jar ファイルまたは .cab ファイルにパッケージ化します（cabarc ユーティリティは、Microsoft から入手できます）。
$ java utils.applet.archiver.AppletArchiver
URLfilename
|
引数 |
定義 |
|---|---|
|
|
アプレットの URL |
|
|
|
以前のバージョンの WebLogic を使用していた場合は、weblogic.properties ファイルを変換する必要があります。変換スクリプトを使用してファイルを変換する手順については、Administration Console オンライン ヘルプの「変換」を参照してください。
ClientDeployer
weblogic.ClientDeployer は、J2EE の EAR ファイルからクライアントサイドの JAR ファイルを抽出し、デプロイ可能な JAR ファイルを作成します。weblogic.ClientDeployer クラスは、次の構文を使って Java コマンドライン上で実行します。
java weblogic.ClientDeployer
ear-fileclient
ear-file 引数は、クライアント アプリケーションの JAR ファイルを 1 つ以上含む展開ディレクトリ (つまり拡張子が .ear の Java アーカイブ ファイル) です。
例:
java weblogic.ClientDeployer app.ear myclient
app.ear は、myclient.jar にパッケージ化する J2EE クライアントを含む EAR ファイルです。
weblogic.j2eeclient.Main ユーティリティを使ってクライアントサイド アプリケーションをブートストラップ化し、WebLogic Server インスタンスを指すようにします。
java weblogic.j2eeclient.Main clientjar URL [application args]
例:
java weblogic.j2eeclient.Main helloWorld.jar t3://localhost:7001 Greetings
der2pem
der2pem ユーティリティを使用すると、X509 証明書を DER 形式から PEM 形式に変換できます。.pem ファイルは、変換元の .der ファイルと同じディレクトリに書き込まれます。
$ java utils.
der2pemderFile[headerFile][footerFile]
$ java utils.
der2pemgraceland_org.der
Decoding
................................................................
dbping
dbping コマンドライン ユーティリティを使用すると、JDBC ドライバを使用した DBMS とクライアント マシンの間の接続をテストできます。このユーティリティを使用する前に、ドライバをインストールしておく必要があります。
$ java
-Dbea.home=WebLogicHomeutils.dbpingDBMSuserpasswordDB
deploy ユーティリティは、アーカイブ（.jar、.war、または .ear）ファイルから J2EE アプリケーションを取得し、その J2EE アプリケーションを実行中の WebLogic Server にデプロイします。詳細については、『Web アプリケーションのアセンブルとコンフィグレーション』および『WebLogic Server アプリケーションの開発』を参照してください。
$ java weblogic.deploy [
options] [action]passwordname {application} {
namesource}
|
オプション |
定義 |
|---|---|
|
|
さまざまな対象にデプロイされるコンポーネント。
（このコマンドは 1 行で入力する。） コンポーネントが展開ディレクトリ形式の場合、アーカイブ ファイルの代わりにそれぞれのディレクトリ名を使用する。 |
|
|
デプロイメント処理中、詳細なデバッグ情報を |
|
|
deploy ユーティリティで使用できるすべてのオプションのリストを出力する。 |
|
|
J2EE アプリケーション（ |
|
|
更新されたファイルがコピーされる webapp コンポーネントを指定する。このオプションを |
|
|
静的なファイル（JSP など）、HTML ファイル、画像ファイル（ |
|
|
J2EE アプリケーション（ 注意: |
|
|
Weblogic Server の URL を指定する。デフォルトは |
|
|
接続が行われるユーザの名前。デフォルトは |
|
|
deploy ユーティリティのバージョンを出力する。 |
deploy ユーティリティは、以下のようなさまざまな目的に役立ちます。
デプロイされた J2EE アプリケーションの表示
ローカル WebLogic Server にデプロイされたアプリケーションを表示するには、次のコマンドを入力します。
% java weblogic.deploy list
password
ここで password は、WebLogic Server システム アカウント用のパスワードです。
リモート サーバにデプロイされたアプリケーションを一覧表示するには、次のように、port オプションと host オプションを指定します。
% java weblogic.deploy -port
port_number-hosthost_namelistpassword
新しい J2EE アプリケーションのデプロイ
まだ WebLogic にデプロイされていない J2EE アプリケーション（.jar、.war、または .ear）ファイルまたはアプリケーション ディレクトリをデプロイするには、次のコマンドを使用します。
% java weblogic.deploy -port
port_number-hosthost_namedeploypasswordapplicationsource
値は以下のとおりです。
application は、このアプリケーションに割り当てる文字列
source は、デプロイする J2EE アプリケーション ファイル（.jar、.war、.ear）のフルパス名か、アプリケーション ディレクトリのフルパス名
次に例を示します。
% java weblogic.deploy -port 7001 -host localhost deploy weblogicpwd Basic_example
c:\mysamples\ejb\basic\BasicStatefulTraderBean.jar
注意: 管理サーバのアプリケーション ディレクトリにコピーする J2EE アプリケーション ファイル（.jar、.war、.ear）は、アプリケーションの名前を使ってリネームされます。このため、前述の例では、アプリケーション アーカイブ ディレクトリ . . .\config\mydomain\applications の名前は、BasicStatefulTraderBean.jar から Basic_example.jar に変更されます。
デプロイされた J2EE アプリケーションの削除
デプロイされた J2EE アプリケーションを削除するには、割り当てられたアプリケーション名の参照のみが必要です。次の例のように入力します。
% java weblogic.deploy -port 7001 -host localhost undeploy
weblogicpwd Basic_example
注意: J2EE アプリケーションを削除しても、アプリケーションは WebLogic Server から削除されません。deploy ユーティリティでそのアプリケーション名を再使用することはできません。次の項で説明するように、update 引数を使用してデプロイメントを更新する場合は、そのアプリケーション名を再使用できます。
デプロイされた J2EE アプリケーションの更新
J2EE アプリケーションを更新するには、次のように、update 引数を使用して、アクティブな J2EE アプリケーションの名前を指定します。
% java weblogic.deploy -port 7001 -host localhost update
weblogicpwd Basic_example
c:\updatesample\ejb\basic\BasicStatefulTraderBean.jar
特定のコンポーネントを更新する場合は、以下のコマンドを入力します。
% java weblogic.deploy -port 7001 -host localhost -component
Basic_example:sampleserver,exampleserver update
weblogicpwd Basic_example
c:\updatesample\ejb\basic\BasicStatefulTraderBean.jar
update を指定すると、アプリケーションまたはコンポーネントは、対象になっているすべてのサーバ インスタンスで更新されます。
updateを参照してください。
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:\
logToZip ユーティリティは、HTTP サーバ ログ ファイルの内容（共通ログ形式）を検索し、その中でサーバによってロードされる Java クラスを検出してから、それらの Java クラスを含む非圧縮の .zip ファイルを作成します。このユーティリティは、HTTP サーバのドキュメント ルート ディレクトリから実行します。
このユーティリティを使用するには、HTTP サーバによって作成されたログ ファイルへのアクセスが必要です。
$ java utils.
logToZiplogfilecodebasezipfile
次の例に、ドキュメント ルート自体に存在するアプレット用の .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 Cluster のコンフィグレーション時にマルチキャストに関する問題をデバッグする場合に便利です。このユーティリティは、マルチキャスト パケットを送信し、ネットワーク上で、マルチキャストがどのくらい効果的に機能してるかについての情報を返します。特に、MulticastTest は標準出力を通して以下のタイプの情報を表示します。
MulticastTest を使用するには、まず、マルチキャスト トラフィックのテストを行う各ノードにこのユーティリティをコピーします。
警告: 現在実行している WebLogic Cluster のアドレスと同じマルチキャスト アドレス（-a パラメータ）を指定して MulticastTest ユーティリティを実行しないでください。このユーティリティは、クラスタ化された WebLogic Server を起動する前に、マルチキャストが正しく機能することを確認することを目的にしています。
マルチキャストの設定に関する情報については、WebLogic Server ホストの特定のオペレーティング システムまたはハードウェアのコンフィグレーションに関するドキュメントを参照してください。クラスタの詳細については、『WebLogic Server Clusters ユーザーズ ガイド』を参照してください。
$ java utils.MulticastTest -n
name-aaddress[-pportnumber]
[-ttimeout] [-ssend]
$ 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.
myipHost toyboat.toybox.com is assigned IP address: 192.0.0.1
pem2der ユーティリティを使用すると、X509 証明書を PEM 形式から DER 形式に変換できます。.der ファイルは、変換元の .pem ファイルと同じディレクトリに書き込まれます。
$ java utils.
pem2derpemFile
|
引数 |
説明 |
|---|---|
|
|
変換するファイルの名前。ファイル名は |
$ java utils.
pem2dergraceland_org.pem
Decoding
................................................................
................................................................
................................................................
................................................................
................................................................
Schema ユーティリティを使用すると、WebLogic JDBC ドライバを使用してデータベースに SQL 文をアップロードできます。データベース接続の詳細については、『WebLogic JDBC プログラミング ガイド』を参照してください。
$ java utils.
SchemadriverURLdriverClass[-uusername]
[-ppassword] [-verboseSQLfile]
次のコードは、Schema コマンド ラインのサンプルです。
$ java utils.
Schema"jdbc:cloudscape:demo;create=true"
COM.cloudscape.core.JDBCDriver
-verbose examples/utils/ddl/demo.ddl
次のコードは、.ddl ファイルのサンプルです。
DROP TABLE ejbAccounts;
CREATE TABLE ejbAccounts
(id varchar(15),
bal float,
type varchar(15));
DROP TABLE idGenerator;
CREATE TABLE idGenerator
(tablename varchar(32),
maxkey int);
showLicenses ユーティリティを使用すると、このマシンにインストールされている BEA 製品に関するライセンス情報を表示できます。
構文
$ java -Dbea.home=license_location utils.
showLicenses
引数
定義
license_location
license.beaファイルが存在するディレクトリの完全修飾名
$ 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
t3dbping ユーティリティを使用すると、任意の 2 層 JDBC ドライバを使用した、DBMS への WebLogic JDBC 接続をテストできます。このユーティリティを使用するには、WebLogic Server と DBMS へのアクセスが必要です。
$ java utils.
t3dbpingWebLogicURL username password DBMS driverClass driverURL
|
引数 |
定義 |
|---|---|
|
|
必須。WebLogic Server の URL。 |
|
|
必須。有効な DBMS ユーザ名。 |
|
|
必須。有効な DBMS パスワード。 |
|
|
必須。データベース名。 |
|
|
必須。WebLogic 2 層ドライバの完全パッケージ名。 |
|
|
必須。WebLogic 2 層ドライバの URL。 |
verboseToZip ユーティリティは、HTTP サーバのドキュメント ルート ディレクトリから実行されると、verbose モードで実行されている Java アプリケーションから標準出力を取得し、参照されている Java クラスを検出してから、それらの Java クラスを含む非圧縮の .zip ファイルを作成します。
$ java utils.
verboseToZipinputFile zipFileToCreate
|
引数 |
定義 |
|---|---|
|
|
必須。verbose モードで実行されているアプリケーションの出力が含まれる一時ファイル。 |
|
|
必須。作成する |
$ java -verbose myapplication > & classList.tmp
$ java utils.verboseToZipclassList.tmp app2.zip
$ java -verbose myapplication > classList.tmp
$ java utils.verboseToZipclassList.tmp app3.zip
version ユーティリティは、インストールされている WebLogic に関する情報を stdout を介して表示します。
$ java weblogic.Admin -url host:port -username username -password password VERSION
$ java weblogic.Admin
-url localhost:7001 -usernamesystem-passwordfoo VERSION
writeLicense ユーティリティを使用すると、WebLogic ライセンスすべてに関する情報を、カレント ディレクトリにある writeLicense.txt というファイルに書き込むことができます。このファイルは、たとえば WebLogic のテクニカル サポートなどへ電子メールで送信できます。
$ java utils.
writeLicense-nowrite -Dbea.home=path
|
引数 |
定義 |
|---|---|
|
|
必須。 |
|
|
必須。WebLogic システム ホーム（インストールされている WebLogic のルート ディレクトリ）を設定する。 注意: この引数は、WebLogic システム ホームから |
$ 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
|
|
|