InformixHQ consists of three distinct pieces that come together to give you a comprehensive monitoring and administering experience for Informix.

• InformixHQ Server:
  • Jetty web server.
  • Provides a REST API for accessing Informix servers.
  • Monitors and administers many Informix database servers.
  • Connects directly to Informix databases servers.
  • Connects to the InformixHQ agents.
• InformixHQ Agent:
  • Lightweight monitoring agent based on Java.
  • Installed alongside each of your Informix database instances.
  • Only needs read access to database server.
  • Can perform native command execution to gather OS statistics as well as database statistics.
• InformixHQ User Interface:
  • Modernized web UI for monitoring, managing, visualizing, and assessing your Informix database servers.

This section lists the steps to start the InformixHQ Server.

1. As informix user, make a copy of the example configuration file:
   Copy

   cp $INFORMIXDIR/hq/informixhq-server-example.properties $INFORMIXDIR/hq/informixhq-server.properties

2. Edit the configuration file and set the password for the admin user in the initialAdminPassword parameter:

   initialAdminPassword=Admin123
   

   Password

   Password must be at least 8 characters and must contain at least one lowercase character, one uppercase character, and one number.

3. Start the InformixHQ server using the following command:
   Copy

   cd $INFORMIXDIR/hq
   java -jar informixhq-server.jar informixhq-server.properties

   Java 1.8

   It may be necessary to install the package java 1.8 or later in your Linux operating system. You can use the common package managers:

   Copy

   yum install java-1.8.0-openjdk

4. Using a web browser, go to the InformixHQ UI at http://localhost:8080/ and login with the user admin and the password specified in your configuration file.
5. Once logged in, click Add Server to add an Informix server that you want to monitor.

To take full advantage of the InformixHQ features, we must have an InformixHQ agent running for each Informix database server that we want to monitor using the informixHQ utility. While the InformixHQ agent is not required to view information about your database server in the InformixHQ UI, the agent is required if you want to gather monitoring data and configure alerts for that server.

There are two options for starting the InformixHQ agent. You can use the InformixHQ UI to automatically deploy and start the InformixHQ agent or you can manually start the InformixHQ agent on the command line.

1. Define the Informix database server that the agent will be monitoring in InformixHQ server.
2. Navigate to the Informix database server’s Setup > Agent page, configure agent deployment and click the Deploy agent button.
   • Define a repository database where to store the gather data.
   • Define the directory to deploy the agent files to and remote user which will own and run the agent.
   

1. Define the Informix database server that the agent will be monitoring in InformixHQ server.
2. Navigate to the Informix database server’s Setup > Agent page, define a repository database and click the Save button.
3. As informix user, make a copy of the example configuration file:
   Copy

   cp $INFORMIXDIR/hq/informixhq-agent-example.properties $INFORMIXDIR/hq/informixhq-agent.properties

4. Edit the configuration file and set the parameters shown below:

   #The ID of the Informix Server defined in InformixHQ
   informixServer.id=1
   
   #host and port of the InformixHQ server
   server.host=localhost
   server.port=8080
   

5. Start the InformixHQ agent using the following command:
   Copy

   cd $INFORMIXDIR/hq
   java -jar informixhq-agent.jar informixhq-agent.properties