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

About this task

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 vRealize Hyperic server.

  • To configure the vRealize 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 vRealize 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 vRealize Hyperic server's keystore password and private key password must be the same, otherwise the vRealize Hyperic server's internal Tomcat-based server will be unable to start.

  • Define the server HQ_JAVA_HOME location.

    vRealize 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 vRealize Hyperic Components.

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


  1. Create a directory for the vRealize Hyperic installation.

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

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

  2. Unpack the tarball or ZIP archive.

    Operating System

    Description and Command

    UNIX-like OS

    Use GNU Tar to unpack vRealize Hyperic tarballs.

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

    Windows OS

    You must run the installer on a local drive.

  3. 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 .

  4. Accept the VMware License agreement.
  5. 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 vRealize 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 vRealize 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 vRealize Hyperic database.

  6. Exit the installer.


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

What to do next

  • After successfully installing vRealize 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 vRealize Hyperic with your existing enterprise directory. The vRealize Hyperic server does not include a strength-of-password policy, or a lockout policy for failed login attempts.

  • Install the vRealize Hypericlicense.