RSRV Configuration Test Plan
Scope
This document describes some of the possible network configurations for RSRV and the expected results with the RSRV interface binding changes https://code.launchpad.net/~epics-core/epics-base/rsrvbindiface.
The expected results are given as the output various IOC shell commands (eg. epicsParamShow/casr/dbcar).
Note that the output of dbcar "" 8 is quite verbose. Searching for the string Search Destination List in the output is suggested.
Preparation
This testing should be done on a computer with more than one physical/virtual network interface in additional to the loopback.
On Linux additional tun/tap virtual interfaces can easily be added. In the following examples the addresses 10.5.1.1 and 10.5.2.1 name two such interfacess. Additional interfaces may be present.
ip tuntap add dev tap0 mode tap ip addr add 10.5.1.1/24 dev tap0 ip tuntap add dev tap1 mode tap ip addr add 10.5.2.1/24 dev tap1
These can later be removed
ip tuntap del dev tap0 mode tap ip tuntap del dev tap1 mode tap
Test IOC
In addition to inspecting the output of the iocsh commands, it is recommended to test a live softIoc.
cat << EOF > test.db
record(calc, "test") {
field(SCAN, "1 second")
field(INPA, "test")
field(CALC, "A+1")
field(FLNK, "invalid")
}
Each Test section includes an example invokation of softIoc and several caget.
Tests
Test #1 Defaults
The default configuration is for RSRV is to bind to the wildcard interface (0.0.0.0), and for libca to search on all local interfaces.
./bin/linux-x86/softIoc -d test.db
Client gets should work.
./bin/linux-x86/caget test
A warning "Identical process variable names on multiple servers" should be seen.
epicsParamShow
EPICS_CA_ADDR_LIST is undefined EPICS_CA_AUTO_ADDR_LIST: YES EPICS_CA_NAME_SERVERS is undefined EPICS_CAS_INTF_ADDR_LIST is undefined EPICS_CAS_AUTO_BEACON_ADDR_LIST is undefined EPICS_CAS_BEACON_ADDR_LIST is undefined
casr 2
Server interface 0.0.0.0:5064 UDP receiver 1 0.0.0.0:5064 Beacon destination 10.5.1.255:5065 Beacon destination 10.5.2.255:5065 ... one for remaining local interfaces ...
dbcar "" 8
... Search Destination List with 4 items UDP Search destination "10.5.1.255:5064" UDP Search destination "10.5.2.255:5064" ... one for remaining local interfaces ...
Test #2 Client address list only
Bind the server to the wildcard address. Client searches only on a sub-set of interfaces.
EPICS_CA_ADDR_LIST=10.5.1.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/softIoc -d test.db
Client gets should work on either interface.
EPICS_CA_ADDR_LIST=10.5.1.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
EPICS_CA_ADDR_LIST=10.5.2.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
epicsParamShow
EPICS_CA_ADDR_LIST: 10.5.1.255 EPICS_CA_AUTO_ADDR_LIST: NO EPICS_CA_NAME_SERVERS is undefined EPICS_CAS_INTF_ADDR_LIST is undefined EPICS_CAS_AUTO_BEACON_ADDR_LIST is undefined EPICS_CAS_BEACON_ADDR_LIST is undefined
casr 2
Server interface 0.0.0.0:5064 UDP receiver 1 0.0.0.0:5064 Beacon destination 10.5.1.255:5065 ... no more destinations ...
dbcar "" 8
... Search Destination List with 1 items UDP Search destination "10.5.1.255:5064" ... No more destinations ...
Test #3 Client and Server on a single interface
RSRV binds to a single interface, and libca only searches on this interface.
EPICS_CAS_INTF_ADDR_LIST=10.5.1.1 \ EPICS_CA_ADDR_LIST=10.5.1.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/softIoc -d test.db
Client gets should work only when the 10.5.1.255 interface.
EPICS_CA_ADDR_LIST=10.5.1.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
and fail on any other interface
EPICS_CA_ADDR_LIST=10.5.2.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
epicsParamShow
EPICS_CA_ADDR_LIST: 10.5.1.255 EPICS_CA_AUTO_ADDR_LIST: NO EPICS_CA_NAME_SERVERS is undefined EPICS_CAS_INTF_ADDR_LIST: 10.5.1.1 EPICS_CAS_AUTO_BEACON_ADDR_LIST is undefined EPICS_CAS_BEACON_ADDR_LIST is undefined
casr 2
Server interface 10.5.1.1:5064 UDP receiver 1 10.5.1.1:5064 UDP receiver 2 10.5.1.255:5064 Beacon destination 10.5.1.255:5065 ... no other destinations ...
Note that "UDP receiver 2" will not be present for Windows targets as it is *nix specific.
dbcar "" 8
... Search Destination List with 1 items UDP Search destination "10.5.1.255:5064" ... No more destinations ...
Test #4 Client and Server on a multiple interfaces
RSRV binds to two interfaces, and libca only searches on these interfaces.
EPICS_CAS_INTF_ADDR_LIST="10.5.1.1 10.5.2.1" \ EPICS_CA_ADDR_LIST="10.5.1.255 10.5.2.255" \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/softIoc -d test.db
Client gets should work only when the 10.5.1.255 and 10.5.2.255 interfaces, and fail on any others.
EPICS_CA_ADDR_LIST=10.5.1.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
EPICS_CA_ADDR_LIST=10.5.2.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
epicsParamShow
EPICS_CA_ADDR_LIST: 10.5.1.255 10.5.2.255 EPICS_CA_AUTO_ADDR_LIST: NO EPICS_CA_NAME_SERVERS is undefined EPICS_CAS_INTF_ADDR_LIST: 10.5.1.1 10.5.2.1 EPICS_CAS_AUTO_BEACON_ADDR_LIST is undefined EPICS_CAS_BEACON_ADDR_LIST is undefined
casr 2
Server interface 10.5.1.1:5064 UDP receiver 1 10.5.1.1:5064 UDP receiver 2 10.5.1.255:5064 Server interface 10.5.2.1:5064 UDP receiver 1 10.5.2.1:5064 UDP receiver 2 10.5.2.255:5064 Beacon destination 10.5.1.255:5065 Beacon destination 10.5.2.255:5065 ... no other destinations ...
Note that "UDP receiver 2" will not be present for Windows targets as it is *nix specific.
dbcar "" 8
... Search Destination List with 2 items UDP Search destination "10.5.1.255:5064" UDP Search destination "10.5.2.255:5064" ... No more destinations ...
Test #5 Client and Server on different, single, interfaces
RSRV binds to one interface, and libca only searches on another interface. This is a "gateway"-like situation.
EPICS_CAS_INTF_ADDR_LIST=10.5.1.1 \ EPICS_CA_ADDR_LIST=10.5.2.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/softIoc -d test.db
Client gets should work only when the 10.5.1.255 interface.
EPICS_CA_ADDR_LIST=10.5.1.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
and fail on any other interface
EPICS_CA_ADDR_LIST=10.5.2.255 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
Additionally, the IOC's CA client will only search on 10.5.2.255.
epicsParamShow
EPICS_CA_ADDR_LIST: 10.5.2.255 EPICS_CA_AUTO_ADDR_LIST: NO EPICS_CA_NAME_SERVERS is undefined EPICS_CAS_INTF_ADDR_LIST: 10.5.1.1 EPICS_CAS_AUTO_BEACON_ADDR_LIST is undefined EPICS_CAS_BEACON_ADDR_LIST is undefined
casr 2
Server interface 10.5.1.1:5064 UDP receiver 1 10.5.1.1:5064 UDP receiver 2 10.5.1.255:5064 Beacon destination 10.5.2.255:5065 ... no other destinations ...
Note that "UDP receiver 2" will not be present for Windows targets as it is *nix specific.
dbcar "" 8
... Search Destination List with 1 items UDP Search destination "10.5.2.255:5064" ... No more destinations ...
Test #6 IPv4 Multicast for search and beacons
Server bound to wildcard, and client searches only with multicast. In addtional a multicast address is specified for name search and beacon messages.
EPICS_CAS_INTF_ADDR_LIST=224.0.2.9 \ EPICS_CA_ADDR_LIST=224.0.2.9 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/softIoc -d test.db
Client searches using multicast will succeed.
EPICS_CA_ADDR_LIST=224.0.2.9 \ EPICS_CA_AUTO_ADDR_LIST=NO \ ./bin/linux-x86/caget test
Searches not using multicast will fail.
./bin/linux-x86/caget test
epicsParamShow
EPICS_CA_ADDR_LIST: 224.0.2.9 EPICS_CA_AUTO_ADDR_LIST: NO EPICS_CA_NAME_SERVERS is undefined EPICS_CAS_INTF_ADDR_LIST: 224.0.2.9 EPICS_CAS_AUTO_BEACON_ADDR_LIST is undefined EPICS_CAS_BEACON_ADDR_LIST is undefined
casr 2
Server interface 0.0.0.0:5064 UDP receiver 1 0.0.0.0:5064 MCast destination 224.0.2.9:5064 Beacon destination 224.0.2.9:5065 ... no destinations for local interfaces ...
dbcar "" 8
... Search Destination List with 1 items ... no destinations for local interfaces UDP Search destination "224.0.2.9:5064" ...
