Starting the InformixHQ Server and the Agent on Linux/AIX

This topic provides a brief tutorial about the script used to get started with InformixHQ Server and Agent on Linux/AIX.

Locate your informixHQ.sh for Linux and InformixHQ.ksh for AIX (default path is ${INFORMIXDIR}/hq).
Note: Following examples are shown on bash shell, however it will run exactly same on korn shell with .ksh script.
Use command InformixHQ help to see sample syntax: e.g- InformixHQ.sh help
Tip: User can only run InformixHQ.sh for help menu

Figure 1. InformixHQ help
Use command to start InformixHQ server with default file names. e.g- ./InformixHQ.sh startserver

It will start INFORMIXHQ Server with default values for all the parameters including jar file name (informixhq-server.jar) and properties filename (informixhq-server.properties).
Use command to start InformixHQ agent with default filenames. e.g- ./InformixHQ.sh starttagent
It will start a INFORMIXHQ Agent with default values for all the parameters including jar file name (informixhq-agent.jar) and properties filename (informixhq-agent.properties).
List the Java processes running. It will list all the InformixHQ processes running with ProcessID e.g: ./InformixHQ.sh list.
Stop the InformixHQ server or agent by providing processID to stop command. It will stop InformixHQ process with provided processID. e.g: ./InformixHQ.sh stop 111307
User can use different properties filenames (with appropriate informixServer.id for different servers) to run agents for different instances as follows. This will help identifying which agent is running for which instance:

User can use different properties filenames (with appropriate informixServer.id for different servers) to run agents for different instances as follows

Following are sample commands where user can provide custom values (similar commands will work with agent)

optional jar and properties filename to start InformixHQ server:

./InformixHQ.sh startserver jarfile=informixhq-myinstance1.jar propfile=hqserver.properties

Use encoding and JVM value:

./InformixHQ.sh startserver Encoding=utf-8 JVMMemx=1004m

Use all input:

InformixHQ.bat startserver Encoding=utf-8 JVMMemx=1004m jarfile=informixhq-server.jar propfile=hqserver.properties

Exception Reporting

If options are not provided correctly then script will report error as follows

If jarfile/propfile option is not specified
filename is not specified with jarfile/propfile option
incorrect filename provided
If specified or default files are not found also if custom filename is specified and file is not found in the folder, it will inform accordingly
If IDS Server is not reachable by Agent. This is not related to script, however sometimes you might get exception if Server or Agent Java process encountered error. While starting agent process, if agent is not able to connect to IDS server specified in HQ then it might show error on screen as follows with message. Socket connection to server (Server IP:Port) failed. Check your server is reachable from this client on the host:port specified.

In such case, ensure, server added in InformixHQ server is configured correctly and is reachable and online.