2.6.7 create-webserver
Webサーバの構築
書式
asadmin [asadmin-options] create-webserver --node node-name [--properties name=value[:name=value]...] [--template webserver-templatedir] [--prf prf-name] webserver-name
格納先
Application Serverインストールディレクトリー/javaee/glassfish/bin
機能
create-webserverサブコマンドは、ドメインにWebサーバを構築します。
このコマンドはリモートモードだけサポートします。
実行権限
一般ユーザー
前提条件
ノードを作成済みであること。
ファイル
Webサーバのサーバテンプレート(オプション指定可能)
ドメインルートディレクトリー/ドメイン名/server_templates/webserver
引数
- --node node-name
-
Webサーバを構築するノードを指定します。
型:String
指定できる値を次に示します。
-
ドメインに存在するノード名
デフォルト値:なし(必須)
-
- --properties name=value[:name=value]...
-
Webサーバの標準プロパティーまたは拡張プロパティーを、プロパティー名と値のペアで指定します。
指定形式は、name=valueです。複数指定する場合は、コロン(:)で区切ります。同じプロパティー名を複数指定した場合は、最後に指定したプロパティーの値が有効となります。
name
型:String
指定できる値を次に示します。
-
Webサーバの標準プロパティーまたは拡張プロパティー(ex_から始まるプロパティー)。
デフォルト値:このオプションで指定していない標準プロパティーについては、Webサーバのデフォルトコンフィグ(コンフィグ名default-webserver-config)の値が適用されます。
value
指定できる値を次に示します。
-
nameに指定したプロパティーの指定範囲に従います。
-
- --template webserver-templatedir
-
Webサーバのサーバテンプレートが格納されているディレクトリーパスを絶対パスで指定します。
型:String
デフォルト値:hitachi-webserver-configs.hitachi-webserver-config.default-webserver-config.hitachi-manage-info.template-path属性に設定されているパスが適用されます。この属性のデフォルト値は次のパスです。
ドメインルートディレクトリー/ドメイン名/server_templates/webserver
- --prf prf-name
-
Webサーバが使用するPRFのサーバ名を指定します。
型:String
指定できる値を次に示します。
-
--nodeに指定したノードに存在するPRF
デフォルト値:なし(指定しない)
-
- webserver-name
-
新規に構築するWebサーバの名称を指定します。
型:String
指定できる値を次に示します。
-
128文字以内のASCII文字であること。
-
名称は次の文字で構成すること。
英小文字<a〜z>
英大文字<A〜Z>
数字<0〜9>
ハイフン<->
アンダースコア<_>
-
先頭文字は英大文字または英小文字を使用すること。
-
ドメインに存在する次の名称は指定できません。
ノード名
JavaEEサーバ名
Webサーバ名
PRFのサーバ名
クラスター名
サーバ間関連名
JavaEEサーバの構成名
-
次に示す名称はシステムで使用済みまたは予約語のため指定できません。
domain
server
default
server-config
default-config
default-webserver-config
default-prf-config
javaee
webserver
prf
cluster
redirect
prf-relation
HJES_で始まる名称
構築済みWebサーバ名-config
構築済みPRF名-config
デフォルト値:なし(必須)
-
使用例
サーバ名Web1、関連するPRFPRF1のWebサーバを構築する場合
asadmin create-webserver --node localhost-domain1 --prf PRF1 Web1
デフォルトから変更したい標準プロパティーを指定してWebサーバを構築する場合
asadmin create-webserver --node localhost-domain1 --properties listen-port=88:server-name=www.webserver.com --prf PRF1 Web1
サーバテンプレートを指定してWebサーバを構築する場合
asadmin create-webserver --node localhost-domain1 --template /user_template/Web1 --prf PRF1 Web1
戻り値
戻り値 |
説明 |
---|---|
0 |
正常終了 |
1 |
異常終了 |
注意事項
構築先ノードのホストに、ほかのドメインがWebサーバを構築済みの場合、そのWebサーバと同じ名称のWebサーバを構築しないでください。