asradm list
asradm send [-n] [activate|audit|deactivate|fault|heartbeat|test]
asradm register -u username [-p password-file] [-e endpoint_URL]
asradm set-proxy [-i] | [-h host[:port]] [-u username]
[-p password-file]
asradm unregister
asradm authenticate -u username -p password-file [-n]
[-e endpoint_URL]
asradm ユーティリティーは、特権システム管理者が Oracle Sun システム用 Oracle ASR (Auto Service Request) の登録簿にホストを登録するために使用されます。auto-case 生成を使用すると、特定のハードウェア障害が発生した際に、システムの可用性が改善され、診断処理が促進されます。
有効な My Oracle Support (MOS) アカウントでシステムが登録されると、smf(5) サービス asr-notify が HTTPS/XML テレメトリの送信を構成済みエンドポイントに直接、またはオプションの HTTP プロキシ経由で開始します。
また、asradm ユーティリティーは、登録済みサーバーから見た現在の登録状態を一覧表示することもできます。これは、Oracle ASR サービスにメッセージが送信されていることを確認するだけであり、システムがアクティブに監視されていることを意味するわけではありません。ユーザーは自身の MOS アカウントにログインし、システム用にサービスをアクティブ化する必要があります。登録簿を完了するために必要な詳細が記載された電子メールが、登録後にユーザーに送信されるはずです。
send サブコマンドを使用すれば、ASR メッセージを手動で送信できます。ASR メッセージを実際に送信しないでその内容を表示することもできます。メッセージの生成は、システムが登録されていない場合でも行えます。
ASR サービスからシステムを登録解除することもでき、その場合は監視対象から除外され、システムから送信されるすべてのテレメトリが無効になります。
サポートしているオプションは、次のとおりです。
登録やすべてのメッセージテレメトリで使用されるエンドポイント URL を設定します。デフォルト値は、すべてのテレメトリが Oracle サービスに直接送信される transport.sun.com です。ASR マネージャーソリューションのローカルインスタンスをサポートするために、別の URL を使用できます。ローカル ASR マネージャーを使用して、多くのホストインスタンスからのテレメトリを集約できます。
インターネットへの接続に使用する HTTPS プロキシホストとオプションのポート番号を設定します。ポートを指定しない場合は、デフォルトのポート値 80 が使用されます。
インターネットに直接接続するように、したがってプロキシホストを使用しないように、HTTPS 接続を設定します。このオプションを指定すると、以前に設定された HTTPS プロキシ情報がクリアーされます。
イベント送信の予行演習を行います (送信されるはずのメッセージデータが標準出力に表示されます)。
register サブコマンドで使用される場合、これは、このシステム上の製品登録に関連付けられる MOS ユーザー名を指定します。set-proxy サブコマンドで使用される場合、これはメッセージトランスポートに使用される HTTPS プロキシユーザー名を指定します。
これは、パスワード値を含む単一行ファイルであるべきです。このコマンドの実行後にすぐに削除される可能性があります。register サブコマンドで使用される場合、これは MOS ユーザー名に関連付けられたパスワードを指定します。set-proxy サブコマンドで使用される場合、このオプションはインターネットへの接続に使用される HTTPS プロキシに関連付けられるパスワードを指定します。–p オプションが入力されず –u オプションが設定されていた場合、ユーザーはパスワードの入力を求められます。
次に asradm サブコマンドについて説明します。
Oracle ASR サービスを使用して MOS 資格を認証して、sysconfig プロパティーを出力します (このプロパティーを自動インストーラとともに使用して asr-notify サービスを取り込むことで、Oracle ASR サービスへの自動登録が可能になります)。
このコマンドには –u ユーザーおよび –p オプションが必須であり、またオプションのエンドポイントを取って ASR マネージャーのエンドポイント位置を定義します。
–n オプションを指定すると、ネットワーク接続は作成されず、あとで認証するのに必要なプロパティーが出力されます。
指定された認証資格を使ってシステムを MOS に登録します。MOS パスワードは、将来のすべてのテレメトリで使用されるトークンを取得するために初期登録でのみ使用され、システム上のどこにも格納されません。
ホストシステムがファイアウォールの背後にある場合は、HTTP プロキシ設定はシステムを登録する前に set-proxy コマンドを使って設定する必要があります。
登録が完了すると、自動サポート呼び出し生成のサポートを要求する ASR アクティベーションメッセージが送信されます。その後、サポート要求のステータスを知らせる電子メールが登録ユーザーに送信されます。
現在の認証済み MOS ユーザー名と、MOS との HTTPS 通信に必要なネットワーク接続情報を表示します。(register コマンドでの) 登録がまだ完了していない場合は、Unregistered というステータスが表示されます。
すべての ASR メッセージの送信に使用される HTTPS 接続情報を設定します。直接接続を行うことも、HTTPS プロキシを定義することもできます。
ASR 非アクティブ化イベントを送信し、構成済み登録情報をすべて削除します。テレメトリはそれ以上送信されなくなり、Oracle ASR サービスは自動サポート呼び出しを生成しなくなります。
指定された ASR メッセージを Oracle ASR サービスに手動で送信し、予行演習オプション (–n) の場合は ASR メッセージを表示します。
次のコマンドは、すべてのメッセージをポート 8080 上の HTTPS プロキシホスト webproxy.example.com に経路指定します。
# asradm set-proxy -h webproxy.example.com:8080使用例 2 MOS ID の登録
次のコマンドは、ASR で使用するために与えられた MOS ID を使ってこのシステムを対話形式で認証および登録するために使用されます。このあと、サポートユーザー名とパスワードの入力を求められます。
# asradm register使用例 3 非対話形式の認証
これは、前述の set—proxy の例に似ています。違いは、MOS ユーザー名とパスワードがコマンド行で指定されている点です。
# asradm register -u joe.admin@example.com -p mypassword使用例 4 監査メッセージの内容の表示
次のコマンドは、イベント送信なしで監査メッセージを表示します。これは、ASR サービスが登録されていない場合でも動作します。
# asradm send -n audit
次の終了ステータスが返されます。
コマンドがエラーなしで完了しました。
システムエラーのためにコマンドを完了できませんでした。
コマンド行の使用が不正です。
接続構成が有効ではありません。
認証エラー。
ネットワーク接続エラー。
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
svcs(1), asr-notify(1M), svcadm(1M), svccfg(1M), syslogd(1M), attributes(5), smf(5)