Connecting CDRouter to a GPON Network

Overview

In a production or shared lab environment, an OLT’s upstream connection usually points to a live network gateway. To successfully test a CPE in this environment, you must ensure that test traffic is properly steered away from the live network and toward CDRouter.

Core Concepts

  • Traffic Forwarding: All test traffic forwarded by the CPE (DUT) must reach CDRouter’s WAN interface.

  • The Reserved Address Block: CDRouter’s emulated services (DNS, NTP, ACS, Remote Hosts) exist in a “virtual space.” These services are assigned IP addresses from a Reserved Address Block (e.g., 202.254.101.0/24 or 3001:FF00::/64) that must be unique to your lab.

  • Routing to CDRouter: Because these virtual services are not physically on the wire, the network must be told how to find them. This is typically done by configuring static routes in the network to use CDRouter’s physical WAN interface address as the next-hop for any traffic destined for the Reserved Address Block.

Connectivity Scenarios

Scenario A:

Same Layer-2 Segment (Direct Connection)

CDRouter’s WAN interface and the OLT’s upstream interface are connected to the same physical switch or broadcast domain. The OLT routes traffic between the CPE and CDRouter.

  • Solution: Add a static route directly to the OLT. The OLT will treat CDRouter as a “router” on its own subnet. CDRouter’s “gateway” to reach the DUT will be the IP address of the connected OLT interface.
Scenario A

Scenario B:

Different Layer-2 Segments (Multiple Router Hops)

One or more IP routers separate CDRouter from the OLT. This is a common “live network” setup.

  • Solution: You must add static routes to the intermediate routers in the lab. The router directly connected to CDRouter must point the Reserved Address Block traffic to CDRouter’s WAN IP. The IP address of that router will be used as CDRouter’s “gateway” to reach the DUT.
Scenario B

Scenario C:

Same Logical Layer-2 Segment

A specific VLAN is provisioned through the live network to connect the CPE and CDRouter. This creates a logical Layer-2 “tunnel” between them.

  • Solution: The DUT and CDRouter behave as if they are directly connected. The DUT uses CDRouter’s IP address as its default router for all destinations.
Scenario C

Example Configurations

Your CDRouter config file contains testvars to set the WAN IP addresses of both CDRouter and the CPE. The examples below illustrate when CDRouter’s WAN address needs to be in the same IPv4 subnet or IPv6 prefix and when it must not, depending on whether its physical interface is on the same Layer-2 segment as the CPE.

Note that the addresses used in these examples are only provided as an example. You will need to allocate addresses for CDRouter’s WAN interface and “Reserved Address Block” that align with your existing network address scheme and topology.

CPE and CDRouter on DIFFERENT Layer-2 Segments

(Includes Scenario A direct OLT connection and Scenario B with intermediate routers)

When the DUT and CDRouter are separated by one or more routers, the “WAN link” is split into two distinct segments. CDRouter uses “gateway” testvars to identify the next-hops that will forward CDRouter test traffic.

In this case, each of the following WAN address testvar pairs must be defined in separate IPv4 subnets or IPv6 prefixes corresponding to their respective segments:

Protocol Segment Testvar Pair Defined By
IPv4 CDRouter Link wanIspIp / wanIspGateway wanIspMask
IPv4 CPE/OLT Link wanIspAssignIp / wanIspAssignGateway wanIspAssignMask
IPv6 CDRouter Link ipv6WanIspIp / ipv6WanIspGateway ipv6WanIspPrefixLen
IPv6 CPE/OLT Link ipv6WanIspAssignIp ipv6WanAssignPrefixLen

IPv4 Configuration

testvar  wanMode                    DHCP

testvar  wanIspIp                   202.254.1.1
testvar  wanIspGateway              202.254.1.2
testvar  perfWanIp                  202.254.1.2
testvar  wanIspMask                 255.255.255.0

testvar  wanIspAssignGateway        202.254.2.1
testvar  wanIspAssignIp             202.254.2.2
testvar  wanIspNextIp               202.254.2.3
testvar  wanIspAssignMask           255.255.255.0

