Oracle Listenerリソースは、Oracle Net Servicesのリスナープロセスを保護します。リスナーはフェイルオーバーのライフサイクルの一環としてIn-ServiceおよびOut of serviceに切り替えられ、クライアント接続がアクティブなOracleデータベースノードに確実にルーティングされるようにします。
リソースタイプ: database/listener
エイリアス: listener
前提条件
- サーバーに Oracle Database (Oracle Net Servicesを含む) がインストールされている必要があります。
- Oracleホームディレクトリおよびリスナー構成ファイル (
listener.ora) にアクセスできる必要があります。 - リスナーの実行ファイルディレクトリを指定する必要があります。
サブコマンド
Oracle Listenerリソースは、次の形式のコマンドで管理されます。
lkcli resource database/listener <サブコマンド> [フラグ]
| サブコマンド | 説明 | 必要なロール |
|---|---|---|
create
|
新しいOracle Listnerリソースを作成します | admin |
extend
|
スタンバイサーバーに拡張します | admin |
get-property
|
リソースプロパティを読み取ります | guest |
set-property
|
編集可能なリソースプロパティを更新します | admin |
create
lkcli resource database/listener create \
--oracle-home-name=<文字列> --config-file=<文字列> \
--listener-list=<array> --exe-dir=<文字列> [フラグ]
| フラグ | 短縮表記 | タイプ | 必須 | デフォルト | 制約 | 説明 |
|---|---|---|---|---|---|---|
--oracle-home-name
|
— | 文字列 | 必須 | — | — | Oracleホーム名 |
--config-file
|
— | 文字列 | 必須 | — | — | listener.oraファイルへのフルパス |
--listener-list
|
— | 配列 | 必須 | — | — | カンマ区切りのリスナー名のリスト |
--exe-dir
|
— | 文字列 | 必須 | — | — | Oracleリスナーの実行ファイルを含むディレクトリへのフルパス |
--protection-level
|
— | 列挙型 | 任意 | Full
|
Full, Intermediate, Minimal
|
リスナーの保護レベル |
--recovery-level
|
— | 列挙型 | 任意 | Standard
|
Standard, Optional
|
リカバリーレベル |
--ip-resource-list
|
— | 配列 | 任意 | — | — | このリソースが依存するIPアドレスリソースのタグ |
--tag
|
— | 文字列 | 任意 | 自動生成 | — | リソースタグ名 |
--switchback
|
— | 列挙型 | 任意 | INTELLIGENT
|
INTELLIGENT, AUTOMATIC
|
スイッチバックタイプ |
extend
lkcli resource database/listener extend --primary-sys=<文字列> --primary-tag=<文字列> [フラグ]
| フラグ | 短縮表記 | タイプ | 必須 | デフォルト | 制約 | 説明 |
|---|---|---|---|---|---|---|
--primary-sys
|
— | 文字列 | 必須 | — | — | 既存のリソースの拡張元サーバーのホスト名 |
--primary-tag
|
— | 文字列 | 必須 | — | — | 拡張する既存リソースのタグ |
--standby-sys
|
— | 文字列 | 任意 | --hostの値(デフォルトはlocalhost)
|
— | スタンバイサーバーのホスト名 |
--config-file
|
— | 文字列 | 任意 | Matches primary | — | スタンバイ上のlistener.oraへのパスを上書きします |
--exe-dir
|
— | 文字列 | 任意 | Matches primary | — | スタンバイ上の実行ファイルディレクトリを上書きします |
--switchback
|
— | 列挙型 | 任意 | INTELLIGENT
|
INTELLIGENT, AUTOMATIC
|
スイッチバックタイプ |
--primary-priority
|
— | 整数 | 任意 | デフォルトは、--primary-sysサーバーの現在の優先順位。リソースが拡張されていない場合は1
|
最小: 1、最大: 999 | プライマリーサーバーのフェイルオーバーの優先順位 |
--standby-priority
|
— | 整数 | 任意 | デフォルトは現在使用中の優先順位に基づいて動的に算出される、未使用の値 | 最小: 1、最大: 999 | スタンバイサーバーのフェイルオーバーの優先順位 |
get-property / set-property
lkcli resource database/listener get-property --tag=<文字列> --property=<文字列>
lkcli resource database/listener set-property --tag=<文字列> --property=<文字列> --value=<文字列>
| フラグ | 短縮表記 | タイプ | 必須 | 説明 |
|---|---|---|---|---|
--tag
|
-t
|
文字列 | 必須 | リソースタグ名 |
--property
|
-p
|
文字列 | 必須 | プロパティ名(「プロパティ」の表を参照) |
--value
|
-v
|
文字列 | 必須 (set-propertyのみ)
|
新しいプロパティ値 |
プロパティ
| プロパティ | タイプ | 制約 | 編集可否 | 説明 |
|---|---|---|---|---|
oracle-home-name
|
文字列 | — | 不可 | Oracleホーム名 |
config-file
|
文字列 | — | 不可 | listener.oraファイルへのフルパス |
exe-dir
|
文字列 | — | 不可 | Oracleリスナーの実行ファイルを含むディレクトリへのフルパス |
listener-list
|
配列 | — | 可 | 管理対象のリスナー名のリスト |
ip-resource-list
|
配列 | — | 可 | このリスナーに関連付けられたLifeKeeper IPリソースタグのリスト |
protection-level
|
列挙型 | Full, Intermediate, Minimal
|
可 | リスナーの保護レベル |
recovery-level
|
列挙型 | Standard, Optional
|
可 | リカバリーレベル |
version
|
文字列 | — | 不可 | Oracleのバージョン(読み取り専用) |
local-recovery
|
列挙型 | enabled, disabled
|
可 | ローカルリカバリーを有効にします |
quickcheck-interval
|
整数 | 最小: 0、最大: 604800 | 可 | クイックチェックの間隔(秒)(デフォルト:180) |
使用例
# Create an Oracle Listener resource
lkcli resource database/listener create \
--host=server1 \
--oracle-home-name=OraDB19Home1 \
--config-file=C:\app\user\product\19.3.0\dbhome_1\network\admin\listener.ora \
--listener-list=LISTENER \
--exe-dir=C:\app\user\product\19.3.0\dbhome_1\bin \
--protection-level=Full \
--tag=listener.0
# Extend to server2
lkcli resource database/listener extend \
--primary-sys=server1 \
--primary-tag=listener.0 \
--standby-sys=server2



このトピックへフィードバック