Console identity string

You can define a console identity string to be displayed in the console banner and in the browser's title bar. This string can be fixed or you can use a variable that is resolved at run time with a Java system property or environment variable.

A cadeia da identidade do console é renderizada diretamente no banner e na barra de título do navegador.
  • Identidade do console no banner
    A cadeia de identidade do console é exibida no banner do console após a saudação ao usuário do console, separada por um traço. Por exemplo, se a cadeia de identidade for definida como Jupiter e o usuário for registrado como consoleadmin, o banner exibirá a seguinte saudação.

    Bem-vindo ao Consoleadmin - Jupiter

    Na página de login, a identidade do console é exibida sem a saudação.

  • Identidade do console na barra de título do navegador
    A cadeia de identidade do console é exibida na barra de título após o nome da marca do console, separada por um espaço. Por exemplo, se a cadeia de identidade for definida como Saturn, a barra de título exibirá a seguinte informação.

    Integrated Solutions Console Saturn

After installation, there are two ways provided to customize the identity string.
  • Use Console Identity in the administrative console. To open, log in to the administrative console and click System administration > Console Identity.
  • Set the value for the string in an XML file, consoleProperties.xml, which is located in app_server_root/profiles/profile_name/config/cell/cell_name/applications/isclite.ear/deployments/isclite/isclite.war/WEB-INF. You should keep a backup copy of the most recent working consoleProperties.xml before making changes to this file.

    The keys that are used to set the console identity string to be displayed in the banner and title bar are defined in an XML <console-property/> element. The required attributes id and value for this element determine the key name and value pairs. The following initial settings are provided in consoleProperties.xml.

    (Some keys are split on multiple lines for printing purposes.)
    Table 1. Console identity key values. The following table describes the console identity key values.
    Key (id) Initial setting (value) Description
    ISC.CONSOLE.ID ISC.CONSOLE.ID.CUSTOM Specifies the ID attribute of another <console-property/> element that contains the actual console identity string
    ISC.CONSOLE.ID.MAXLEN 27 Specifies the maximum length of the resolved console identity string. The string will be truncated to this length if necessary.
    ISC.CONSOLE.ID.CUSTOM empty string A custom string to be displayed in the banner and title bar.
    ISC.CONSOLE.ID.DEPLOYER.
    unique_suffix
    None Specifies a custom string that can be selected using the Console Identity application under System Administration. By providing multiple <console-property/> entries with the
    ISC.CONSOLE.ID.DEPLOYER.
    unique_suffix
    id attribute, you can provide multiple identity strings for console users to select from. Each entry of this type should have a distinct unique_suffix from the other entries. If multiple entries are provided with the same unique_suffix, then only the first value with this suffix is displayed in the selection list for the console user.
    Examples:
    • In the following example, the deployer wants to create custom strings that indicate different departments served by their respective host consoles. Console users will be able to select which identity is displayed in each department's console interface. To achieve this goal, the deployer provides the following custom keys in the installation package. Out of the box, the blank value for ISC.CONSOLE.ID.CUSTOM is used.
      <?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>
    • The administrator wants to append information about the host console to the banner and title bar. This can be accomplished by updating the ISC.CONSOLE.ID.CUSTOM key to include the PROCESSOR_ARCHITECTURE environment variable (which works on Windows machines) along with the os.name Java system property. The other keys are not changed.
      <?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>
      Since the ISC.CONSOLE.ID.MAXLEN key indicates a maximum display of 27 characters, the resulting string, which is resolved at run time, is rendered in the banner as follows for a Windows 2003 Server environment.

      Platform: x86 OS: Window...

Note: After the console identity string is saved, the settings are applied across the console. For an administrative agent configuration, this means that the changes are applied to the administrative agent and all of its registered application servers, regardless of where the changes were actually saved.

Ícone que indica o tipo de tópico Tópico de Conceito



Ícone de registro de data e hora Última atualização: July 9, 2016 8:00
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=console_id
Nome do arquivo: console_id.html