Skip to main content

Appendix: VMware Router Configuration

This appendix contains the complete SSR PCLI configuration for the Spoke1 VMware router described in this guide. This configuration reflects the final state after completing all steps through Step 4 — Configure the Router on the Conductor.

important

This appendix uses example PCI addresses (0000:0b:00.0 for WAN, 0000:13:00.0 for LAN). Replace these with the actual values discovered in Step 3 — Find VM NIC PCI Addresses.

Network Design Reference

The following IP addressing and naming scheme is used consistently throughout this guide. Substitute your own values when configuring your network.

ParameterExample ValueDescription
Authority NameAuthority128Organizational authority name
Conductor NameConductorPre-existing conductor system name
Conductor IP Address192.168.100.10Conductor IP — must be reachable from the router WAN
Router NameSpoke1VMware router system name
Router Node Namenode0Router node name
Router Asset IDSpoke1Asset ID reported after initialization; see Step 2
WAN Device Interfacewan-devWAN device interface name
WAN Network Interfacewan1WAN network interface name
WAN PCI Address(discovered in Step 3)VMXNet3 WAN NIC PCI address
LAN Device Interfacelan-devLAN device interface name
LAN Network Interfacelan1LAN network interface name
LAN PCI Address(discovered in Step 3)VMXNet3 LAN NIC PCI address
Router LAN IP Address192.168.1.1/24LAN gateway address
Tenant NamecorpLAN-side user tenant
Service NameInternet-TrafficInternet breakout service
Service Address0.0.0.0/0All internet-bound traffic
NeighborhoodinternetSVR neighborhood name

Applying This Configuration

This configuration can be applied to the conductor using the PCLI import function.

  1. Save the router configuration block below to a file — for example, vmware-router-Spoke1.cfg.

  2. Copy the file to the conductor:

    scp vmware-router-Spoke1.cfg admin@192.168.100.10:/tmp/
  3. Log in to the conductor PCLI:

    ssh admin@192.168.100.10
  4. Enter configuration mode and import:

    admin@node0.conductor1# import config /tmp/vmware-router-Spoke1.cfg
  5. Review any validation warnings, then commit:

    admin@node0.conductor1 (config)# commit
    Are you sure you want to commit the candidate config? [y/N]: y

Alternatively, copy and paste each block into the PCLI while in configureedit mode.

note

The authority-level objects this router depends on (Internet-Traffic service, corp tenant, and conductor address) must already exist in the running configuration. For the complete authority-level configuration, see Appendix — VMWare Conductor Configuration.

Router Configuration

Spoke1 Config diagram

The following block shows the Spoke1 router configuration as it appears within the authority configuration.

config

authority
conductor-address 10.0.0.63



router Conductor
name Conductor
location-coordinates +38.7127105-077.0060152/

node node0
name node0
asset-id Conductor
platform-type "440BX Desktop Reference Platform"
exit
exit

router spoke1
name spoke1
location-coordinates +40.741895-073.989308/
inter-node-security internal

node node0
name node0
asset-id Spoke1
role combo
platform-type "440BX Desktop Reference Platform"

device-interface wan-dev
name wan-dev
pci-address 0000:0b:00.0

network-interface wan1
name wan1
global-id 1
conductor true
default-route true

neighborhood internet
name internet
exit
inter-router-security internal
source-nat true
management true

management-vector
name mgmt-vec-wan
priority 100
exit

address 10.0.128.127
ip-address 10.0.128.127
prefix-length 16
gateway 10.0.0.128

host-service web
service-type web
exit
exit
dhcp disabled
exit
exit

device-interface lan
name lan
pci-address 0000:13:00.0

network-interface lan
name lan
global-id 2
tenant corp
source-nat true

address 192.168.1.1
ip-address 192.168.1.1
prefix-length 24

host-service dhcp-server
service-type dhcp-server

address-pool 192.168.1.2
start-address 192.168.1.2
end-address 192.168.1.20
router 192.168.1.1
domain-server 8.8.8.8
exit
exit
exit
dhcp disabled
exit
exit
exit

service-route internet-route
name internet-route
service-name Internet-Traffic

next-hop node0 wan1
node-name node0
interface wan1
gateway-ip 10.0.0.1
exit
exit
exit

tenant corp
name corp
exit

software-access
username (removed)
token (removed)
exit

service internet
name internet
security internal
exit

service Internet-Traffic
name Internet-Traffic
address 0.0.0.0/0

access-policy corp
source corp
exit
exit
exit
exit


Interface Summary

InterfaceDevice InterfacePCI AddressTypeConfiguration
wan1wan-dev0000:0b:00.0 (example)ExternalDHCP, conductor, default-route, source-nat, management, neighborhood internet
lan1lan-dev0000:13:00.0 (example)Externaltenant corp, static 192.168.1.1/24

Service Route Summary

Service RouteServiceTypeNext Hop
internet-routeInternet-Trafficservice-agentnode0 / wan1

Design Notes

Management over Forwarding — The wan1 interface carries both internet traffic and conductor management sessions simultaneously. Management traffic from the 169.254.x.x range is source-NAT'd to the WAN DHCP address before leaving the interface. This eliminates the need for a separate out-of-band management network at the branch site.

Internet Breakout — The internet-route service route directs all corp-tenant traffic matching the Internet-Traffic service (destination 0.0.0.0/0) out through wan1 as a service-agent. The source NAT setting on wan1 ensures LAN client traffic is translated to the WAN IP before it reaches the ISP.

PCI Address Binding — VMware assigns PCI addresses based on the VM's hardware slot configuration. The example addresses in this appendix (0000:0b:00.0, 0000:13:00.0) are illustrative only. Always use the values discovered by following Step 3 — Find VM NIC PCI Addresses.