Sun GlassFish Enterprise Server v3 管理ガイド

構成でのドット表記名の機能

初期構成の適用後、Enterprise Server の稼働期間に使用中の構成を継続して管理します。生産性を向上させるためにリソースの調整が必要になったり、問題が発生して設定の変更やデフォルトへのリセットなどが必要になることがあります。update-connector-work-security-map サブコマンドのように、更新用の asadmin のサブコマンドが用意されている場合があります。しかし、たいていの更新は、listget、および set のサブコマンドとドット表記名を使用して行われます。ドット表記名の詳細については、dotted-names(5ASC) のマニュアルページを参照してください。


注 –

ドット表記名は監視にも使用しますが、メソッドが異なります。監視でのドット表記名の使用方法については、「監視のツリー構造の仕組みについて」を参照してください。


コマンド行で構成変更を操作する一般的なプロセスは、次のとおりです。

  1. 目的のコンポーネントのモジュールを一覧表示します。

    次のシングルモードの例は、| (パイプ) 文字と grep コマンドを使用して、検索を絞り込んでいます。


    asadmin list "*" | grep http | grep listener
    

    次のような情報が返されます。


    configs.config.server-config.network-config.network-listeners.network-listener.http-listener-1
    configs.config.server-config.network-config.network-listeners.network-listener.http-listener-2
    configs.config.server-config.network-config.protocols.protocol.admin-listener.http
    configs.config.server-config.network-config.protocols.protocol.admin-listener.http.file-cache
    configs.config.server-config.network-config.protocols.protocol.http-listener-1
    configs.config.server-config.network-config.protocols.protocol.http-listener-1.http
    configs.config.server-config.network-config.protocols.protocol.http-listener-1.http.file-cache
    configs.config.server-config.network-config.protocols.protocol.http-listener-2
    configs.config.server-config.network-config.protocols.protocol.http-listener-2.http
    configs.config.server-config.network-config.protocols.protocol.http-listener-2.http.file-cache
    configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl
  2. 目的のモジュールに適用する属性を取得します。

    次のマルチモードの例は、http-listener-1 の属性と値を取得します。


    asadmin> get server-config.network-config.network-listeners.network-listener.http-listener-1.* 
    

    次のような情報が返されます。


    server.http-service.http-listener.http-listener-1.acceptor-threads = 1
    server.http-service.http-listener.http-listener-1.address = 0.0.0.0
    server.http-service.http-listener.http-listener-1.blocking-enabled = false
    server.http-service.http-listener.http-listener-1.default-virtual-server = server
    server.http-service.http-listener.http-listener-1.enabled = true
    server.http-service.http-listener.http-listener-1.external-port =
    server.http-service.http-listener.http-listener-1.family = inet
    server.http-service.http-listener.http-listener-1.id = http-listener-1
    server.http-service.http-listener.http-listener-1.port = 8080
    server.http-service.http-listener.http-listener-1.redirect-port =
    server.http-service.http-listener.http-listener-1.security-enabled = false
    server.http-service.http-listener.http-listener-1.server-name =
    server.http-service.http-listener.http-listener-1.xpowered-by = true
  3. サブコマンド set を使用して、属性を変更します。

    この例は、http-listener-1 の属性 security-enabled を true に設定します。


    asadmin> set server.http-service.http-listener.http-listener-1.security-enabled = true