Systemwalker Service Quality Coordinator User's Guide

1.2.2 Definition method

Definition procedure

By implementing the following definition procedure, the records that can be collected for management servers and managed servers are as follows:

• WL_JMX_JAVAEE_JVM

• WL_JMX_JAVAEE_JDBC_POOL

• WL_JMX_JAVAEE_THREAD_POOL

• WL_JMX_JAVAEE_TRANSACTION

Each item is collected per management server or managed server.

1. Modify the collection template (template.dat).

   Definition location

   [Windows]

   <Variable file storage directory>\control\template.dat

   [UNIX]

   /etc/opt/FJSVssqc/template.dat

   1. Modify the [WLJMXSNSR] section.

      Content to be modified

      Modify the lines indicated by a star (*) as required.

      #########################################
      # WebLogic Server JMX Sensor Information
      [WLJMXSNSR]
      DCAID="WLJMXSNSR"
      SERVERNAME=""   *Set the name of the management server or managed server.
      PORT=""         *Set the port number of the MBean server to be connected.
      USER=""         *Set the user name to be connected to the JMX service.
      PASSWORD=""     *Set the password of the user to be connected to the JMX service.
      JAVA_HOME=""    *Set the java bin directory to be used to connect to the JMX service.
      #########################################

      Setting values

      Key	Mandatory/optional	Format	Explanation	Default value
      DCAID	Mandatory	WLJMXSNSR	Fixed as "WLJMXSNSR".	WLJMXSNSR
      SERVERNAME	Mandatory	(*1)	Specify the name of the management server or managed server.	None
      PORT	Mandatory	Port number (1 to 65535)	Specify a port number for connecting to the MBean server using the RMI protocol (only supports JNDI format). (*2)	None
      USER	Mandatory	(*3)	Specify a user name for connecting to JMX services.	None
      PASSWORD	Mandatory	String created using genpwd (*3) (*4)	Encrypt and specify a password for connecting to JMX services.	None
      JAVA_HOME	Mandatory	Full path of JAVA bin directory(*5)	Specify a java path to be used for connecting to JMX services.	None

      *1: Refer to a WebLogic Server manual for details on names of management servers and managed servers.

      *2: Specify the port number that was specified when the JMX Agent (MBean server) was enabled.

      *3: Refer to a WebLogic Server manual for details on user names and passwords.

      *4: Refer to "A.6 genpwd (Password Encryption Command)" for information on how to use genpwd (password encryption command).

      *5: A path for JRockit JVM or Hotspot JVM can be specified. However, a JRockit JVM path cannot be specified when on the Solaris versions. Specify a Hotspot JVM path.

      Definition example

      :

      #########################################

      # WebLogic Server JMX Sensor

      [WLJMXSNSR]

      DCAID="WLJMXSNSR"

      SERVERNAME="AdminServer"

      PORT="7002"

      USER="weblogic"

      PASSWORD="XeFd21355Fxskgxoti1"

      JAVA_HOME="/root/Oracle/Middleware/bin"

      #########################################

      :

   2. Modify the [ATTR::AP] section.

      Content to be modified

      Add the section name "WLJMXSNSR" to the GROUP key.

      [Before modification]

      [ATTR::AP]

      GROUP="XXXX,YYYY"

      [After modification]

      [ATTR::AP]

      GROUP="XXXX,YYYY,WLJMXSNSR"

Point

If multiple instances, such as a management server and a managed server, are being monitored, perform the following definition:

1. Add a section and set parameters.

   • A section can be defined freely within a collection template, but define the section such that the section name is not duplicated within the collection template. An example of adding a section called "WLJMXSNSR2" is given below.

   • If multiple instances are being monitored, define the value of the "DCAID" key as "WLJMXSNSR".

   [Definition example]

   :

   ######################################

   # WebLogic Server JMX Sensor

   [WLJMXSNSR]

   DCAID="WLJMXSNSR"

   SERVERNAME="AdminServer"

   PORT="7002"

   USER="weblogic"

   PASSWORD="XeFd21355Fxskgxoti1"

   JAVA_HOME="/root/Oracle/Middleware/bin"

   [WLJMXSNSR2]

   DCAID="WLJMXSNSR"

   SERVERNAME="ManagedServer"

   PORT="7007"

   USER="webadmin"

   PASSWORD="T3Fxdghs15kgxotxcg"

   JAVA_HOME="/root/Oracle/Middleware/bin"

   :

2. Add the section name that was added in step 1 to the "GROUP" key of the "ATTR::AP" section. If definition was performed as in the example in step 1, modify it as shown below.

   [Before modification]

   [ATTR::AP]

   GROUP="XXXX,YYYY,WLJMXSNSR"

   [After modification]

   [ATTR::AP]

   GROUP="XXXX,YYYY,WLJMXSNSR,WLJMXSNSR2"