This vCenter Hyperic installer script uses the full qualifier. It can be used to install both the vCenter Hyperic server and the agent.

If you use a different mode, some of the prompts described in this procedure will not appear. Default values will be used instead for most configuration options.

If you are using an external PostgreSQL database, you must set it up before installing vCenter Hyperic server.

To configure the vCenter Hyperic server to use a keystore that you manage yourself for SSL communication, rather than Hyperic-generated keystores, set up a JKS format keystore for the vCenter Hyperic server on its host and import the SSL certificate for it. Make a note of the full path to the keystore, and its password. You will supply this information when you run the Hyperic installer (in -full mode).

The vCenter Hyperic server's keystore password and private key password must be the same, otherwise the vCenter Hyperic server's internal Tomcat-based server will be unable to start.

Define the server HQ_JAVA_HOME location.

vCenter Hyperic platform-specific server installers include a JRE, platform-independent installers do not. Depending on your environment and the installer you use, you may need to define the location of the JRE to ensure that the server can find the JRE to use. See Configuring JRE Locations for vCenter Hyperic Components.

Verify that the vCenter Hyperic database is available. During installation, the vCenter Hyperic server tests the database connection.


Create a directory for the vCenter Hyperic installation.

On Windows operating systems, the installation dialog assumes your vCenter Hyperic installation directory is c:\Program Files.

On UNIX-like operating systems, the installation dialog assumes your vCenter Hyperic installation directory is /home/hyperic.


Unpack the tarball or ZIP archive.

Operating System

Description and Command

UNIX-like OS

Use GNU Tar to unpack vCenter Hyperic tarballs.

tar zxvf hyperic-hq-installer-4.x.y-xxx.tgz

Windows OS

You must run the installer on a local drive.


Open a command shell where mode is one of the values in the table.

Operating System

Description and Command

UNIX-like OS

PathToInstaller/ -full

Windows OS

PathToInstaller\setup.bat -full

with the exception of upgrade .


Accept the VMware License agreement.


Follow the installer prompts, taking note of the following comments.



Choose which software to install 1: Hyperic HQ Server 2: Hyperic HQ Agent

To install both the server and the agent, type 1,2

HQ server installation path [default '.....']:

The account that you are running under must have write access the directory location.

Would you like us to use your own java keystore? [default '2'] 1: Yes 2: No

Type 1 to configure theserver to use a certificate you manage, rather than generate its own.

If you accept the default 2, a default keystore will be generated at ServerHome/conf/hyperic.keystore with the password hyperic.

Enter the base URL for the Hyperic server's web-based GUI [default...]

This value is used in alert notification emails. The value can be changed on the Administration page in the vCenter Hyperic portal.

Enter the fully qualified domain name of the SMTP server that Hyperic will use to send email messages [default FQDN.local]

If the installer does not find a local SMTP server, and you do not specify one, Hyperic cannot send alert notifications

What is the installation profile? default '1':]

If you are using the embedded PostgreSQL database, rather than an external database (required for production environments), select the small sizing profile.

Override the JDBC connection URL for the PostgreSQL database [default 'jdbc:postgresql://localhost:5432/HQ?protocolVersion=2']:

Correct the URL, if necessary.

Would you like to use an auto generated encryption key to encrypt the database password? [default '1']

If you accept the default, the installer will generate a key for encrypting the database password. Type 2 to supply the string yourself and, when prompted, type a string of at least 8 characters.

If the installer detects a database from a previous Hyperic installation, it will prompt you to:

1: Upgrade the HQ server database

2: Overwrite the HQ server database

Type 1 to preserve your existing vCenter Hyperic data. You also need to migrate your server and database to the new version.

Type 2 to erase all of the data in your vCenter Hyperic database.


Exit the installer.

The installer indicates that the installation was successful.The URL for the vCenter Hyperic portal and the default username and password appear.

After successfully installing vCenter Hyperic server, delete InstallerHome/logs/hq-install.log and hq-install.log.verbose, or the whole the exploded installer. This is necessary to delete sensitive data that is written to the installation log files.

Integrate vCenter Hyperic with your existing enterprise directory. The vCenter Hyperic server does not include a strength-of-password policy, or a lockout policy for failed login attempts.

Install the vCenter Hypericlicense.