ZendHQ Service Configuration

You find the configuration for the ZendHQ daemon in the file /opt/zend/zendphp/etc/zendhqd.ini.

Configuring zendhqd

Below are the primary configuration values you may need to change:

  • zendhqd.daemon_uri:
    Change this value if you need the daemon to listen for activity from ZendPHP instances on a different IP address or port. Most commonly, particularly in Docker, you will set this to tcp://0.0.0.0:10090, indicating you want to listen on any available IP address via port 10090.
  • zendhqd.websocket.interface:
    Change this value if you need the websocket, used for the ZendHQ User Interface and the websocket API, to listen on a different IP address or port. Most commonly, particularly in Docker, you will set this to :10091, indicating you want to listen on any available IP address via port 10091.
  • zendhqd.monitor.aggregrate_events:
    Enable this (set to "1") if you want the event log to report an aggregate count for a triggered event type. When you do, the event log will not show multiple entries for events of the same type and severity; when opening the event callout, it includes information on the first and last times the event was triggered, and the rest of the details are derived from the most recent event.

Do not configure the zendhqd.websocket.interface setting to listen on all IP addresses unless the ZendHQ Daemon is behind a secure firewall. Not specifying an IP address poses a security risk.

For these changes to take effect, restart the zendhqd daemon.

Restarting zendhqd

After making configuration changes, you need to restart the ZendHQ daemon.

For Linux:

$ sudo systemctl restart zendhqd

For IBM i, use either the Green Screen Menu or the Control Script:

On the Green Screen, enter GO ZENDPHP/ZPMNUHQ options 3/4/5:

  • 3. Start ZendHQ Daemon
  • 4. Stop ZendHQ Daemon
  • 5. Reload ZendHQ Daemon

Using the control script, execute:

$ /opt/zend/zendphp/bin/zendhqd_ctl.sh restart