Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP Global Workload Manager Version 4.1 User's Guide > Chapter 5 Additional Configuration and Administration Tasks

Setting gWLM Properties

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

gWLM provides two properties files that allow you to control various gWLM behaviors. One file is for the CMS daemon or service, and the other is for use on all the managed nodes. Read the files for information on the behaviors they control.

CMS Properties

The CMS properties are in /etc/opt/gwlm/conf/gwlmcms.properties on HP-UX and in C:\Program Files\HP\Virtual Server Environment\conf\gwlmcms.properties on Windows. (The given Windows path is the default; however, a different path may have been selected at installation.)

NOTE: Some values are read by gWLM only when a daemon or service is started; while other values are read when an SRD is deployed. Refer to the file for information on when individual properties are read.

Restarting gwlmcmsd temporarily disables HP Virtualization Manager and HP Capacity Advisor.

The gwlmcms.properties file is shown below.

#
# (C) Copyright 2004-2008 Hewlett-Packard Development Company, L.P.
#
# $Date: 2008/12/02 20:17:18 $
# $Revision: 1.1 $
#
# Contents:
#	This file contains the default configuration values for the
#	Global Workload Manager CMS.
#
#	You must restart gwlmcmsd for changes made to this file
#	to take effect--unless otherwise noted.
#

#
# Set FileHandler log level for the following log files:
#       /var/opt/gwlm/gwlmcmsd.log.0
#       /var/opt/gwlm/gwlmcommand.log.0
#       /var/opt/gwlm/gwlm.log.0
#       /var/opt/vse/logs/gwlminitconfig.log.0
# Valid levels, from most severe to least, are:
#       SEVERE
#       WARNING
#       INFO
#       CONFIG
#       FINE
#       FINER
#       FINEST
# When you set the level, you will see messages only from that level and
# the levels that are more severe. So, the SEVERE level produces the fewest
# messages, while the FINEST level includes messages from all seven levels.
#
com.hp.gwlm.util.Log.logLevel = INFO

#
# Specify the size (in MB) and number of files to use  
# for logging. For a single file of unlimited size, set
# logFileSize to negative one (logFileSize=-1).
# Otherwise, total log file size is
#    logFileSize * logNFiles
#
com.hp.gwlm.util.Log.logFileSize = 20
com.hp.gwlm.util.Log.logNFiles = 3

#
# Support for automatic database statistics gathering.  These properties
# control how often row-level statistics are gathered from the database in
# order to optimize performance.
#
#   com.hp.gwlm.cms.db.analyze.time:
#       Frequency, in minutes, in which statistics are gathered.  The
#       default is to attempt to gather database statistics every 60
#       minutes.  When the analysis runs, statistics will only be gathered
#       if a certain number of transactions  have been processed (which is
#       configured in the property below).
#
#   com.hp.gwlm.cms.db.analyze.limit:
#       Number of consecutive transactions that must take place before a
#       database analysis is performed.
#
com.hp.gwlm.cms.db.analyze.time  = 60
com.hp.gwlm.cms.db.analyze.limit = 50

#
# Support for the database cache on the CMS.
#
#   cachesize:
#	The number of historical configurations to cache in memory.
#	A larger historical configuration cache reduces time spent
#	in database lookups.  The valid range is 1-1000.
#
com.hp.gwlm.cms.cachesize = 100

#
# Support for local data caching on a remote node for report generation.
# These properties are defined on the CMS but are pushed out to the remote
# node managers during deployment of an SRD.  The cached objects on the
# agent consume an amount of memory approximated by:
#
#    Memory = 5000 * workloads * cachesize * (60 / resource_domain_interval)
#
# bytes of memory.  For example, if there are 4 workloads deployed with a
# 15 second interval and a cachesize of 20 minutes, the agent will need:
#
#    Memory = 5000 * 4 * 20 * (60 / 15) ~ 2.5 MB.
#
#   cachesize:
#       The number of minutes of real-time data to maintain on the remote
#	node for future CMS access.  This value must be at least three
#	times the 'samples' value specified below.  The default value is
#       20 minutes.
#
#   samples:
#	The number of minutes of real-time data used to aggregate into a
#	historical data point. The default is to aggregate the data into
#	5-minute averages.
#
com.hp.gwlm.node.cachesize = 20
com.hp.gwlm.node.samples   = 5

#
# Support for real-time graphing properties.
#
#   viewport:
#       The size of the displayed real-time graph (in minutes).
#
#   refresh:
#       The refresh rate of the real-time graphs and tables (in seconds).
#
com.hp.gwlm.ui.monitor.viewport = 20
com.hp.gwlm.ui.monitor.refresh  = 15

