IIS Webアプリケーションリソースは、Microsoft Internet Information Services (IIS) のWebサイトまたはFTPサイトを保護します。フェイルオーバーが発生すると、LifeKeeperはスタンバイサーバー上でIISサイトを起動し、WebまたはFTPクライアントへのサービスを復旧させます。
リソースタイプ: WEBServer/webapp
エイリアス: webserver/webapp, webapp, iis
前提条件
- サーバーに Microsoft IIS (Internet Information Services) がインストールされている必要があります。
--site-name で指定されたIISサイトが、IIS上に既に存在している必要があります。
サブコマンド
IIS Web/FTPアプリケーションリソースは、次の形式のコマンドで管理されます。
lkcli resource WEBServer/webapp <サブコマンド> [フラグ]
| サブコマンド |
説明 |
必要なロール |
create |
新しいIIS Web/FTPアプリケーション リソースを作成します |
admin |
extend |
スタンバイサーバーに拡張します |
admin |
get-property |
リソースプロパティを読み取ります |
guest |
set-property |
編集可能なリソースプロパティを更新します |
admin |
create
lkcli resource WEBServer/webapp create \
--service-type=<列挙型> --site-name=<文字列> [フラグ]
| フラグ |
短縮表記 |
タイプ |
必須 |
デフォルト |
制約 |
説明 |
--service-type |
— |
列挙型 |
必須 |
— |
WEB, FTP |
IISサービスタイプ |
--site-name |
— |
文字列 |
必須 |
— |
— |
IISサイト名 (IIS Managerで設定されたもの) |
--connection-check |
— |
列挙型 |
任意 |
enabled |
enabled, disabled |
接続確認のヘルスモニタリングを有効または無効にします |
--url |
— |
文字列 |
任意 |
— |
— |
接続確認用ヘルスプローブのURL(WEBタイプのみ) |
--ftp-ssl |
— |
列挙型 |
任意 |
disabled |
enabled, disabled |
接続確認用にFTP over SSLを有効にします (FTPタイプのみ) |
--tag |
— |
文字列 |
任意 |
自動生成 |
— |
リソースタグ名 |
--switchback |
— |
列挙型 |
任意 |
INTELLIGENT |
INTELLIGENT, AUTOMATIC |
スイッチバックタイプ |
--local-recovery |
— |
列挙型 |
任意 |
enabled |
enabled, disabled |
ローカルリカバリーを有効にします |
--quickcheck-interval |
— |
整数 |
任意 |
180 |
最小: 0、最大: 604800 |
クイックチェックの間隔(秒 |
--deepcheck-interval |
— |
整数 |
任意 |
300 |
最小: 0、最大: 604800 |
ディープチェックの間隔(秒) |
extend
lkcli resource WEBServer/webapp extend --primary-sys=<文字列> --primary-tag=<文字列> [フラグ]
| フラグ |
短縮表記 |
タイプ |
必須 |
デフォルト |
制約 |
説明 |
--primary-sys |
— |
文字列 |
必須 |
— |
— |
既存のリソースの拡張元サーバーのホスト名 |
--primary-tag |
— |
文字列 |
必須 |
— |
— |
拡張する既存リソースのタグ |
--standby-sys |
— |
文字列 |
任意 |
--host の値(デフォルトは localhost) |
— |
スタンバイサーバーのホスト名 |
--switchback |
— |
列挙型 |
任意 |
INTELLIGENT |
INTELLIGENT, AUTOMATIC |
スイッチバックタイプ |
--primary-priority |
— |
整数 |
任意 |
デフォルトは、 --primary-sys サーバーの現在の優先順位。リソースが拡張されていない場合は1 |
最小: 1、最大: 999 |
プライマリーサーバーのフェイルオーバーの優先順位 |
--standby-priority |
— |
整数 |
任意 |
デフォルトは現在使用中の優先順位に基づいて動的に算出される、未使用の値 |
最小: 1、最大: 999 |
スタンバイサーバーのフェイルオーバーの優先順位 |
get-property / set-property
lkcli resource WEBServer/webapp get-property --tag=<文字列> --property=<文字列>
lkcli resource WEBServer/webapp set-property --tag=<文字列> --property=<文字列> --value=<文字列>
| フラグ |
短縮表記 |
タイプ |
必須 |
説明 |
--tag |
-t |
文字列 |
必須 |
リソースタグ名 |
--property |
-p |
文字列 |
必須 |
プロパティ名(「プロパティ」の表を参照) |
--value |
-v |
文字列 |
必須(set-property のみ) |
新しいプロパティ値 |
プロパティ
| プロパティ |
タイプ |
制約 |
編集可否 |
説明 |
service-type |
列挙型 |
WEB, FTP |
不可 |
IISサービスのタイプ |
site-name |
文字列 |
— |
不可 |
IISサイト名 |
resource-version |
文字列 |
— |
不可 |
リソースバージョン文字列 |
connection-checking-settings |
オブジェクト(JSONまたは「key1=value1,key2=value2,…」形式) |
必須フィールド:connection_check(enabledまたはdisabled)、update_cluster(trueまたはfalse)。connection_checkがenabledの場合、urlが必須となります。ftp_sslは任意(enabledまたはdisabled)です。 |
可 |
接続確認設定オブジェクト(チェックの種類、URL、FTP SSL設定を含む) |
deepcheck-interval |
整数 |
最小: 0、最大: 604800 |
可 |
ディープチェックの間隔(秒)(デフォルト: 300) |
quickcheck-interval |
整数 |
最小: 0、最大: 604800 |
可 |
クイックチェックの間隔(秒)(デフォルト:180) |
local-recovery |
列挙型 |
enabled, disabled |
可 |
ローカルリカバリーを有効にします |
switchback |
列挙型 |
INTELLIGENT, AUTOMATIC |
可 |
スイッチバックタイプ |
使用例
# Create an IIS Web site resource
lkcli resource WEBServer/webapp create \
--host=server1 \
--service-type=WEB \
--site-name="Default Web Site" \
--connection-check=enabled \
--url="http://localhost/health" \
--tag=webapp.DefaultWebSite
# Create an IIS FTP site resource
lkcli resource iis create \
--host=server1 \
--service-type=FTP \
--site-name="Default FTP Site" \
--ftp-ssl=disabled \
--tag=webapp.DefaultFTPSite
# Extend to server2
lkcli resource WEBServer/webapp extend \
--host=server2 \
--primary-sys=server1 \
--primary-tag=webapp.DefaultWebSite
# Disable connection checking
lkcli resource webapp set-property \
--host=server1 \
--tag=webapp.DefaultWebSite \
--property=connection-checking-settings \
--value="connection_check=disabled"
このトピックへフィードバック