3.5 診断コマンド

この項のWLSTコマンドを使用して、製品が適切に機能するために必要なWSMコンポーネントのステータスをチェックします。

3.5.1 checkWSMStatus

コマンド・カテゴリ: 診断

WLSTでの使用: オンライン

説明

製品が適切に機能するために必要なOWSMコンポーネントのステータスをチェックします。チェックされるOWSMコンポーネントは、ポリシー・マネージャ(wsm-pm)、エージェント(agent)および資格証明ストアとキーストア構成です。コンポーネントのステータスは、まとめて確認することも、個別に確認することもできます。

注意:

ステータス・チェック・ツールが正しく機能するには、ポリシー・マネージャ(wsm-pm)アプリケーションがデプロイおよび実行されている必要があります。

構文

checkWSMStatus([component=None],[address=None],[verbose=true])

引数説明

引数	説明
`component`	オプション。値を指定しないと、すべてのチェックが実行されます。有効なオプションは次のとおりです。 `wsm-pm`—ポリシー・マネージャ。ポリシー・マネージャ・コンポーネントの構成状態をチェックします。 `agent`—強制エージェント。`wsm`エージェント・コンポーネントによるエンドツーエンドのサービス側強制のステータスをチェックします。強制チェックは、コマンドが実行される環境に固有のものです。 `credstore`—資格証明ストア。キーストア内のキーストア・パスワード、署名および暗号化証明書に対して資格証明が構成されているかどうかをチェックします。
`address`	オプション。`wsm-pm`アプリケーションを実行しているホストのHTTP URL。この値は、たとえば次のように、エージェント・コンポーネントを介して強制をチェックする際に必要です。 checkWSMStatus('agent', 'http://localhost:7001') 自動検出が設定されているWebLogic Serverドメインではアドレスは必要ありません。
`verbose`	オプション。このフラグの値が`true`の場合、詳細なメッセージ(存在する場合は、スタック・トレースを含む)が表示されます。デフォルトは`false`です。

component

オプション。値を指定しないと、すべてのチェックが実行されます。有効なオプションは次のとおりです。

wsm-pm—ポリシー・マネージャ。ポリシー・マネージャ・コンポーネントの構成状態をチェックします。
agent—強制エージェント。wsmエージェント・コンポーネントによるエンドツーエンドのサービス側強制のステータスをチェックします。強制チェックは、コマンドが実行される環境に固有のものです。
credstore—資格証明ストア。キーストア内のキーストア・パスワード、署名および暗号化証明書に対して資格証明が構成されているかどうかをチェックします。

address

オプション。wsm-pmアプリケーションを実行しているホストのHTTP URL。この値は、たとえば次のように、エージェント・コンポーネントを介して強制をチェックする際に必要です。

checkWSMStatus('agent', 'http://localhost:7001')

自動検出が設定されているWebLogic Serverドメインではアドレスは必要ありません。

verbose

オプション。このフラグの値がtrueの場合、詳細なメッセージ(存在する場合は、スタック・トレースを含む)が表示されます。デフォルトはfalseです。

例

次の例では、checkWSMStatusコマンドは引数なしで実行されています。資格証明ストア、ポリシー・マネージャおよび強制エージェントのステータスが返されます。

wls:/base_domain/serverConfig> checkWSMStatus()
 
Credential Store Configuration:
 
PASSED.
        Message(s):
             keystore.pass.csf.key : Property is configured and its value is "keystore-csf-key".
                 Description: The "keystore.pass.csf.key" property points to the CSF alias that is mapped to the username and password of the keystore. Only the password is used; username is redundant in the case of the keystore.
             keystore-csf-key : Credentials configured.
             keystore.sig.csf.key : Property is configured and its value is "sign-csf-key".
                 Description: The "keystore.sig.csf.key" property points to the CSF alias that is mapped to the username and password of the private key that is used for signing.
             sign-csf-key : Credentials configured.
             Sign Key : Key configured.
                 Alias - orakey
             Sign Certificate : Certificate configured.
                 Alias - CN=weblogic, OU=Orakey Test Encryption Purposes Only, O=Oracle, C=US
                 Expiry - June 28, 2020 11:17:12 AM PDT
             keystore.enc.csf.key : Property is configured and its value is "enc-csf-key".
                 Description: The "keystore.enc.csf.key" property points to the CSF alias that is mapped to the username and password of the private key that is used for decryption.
             enc-csf-key : Credentials configured.
             Encrypt Key : Key configured.
                 Alias - orakey
             Encrypt Certificate : Certificate configured.
                 Alias - CN=weblogic, OU=Orakey Test Encryption Purposes Only, O=Oracle, C=US
                 Expiry - June 28, 2020 11:17:12 AM PDT
 