#
# Support for securing Oracle communication.
#
#  com.hp.gwlm.jdbc.oracle.secure:
# 	Whether communication with Oracle server is secure or not. Possible
#	values are 'on' and 'off'. Default is off.
#
#  oracle.net.encryption_types_client:
#	Secure communication encryption type. Possible values are RC4_256,
#	RC4_128, RC4_56, RC4_40, 3DES112, 3DES168. See Oracle documentation
#	for details.  
#
#  oracle.net.crypto_checksum_types_client:
#  	Encryption type for Oracle secure communication integrity checking.
#
#  Make sure that the parameter values specified here match those on
#  the Oracle server.
#
com.hp.gwlm.jdbc.oracle.secure = off
oracle.net.encryption_types_client = 3DES112
oracle.net.crypto_checksum_types_client = MD5

Agent Properties

The agent properties are in /etc/opt/gwlm/conf/gwlmagent.properties on HP-UX and in C:\Program Files\HP\Virtual Server Environment\conf\gwlmagent.properties on Windows. (The given Windows path is the default; however, a different path may have been selected at installation.)

NOTE: You must restart the gwlmagent daemon on each managed node where you have modified the properties file for the changes to the file to take effect.

The gwlmagent.properties file is shown below.

#
# (C) Copyright 2004-2007 Hewlett-Packard Development Company, L.P.
#
# $Date: 2008/12/02 20:17:18 $
# $Revision: 1.1 $
#
# Contents:
#	This file contains the default configuration values for the
#	Global Workload Manager Agent on a given managed node. The
#	agent on each managed node uses the default values unless you
#	edit that node's gwlmagent.properties file.
#
#	You must restart gwlmagent for changes made to this file to
#	take effect.
#

#
# Set FileHandler /var/opt/gwlm/gwlmagent.log.0 log level.
# Valid levels, from most severe to least, are:
#	SEVERE
#	WARNING
#	INFO
#	CONFIG
#	FINE
#	FINER
#	FINEST
# When you set the level, you will see messages only from that level and
# the levels that are more severe. So, the SEVERE level produces the fewest
# messages, while the FINEST level includes messages from all seven levels.
#
com.hp.gwlm.util.Log.logLevel = INFO

#
# Specify the size (in MB) and number of files to use  
# for logging. For a single file of unlimited size, set
# logFileSize to negative one (logFileSize=-1).
# Otherwise, total log file size is
#    logFileSize * logNFiles
#
com.hp.gwlm.util.Log.logFileSize = 20
com.hp.gwlm.util.Log.logNFiles = 3

#
# Set the number of seconds for the high availability (HA) minimum
# timeout. Communication is considered lost on a managed node
# once the timeout period has elapsed.
#
# By default, communication is not considered lost until 10 allocation
# intervals have elapsed without communication. The default value of the
# property (60) is used only when the allocation interval is less than 6
# seconds.  
#
com.hp.gwlm.node.HA.minimumTimeout = 60

#
# Enable/disable use of Instant Capacity (iCAP) to simulate movement of
# cores across nPartitions. To use iCAP, you must enable this property on 
# each managed nPartition where you want to take advantage of iCAP. Also, 
# each nPartition must meet the requirements outlined in the online help 
# topic "Getting the most out of gWLM" as well as in the section "USING 
# NPARS AS COMPARTMENTS IN AN SRD" in the gwlmxml(4) man page on HP-UX or 
# the gwlmxml(5) man page on Linux.
#
com.hp.gwlm.platform.icap.manageWithIcap = on

#
# Set the minimum number of Temporary Instant Capacity (TiCAP) minutes
# that must be available for TiCAP activation.  gWLM will stop using
# TiCAP when the available balance goes below this threshold.  The
# same value should be set on all agents managing the SRD.  To use
# TiCAP, it must be available on the complex and enabled at the policy
# level or the SRD level.
#
com.hp.gwlm.node.ticap.minimumBalance = 30

Communications Ports

gWLM uses the following ports for communications:

Managed nodes: 9617

CMS: 9618

If you need to change these ports, add the following lines:

com.hp.gwlm.cms.port = portX

com.hp.gwlm.node.port = portY

to both properties files:

  • gwlmcms.properties

    On HP-UX, this file is in /etc/opt/gwlm/conf/. On Windows, it is in C:\Program Files\HP\Virtual Server Environment\conf\. (The given Windows path is the default; however, a different path may have been selected at installation.)

  • /etc/opt/gwlm/conf/gwlmagent.properties

The portX and portY values cannot be the same value.

The com.hp.gwlm.cms.port property must have the same portX value in all the properties files—across all managed nodes and on the CMS. Similarly, the com.hp.gwlm.node.port property must have the same portY value in all the properties files—across all managed nodes and on the CMS.

You must restart gwlmcmsd and gwlmagent for the changes to take effect. If you are using gWLM through HP SIM, you must also restart SIM. (On HP-UX, restart SIM daemons using /opt/mx/bin/mxstop and mxstart. On Windows, restart the HP Systems Insight Manager service.)

NOTE: Restarting gwlmcmsd temporarily disables HP Virtualization Manager and HP Capacity Advisor.
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2004-2009 Hewlett-Packard Development Company, L.P.