Module Loading

  1. Select "Load Module..." from the Module Menu of the Host Details window (also available from the host's Pop-up Menu). (See Figure 1)
  1. Select "PrimeAlert for Sun Application Server v2" from the Load Module pick list and click on the OK button. This will launch the Module Loader containing the following fields:

Figure 1 - PrimeAlert for Sun Application Server v2 Module Parameters

Field

Description

Instance Enter a unique alphanumeric short description used to differentiate one instance of the module loaded into an agent from another. The description you enter here is appended to the module file name.

For example, if primary is entered, then primary is appended to "HALSunAppServerJMX" to create the following unique instance name:

HALSunAppServerJMX+primary

More than one instance can be loaded into the same agent to monitor multiple Application Server domains.
Description Enter a short formal description of the module. This description is used to identify the module in the console window.

The short description you enter in this field will be appended to the Module Name.

For example, if you enter Test Domain, the instance will be identified in the console window as:

PrimeAlert for Sun Application Server v2 [Test Domain]

Installation Directory Enter the directory that you installed Application Server into.
Domain Name Enter the name of the domain which is associated with the DAS JMX Port specified below.
Administration Host Enter the hostname where the domain resides. This is the same as the Admin Console host.
DAS host Enter the hostname of the Domain Administration Server. Typically, this is the same as the Administration Host.
DAS JMX Port Enter the port for the JMX Server for the Domain Administration Server.

NOTE: Ensure that the Port specified here is the one associated with the Domain Name specied above. If this is not the domain's JMX port, the module will not be able to properly monitor the domain specified.
See "Determining JMX Port Number here: Application Server Configuration

DAS Admin User Enter the administrator name of the Domain Administration Server. This is the username used to login the Admin Console.
DAS Admin Password Enter the administrator password of the Domain Administration Server. This is the password used to login the Admin Console.
Monitored Server Instances

This is a space delimited set of regular expressions that lists the server instances to be monitored. Any server instance that resides on the agent host and match one of the specified regular expressions will be monitored.

Regular expression:

  • ^ - match start of string
  • $ - match end of string
  • . - match any character
  • ? - match zero or one of the previous character
  • + - match one or more of the previous character
  • * - match zero or more of the previous character
  • (abc) - treat the sequence abc as a character
  • [abc] - match any of a, b, c
  • [^ab] - match any character except a, b
  • (ab)|(cd) - match ab or cd

Examples:

  • Monitor everything:
    .*
  • Monitor all instances starting with "Test" or "test":
    ^[Tt]est.*
  • Monitor all instances except the ones starting with "Test", but monitor "Test4":
    [^(Test)].*  Test4
SSL Enabled Select this checkbox if SSL support has been enabled for the JMX Connector.
Trust Store File If the SSL Enabled checkbox has been selected then you may optionally specify the fullpath to a trust store file. If the Trust Store File has been specified, then only the certificates listed in the Trust Store File will be trusted by the module. Otherwise, all certificates from the Application Server will be trusted.
Trust Store Password Specify the password for the Trust Store File. For more details on how to configure the Trust Store File and Trust Store Password, refer to the administration guide for your version of Sun Application Server.

For example, the Working with Certificates and SSL section of the Sun Java System Application Server Enterprise Edition 8.1 2005Q1 Administration Guide contains the required information.

The default value for this parameter is "" (empty string).

  1. Click on the OK button to load the module.