ZabbixW32 is ZABBIX agent for Win32 systems. It will work on Windows NT 4.0,
Windows 2000, and Windows XP. ZabbixW32 doesn't work on other Windows platforms.
Installation
Installation is very simple and includes 3 steps:
- Unpack ZabbixW32.exe
- Create configuration file c:/zabbix_agentd.conf (it has the same syntax as UNIX agent).
- Run this command to install ZABBIX as a service.
ZabbixW32.exe install
If you wish to use configuration file other that c:\zabbix_agentd.conf, you should use the following command for service installation:
ZabbixW32.exe --config <your_configuration_file> install
Full path to configuration file should be specified.
Now you can use Control Panel to start agent's service or run:
ZabbixW32.exe start
Note: Windows NT 4.0 note. ZabbixW32 uses PDH (Performance Data Helper) API to gather various system information, so PDH.DLL is needed. This DLL is not supplied with Windows NT 4.0, so you need to download and install it by yourself. Microsoft Knowledge Base article number 284996 describes this in detail and contains a download link. You can find this article at
http://support.microsoft.com/default.aspx?scid=kb;en-us;284996
Command line syntax
Usage:
zabbixw32 [options] [command]
Where possible commands are:
- check-config
Check configuration file and exit
- standalone
Run in standalone mode
- start
Start Zabbix Win32 Agent service
- stop
Stop Zabbix Win32 Agent service
- install
Install Zabbix Win32 Agent as service
- remove
Remove previously installed Zabbix Win32 Agent service
- install-events
Install Zabbix Win32 Agent as event source for Event Log. This is done automatically when service is being installed.
- remove-events
Remove Zabbix Win32 Agent event source. This is done automatically when service is being removed.
- help
Display help information
- version
Display version information
And possible options are:
The file contains configuration parameters for ZabbixW32. Supported parameters:
| Parameter |
Mandatory |
Default value |
Description |
| Alias | No | - | Sets the alias for parameter. It can be useful to substitute long and complex parameter name with a smaller and simpler one. For example, if you wish to retrieve paging file usage in percents from the server, you may use parameter "perf_counter[\Paging File(_Total)\% Usage]", or you may define an alias by adding the following line to configuration file:
Alias = pg_usage:perf_counter[\Paging File(_Total)\% Usage]
After that you can use parameter name "pg_usage" to retrieve the same information. You can specify as many "Alias" records as you wish. Please note that aliases cannot be used for parameters defined in "PerfCounter" configuration file records. |
| DebugLevel | No | - | The parameter has no effect. |
| ListenPort | No | 10000 | Port number to listen |
| LogFile | No | - | Name of log file. If not set, syslog is used. |
| LogUnresolvedSymbols | No | - | Controls logging of unresolved symbols during agent startup. Values can be strings "yes" or "no" (without quotes). |
| MaxCollectorProcessingTime | No | 100 | Sets maximum acceptable processing time of one data sample by collector thread (in milliseconds). If processing time will exceed specified value, warning message will be written to the log file. |
| NoTimeWait | No | - | The parameter has no effect. |
| PerfCounter | No | - | <parameter_name>,"<perf_counter_path>",<period>
Defines new parameter <parameter_name> which is an average value for system performance counter <perf_counter_path> for the specified time
period <period> (in seconds).
For example, if you wish to receive average number of processor interrupts per second for last minute, you can define new parameter "interrupts" as following:
PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60
Please note double quotes around performance counter path. Samples for calculating average value will be taken every second.
|
| PidFile | No | - | The parameter has no effect. |
| Server | Yes | - | Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected. |
| StartAgents | No | - | The parameter has no effect. |
| UserParameter | No | - | User-defined parameter to monitor. There can be several user-defined parameters. Value has form <key>,<shell command>. Do not use spaces around pipe ('|') characters!
Example:UserParameter=test,echo 1 |
|