Starting the InformixHQ Server and the Agent on Windows

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

Procedure

  1. Locate your informixHQ.bat for Windows (default path is %INFORMIXDIR%/hq).
  2. Use command InformixHQ help to see sample syntax: e.g- InformixHQ.bat help.
    Tip: User can only run InformixHQ.bat for help menu
    Figure 1: InformixHQ help
    This figure shows InformixHQ help sample syntax.
  3. Use command to start InformixHQ server with default file names. e.g- InformixHQ.bat startserver .
    hq_server_start1_alt

    It will start a 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 to start InformixHQ agent with default filenames. e.g- InformixHQ.bat startagent.
    hq_start_agent

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

  5. List the Java processes running. It will list all the InformixHQ processes running with ProcessID e.g. – InformixHQ.bat list .
    hq_java_processing_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.
    hq_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.bat stop 142952.
    hq_stop_servagent_alt
  8. stopserver command will stop the server processes. e.g. - InformixHQ.bat stopserver .
    ifxhq_stop_serv_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 .
    ifxhq_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' :

    ifxhq_stopagent_1_alt

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

    ifxhq_stopagent_2_alt

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

    ifxhq_stopagent_3_alt

Example

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.bat startserver jarfile=informixhq-myinstance1.jar propfile=hqserver.properties
    ifxhq_opt1_alt
  • Use encoding and JVM value:
    InformixHQ startserver Encoding=utf-8 JVMMemx=1004m
    ifxhq_opt2_alt
  • Use all input:
    InformixHQ.bat startserver Encoding=utf-8 JVMMemx=1004m jarfile=informixhq-server.jar propfile=hqserver.properties
    ifxhq_opt3_alt