xref: /PHP-7.3/ext/snmp/tests/README (revision 3362620b)
1SNMP Tests
2----------
3
4To enable these tests, you must have :
5- PHP compiled with SNMP (--with-snmp)
6- an SNMP server running.
7
8
9** How to test **
10You need to give credentials with environment vars if default ones are not
11sutable (see snmp_include.inc for more info):
12SNMP_HOSTNAME : IPv4 of remote SNMP agent
13SNMP_HOSTNAME : IPv6 or remote SNMP agent
14SNMP_PORT : SNMP port for queries
15SNMP_COMMUNITY : community name
16SNMP_COMMUNITY_WRITE : community used for write tests (snmpset()).
17SNMP_MIBDIR : Directory containing MIBS
18
19To run test suite you may use this command (presuming that you pwd is where
20this README file is located):
21> make -C ../../.. test TESTS="`cd ../../..; /bin/ls -1 ext/snmp/tests/*.phpt | xargs echo`"
22Running run-tests.php directly will clear your environment and therefore
23tests will fail if your SNMP configuration does not fit into default values
24specified in snmp_include.inc.
25
26** Configuring the SNMPD server **
27
28On Linux/FreeBSD
29--------
30
31- Install package net-snmpd (name may differ based on your distribution).
32- Replace config file (by default this is /etc/snmp/snmpd.conf on Linux and
33  /usr/local/etc/snmp/snmpd.conf on FreeBSD) with snmpd.conf supplied.
34
35Before launching daemon make sure that there is no file /var/net-snmp/snmpd.conf
36Delete it if exists. Ingoring to to so will fail SNMPv3 tests.
37
38- Place bigtest.sh near snmpd.conf, tune path to it in snmpd.conf
39
40- Launch snmpd (service snmpd start or /etc/init.d/snmpd start).
41  Alternatively you can start snmpd daemon using following command line:
42    sudo snmpd -C -c ./snmpd.conf -f -Le
43
44
45On Windows
46----------
47
48[to be completed]
49