この付録では、Oracle Web Services Manager(Oracle WSM)wsmadmin
コマンドの機能の概要を説明します。
必要な実行コンポーネントの登録
追加アプリケーションおよび実行コンポーネントのインストール
Oracle WSMをインストールしたら、トポロジの要件に応じたインストールの構成およびカスタマイズに、Oracle WSMコンフィギュレーション・アシスタントを使用する上で、この付録の情報を役立ててください。
WSMADMINコマンドの場所
wsmadminコマンドは、次のディレクトリから実行します。
ORACLE_HOME
\owsm\bin
wsmadmin startコマンドを使用したOracle WSMサーバーの起動
スタンドアロンのOracle WSMインストールの場合、Oracle WSMサーバーは、wsmadmin start
コマンドを使用して起動する必要があります。「start」を参照してください。
注意: バンドルされたアプリケーション・サーバーを単独で起動すると、Oracle WSMは動作しません。 |
Oracle WSMをOracle Application Server 10gリリース3(10.1.3.1.0)の一部としてインストールした場合、サーバーの起動の詳細は、『Oracle Application Server管理者ガイド』を参照してください。
次に示すのは、wsmadmin
コマンドの構文です。
wsmadmin
operation parameters
operation
の有効値は、次のとおりです。
コマンドには、大文字と小文字の区別があります。各操作については、後続の項で説明します。
この操作では、JARおよびJSPソース・ファイルを使用して、デプロイされるJ2EEアプリケーションWARまたはEARファイルを作成します。
構文
wsmadmin buildApps
使用方法
インストール済アプリケーションの値は、Oracle WSMインストール時にinstall.properties
ファイルに保存されています。buildApps
操作の実行後、deployApps
操作を実行する必要があります。アプリケーションを個人で作成し、デプロイする必要が生じる場合があります。たとえば、buildApps
操作とdeployApps
操作の間に、次の手動の作業が必要になる場合があります。
Oracle WSMアプリケーションのデプロイ前に、Oracle WSMアプリケーション・アーカイブのバージョニング
手動でデプロイするアプリケーション・アーカイブの準備
buildApps
操作でアプリケーションの作成が終了すると、deployApps
を使用して、標準設定でアプリケーション・アーカイブをデプロイします。
この操作では、install.properties
ファイルの値に基づいて新しいアプリケーションの構成ファイルを生成します。
構文
wsmadmin configApps
使用方法
buildApps
またはdeploy
を実行する前に、この操作を使用します。この操作を実行しても、JSSO対応アプリケーションに影響はありません。この操作を使用して、データベース・パスワード変更してから、アプリケーションを再デプロイできます。
この操作では、install.properties
ファイルから次のプロパティを読み取ります。
表B-1 configApps実行時に使用されるinstall.properties
属性名 | 説明 |
---|---|
|
アプリケーション・サーバーのタイプを |
|
HTTPホスト名を指定します。 |
|
HTTPポートを指定します。 |
|
アプリケーションをデプロイするコンテナの名前を指定します。 |
|
Oracle WSM Controlに対してシングルサインオンを有効にする場合にのみ、値を |
|
プロキシ・サーバーの名前。 |
|
プロキシ・サーバーのポート番号。 |
|
プロキシ・サーバーを使用して接続しないホストをリストにします。縦棒(|)で区切られたリストを作成でき、ワイルドカード一致にアスタリクス(*)を使用できます。 |
|
値を |
|
ドライバ・タイプを |
|
データベースがインストールされているマシン名、またはIPアドレスを指定します。 |
|
データベースのポート番号を指定します。 |
|
データベース・ユーザーIDを指定します。 |
|
データベースのパスワードを指定します。 |
|
SQL Server JDBC JARファイルの場所を指定します。 |
この操作を実行すると、既存のファイルが上書きされ、次のファイルが作成されます。
ORACLE_HOME
\owsm\bin\agent.properties
ORACLE_HOME
\owsm\bin\coresv.properties
ORACLE_HOME
\owsm\config\ccore\logging.xml
ORACLE_HOME
\owsm\config\ccore\logging.xml
ORACLE_HOME
\owsm\config\ccore\ui-config-installer.properties
ORACLE_HOME
\owsm\config\clientagent\clientagent-config-installer.properties
ORACLE_HOME
\owsm\config\clientagent\logging.xml
ORACLE_HOME
\owsm\config\coreman\logging.xml
ORACLE_HOME
\owsm\config\coreman\monitor-config-installer.properties
ORACLE_HOME
\owsm\config\gateway\gateway-config-installer.properties
ORACLE_HOME
\owsm\config\gateway\logging.xml
この操作により、copyDBConfig
操作の使用時に作成されるファイルのサブセットも含め、すべてのアプリケーションの構成に必要な全ファイルが作成されます。
変更を伝播するために、アプリケーションを再デプロイする必要があります。
この操作では、データベース構成パラメータを構成ディレクトリ・プロパティ・ファイルにコピーします。
構文
wsmadmin copyDBConfig
構文
buildApps
またはdeploy
を実行する前に、この操作を使用します。この操作では、coresv.properties
ファイルから次の値を読み取ります。
表B-2 copyDBConfig実行時に使用されるcoresv.properties
属性名 | 説明 |
---|---|
|
データベースURLの場所 |
|
データベース・ドライバのタイプ( |
|
データベースのログインに使用されるユーザーID |
|
データベースにログインするための暗号化されたパスワード |
この操作では、値を読み取った後、次のcoresv.properties
ファイルが変更されます。
ORACLE_HOME
\owsm\bin\agent.properties
ORACLE_HOME
\owsm\bin\coresv.properties
ORACLE_HOME
\owsm\config\ccore\ui-config-installer.properties
ORACLE_HOME
\owsm\config\clientagent\clientagent-config-installer.properties
ORACLE_HOME
\owsm\config\coreman\monitor-config-installer.properties
ORACLE_HOME
\owsm\config\gateway\gateway-config-installer.properties
変更を伝播するために、アプリケーションを再デプロイする必要があります。
この操作は、Oracle WSM Monitorで表示できるデータを生成するテスト・ツールです。wsmadmin dataGenerator
を使用して、次のタイプのデータを表示します。
構文
wsmadmin dataGenerator
使用方法
wsmadmin dataGenerator
を使用して、次のタイプのデータを表示します。
pingデータ
フロー・データ
起動データ
次のプロパティは、Oracle WSM Monitor専用です。この操作では、coresv.properties
ファイルから次の値を読み取ります。
この操作では、dataloadConfigure
操作で生成されたSQLスクリプトをプライマリOracle WSMデータベースにロードします。
構文
wsmadmin dataload
database_server_password
パラメータ
database_server_password
: データベース・サーバー・パスワード
使用方法
dataload
操作では、データをOracle WSMデータベースにロードする前に、そのデータがデータベースにすでに存在しているかどうかをチェックします。データが存在している場合、操作は終了します。
dataload
の実行前に、dataloadConfigure
操作を実行する必要があります。dataload
とdataloadConfigure
の2つの操作により、データベースにロードする前にデータを柔軟にカスタマイズできます。
initialize
操作は、dataload
操作とdataloadConfigure
操作を結合します。
dataload
操作では、coresv.properties
ファイルから次の属性を読み取ります。
この操作では、データベース・スキーマの作成とシード・データのロードに使用されるSQLスクリプトを生成します。
構文
wsmadmin dataloadConfigure
使用方法
データベース・ファイルは、ORACLE_HOME
\owsm\db
に作成されます。dataloadConfigure
操作では、coresv.properties
ファイルから次の属性を読み取ります。
表B-5 dataloadConfigure実行時に使用されるcoresv.properties
属性名 | 説明 |
---|---|
|
データベースURLの場所 |
|
データベース・ドライバのタイプ( |
|
データベースにログインするためのユーザーID |
|
データベースにログインするための暗号化されたパスワード |
dataloadConfigure
の実行後に、dataload
操作を実行します。詳細は、「dataload」を参照してください。
initialize
操作は、dataload
操作とdataloadConfigure
操作を結合します。
この操作では、コンポーネントを作成、デプロイし、OC4Jアプリケーション・エンジンにバインドします。
構文
wsmadmin deploy
application_server_password component
application_server_password
: アプリケーション・サーバーのパスワード。
component
: デプロイされるコンポーネントの名前。有効値は次のとおりです。
all
: すべてのコンポーネントをデプロイします。
control
: Web Services Manager Controlをデプロイします。
gateway
: Oracle WSM Gatewayをデプロイします。
monitor
: Oracle WSM Monitorをデプロイします。
policymanager
: Oracle WSM Policy Managerをデプロイします。
使用方法
この操作を使用して、コントロール、ゲートウェイ、モニターまたはポリシー・マネージャのインスタンスの作成、デプロイ、バインドを行います。すべてのコンポーネント上でこれらの作業を同時に実行できます。この操作を実行して、デプロイ前にカスタマイズすることなく、アプリケーションをデプロイします。デプロイ前にアプリケーションをカスタマイズするには、「buildApps」を参照してください。
この操作では、コンポーネントをOC4Jアプリケーション・エンジンにデプロイします。
構文
wsmadmin deployApps
application_server_password component
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
component
: デプロイされるコンポーネントの名前。有効値は次のとおりです。
all
: すべてのコンポーネントをデプロイします。
control
: Web Services Manager Controlをデプロイします。
gateway
: Oracle WSM Gatewayをデプロイします。
monitor
: Oracle WSM Monitorをデプロイします。
policymanager
: Oracle WSM Policy Managerをデプロイします。
使用方法
この操作を使用して、Web Services Manager Control、Oracle WSM Gateway、Oracle WSM MonitorまたはOracle WSM Policy Managerのインスタンスをデプロイします。all
パラメータを使用して、すべてのコンポーネントを一度にデプロイすることも、個々のコンポーネントをデプロイすることもできます。buildApps
操作の使用後に、この操作を使用します。詳細は、「buildApps」を参照してください。deployApps
操作では、coresv.properties
ファイルから次の属性を読み取ります。
表B-6 deployApps実行時に使用されるcoresv.properties
属性名 | 説明 |
---|---|
|
OC4Jコンテナの場所 |
|
外部OC4Jインストールの場所 |
|
外部OC4Jインストールのホスト名 |
|
外部OC4Jインストールのポート番号 |
|
外部OC4Jインストールの管理者のポート番号 |
|
外部OC4Jインストールの管理者のユーザー名 |
|
OC4Jインスタンスの場所 |
この操作では、プロパティ・ファイル内のパスワードをエンコードします。
構文
wsmadmin encodePasswords
propertyFile properties
パラメータ
propertyFile
: 指定したファイルの名前
properties
: エンコードされるパスワードのリスト
使用方法
複数のパスワードはコロン(:)で区切ることができます。ただし、空白は使用できません。
この操作では、Oracle WSMデータベースからファイルにデータをエクスポートします。
構文
wsmadmin exportDBData
database_server_password
パラメータ
database_server_password
: データベース・サーバー・パスワード
使用方法
このコマンドを実行すると、次のメッセージが表示されます。
警告: 入力ディレクトリのデータが削除されます。続行しますか。Y-Yes N-No:
データのエクスポートを続行するには、Y
を選択します。
エクスポートされた表は、XMLファイルとして格納されます。この操作は、次の理由で実行します。
Oracle WSMデータをバックアップする。
データを別の場所に移動する前に格納する。
注意: PATH環境変数がSQL*Plusのインストールされている場所に設定されていることを確認します。 |
exportDBData
操作では、coresv.properties
ファイルから次の属性を読み取ります。
構文
wsmadmin help
[operation]
パラメータ
[operation]
: この付録で説明されている任意の有効なwsmadmin
操作。wsmadmin
操作の完全なリストは、「WSMADMINコマンドの構文」を参照してください。
使用方法
コマンドwsmadmin help
を実行すると、このコマンドで実行できる有効な操作のリストが表示されます。操作で指定可能な引数を含め、特定の操作のヘルプを表示するには、operation
変数でその操作の名前を指定します。
この操作では、ファイルのデータをOracle WSMデータベースにインポートします。
構文
wsmadmin importDBData
database_server_password
パラメータ
database_server_password
: データベース・サーバー・パスワード
使用方法
次の要件が満たされていることを確認します。
この操作を実行する前に、SQL*Plusがインストールされていることを確認します。
PATH環境変数がSQL*Plusのインストールされている場所に設定されていることを確認します。
importDBData
操作では、coresv.properties
ファイルから次の属性を読み取ります。
構文
wsmadmin initialize
database_server_password
パラメータ
database_server_password
: データベース・サーバー・パスワード
使用方法
この操作を使用して、Oracle Liteデータベースを初期化し、スキーマを作成します。ただし、Oracleデータベースを初期化するには、この操作を使用する前に、スキーマを終了する必要があります。データベースにロードするデータのカスタマイズが必要な場合、dataloadConfigure
操作とdataload
操作を使用します。詳細は、「dataloadConfigure」と「dataload」を参照してください。
initialize
操作では、coresv.properties
ファイルから次の属性を読み取ります。
表B-9 dataload実行時に使用されるcoresv.properties
属性名 | 説明 |
---|---|
|
データベースURLの場所 |
|
データベース・ドライバのタイプ( |
|
データベースにログインするためのユーザーID |
|
データベースにログインするための暗号化されたパスワード |
|
データのみ、またはスキーマとデータをインポートする値 |
この操作は、インストール手順の最後に、インストーラにより自動的に起動されます。
構文
wsmadmin install
application_server_password database_server_password
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
database_server_password
: データベース・サーバー・パスワード
使用方法
インストーラは、Oracle WSM構成の最後に、このコマンドを起動します。必要な場合は、構成手順に、バンドルされたOC4JコンポーネントおよびOracle Liteコンポーネントの初期化が含まれます。J2EEアプリケーション(Web Services Manager Control、Oracle WSM Policy Manager、Oracle WSM Monitorなど)の作成およびデプロイも行います。この単一の操作により、次のすべての操作が起動され、実行されます。
configApps
installOLite
installOC4J
initialize
encodePasswords
encodePasswords
操作では、パスワードをinstall.properties
ファイルと比較します。
この操作では、agent.properties
ファイルに基づき、J2EEエージェントを作成し、インストールします。
構文
wsmadmin installAgent
application_server_password
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
使用方法
この操作には、OC4Jインタセプタ・エージェントを作成し、インストールするために、アプリケーション・サーバー・パスワードが必要です。installAgent
操作には、agent.properties
ファイルの次の属性が必要です。
表B-10 installAgent実行時に使用されるagent.properties
属性名 | 説明 |
---|---|
|
エージェントのタイプは、クライアント・エージェントまたはサーバー・エージェントのいずれかです。 |
この操作では、スタンドアロン・インストールに含まれているバンドル済のOC4Jアプリケーション・サーバーをインストールします。
構文
wsmadmin installOC4J
application_server_password
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
使用方法
この操作は、Oracle WSMのOC4Jサーバー・ポートを初期化します。この操作では、最初の実行時に、OC4J管理者パスワードを設定します。
この操作では、基本インストールに含まれているバンドル済のOracle Liteデータベースをインストールします。
構文
wsmadmin installOLite
database_server_password
パラメータ
database_server_password
: Oracle WSMデータベース(orawsm)インスタンスのシステム・ユーザーのパスワード
使用方法
この操作により、次の機能が実行されます。
install.properties
ファイルのinstall.db.*
属性の読取り
%WinDir%/OCBC.ini
へのデータベース・エントリの追加
%WinDir%/POLITE.ini
の作成および更新
Windowsサービス管理ツールでの、Oracle Liteデータベース用サービスの作成
この操作を使用して、データベースでユーザー・グループを管理します。
構文
wsmadmin manageUserGroups
database_server_password parameter
パラメータ
database_server_password
: Oracle Liteデータベースのパスワード。
parameter
: ユーザーまたはグループ名。有効値は次のとおりです。
addUser
addGroup
addUserGroup
deleteUser
deleteGroup
deleteUserGroup
使用方法
manageUserGroups
操作には、manageUserGrops.properties
ファイルの特定の属性が必要です。propertiesファイルの作成に必要な変更については、『Oracle Web Services Manager管理者ガイド』を参照してください。
この操作を使用して、指定したパスワード・ファイルに対して、ユーザーに関連付けられたパスワードをエンコードします。これは、ファイル・ベース認証とともに使用します。
構文
wsmadmin md5encode
username password htpasswdfile
パラメータ
username
: テキスト・ファイルのユーザー名
password
: ユーザーに割り当てられたパスワード
htpasswdfile
: ユーザー名およびパスワードを含むファイルの名前
使用方法
ユーザー名およびパスワードごとに、md5encodeコマンドを実行します。暗号化された結果はそれぞれ、ファイルの最後に追加されます。htpasswdfileファイルでの例は、次のとおりです。
johndoe:{MD5}JMnhX1KvxHwiW3V+e+4fnQ==
janedoe:{MD5}dqIXO+Y5M1TnL/pNbfEDCg==
この操作では、プロパティおよびデータベース設定を前のバージョンから移行します。
構文
wsmadmin migrate
previous_home application_server_password database_server_password
パラメータ
previous_home
: 既存バージョンのpropertiesファイルとデータベース設定の場所
application_server_password
: OC4Jシステム管理者パスワード
database_server_password
: データベース・サーバー・パスワード
この操作では、基本インストールに含まれているOC4Jアプリケーション・エンジンとOracle Liteデータベース・サーバーを起動します。
構文
wsmadmin start
使用方法
start
操作では、coresv.properties
ファイルから次の属性を読み取ります。
表B-11 start実行時に使用されるcoresv.properties
属性名 | 説明 |
---|---|
|
OC4Jコンテナの場所 |
|
OC4Jインストールのホスト名 |
|
プロキシ・サーバーのポート番号 |
|
プロキシを使用してデータを交換しないホスト・マシンの名前 |
startOLite
の後にstartOC4J
を使用する場合は、この操作を使用します。
この操作では、基本インストールに含まれているOC4Jアプリケーション・エンジンを起動します。
構文
wsmadmin startOC4J
使用方法
startOC4J
操作では、coresv.properties
ファイルから次の属性を読み取ります。
この操作では、基本インストールに含まれているOC4Jアプリケーション・エンジンとOracle Liteデータベース・サーバーを停止します。
構文
wsmadmin stop
application_server_password
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
使用方法
この操作では、coresv.properties
ファイルのoc4j.j2ee.home
属性を読み取ります。
stopOC4J
とstopOLite
を使用する場合は、この操作を使用します。
この操作では、基本インストールに含まれているOC4Jアプリケーション・エンジンを停止します。
構文
wsmadmin stopOC4J
application_server_password
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
この操作では、指定したコンポーネントをOC4Jインスタンスからアンバインドおよびアンデプロイします。
構文
wsmadmin undeploy
application_server_password component
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
component
: デプロイされるコンポーネントの名前。有効値は次のとおりです。
all
: すべてのコンポーネントをデプロイします。
control
: Web Services Manager Controlをデプロイします。
gateway
: Oracle WSM Gatewayをデプロイします。
monitor
: Oracle WSM Monitorをデプロイします。
policymanager
: Oracle WSM Policy Managerをデプロイします。
使用方法
undeploy
操作では、install.properties
ファイルから次の属性を読み取ります。
Oracle WSM製品のアンインストール時に、インストーラは自動的にこの操作を起動します。
構文
wsmadmin uninstall
application_server_password
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
使用方法
構成解除手順には、OC4JおよびOracle Liteのコンポーネントのアンインストールが含まれます。J2EEアプリケーションもアンインストールされます。パスワードを指定しないと、操作でOC4Jコンポーネントはアンインストールされません。この操作により、次の全操作の機能が実行されます。
uninstallOC4J
を実行します。パスワードを指定しないと、OC4Jはアンインストールされません。OC4Jを手動でアンインストールする必要があります。
uninstallOLite
を実行します。
構成ファイルを削除します。
注意: この操作では、データベースはクリーンアップされません。この手順は別に実行する必要があります。 |
この操作では、基本インストールに含まれているOC4Jアプリケーション・サーバーを非アクティブ化します。
構文
wsmadmin uninstallOC4J
application_server_password
パラメータ
application_server_password
: OC4Jシステム管理者パスワード
使用方法
この操作により、次の全操作の機能が実行されます。
undeployAll
stopOC4J
この操作では、Oracle WSM基本インストールに含まれているOracle Liteデータベース・サーバーをアンインストールします。
構文
wsmadmin
uninstallOLite
使用方法
この操作により、次のタスクが実行されます。
Oracle Liteデータベース・サーバーの停止およびシステムからのサービスの削除
%WinDir%/OCBC.ini
からのデータベース・エントリの削除
%WinDir%/POLITE.ini
の消去