WeOSNon Redundant ECSP Services HowTo
This document describes how to configure the ECSP services in a non redundant train setup. The consists are depicted in Figure 1.
The result of the inauguration will be a network where ETBN1 in consist 1 has ETBN-ID 1, the IP-address 10.128.0.1 (based on the ETBN-ID and since the network is configured as TCMS). ETBN1 in consist 2 will attain ETBN-ID 2 and IP 10.128.0.2. CN1 in consist 1 will attain the network IP 10.128.64.0/18, and CN1 in consist 2 IP 10.128.128.0/18.
Note that in the diagram below, the nodes are named ETBN1 and ETBN2 respectively, while in the configuration examples below, the device hostnames are etbn1cst1 and etbn1cst2. This is to differentiate between a few concepts: the names in the diagram refer to the local ETBN ID (set using the local-id command), while the hostnames refer to both the local ETBN ID as well as the consist that the node is in.
.-------. .-------.
/ cst1 \ / cst2 \
'---------' '---------'
.-------. .-------.
--+ +----+ +-- dir1 = (ethX5, ethX6)
<-dir1| ETBN1 | | ETBN2 |dir2-> dir2 = (ethX7, ethX8)
--+ +----+ +--
'---+---' '---+---'
| |
| --+--+---- cst2-cn1 vlan10 (ethX3)
| |
| ECSC2
|
--+---+----- cst1-cn1 vlan10 (ethX3)
|
ECSC1
Figure 1: Accessing the ECSP's in two consists.
Configuration
The first configuration example shows how to configure ETBN1 in consist 1.
etbn1cst1:#> configure etbn1cst1:/config/#> vlan 10 Creating new VLAN vid:10 with name: vlan10 etbn1cst1:/config/vlan-10/#> untagged ethX3 etbn1cst1:/config/vlan-10/#> end etbn1cst1:/config/#> iface vlan10 etbn1cst1:/config/iface-vlan10/#> no inet etbn1cst1:/config/iface-vlan10/#> inet static 10.0.0.10/18 etbn1cst1:/config/iface-vlan10/inet-static-10.0.0.10/#> end etbn1cst1:/config/iface-vlan10/#> end etbn1cst1:/config/#> ttdp Activating TTDP with default settings. etbn1cst1:/config/ttdp/#> uuid 11111111-1111-1111-1111-111111111111 etbn1cst1:/config/ttdp/#> node 1 ecn 1 etbn1cst1:/config/ttdp/#> ecn 1 vlan10 etbn1cst1:/config/ttdp/#> dir1 ethX5,ethX6 Remember to manually set mdi/mdi-x mode in port settings for all agg ports. etbn1cst1:/config/ttdp/#> dir2 ethX7,ethX8 Remember to manually set mdi/mdi-x mode in port settings for all agg ports. etbn1cst1:/config/ttdp/#> local-id 1 etbn1cst1:/config/ttdp/#> mroute group 239.193.0.1 out 1,etb Adding multicast route for 239.193.0.1 etbn1cst1:/config/ttdp/#> ecsp-iface vlan10 etbn1cst1:/config/ttdp/#> ecsp-addr 10.0.0.10 etbn1cst1:/config/ttdp/#> ecsc-addr 10.0.0.42 etbn1cst1:/config/ttdp/#> end TTDP: Created VLAN 492. Note that this VLAN will not be deleted automatically if TTDP is deactivated. etbn1cst1:/config/#> vlan 2 Creating new VLAN vid:2 with name: vlan2 etbn1cst1:/config/vlan-2/#> no multicast-snooping etbn1cst1:/config/vlan-2/#> untagged lag-dir1,lag-dir2 etbn1cst1:/config/vlan-2/#> end
Continue by configuring the ports.
etbn1cst1:/config/#> port ethX5 etbn1cst1:/config/port-ethX5/#> speed-duplex 100-full etbn1cst1:/config/port-ethX5/#> no auto-negotiate etbn1cst1:/config/port-ethX5/#> fastlink etbn1cst1:/config/port-ethX5/#> mdix-mode mdi etbn1cst1:/config/port-ethX5/#> end etbn1cst1:/config/#> port ethX6 etbn1cst1:/config/port-ethX6/#> speed-duplex 100-full etbn1cst1:/config/port-ethX6/#> no auto-negotiate etbn1cst1:/config/port-ethX6/#> fastlink etbn1cst1:/config/port-ethX6/#> mdix-mode mdi etbn1cst1:/config/port-ethX6/#> end etbn1cst1:/config/#> port ethX7 etbn1cst1:/config/port-ethX7/#> speed-duplex 100-full etbn1cst1:/config/port-ethX7/#> no auto-negotiate etbn1cst1:/config/port-ethX7/#> fastlink etbn1cst1:/config/port-ethX7/#> mdix-mode mdi etbn1cst1:/config/port-ethX7/#> end etbn1cst1:/config/#> port ethX8 etbn1cst1:/config/port-ethX8/#> speed-duplex 100-full etbn1cst1:/config/port-ethX8/#> no auto-negotiate etbn1cst1:/config/port-ethX8/#> fastlink etbn1cst1:/config/port-ethX8/#> mdix-mode mdi etbn1cst1:/config/port-ethX8/#> end etbn1cst1:/config/#> end Applying configuration. Configuration activated. Remember "copy run start" to save to flash (NVRAM). etbn1cst1:/#>
Note
In this HowTo, it is assumed that the ETB uses crossover cabling. For this reason, all ETB ports on both ETBNs use the same MDI-X mode. If non-crossover cabling is used, these settings must be changed for two of the inward-facing ETB ports.
Now, repeat the exact steps above in the second ETB node. The only difference is the uuid which now will be uuid 22222222-2222-2222-2222-222222222222.
etbn1cst2:#> configure etbn1cst2:/config/#> vlan 10 Creating new VLAN vid:10 with name: vlan10 etbn1cst2:/config/vlan-10/#> untagged ethX3 etbn1cst2:/config/vlan-10/#> end etbn1cst2:/config/#> iface vlan10 etbn1cst2:/config/iface-vlan10/#> no inet etbn1cst2:/config/iface-vlan10/#> inet static 10.0.0.10/18 etbn1cst2:/config/iface-vlan10/inet-static-10.0.0.10/#> end etbn1cst2:/config/iface-vlan10/#> end etbn1cst2:/config/#> ttdp Activating TTDP with default settings. etbn1cst2:/config/ttdp/#> uuid 22222222-2222-2222-2222-222222222222 etbn1cst2:/config/ttdp/#> node 1 ecn 1 etbn1cst2:/config/ttdp/#> ecn 1 vlan10 etbn1cst2:/config/ttdp/#> dir1 ethX5,ethX6 Remember to manually set mdi/mdi-x mode in port settings for all agg ports. etbn1cst2:/config/ttdp/#> dir2 ethX7,ethX8 Remember to manually set mdi/mdi-x mode in port settings for all agg ports. etbn1cst2:/config/ttdp/#> local-id 1 etbn1cst2:/config/ttdp/#> mroute group 239.193.0.1 out 1,etb Adding multicast route for 239.193.0.1 etbn1cst2:/config/ttdp/#> ecsp-iface vlan10 etbn1cst2:/config/ttdp/#> ecsp-addr 10.0.0.10 etbn1cst2:/config/ttdp/#> ecsc-addr 10.0.0.42 etbn1cst2:/config/ttdp/#> end TTDP: Created VLAN 492. Note that this VLAN will not be deleted automatically if TTDP is deactivated. etbn1cst2:/config/#> vlan 2 Creating new VLAN vid:2 with name: vlan2 etbn1cst2:/config/vlan-2/#> no multicast-snooping etbn1cst2:/config/vlan-2/#> untagged lag-dir1,lag-dir2 etbn1cst2:/config/vlan-2/#> end
Continue by configuring the ports.
etbn1cst2:/config/#> port ethX5 etbn1cst2:/config/port-ethX5/#> speed-duplex 100-full etbn1cst2:/config/port-ethX5/#> no auto-negotiate etbn1cst2:/config/port-ethX5/#> fastlink etbn1cst2:/config/port-ethX5/#> mdix-mode mdi etbn1cst2:/config/port-ethX5/#> end etbn1cst2:/config/#> port ethX6 etbn1cst2:/config/port-ethX6/#> speed-duplex 100-full etbn1cst2:/config/port-ethX6/#> no auto-negotiate etbn1cst2:/config/port-ethX6/#> fastlink etbn1cst2:/config/port-ethX6/#> mdix-mode mdi etbn1cst2:/config/port-ethX6/#> end etbn1cst2:/config/#> port ethX7 etbn1cst2:/config/port-ethX7/#> speed-duplex 100-full etbn1cst2:/config/port-ethX7/#> no auto-negotiate etbn1cst2:/config/port-ethX7/#> fastlink etbn1cst2:/config/port-ethX7/#> mdix-mode mdi etbn1cst2:/config/port-ethX7/#> end etbn1cst2:/config/#> port ethX8 etbn1cst2:/config/port-ethX8/#> speed-duplex 100-full etbn1cst2:/config/port-ethX8/#> no auto-negotiate etbn1cst2:/config/port-ethX8/#> fastlink etbn1cst2:/config/port-ethX8/#> mdix-mode mdi etbn1cst2:/config/port-ethX8/#> end etbn1cst2:/config/#> end Applying configuration. Configuration activated. Remember "copy run start" to save to flash (NVRAM). etbn1cst2:/#>
Communication Profile Configuration
Finally, for the ECSPs to function properly, a CSTINFO data file is needed on each device. See the Communication Profile documentation for more information about this file and its purpose.
Two such files are provided as examples for this HowTo: CSTINFO data file for consist 1 and CSTINFO data file for consist 2. They are, like the remainder of this document, representative but non-exhaustive examples.
On each node, the CSTINFO data file must be placed in the directory /cfg/ with the name cstinfo.json. This can be done by using any available administrative interface, or by putting the file on the external USB media (in which case it will be available in the /cfg/ directory after rebooting the device).
Note
Ensure the filenames are correct. That is, the file should be named cstinfo.json and placed in /cfg/ on each device.
When the above configuration is complete, the ECSP in cst1 uses IP address 10.0.0.10 on iface vlan10, while the ECSP in cst2 uses IP address 10.0.0.20 on iface vlan10.
To use the ECSP services on cst1, an ECSC client (ECSC1 in figure 1) needs to be running on a host with IP address 10.0.0.42 To use the ECSP services on cst2, an ECSC client (ECSC2 in figure 1) needs to be running on a host with IP address 10.0.0.42 (but connected to the correct consist net of course).
Inauguration Result
Using the show ttdp command we now verify that we have recevied the intended network configuration.
Highlighted in orange are the values that are of interest.
etbn1cst1:/#> show ttdp TTDP NODE backbone-id : 0 (tcms) etbn-id : 1 etbn-ip : 10.128.0.1 local-id : 1 own-mac : 0c:65:8c:93:00:00 uuid : 11111111-1111-1111-1111-111111111111 connTableCnt : 0xb81af94 EtbTopoCnt : 0xec518201 Inauguration : INAUGURATED Inhibition : Self: Off, Others: Off, Train: Off CST-NET IFACE IP CONNECTED ETBNs 1 vlan10 10.0.0.10/18 1 NODE ID MAC ADDRESS ORIENTATION 1 0c:65:8c:93:00:00 Direct 2 0c:7a:40:ee:00:00 Direct CONSIST NODES DIRECTION NETWORKS 11111111-1111-1111-1111-111111111111 1 Direct 10.128.64.0/18 22222222-2222-2222-2222-222222222222 2 Direct 10.128.128.0/18 etbn1cst1:/#>
etbn1cst2:/#> show ttdp TTDP NODE backbone-id : 0 (tcms) etbn-id : 2 etbn-ip : 10.128.0.2 local-id : 1 own-mac : 0c:7a:40:ee:00:00 uuid : 22222222-2222-2222-2222-222222222222 connTableCnt : 0xb81af94 EtbTopoCnt : 0xec518201 Inauguration : INAUGURATED Inhibition : Self: Off, Others: Off, Train: Off CST-NET IFACE IP CONNECTED ETBNs 1 vlan10 10.0.0.10/18 2 NODE ID MAC ADDRESS ORIENTATION 1 0c:65:8c:93:00:00 Direct 2 0c:7a:40:ee:00:00 Direct CONSIST NODES DIRECTION NETWORKS 11111111-1111-1111-1111-111111111111 1 Direct 10.128.64.0/18 22222222-2222-2222-2222-222222222222 2 Direct 10.128.128.0/18 etbn1cst2:/#>
Additionally, we can use the nslookup command to verify that the communication profile configuration has
been read. A set of URIs has been choosen to verify that the DNS entries has been created.
etbn1cst1:/#> nslookup devDCU2.anyVeh.lCst.lTrn Server: 127.0.0.1 Address 1: 127.0.0.1 localhost Name: devDCU2.anyVeh.lCst.lTrn Address 1: 10.0.0.111 etbn1cst1:/#> nslookup devHVAC.anyVeh.lCst.lTrn Server: 127.0.0.1 Address 1: 127.0.0.1 localhost Name: devHVAC.anyVeh.lCst.lTrn Address 1: 10.0.0.100 etbn1cst1:/#> nslookup devCCUO2.anyVeh.lCst.lTrn Server: 127.0.0.1 Address 1: 127.0.0.1 localhost Name: devCCUO2.anyVeh.lCst.lTrn Address 1: 10.0.0.11 etbn1cst1:/#>