HP 3PAR Policy Server Administrator's Guide (QR483-96003, December 2012)

HP 3PAR Policy Server 7-2
Changes That Require Configuration File Edits
Why would you want to edit the Policy Server configuration files? After running Policy Server for a while,
you may want to change how long remote sessions are displayed in the Remote Sessions table or the
frequency of automatic database backups. Alternatively, you may be seeing too many audit messages from
the Agents for SetDataItem actions and you want to filter out audit messages for certain data items. To make
these types of changes, edit the configuration file for Policy Server, called PolicyManager.properties.
Suppose your IT department moves - or completely changes - your e-mail server or external directory server.
Such changes mean that you need to change settings in the configuration files for Policy Server and for
Tomcat.
If you move the Policy Server machine, you need to edit the Policy Server configuration file. Moving the
Policy Server machine may also require that you reconfigure the Policy Server IP address and port for the
Policy Agents running on assets managed by Policy Server. You can perform this second task using either
Agent Builder or Agent Deployment Utility .
If you decide to switch to using SSL, you need to create the hostname.jks file for the machine, using the
OpenSSL utility. The hostname.jks file contains the certificate and private key for the machine. This change
requires changes to configuration files for Policy Server and Tomcat. This chapter does NOT explain the
changes needed for Tomcat. For that information, refer to the Tomcat document, SSL HOWTO, at
http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html.
If you could not use the default port for the OpenDS directory server (389), you must edit the OpenDS
configuration file. Refer to the section, "Editing the OpenDS Configuration File."
In general, the configuration files are comprised of name-value pairs (for example
server.database=HP3PS, where server.database is the name and HP3PS is the value). Do not change the
names. If you want to change the values, make sure the values you apply are supported. In addition, make
sure you use the same case, as the files are case-sensitive.
Note: You can change some user information stored in an External Directory Server from the Users tab
of the Policy Server application. When you attempt to make changes, you must log in with an authorized
user name and password for the directory server. If you delete a user using the Users tab, it will also be
deleted from the External Directory Server.
The rest of this chapter explains how to find the configuration files for Policy Server and Tomcat and
provides tables that list and describe the properties they contain.