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.

Procedure

  1. 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 those will run exactly same on korn shell with .ksh script.
  2. 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
    This figure shows InformixHQ help sample syntax.
  3. Use command InformixHQ startserver to start InformixHQ server with default file names. e.g- ./InformixHQ.sh startserver .
    infxhq_ser_lin_start_alt

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

  4. Use command InformixHQ startagent to start InformixHQ agent with default filenames. e.g- ./InformixHQ.sh startagent
    ifxhq_agent_lin_start_alt
    It will start an INFORMIXHQ Agent with default values for all the parameters including jar file name (informixhq-agent.jar) and properties filename (informixhq-agent.properties).
  5. List the Java processes running. It will list all the InformixHQ processes running with ProcessID e.g: ./InformixHQ.sh list.
    ifxhq_java_processing_lin_alt
  6. Additionally user can filter the list by passing search keyword to the list command. e.g. – InformixHQ.bat list prod .
    Note: It is recommended that properties file name should be unique which will help users to search specific processes.
    ifxhq_list_prod_alt
  7. 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 183230 .
    ifxhq_java_processing_lin_alt
  8. stopserver command will stop the server processes. e.g. - InformixHQ.bat stopserver .
    ifxhq_stop_lin_alt

    0. exit: It will exit from the command.

    1. Terminate: It will terminate server process.
    Note: Unless valid option is provided, it will not proceed further.
  9. stopagent command will stop the agent processes. e.g. - InformixHQ.bat stopagent .
    stopagent_alt

    0: exit - It will exit from the command.

    1: Terminate all - It will terminate all the agent processes.

    2: Terminate one by one - It will terminate agent processes one by one after user confirmation.

    Note: Unless valid option is provided, it will not proceed further.

    Sample screenshot for 'terminate all processes' :

    stopagent_sample1_alt

    Sample screenshot for 'one-by-one process termination' :

    stopagent_sample2_alt

    Additionally, user can search specific agent process using stopagent command. e.g. - stopagent prod .

    stopagent_sample3_alt

Example

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.