Hitachi

 Hitachi Application Server V10 コマンドリファレンスWindows®用)


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文字であること。

  • 名称は次の文字で構成すること。

    英小文字<az>

    英大文字<AZ>

    数字<09>

    ハイフン<->

    アンダースコア<_>

  • 先頭文字は英大文字または英小文字を使用すること。

  • ドメインに存在する次の名称は指定できません。

    ノード名

    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

  • システム(Webサーバが稼働するノード上のOS)に登録されているほかのWindowsサービスの名称と重複しないこと。

デフォルト値:なし(必須)

使用例

サーバ名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

異常終了

注意事項