Skip to end of metadata
Go to start of metadata

About HQ Server Configuration

Configuration Settings in server.conf

server.conf contains the configuration settings that HQ Server requires to start up and get ready for work. For instance, server.conf has properties that tell the server how to connect to the database and where to listen for agent and web application communications.

When you install HQ Server, the selections you can make - port selections, use of plaintext or SSL communications, and so on - correspond to properties in server.conf. The configuration settings you supply during installation are persisted in server.conf in the HQ Server's /conf directory.

In addition to the properties that reflect installation choices, server.conf contains properties with default values that you can modify, after installation, based on the your environment and the size of your HQ deployment. For example, there are properties in server.conf that set defaults for database and JMS configuration options.

Each time HQ Server starts up, it reads the values of the properties in server.conf.

Note: HQ Server supports some properties that do not appear in server.conf unless you add them explicitly.

After you change the values of properties in server.conf or add new properties to the file, you must restart the server for the new settings to take effect.

Configuration Settings in the Database

Some of the configuration data that governs HQ Server behavior is stored in the HQ Server database. For example, the data HQ Server needs to contact an HQ Agent is stored in in the HQ Database. For information about how HQ Server obtains HQ Agent address information, see Agent Server Communications Diagram.

Server Property Definitions

hq-engine.jnp.port

Description

The JNDI listen port

Default

2099


hq-engine.server.port

Description

The JRMP listen port

Default

9093


server.database

Description

The kind of database the HQ server will use. The HQ server adjusts its interactions with the database according to the value of this property.

Valid values are:

  • PostgreSQL
  • Oracle8
  • Oracle9i

Default

PostgreSQL


server.database-blockingtimeout

Description

Maximum time in milliseconds to wait for a connection from the pool.

Default

10000


server.database-driver

Description

The JDBC driver to use. You shouldn't change this unless you really know what you're doing.

Default

org.postgresql.Driver


server.database-maxpoolsize

Description

The maximum number of database connections to keep in the pool. This must be set lower than the total number of connections allowed to the backend database.

Default

90


server.database-minpoolsize

Description

The minimum number of database connections to keep in the pool

Default

5


server.database-password

Description

The database user's password.

Default

hqadmin

Known problem in HQ 4.2 (HQ-2151) with changing the database user username or password.
In HQ 4.2, changing either of the following server properties in server.conf causes the HQ Server to fail to start and to write "Access Denied" errors to server.log:
  • server.database-user
  • server.database-password

To avoid this problem, in addition to changing the property value in server.conf, set the corresponding property in hq-engine/server/default/deploy/hq.ear/META-INF/hibernate.cfg.xml to the new value. Those properties are:

  • hibernate.connection.username
  • hibernate.connection.password

server.database-url

Description

The JDBC URL to connect to.

Default

jdbc:postgresql://127.0.0.1:9432/hqdb?protocolVersion=2


server.database-user

Description

The database user to connect as.

Default

hqadmin

Known problem in HQ 4.2 (HQ-2151) with changing the database user username or password.
In HQ 4.2, changing either of the following server properties in server.conf causes the HQ Server to fail to start and to write "Access Denied" errors to server.log:
  • server.database-user
  • server.database-password

To avoid this problem, in addition to changing the property value in server.conf, set the corresponding property in hq-engine/server/default/deploy/hq.ear/META-INF/hibernate.cfg.xml to the new value. Those properties are:

  • hibernate.connection.username
  • hibernate.connection.password

server.java.opts

Description

Additional options to pass to Java.

Default

-XX:MaxPermSize=192m -Xmx512m -Xms512m -XX:+HeapDumpOnOutOfMemoryError

For information about changing heap size, see Increasing Java Heap and Changing GC Settings.

Setting Hyperic Server Timzone
You can set the time zone for the JVM in which Hyperic Server runs by adding -Duser.timezone=Area/Location to server.java.opts, where:
  • Area — Is a continent or ocean, for example America}
  • Location — Is a city, with underbar (_) for embedded spaces, for example New_York.

For information about using different Java options when starting HQ Server, see Increasing Java Heap and Changing GC Settings.

For information about how to change Java heap settings on Windows, see Changing Heap Size on Windows.


server.jms.highmemory

Description

The high memory mark for the JMS queue.

Default

350


server.jms.maxmemory

Description

The max memory mark for the JMS queue.

Default

400


server.mail.host

Description

The IP or hostname of the SMTP server that the HQ server will use for sending alerts and other HQ-related emails. Most UNIX platforms have a local SMTP server, in which case localhost or 127.0.0.1 can be used here.

Default

127.0.0.1


server.quartzDelegate

Description

The database-specific plugin class used by HQ's internal scheduler service.

If you use Oracle as your HQ database, specify:

org.quartz.impl.jdbcjobstore.oracle.OracleDelegate

If you use the either HQ's internal PostgreSQL database or an external PostgreSQL database as your HQ database, specify:

org.quartz.impl.jdbcjobstore.PostgreSQLDelegate

Default

org.quartz.impl.jdbcjobstore.PostgreSQLDelegate


server.webapp.port

Description

The HTTP listen port. This is for the HQ web-based GUI and also HQ agents that communicate with the HQ server in non-secure mode

Default

7080


server.webapp.secure.port

Description

The HTTPS listen port. This is for the HQ web-based GUI and also HQ agents that communicate with the HQ server in secure mode

Default

7443

Clustering Properties in HQ Enterprise

For information about properties for configuring an HQ Server cluster, see Clustering HQ Servers for Failover.

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Sep 10, 2012

    HI,

    Their is no file as hibernate.cfg.xml in Hq-server path and server.conf file contains encrypted password.
    Can you please suggest me how to change db password in hyperic 4.6. Please reply asap.(URGENT)

    Regards
    Mahaveer