WebLogic Server コマンド リファレンス
weblogic.Server クラスは、WebLogic Server インスタンスのメイン クラスです。Java コマンドで weblogic.Server を呼び出すことで、サーバ インスタンスを起動します。クラスは、コマンド プロンプト (シェル) で直接呼び出すことも、スクリプトまたはノード マネージャから間接的に呼び出すこともできます。
weblogic.Server を呼び出すための構文を示します。
weblogic.Server コマンドの環境を設定するには、次の手順に従います。
CLASSPATH 環境変数に追加します。 PATH 環境変数に JVM を追加しない場合は、JVM が提供する Java 実行可能ファイルのパス名を指定する必要があります。
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 環境変数の先頭に追加します。setDomainEnv.cmd/sh スクリプトを編集し、そのパッチを PRE_CLASSPATH 環境変数の先頭に追加します。
WL_HOME/common/eval/pointbase/lib/
pbserver44.jar および pbclient44.jar
WL_HOME/server/lib/wlepool.jar
WL_HOME/server/lib/wleorb.jar
weblogic.Server を呼び出すための構文は次のとおりです。
options] weblogic.Server [-help]
java weblogic.Server -help コマンドは、よく使用されるオプションのリストを返します。
java weblogic.Server を入力すると、WebLogic Server は次のように動作します。
config.xml というファイルを探します。
config.xml が存在する場合、WebLogic Server は次のように動作します。
./config.xml でサーバ インスタンスが 1 つだけ定義されている場合、そのサーバ インスタンスを起動します。
WL_HOME\samples\domains\medrec から java weblogic.Server を発行すると、WebLogic Server は MedRec サーバを起動します。
./config.xml で複数のサーバ インスタンスが定義されている場合、WebLogic Server は myserver という名前のサーバ コンフィグレーションを探します。サーバ コンフィグレーションが見つかった場合は、myserver インスタンスを起動します。
myserver というサーバが見つからない場合、WebLogic Server は weblogic.Server プロセスを終了してエラー メッセージを生成します。
config.xml ファイルがない場合、WebLogic Server はドメインとサーバ インスタンスを作成するかどうかを尋ねます。yes と回答すると、WebLogic Server は次のように動作します。
myserver という名前のサーバ コンフィグレーションを作成して、./config.xml ファイルにそのコンフィグレーションを格納します。
config.xml ファイルに保持されます。たとえば、-Dweblogic.ListenPort=8001 と指定すると、WebLogic Server は config.xml ファイルに 8001 を保存します。指定しないオプションについては、サーバ インスタンスはデフォルト値を使用します。
config.xml.booted ファイルも作成します。このファイルは、サーバが正常に起動した直後の状態の config.xml ファイルのコピーです。config.xml が破損した場合は、この config.xml.booted ファイルを使用してサーバを起動することができます。
DefaultAuthenticatorInit.ldift および SerializedSystemIni.dat ファイルに格納します。
boot.properties ファイルに格納します。これにより、以後サーバをインスタンス化するときにはログイン プロンプトが回避されます。詳細については、Administration Console オンライン ヘルプの「起動 ID ファイル」を参照してください。
startmydomain.cmd および startmydomain.sh を作成します。テキスト エディタを使用して、サーバをプロダクション モードと開発モードのどちらで起動するかなどの起動オプションを変更することができます。startmydomain スクリプトには、各オプションを説明するコメントが含まれています。
weblogic.Server オプションを使用して、サーバ インスタンスの以下の属性をコンフィグレーションできます。
config.xml ファイルに保持されている値は変更されません。config.xml ファイルを変更するには、Administration Console または weblogic.Admin コマンドを使用します。
|
|
|
|
-Xms および -Xmx
|
java -Xms200m オプションおよび -Xmx200m オプションを使用してサーバを起動できる。
|
|
-classpath
|
CLASSPATH 環境変数を使用してクラスパスを指定できる。
|
|
-client
-server
|
|
|
|
|
|
-Dbea.home=bea_home
|
weblogic.Server はクラスパス内の値に基づいて BEA ホーム ディレクトリの場所を判別する。
|
|
-Dweblogic.RootDirectory=path
|
|
|
-Dweblogic.ConfigFile=
file_name
|
file_name 値は、『コンフィグレーション リファレンス』で定義されたスキーマに準拠する有効な XML ファイルでなければならない。
-Dweblogic.RootDirectory で指定したディレクトリ。
file_name 値にはパス名を指定できない。たとえば、次の値は無効となる。
-Dweblogic.ConfigFile=c:\mydir\myfile.xml
-Dweblogic.RootDirectory=c:\mydir
-Dweblogic.ConfigFile=myfile.xml
config.xml になる。
|
|
-Dweblogic.management.GenerateDefaultConfig=true
|
config.xml ファイルの作成時に weblogic.Server クラスが確認を求めないようにする。
weblogic.Server を空のディレクトリで呼び出した場合にだけ有効。「デフォルト動作」を参照。
|
|
-Dweblogic.Domain=domain
|
weblogic.Server を使用してドメインを作成する場合、このオプションを使用するとドメインに特定の名前を指定できる。
/config/domain/config.xml
domain はドメインの名前。
config/domain 以外のディレクトリから weblogic.Server コマンドを呼び出す場合、-Dweblogic.Domain=domain 引数を指定すると、WebLogic Server は config/domain/config.xml に一致するパス内で config.xml ファイルを探す。
|
-Dweblogic.management.server エントリを参照してください。
config.xml ファイルの名前が SimpleDomain.xml になり、c:\my_domains\SimpleDomain というディレクトリに格納されています。コマンドは WL_HOME\server\bin\setWLSEnv.cmd の実行後に D:\ ディレクトリから発行されます。WL_HOME は WebLogic Server のインストール ディレクトリです。
D:\> java -Dweblogic.Name=SimpleServer -Dweblogic.ConfigFile=SimpleDomain.xml -Dweblogic.RootDirectory=c:\my_domains\SimpleDomain weblogic.Server
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
|
|
|
|
-Dweblogic.management.server=
[protocol://]Admin-host:port
|
-Dweblogic.management.server オプションを省略した場合、サーバは管理サーバとして起動される (ただし、特定のドメイン内でアクティブな管理サーバ インスタンスは 1 つのみ)。管理サーバを実行したら、他のすべてのサーバ コンフィグレーションは、起動コマンドに -Dweblogic.management.server オプションを指定して、管理対象サーバとして起動する必要がある。
protocol には、HTTP、HTTPS、T3、または T3S を指定する。T3S および HTTPS プロトコルの場合は、管理対象サーバと管理サーバで SSL を有効にして、管理サーバの SSL リスン ポートを指定する必要がある。
Admin-host には、localhost または管理サーバが動作するマシンの DNS 名または IP アドレスを指定する。
port には、管理サーバのリスン ポートを指定する。ドメインサイドに管理ポートを設定する場合は、port にドメイン全体の管理ポートを指定する必要がある。
|
|
-Dweblogic.ListenAddress=host
|
host の値は、サーバ インスタンスをホストするコンピュータの DNS 名または IP アドレスのいずれかでなければならない。
config.xml ファイルで指定されたリスン アドレス値をオーバーライドする。オーバーライドは現在のサーバのインスタンス化に適用され、config.xml ファイルの値は変更されない。config.xml ファイルを変更するには、Administration Console または weblogic.Admin コマンドを使用する。
|
|
-Dweblogic.ListenPort=
portnumber
|
config.xml ファイルで指定されたリスン ポート値をオーバーライドする。オーバーライドは現在のサーバのインスタンス化に適用され、config.xml ファイルの値は変更されない。config.xml ファイルを変更するには、Administration Console または weblogic.Admin コマンドを使用する。
|
|
-Dweblogic.ssl.ListenPort=
portnumber
|
config.xml ファイルで指定された SSL リスン ポート値をオーバーライドする。オーバーライドは現在のサーバのインスタンス化に適用され、config.xml ファイルの値は変更されない。config.xml ファイルを変更するには、Administration Console または weblogic.Admin コマンドを使用する。
|
|
-Dweblogic.management.
discover={true | false}
|
true 値の場合、管理サーバはすべての管理対象サーバと通信し、管理サーバが動作していることを通知する。
false 値の場合、管理サーバは、ドメインで現在アクティブな管理対象サーバと通信できない。
false の値は、単一サーバの開発環境でのみ指定すること。false を指定すると、ドメイン内のサーバ インスタンスが持つデプロイ済みモジュールのセットに整合性がなくなる可能性がある。
|
weblogic.management.security.SSLMBean のインスタンスを使用して、SSL コンフィグレーションを表現します。以下の表で、-Dweblogic.security.SSL で始まるすべてのオプションは、サーバの SSLMBean のコンフィグレーションを変更します。たとえば、-Dweblogic.security.SSL.ignoreHostnameVerification オプションでは、SSLMBean の ignoreHostnameVerification 属性の値を設定します。
|
|
|
|
-Dweblogic.security.SSL.
ignoreHostnameVerification=
true
|
config.xml ファイル内のサーバのコンフィグレーションを変更することで、ホスト名検証を無効にすると、サーバ インスタンスは SSL クライアントである場合にホスト名を検証しない。
config.xml ファイルで設定されたホスト名検証をオーバーライドする。オーバーライドは現在のサーバのインスタンス化に適用され、config.xml ファイルの値は変更されない。config.xml ファイルを変更するには、Administration Console または weblogic.Admin コマンドを使用する。
|
|
-Dweblogic.security.SSL.
HostnameVerifier=
hostnameverifierimplmentation
|
weblogic.security.SSL.HostnameVerifier インタフェースを実装する必要がある。
|
|
-Dweblogic.security.SSL.
sessionCache.ttl=
sessionCacheTimeToLive
|
sessionCacheTimeToLive 値で、SSL セッションの存続時間 (単位 : ミリ秒) を指定する。デフォルト値は 90000 ミリ秒 (90 秒)。つまり、サーバに対してクライアントが 90 秒以内に (同じセッション ID で) 再びアクセスすると、既存の SSL セッションが使用されることになる。この値は、サーバの起動スクリプト内の -Dweblogic.security.SSL.sessionCache.ttl の設定によって変更可能。
sessionCache.ttl の場合、
|
|
-Dweblogic.management.
pkpassword=pkpassword
|
|
|
-Dweblogic.security.SSL.
trustedCAKeyStore=path
|
path の値は、Sun JKS キーストア ファイル (キーおよび証明書のリポジトリを格納) への相対パス名または絶対パス名でなければならない。
JAVA_HOME\jre\lib\security\cacerts で指定されているすべての証明書を信頼する。
|
SSLMBean および ServerMBean の「WebLogic Server Javadoc」を参照してください。Javadoc では、各属性の有効な値も示されています。 SSLMBean および ServerMBean がセッター メソッドとして公開している各属性は、起動オプションで設定できます。
SSLMBean に属性を設定するには、起動コマンドに次のオプションを追加します。
-Dweblogic.ssl.attribute-name=value attribute-name は、MBean のセッター メソッドの名前から set プレフィックスを除いたものです。
ServerMBean に属性を設定するには、起動コマンドに次のオプションを追加します。
-Dweblogic.server.attribute-name=value attribute-name は、MBean のセッター メソッドの名前から set プレフィックスを除いたものです。
SSLMBean は次のセッター メソッドでその Enabled 属性を公開します。
setEnabled()
-Dweblogic.ssl.Enabled=true weblogic.Server
|
|
|
|
-Dweblogic.management.
username=username
|
|
|
-Dweblogic.management.
password=password
|
|
|
-Dweblogic.system.
StoreBootIdentity=true
|
boot.properties ファイルを作成する。このファイルには、サーバの起動に使用したユーザ名とパスワードの暗号化バージョンが格納される。
ServerStartMBean で指定しないこと (Administration Console の [リモート スタート] タブ)。Administration Console オンライン ヘルプの「ノード マネージャを使用してサーバを起動するときのユーザ資格の指定」を参照。
boot.properties ファイルを作成する場合にのみ使用すること。
|
|
-Dweblogic.system.
BootIdentityFile=filename
|
filename の値は、有効な起動 ID ファイルの絶対パス名でなければならない。例 :
-Dweblogic.system.BootIdentityFile=C:\BEA\
wlserver8.1\user_config\mydomain\myidentity.prop
weblogic.Admin SHUTDOWN および FORCESHUTDOWN コマンドは、サーバのルート ディレクトリにある boot.properties ファイルを使用する。
|
|
-Dweblogic.system.
RemoveBootIdentity=true
|
|
|
-Dweblogic.security.anonymous
UserName=name
|
<anonymous> という文字列で識別される。
name の値に guest を指定して、セキュリティ レルムに guest という名前のユーザを作成する。
|
|
-Djava.security.manager
-Djava.security.policy[=]=
filename
|
WL_HOME\server\lib\weblogic.policy を指定する。
-Djava.security.policy==filename を使用すると、ポリシー ファイルはデフォルトのセキュリティ ポリシーをオーバーライドする。単一の等号記号 (=) を使用すると、ポリシー ファイルは既存のセキュリティ ポリシーに付加される。
|
|
-Dweblogic.security.
fullyDelegateAuthorization=true
|
<unchecked> タグまたは <restricted> タグを使用する EJB または EJB メソッド、または <auth-constraint> タグに role-name が指定されていない Web アプリケーションでは機能しない。
|
|
-Dweblogic.management.
anonymousAdminLookupEnabled=true
|
MBeanHome インタフェースを取得できるようにする。MBeanHome インタフェースは WebLogic Server JMX API の一部。
MBeanHome を取得すると、インタフェースは、WebLogic Server MBean の認可プロセスで保護されるように明示的にマークされていない MBean 属性の値に対する読み込み専用アクセスをユーザに付与する。
MBeanHome API は、デフォルトのセキュリティ ロールのいずれかを持つ WebLogic ユーザに対してのみ MBean へのアクセスを許可する。詳細については、『WebLogic リソースのセキュリティ』の「セキュリティ ロール」を参照。
|
|
-Dweblogic.security.
identityAssertionTTL=seconds
|
<run-as> タグを使用したサーブレットと EJB メソッドのパフォーマンスと、ID アサーションが使用されるがキャッシュされないその他の場所のパフォーマンス (XML ドキュメントの署名と暗号化など) が大幅に向上する。このキャッシングにより、目的のセマンティクスに違反する場合もある。
0 に設定するとキャッシュを無効化できる。
|
|
-Dweblogic.security.
audit.auditLogDir
|
DefaultAuditRecorder.log ファイルの新しいディレクトリを指定する。
WL_HOME\yourdomain\yourserver\DefaultAuditRecorder.log に保存される。
|
|
maxSize=<max bytes>
|
|
|
changeLogThreshold=<number of entries>
|
|
|
|
|
|
-Dweblogic.Stdout="filename"
|
|
|
-Dweblogic.Stderr="filename"
|
|
|
-Dweblogic.domain.ConfigurationAuditType=
{ none|log|audit|logaudit }
|
|
weblogic.management.configuration.LogMBean のインスタンスを使用して、ロギング サービスのコンフィグレーションを表現します。
LogMBean 属性の値を設定するには、次の手順に従います。
LogMBean がセッター メソッドとして公開している各属性は、起動オプションで設定できます。
-Dweblogic.log.attribute-name=value attribute-name は、MBean のセッター メソッドの名前から set プレフィックスを除いたものです。
LogMBean は次のセッター メソッドでその FileName 属性を公開します。
setFileName()
-Dweblogic.log.FileName="C:\logfiles\myServer.log"
weblogic.Server
|
|
|
|
-Dweblogic.Name=
servername
|
config.xml ファイルで定義されているサーバの名前を参照していなければならない。
|
|
-Dweblogic.ProductionModeEnabled=
{true | false}
|
true を指定すると、WebLogic Server は domain_name/applications ディレクトリにあるアプリケーションを自動的にデプロイおよび更新できなくなる。
false と見なされる。
|
|
-Dweblogic.management.
startupMode=STANDBY
|
STANDBY) 状態にする。この起動引数を使用するには、ドメイン全体の管理ポートを使用するようにドメインをコンフィグレーションする必要がある。
config.xml ファイルの起動モード設定をオーバーライドする。オーバーライドは現在のサーバのインスタンス化に適用され、config.xml ファイルの値は変更されない。config.xml ファイルを変更するには、Administration Console または weblogic.Admin コマンドを使用する。
config.xml のいずれかで、この値を指定しない場合、デフォルトでは実行中 (RUNNING) 状態で起動される。
|
|
-Dweblogic.apache.xerces.
maxentityrefs=numerical-value
|
|
|
-Dweblogic.jsp.windows.caseSensitive=true
|
|
|
-Dweblogic.net.http.
URLStreamHandlerFactory=
classname
|
java.net.URLStreamHandlerFactory インタフェースを実装するクラスを記述する。インタフェースで指定された createURLStreamHandler("http") メソッドを実装する他に、このクラスには、クラスのインスタンスを引数に指定して java.net.URL.setURLStreamHandlerFactory() を呼び出す main() メソッドも必要。このシステム プロパティをこのクラスの名前に設定する。詳細については、java.net.URL.URLStreamHandlerFactory インタフェースの Javadoc を参照。
|
|
-Dweblogic.servlet.optimisticSerialization=true
|
optimistic-serialization が有効になっている場合、リクエストがサーブレット コンテキストを超えてディスパッチされるときに getAttribute(name) のコンテキストとリクエスト属性がシリアライズおよびデシリアライズされない。
optimistic-serialization がオフ (デフォルト値) になっている場合、WebLogic Server は ClassCastException の発生を回避するために getAttribute(name) のコンテキストおよびリクエストの属性をシリアライズおよびデシリアライズする。
WebAppContainerMBean でドメイン レベルで指定することもできる。この値は、すべての Web アプリケーションに適用される。weblogic.xml に値を指定した場合、その値はドメイン レベルの値をオーバーライドする。
|
|
|
|
|
-Dweblogic.cluster.
multicastAddress
|
config.xml ファイルで定義されたマルチキャスト アドレスを参照する。このオプションを使用して config.xml の値をオーバーライドする。
|
WL_HOME\server\bin\setWLSEnv.cmd (Windows の場合)
WL_HOME/server/bin/setWLSEnv.sh (UNIX の場合) WL_HOME は WebLogic Server ソフトウェアのインストール ディレクトリです。
config.xml ファイルが格納されているディレクトリに移動します。たとえば、WL_HOME\samples\domains\medrec ディレクトリに移動します。
java -Dweblogic.Name=servername weblogic.Server servername は config.xml ファイルにすでに存在するサーバ コンフィグレーションの名前です。
java -Dweblogic.Name=MedRecServer weblogic.Server
config.xml ファイルで管理対象サーバをすでに定義している場合は、管理対象サーバを次のように起動できます。
java -Dweblogic.Name=managed-server-name
-Dweblogic.management.server=url-for-Administration-Server
weblogic.Server
java -Dweblogic.Name=MedRecManagedServer
-Dweblogic.management.server=localhost:7001
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 ファイルに保持される属性ではありません。
WL_HOME\server\bin\setWLSEnv.cmd (Windows の場合)
WL_HOME/server/bin/setWLSEnv.sh (UNIX の場合) WL_HOME は WebLogic Server ソフトウェアのインストール ディレクトリです。
java -Dweblogic.Domain=SimpleDomain -Dweblogic.Name=SimpleServer
-Dweblogic.management.username=weblogic
-Dweblogic.management.password=weblogic -Dweblogic.ListenPort=7701
weblogic.Server
config.xml ファイルを作成するかどうかをたずねてきます。y と入力すると、パスワードの確認を要求します。その後、SimpleDomain というドメインをインスタンス化します。ドメインの管理サーバは次のようにコンフィグレーションされます。
weblogic が 1 つ定義される (パスワードは weblogic)。localhost、ホスト コンピュータの IP アドレス、またはホスト コンピュータの DNS 名を使用できる。リスン アドレスの設定の詳細については、Administration Console オンライン ヘルプの「リスン アドレスのコンフィグレーション」を参照してください。
weblogic.Server コマンドを入力すると、次のファイルが作成されます。
config.xml DefaultAuthenticatorInit.ldift および SerializedSystemIni.dat。基本的なセキュリティ関連データを格納します。 boot.properties ファイル。暗号化された形式でユーザ名とパスワードを格納します。このファイルを使用すると、サーバ起動時のユーザ名とパスワードのプロンプトを回避できます。詳細については、Administration Console オンライン ヘルプの「起動 ID ファイル」を参照してください。startmydomain.cmd および startmydomain.sh。以後サーバのインスタンス化に使用できます。
weblogic.Admin ユーティリティを使用します。
java weblogic.Admin -url url-for-server-instance -username username -password password GET -type MBean-nameConfig -property attribute-name
MRMachine1:7041 はクラスタ メンバーのリスン アドレスとポートです。
java weblogic.Admin -url MRMachine1:7041 -username weblogic -password weblogic GET -pretty -type ClusterConfig -property MulticastAddress
java weblogic.Admin -url localhost:7001 -username weblogic -password weblogic GET -pretty -type ServerConfig -property StdoutSeverityLevel
weblogic.Admin ユーティリティの使用方法については、「weblogic.Admin コマンドライン リファレンス」を参照してください。