Policy Manager:
 
 
PASSED.
        Message(s):
             OWSM Policy Manager connection state is OK.
             OWSM Policy Manager connection URL is "host.example.com:1234".
 
Enforcement Agent:
 
 
PASSED.
        Message(s):
             Enforcement is successful.
             Service URL: http://host:port/Diagnostic/DiagnosticService?wsdl

次の例では、資格証明ストア・キーkeystore-csf-keyが削除され、資格証明ストアcredstoreに対してcheckWSMStatusコマンドが再実行されています。資格証明ストアにcsf-key keystore-csf-keyが存在しないため、このステータス・チェックは失敗します。

wls:/base_domain/serverConfig> deleteCred(map="oracle.wsm.security", key="keystore-csf-key") 
wls:/base_domain/serverConfig> checkWSMStatus('credstore')
 
Credential Store Configuration:
 
FAILED.
        Message(s):
             keystore.pass.csf.key : Property is configured and its value is "keystore-csf-key".
                 Description: The "keystore.pass.csf.key" property points to the CSF alias that is mapped to the username and password of the keystore. Only the password is used; username is redundant in the case of the keystore.
             keystore-csf-key : Credentials not configured.
 
Credential Store Diagnostic Messages:
        Message(s):
                 The csf-key keystore-csf-key is not present in the credential store. 
 
 Perform the following steps to update the credential store (using WLST commands):-
 1. connect()
 2. createCred(map="oracle.wsm.security", key="keystore-csf-key", user="keystore-csf-key", password="<keystore-password>", desc="Keystore Password CSF Key")
 NOTE:- All the above commands are based on the Domain level configurations. The actual csf key may be overridden at runtime due to config override. See Documentation for more details.

次の例では、csf-key keystore-csf-keyが構成され、checkWSMStatusコマンドが再実行されています。構成チェックが成功します。

wls:/base_domain/serverConfig> createCred(map="oracle.wsm.security", key="keystore-csf-key", user="keystore-csf-key", password="welcome1", desc="Keystore Password CSF Key")
Already in Domain Runtime Tree
 
wls:/base_domain/serverConfig> checkWSMStatus('credstore')
 
Credential Store Configuration:
 
 
PASSED.
        Message(s):
             keystore.pass.csf.key : Property is configured and its value is "keystore-csf-key".
                 Description: The "keystore.pass.csf.key" property points to the CSF alias that is mapped to the username and password of the keystore. Only the password is used; username is redundant in the case of the keystore.
             keystore-csf-key : Credentials configured.
             keystore.sig.csf.key : Property is configured and its value is "sign-csf-key".
                 Description: The "keystore.sig.csf.key" property points to the CSF alias that is mapped to the username and password of the private key that is used for signing.
             sign-csf-key : Credentials configured.
             Sign Key : Key configured.
                 Alias - orakey
             Sign Certificate : Certificate configured.
                 Alias - CN=weblogic, OU=Orakey Test Encryption Purposes Only, O=Oracle, C=US
                 Expiry - June 28, 2020 11:17:12 AM PDT
             keystore.enc.csf.key : Property is configured and its value is "enc-csf-key".
                 Description: The "keystore.enc.csf.key" property points to the CSF alias that is mapped to the username and password of the private key that is used for decryption.
             enc-csf-key : Credentials configured.
             Encrypt Key : Key configured.
                 Alias - orakey
             Encrypt Certificate : Certificate configured.
                 Alias - CN=weblogic, OU=Orakey Test Encryption Purposes Only, O=Oracle, C=US
                 Expiry - June 28, 2020 11:17:12 AM PDT
true

次の例では、URL http://localhost:7001にあるエージェント・コンポーネントの強制ステータスをチェックします。

wls:/test_domain1/serverConfig> checkWSMStatus('agent','http://localhost:7001')
 
Enforcement Agent:
 
Note: Enforcement might succeed if OWSM Policy Manager is down due to policy caching. For such scenarios wsm-pm test must be run prior to this test.
 
PASSED.
        Message(s):
             Enforcement is successful.
             Service URL: http://localhost:7001/Diagnostic/DiagnosticService?wsdl