testvar  IPv4HopCount               2

IPv6 Configuration

testvar  ipv6WanMode                DHCP

testvar  ipv6WanIspIp               3001:A::1
testvar  ipv6WanIspGateway          3001:A::2
testvar  perfWanIpv6                3001:A::3
testvar  ipv6WanIspPrefixLen        64

testvar  ipv6WanIspAssignIp         3001:B::2
testvar  ipv6WanIspNextIp           3001:B::3
testvar  ipv6WanAssignPrefixLen     64

testvar  IPv6HopCount               2

CPE and CDRouter on the SAME Layer-2 Segment

(Scenario C with provisioned VLAN)

In this setup, the WAN interfaces of CDRouter and the DUT are in the same broadcast domain and no IP routing is required. This corresponds to CDRouter’s default configuration template with all WAN interface address testvars in the same IPv4 subnet and IPv6 prefix:

IPv4 Configuration

testvar  wanMode                    DHCP

testvar  wanIspIp                   202.254.1.1
testvar  wanIspAssignIp             202.254.1.2
testvar  wanIspNextIp               202.254.1.3
testvar  perfWanIp                  202.254.1.4
testvar  wanIspMask                 255.255.255.0

testvar  IPv4HopCount               1

# -- Unused --
# testvar  wanIspGateway              202.254.1.2     
# testvar  wanIspAssignGateway        202.254.2.1
# testvar  wanIspAssignMask           255.255.255.0

IPv6 Configuration

testvar  ipv6WanMode                DHCP
testvar  ipv6WanIspIp               3001::1
testvar  ipv6WanIspAssignIp         3001::2
testvar  ipv6WanIspNextIp           3001::3
testvar  perfWanIpv6                3001::4
testvar  ipv6WanIspPrefixLen        64

testvar  IPv6HopCount               1

# -- Unused --
# testvar  ipv6WanIspGateway          3001:A::2
# testvar  ipv6WanAssignPrefixLen     64

Reserved Address Block

In any of the above scenarios, CDRouter’s virtual servers should be assigned unique addresses from the Reserved Address block. This ensures all test traffic forwarded by the DUT will be routed properly and received by CDRouter’s WAN interface.

# -- IPv4 202.254.101.0/24

testvar wanDnsServer         202.254.101.1
testvar wanBackupDnsServer   202.254.101.2
testvar ntpServer1           202.254.101.3
testvar ntpServer2           202.254.101.4
testvar remoteHostIp         202.254.101.5
testvar acsIp                202.254.101.6
testvar uspControllerIpv4    202.254.101.7
testvar FreeNetworkStart     202.254.101.16
testvar FreeNetworkStop      202.254.101.254
testvar FreeNetworkMask      255.255.255.240

# -- IPv6 3001:FF00::/32

testvar ipv6WanDnsServer           3001:FF00::1
testvar ipv6WanBackupDnsServer     3001:FF00::2
testvar ipv6NtpServer1             3001:FF00::3
testvar ipv6NtpServer2             3001:FF00::4
testvar ipv6RemoteHost             3001:FF00::5
testvar acsDualStackIp             3001:FF00::6
testvar uspControllerIpv6          3001:FF00::7
testvar ipv6FreeNetworkStart       3001:FF00:1::1
testvar ipv6FreeNetworkStop        3001:FF00:FFFF::FFFF
testvar ipv6FreeNetworkPrefixLen   64

Summary Checklist

  • Static Routes: Ensure every router in the path has a route for the Reserved Block using CDRouter’s wanIspIp as the next-hop.

  • DHCP-Relay: If the CPE requires DHCP from CDRouter, ensure the OLT or local gateway is configured as a DHCP-Relay agent pointing to CDRouter’s WAN IP.

  • No Overlaps: Ensure the Reserved Block does not overlap with any existing subnets in your lab.

  • VLAN Tagging: In Scenario C, verify that the VLAN ID on CDRouter matches the OLT’s configuration and that intermediate switches are trunking the VLAN correctly.