コンソール ID ストリング

コンソール ID ストリングを、コンソール・バナーやブラウザーのタイトル・バーに 表示されるように定義することができます。 このストリングは固定することもできますが、 Java システム・プロパティーや環境変数によって実行時に解決される変数を 使用することもできます。

コンソール ID ストリングの表示は、バナーとブラウザーのタイトル・バーとでは異なります。
  • バナーでのコンソール ID
    コンソール・バナーでは、コンソール ID ストリングは、 コンソール・ユーザーへのグリーティングの後にダッシュで区切って表示されます。 例えば、ID ストリングが Jupiter に設定され、ユーザーが consoleadmin としてログインしている場合は、以下のグリーティングがバナーに表示されます。

    ようこそ consoleadmin - Jupiter

    ログイン・ページでは、コンソール ID のみが表示され、グリーティングは表示されません。

  • ブラウザー・タイトル・バーでのコンソール ID
    タイトル・バーでは、コンソール ID ストリングは、 コンソール製品名の後にスペースで区切って表示されます。 例えば、ID ストリングが Saturn に設定されている場合は、以下の情報がタイトル・バーに表示されます。

    Integrated Solutions Console Saturn

インストール後に ID ストリングをカスタマイズするには、2 つの方法が 使用できます。
  • 管理コンソールの「コンソール ID (Console Identity)」を使用します。 開くには、管理コンソールにログインし、 「システム管理」 > 「コンソール ID」をクリックします。
  • XML ファイル consoleProperties.xml でストリングの値を設定します。 このファイルは app_server_root/profiles/profile_name/config/cell/cell_name/applications/isclite.ear/deployments/isclite/isclite.war/WEB-INF にあります。 このファイルを変更する場合は、その前に、 最新の作業 consoleProperties.xml のバックアップ・コピーを取っておく 必要があります。

    バナーおよびタイトル・バーに表示されるコンソール ID ストリングを設定するために使用されるキーは、XML < console-property/> エレメントで定義されます。 このエレメントの必須属性 id および value によって、 鍵の名前と値のペアが決まります。 以下の初期設定は、 consoleProperties.xml で提供されています。

    (一部の鍵は、印刷の目的で複数行に分割されています。)
    表 1. コンソール識別キー値。 以下の表は、コンソール　ID の鍵の値を説明しています。
    鍵 (ID) 初期設定 (値) 説明
    ISC.CONSOLE.ID ISC.CONSOLE.ID.CUSTOM 実際のコンソール ID ストリングを含む別の < console-property/> エレメントの ID 属性を指定します。
    ISC.CONSOLE.ID.MAXLEN 27 解決済みのコンソール ID ストリングの最大長を 指定します。 ストリングは、必要に応じてこの長さにまで切り捨てられます。
    ISC.CONSOLE.ID.CUSTOM 空ストリング バナーおよびタイトル・バーに表示される カスタム・ストリング。 
    ISC.CONSOLE.ID.DEPLOYER.
unique_suffix
    		 なし 「システム管理」の下にあるコンソール ID アプリケーションを使用して 選択できるカスタム・ストリングを指定します。 複数の < console-property/> 項目を指定することにより、
    ISC.CONSOLE.ID.DEPLOYER.
unique_suffix
    ID 属性。コンソール・ユーザーが選択できる複数の ID ストリングを指定できます。 このタイプのエントリーにはそれぞれ、他のエントリーと異なる独自の unique_suffix が 必要です。 同じ unique_suffix を持つエントリーが複数ある場合は、 このサフィックスを持つ最初の値だけがコンソール・ユーザーの選択リストに 表示されます。
    例:
    • 次の例では、デプロイヤーが、個々のホスト・コンソールが提供する 異なる部門を表すカスタム・ストリングを作成しようとしています。 コンソール・ユーザーは、各部門のコンソール・インターフェースに表示される ID を 選択できます。 この目標達成のために、デプロイヤーは、インストール・パッケージで 以下のカスタム鍵を提供します。 最初は、ISC.CONSOLE.ID.CUSTOM にはブランク値が 使用されています。
      
<?xml version="1.0" encoding="UTF-8"?>
<consoleproperties:ibm-portal-consoleproperties xmlns:consoleproperties=
    "http://www.ibm.com/websphere/appserver/schemas/6.0/ibm-portal-consoleproperties.xsd"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation=
    "http://www.ibm.com/websphere/appserver/schemas/6.0/ibm-portal-consoleproperties.xsd 
                                                        ibm-portal-consoleproperties.xsd">
     <consoleproperties:console-property id="ISC.CONSOLE.ID" 
                                                        value="ISC.CONSOLE.ID.CUSTOM"/>
     <consoleproperties:console-property id="ISC.CONSOLE.ID.MAXLEN" value="27"/>
     <consoleproperties:console-property id="ISC.CONSOLE.ID.CUSTOM"   value=""/>
     <consoleproperties:console-property 
                             id="ISC.CONSOLE.ID.DEPLOYER.sales"     value="Sales & Marketing"/>
     <consoleproperties:console-property 
                             id="ISC.CONSOLE.ID.DEPLOYER.finance"   value="Finance"/>
     <consoleproperties:console-property 
                             id="ISC.CONSOLE.ID.DEPLOYER.research"  value="Research & Development"/>
     <consoleproperties:console-property 
                             id="ISC.CONSOLE.ID.DEPLOYER.dist"      value="Distribution"/>
</consoleproperties:ibm-portal-consoleproperties>
    • 管理者は、バナーやタイトル・バーにホスト・コンソールに関する情報を 付加する必要があります。 これは、os.name Java システム・プロパティーと 共に PROCESSOR_ARCHITECTURE 環境変数 (Windows マシンで動作) を組み込むように、 ISC.CONSOLE.ID.CUSTOM 鍵を更新すれば実現できます。 これ以外の鍵は変更されません。
      
<?xml version="1.0" encoding="UTF-8"?>
<consoleproperties:ibm-portal-consoleproperties
  xmlns:consoleproperties=
        "http://www.ibm.com/websphere/appserver/schemas/6.0/ibm-portal-consoleproperties.xsd"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation=
        "http://www.ibm.com/websphere/appserver/schemas/6.0/ibm-portal-consoleproperties.xsd 
                                                            ibm-portal-consoleproperties.xsd">
     <consoleproperties:console-property id="ISC.CONSOLE.ID" 
                                                    value="ISC.CONSOLE.ID.CUSTOM"/>
     <consoleproperties:console-property id="ISC.CONSOLE.ID.MAXLEN" value="27"/>
     <consoleproperties:console-property id="ISC.CONSOLE.ID.CUSTOM"   
          value="Platform: %PROCESSOR_ARCHITECTURE% OS: %os.name%"/>
</consoleproperties:ibm-portal-consoleproperties>
      ISC.CONSOLE.ID.MAXLEN 鍵は、27 文字の最大表示文字数を 表すので、その結果生成されるストリング (実行時に解決される) は、 Windows 2003 Server 環境では次のようにバナーにレンダリングされます。

      プラットフォーム: x86 OS: Window...

注: コンソール ID ストリングが保存されると、設定がコンソール全体に適用されます。 つまり、管理エージェント構成では、 変更内容は、その実際の保存場所には関係なく、管理エージェントと そのすべての登録済みアプリケーション・サーバーに適用されます。