CDRouter IPv6 User Guide 6.3/Configuration
From QA Cafe Support Wiki
Contents |
Configuration
Global IPv6 Configuration
CDRouter IPv6 has several IPv6 specific configuration options, also known as test variables, or “testvars” for short, that define the DUT and the test environment.
The following tables describe each available testvar. The tables below group testvars by the test interface they are applicable to or the protocol/functionality they define.
To globally enable IPv6 within CDRouter, the testvar supportsIPv6 must be set to a value of “yes”.
| supportsIPv6 | This option enables or disables IPv6 functionality within CDRouter. If enabled, CDRouter will create a new client on the LAN and attempt to obtain an IPv6 address from the DUT using the protocol specified by the "LAN Mode" option. |
Values: yes|no | |
| Example: testvar supportsipv6 yes |
IPv6 WAN Configuration
CDRouter IPv6 supports a number of different IPv6 WAN connection modes and options. See the table below for a complete list of all distinct IPv6 WAN connection modes currently supported by CDRouter, where "DHCPv6 NA" refers to the use of DHCPv6 for non-temporary address assignment, and "DHCPv6 PD" refers to the use of DHCPv6 for prefix delegation.
| Configuration | IPv6 WAN Mode ipv6WanMode |
DHCPv6 NA dhcpv6WanEnableNA |
DHCPv6 PD dhcpv6WanEnablePD |
| 1 | static | not applicable | no |
| 2 | static | not applicable | yes |
| 3* | PPPoE | no | no |
| 4 | PPPoE | yes | yes |
| 5 | PPPoE | no | yes |
| 6 | 6to4 | not applicable | not applicable |
| 7 | 6rd | not applicable | not applicable |
| 8 | autoconf | not applicable | no |
| 9 | autoconf | not applicable | yes |
| 10 | DHCP | not applicable** | no |
| 11 | DHCP | not applicable** | yes |
* This configuration assumes that the DUT's global IPv6 address and prefix on the LAN are manually configured.
** When the testvar ipv6WanMode is set to DHCP, DHCPv6 is implicitly used for non-temporary address assignment. The testvar dhcpv6WanEnableNA has no impact.
The following testvars describe the basic IPv6 configuration of the WAN interface.
| ipv6WanMode | This option specifies the IPv6 WAN connection mode, or protocol, implemented by the DUT. CDRouter currently supports the following IPv6 WAN connection modes: * 6to4 * 6rd * DHCP * PPPoE * autoconf * static * none CDRouter will create and simulate all necessary network elements based on the chosen WAN connection mode. Please see the specific configuration options associated with each WAN connection mode. |
Values: 6to4 | 6rd | DHCP | PPPoE | autoconf | static | none | |
| Example: testvar ipv6WanMode 6to4 |
| ipv6WanIspIp | This parameter specifies the IPv6 address assigned by CDRouter to the WAN test interface. This is CDRouter's WAN IPv6 address and represents the simulated ISP IP address and next-hop gateway for the DUT. |
Values: A valid IPv6 address | |
| Example: testvar ipv6WanIspIp 3001::1 |
| ipv6WanIspAssignIp | This parameter specifies the IPv6 address of the DUT's WAN interface. This address can be statically configured or assigned by CDRouter via DHCPv6. This IPv6 address must be on the same network as the ISP's IPv6 address. |
Values: A valid IPv6 address | |
| Example: testvar ipv6WanIspAssignIp 3001::2 |
| ipv6WanIspNextIp | This parameter specifies a free IPv6 address used for WAN-side renumbering tests. This IPv6 address must be on the same network as the ISP's IPv6 address. |
Values: A valid IPv6 address | |
| Example: testvar ipv6WanIspNextIp 3001::3 |
| ipv6WanIspPrefixLen | This parameter specifies the prefix length of the WAN IPv6 network. |
Values: decimal from 1 to 128 | |
| Example: testvar ipv6WanIspPrefixLen 64 |
| ipv6RelayServer | This parameter specifies the IPv4 address of the 6to4 or 6rd relay server on the WAN. For 6to4 configurations this address is usually the well known anycast address 192.88.99.1. For 6rd configurations this address must be arbitrarily chosen. |
Values: A valid IPv4 address | |
| Example: testvar ipv6RelayServer 192.88.99.1 |
| ipv6rdPrefix | This parameter specifies the DUT's staticly configured 6rd prefix. This parameter is represented as a 16 octet IPv6 address with all bits following the 6rd prefix length set to 0. Some 6rd configuration examples: **Private WAN IPv4 Address** WAN IPv4 Address: 192.168.200.2 6rd Prefix: 2010:1234:: 6rd Prefix Length: 32 6rd IPv4 Mask Length: 8 6rd Delegated Prefix: 2010:1234:A8C8:0200:/56 **Public WAN IPv4 Address** WAN IPv4 Address: 12.12.12.2 6rd Prefix: 2010:: 6rd Prefix Length: 16 6rd IPv4 Mask Length: 0 6rd Delegated Prefix: 2010:0C0C:0C02::/48 Note that stateless address autoconfiguration (autoconf) requires an IPv6 prefix less than or equal to 64 bits. The test run will be aborted if autoconf is used on the LAN and the DUT provides a 6rd prefix greater than 64 bits in length. |
Values: A valid IPv6 address | |
| Example: testvar ipv6rdPrefix 2010:1234:: |
| ipv6rdPrefixLen | This parameter specifies the length of the DUT's 6rd prefix. The prefix length must be an integer value between 1 and 128. By default the 6rd prefix length is 32. Some 6rd configuration examples: **Private WAN IPv4 Address** WAN IPv4 Address: 192.168.200.2 6rd Prefix: 2010:1234:: 6rd Prefix Length: 32 6rd IPv4 Mask Length: 8 6rd Delegated Prefix: 2010:1234:A8C8:0200:/56 **Public WAN IPv4 Address** WAN IPv4 Address: 12.12.12.2 6rd Prefix: 2010:: 6rd Prefix Length: 16 6rd IPv4 Mask Length: 0 6rd Delegated Prefix: 2010:0C0C:0C02::/48 Note that stateless address autoconfiguration (autoconf) requires an IPv6 prefix less than or equal to 64 bits. The test run will be aborted if autoconf is used on the LAN and the DUT provides a 6rd prefix greater than 64 bits in length. |
Values: decimal from 1 to 128 | |
| Example: testvar ipv6rdPrefixLen 32 |
| ipv6rdIPv4MaskLen | This parameter specifies the number of high-order bits that are identical across all IPv4 addresses within a 6rd domain. If the IPv4 mask length is 0, the DUT's entire WAN IPv4 address is used to create the 6rd delegated prefix. If the DUT's 6rd mask length is 8, only the lowest order 24 bits of the DUT's WAN IPv4 address are used to create the 6rd prefix. The IPv4 mask length must be an integer value between 0 and 32. By default the IPv4 mask length is 0. Some 6rd configuration examples: **Private WAN IPv4 Address** WAN IPv4 Address: 192.168.200.2 6rd Prefix: 2010:1234:: 6rd Prefix Length: 32 6rd IPv4 Mask Length: 8 6rd Delegated Prefix: 2010:1234:A8C8:0200:/56 **Public WAN IPv4 Address** WAN IPv4 Address: 12.12.12.2 6rd Prefix: 2010:: 6rd Prefix Length: 16 6rd IPv4 Mask Length: 0 6rd Delegated Prefix: 2010:0C0C:0C02::/48 Note that stateless address autoconfiguration (autoconf) requires an IPv6 prefix less than or equal to 64 bits. The test run will be aborted if autoconf is used on the LAN and the DUT provides a 6rd prefix greater than 64 bits in length. |
Values: decimal from 0 to 32 | |
| Example: testvar ipv6rdIPv4MaskLen 0 |
| ipv6WanIspGateway | This parameter specifies the IPv6 address for the CDRouter IPv6 gateway on the WAN. This testvar is normally used for DHCPv6 relay configurations and is not normally defined. CDRouter uses this address as its IPv6 gateway on the WAN. If not specified, CDRouter uses the testvar ipv6WanIspAssignIp as the gateway. |
Values: A valid IPv6 address | |
| Example: testvar ipv6WanIspGateway 3001::9 |
| ipv6ExpectRAonWan | This parameter specifies whether or not the DUT is configured to send Router Advertisements on the WAN. This testvar impacts some aspects of the ndp-wan test module. |
Values: yes|no | |
| Example: testvar ipv6ExpectRAonWan yes |
| ipv6WanRDNSS | This option enables or disables the IPv6 RDNSS option for router advertisements on the WAN. When set to yes, CDRouter will announce the configured IPv6 DNS servers using the RDNSS option in router advertisements. By default, this option is set to no. |
Values: yes|no | |
| Example: testvar ipv6WanRDNSS yes |
WAN-Side DHCPv6 Server Configuration
The following testvars relate to the general configuration of CDRouter’s DHCPv6 server on the WAN.
| dhcpv6IAValidLifetime | This parameter defines the IA Valid Lifetime, in seconds, utilized by CDRouter's DHCPv6 server on the WAN. CDRouter's DHCPv6 server will provide this Valid Lifetime to the DUT's DHCPv6 client on the WAN. To return an infinite Valid Lifetime to the WAN client, a value of "infinite" may be specified. In an infinite lifetime is used, all tests that require the WAN client to renew or rebind will be skipped. Note that the Valid Lifetime must be greater than or equal to the Preferred Lifetime. |
| Example: testvar dhcpv6IAValidLifetime 300 |
| dhcpv6IAPreferredLifetime | This parameter defines the IA Preferred Lifetime, in seconds, utilized by CDRouter's DHCPv6 server on the WAN. CDRouter's DHCPv6 server will provide this Preferred Lifetime to the DUT's DHCPv6 client on the WAN. To return an infinite Preferred Lifetime to the WAN client, a value of "infinite" may be specified. In an infinite lifetime is used, all tests that require the WAN client to renew or rebind will be skipped. Note that the Preferred Lifetime must be less than or equal to the Valid Lifetime |
| Example: testvar dhcpv6IAPreferredLifetime 300 |
| dhcpv6DuidType | This option defines the DUID type used by the CDRouter DHCPv6 client and server. Types 1, 2, and 3 are defined by RFC 3315. * Type 1 DUID-LLT * Type 2 DUID-EN * Type 3 DUID-LL |
Values: decimal from 1 to 3 | |
| Example: testvar dhcpv6DuidType 1 |
| dhcpv6ServerOptionCode* | CDRouter’s DHCPv6 server on the WAN may be configured to return specific options to the DUT’s DHCPv6 client. Up to 255 additional DHCPv6 options may be defined. The testvar dhcpv6ServerOptionCode* should specify the DHCP option code in decimal format. The dhcpv6ServerOptionData* testvar is used to define the option data for any additional DHCPv6 options configured on the WAN side DHCPv6 server. The option data must be encoded in ascii hex format. The option length will be computed automatically based on the size of the data. |
Values: decimal from 1 to 255 | |
| Example: testvar dhcpv6ServerOptionCode1 69 |
| dhcpv6ServerOptionData* | CDRouter’s DHCPv6 server on the WAN may be configured to return specific options to the DUT’s DHCPv6 client. Up to 255 additional DHCPv6 options may be defined. The testvar dhcpv6ServerOptionCode* should specify the DHCP option code in decimal format. The dhcpv6ServerOptionData* testvar is used to define the option data for any additional DHCPv6 options configured on the WAN side DHCPv6 server. The option data must be encoded in ascii hex format. The option length will be computed automatically based on the size of the data. |
| Example: testvar dhcpv6ServerOptionData1 04040404 |
WAN-Side DHCPv6 Prefix Delegation Configuration
The following testvars relate to the configuration of DHCPv6 prefix delegation within CDRouter’s WAN DHCPv6 server.
| dhcpv6WanEnablePD | This option defines whether or not the DUT supports DHCPv6 prefix delegation, as defined in IETF RFC 3633, on the WAN. If this option is enabled, CDRouter's DHCPv6 server will respond to DHCPv6 IA_PD option requests from the DUT. |
Values: yes|no | |
| Example: testvar dhcpv6WanEnablePD yes |
| dhcpv6WanAssignPrefix | This parameter specifies the IPv6 address prefix assigned by CDRouter's DHCPv6 server on the WAN to the DUT. The DUT should use this prefix as the basis for its LAN side IPv6 configuration. The prefix delegation latency parameter defines the expected maximum amount of time it takes the DUT to update its LAN-side IPv6 settings when a new prefix is learned on the WAN. |
Values: A valid IPv6 address | |
| Example: testvar dhcpv6WanAssignPrefix 3001:dddd:: |
| dhcpv6WanAssignNextPrefix | This parameter specifies a free IPv6 address prefix used for WAN-side renumbering tests. |
Values: A valid IPv6 address | |
| Example: testvar dhcpv6WanAssignNextPrefix 3001:ddde:: |
| dhcpv6WanAssignPrefixLen | This parameter specifies the IPv6 address prefix length assigned by CDRouter's DHCPv6 server on the WAN to the DUT. |
Values: decimal from 1 to 128 | |
| Example: testvar dhcpv6WanAssignPrefixLen 64 |
| dhcpv6PDLatency | This parameter specifies the maximum amount of time, in seconds, that it takes for the DUT to update its LAN-side IPv6 settings when a new prefix is learned on the WAN. CDRouter will wait this amount of time before verifying that changes to the delegated prefix on the WAN have propagated to clients on the LAN-side of the DUT. |
Values: decimal | |
| Example: testvar dhcpv6PDLatency 30 |
IPv6 LAN Configuration
CDRouter IPv6 currently supports DHCPv6 or stateless address autoconfiguration (autoconf) for provisioning of global IPv6 addresses on the LAN. If the testvar ipv6LanMode is set to "DHCP", CDRouter's LAN clients will attempt to obtain global IPv6 addresses from the DUT via DHCPv6. If this testvar is set to "autoconf" CDRouter's LAN clients will attempt to obtain addresses via stateless address autoconfiguration using an EUI-64 based host identifier.
CDRouter's IPv6 LAN configuration must match the LAN configuration of the DUT. CDRouter compares the actual IPv6 global address and prefix information obtained from the DUT with the expected values defined in the CDRouter configuration file.
Regardless of which LAN mode is implemented, the expected global IPv6 address and prefix used by the DUT on the LAN is largely dependent on the IPv6 WAN mode that is selected. With certain WAN modes, LAN side prefix information is assumed to be learned or calculated dynamically, whereas with other WAN modes manual configuration of LAN side prefix information is required.
| IPv6 WAN Configuration | IPv6 LAN Mode ipv6LanMode |
DUT's IPv6 WAN Address | DUT's IPv6 LAN Prefix |
| 1 | autoconf or DHCP | manually configured | manually configured |
| 2 | autoconf or DHCP | manually configured | manually configured* |
| 3 | autoconf or DHCP | no address | manually configured |
| 4 | autoconf or DHCP | DHCPv6 NA | DHCPv6 PD |
| 5 | autoconf or DHCP | no address | DHCPv6 PD |
| 6 | autoconf or DHCP | no address | 6to4 |
| 7 | autoconf or DHCP | no address | 6rd |
| 8 | autoconf or DHCP | autoconf | manually configured |
| 9 | autoconf or DHCP | autoconf | DHCPv6 PD |
| 10 | autoconf or DHCP | DHCPv6 NA | manually configured |
| 11 | autoconf or DHCP | DHCPv6 NA | DHCPv6 PD |
* Note that in this mode of operation the prefix portion of the testvar ipv6LanIp must be explicitly specified and must match the prefix assigned by CDRouter's DHCPv6 server to the DUT, as specified by the testvar dhcpv6WanAssignPrefix.
For configurations where the DUT's global IPv6 prefix must be manually configured (configurations 1, 2, 3, 8, and 10 above), the testvar ipv6LanIp should match the DUT's LAN side global IPv6 address exactly, and should be a complete IPv6 address including both a prefix and host identifier. CDRouter automatically determines the expected global IPv6 prefix used by the DUT on the LAN using the ipv6LanIp and ipv6LanPrefixLen testvars.
When using IPv6 WAN configurations 4, 5, 6, 7, 9, or 11 above, the DUT is expected to dynamically update prefix information on the LAN based on information either learned or calculated from the WAN and/or WAN settings. For these configurations, the expected LAN IPv6 prefix is deterministic. As a result, the testvar ipv6LanIp need only include a host identifier. If a prefix is included it will be ignored by CDRouter.
The following testvars describe the basic IPv6 configuration of the LAN interface.
| ipv6LanMode | This option specifies the mode, or protocol, used by CDRouter to obtain IPv6 addresses on the LAN. CDRouter currently supports the following LAN-side IPv6 address acquisition modes: * autoconf * DHCP * router * none If DHCP is chosen, the DHCPv6 address pool used by the DUT must also be configured. Note that when DHCPv6 is enabled, CDRouter will use DHCPv6 pool range to determine the validity of IPv6 addresses received by its DHCPv6 clients. CDRouter's DHCPv6 clients expect to receive an IPv6 address within the specified DHCPv6 pool range. The router option is used in test scenarios where the DUT is not a gateway, or does not support address provisioning for LAN clients via autoconf or DHCP. In router mode CDRouter will automatically transmit Router Advertisements on the LAN and advertise a global IPv6 prefix based on the prefix portion of the testvar ipv6LanIp. CDRouter will also configure its primary LAN interface with an IPv6 address based on the Router Advertisements it sends. The most common test scenario for router mode is testing a standalone storage device. |
Values: autoconf | DHCP | dhcp | router | none | |
| Example: testvar ipv6LanMode autoconf |
| ipv6LanIp | This parameter specifies the DUT's expected LAN side global IPv6 address. The keyword "%eui64%" can be used for the host ID portion of this address. When "%eui64%" is used, CDRouter will automatically calculate the expected host ID portion of the DUT's LAN IPv6 address based on the EUI64 representation of its LAN MAC address. For IPv6 WAN modes where the prefix is deterministic, such as "6to4" or "6rd", or when DHCPv6 prefix delegation is enabled, the prefix portion of this address may be omitted. Some examples: testvar ipv6LanIp 2004::1 testvar ipv6LanIp 2004::%eui64% testvar ipv6LanIp ::%eui64% (suitable for 6to4, 6rd, or prefix delegation configurations only) |
| Example: testvar ipv6LanIp 2004::1 |
| ipv6LanPrefixLen | This parameter specifies the prefix length of the DUT's LAN side global IPv6 address. This value should match the value configured on the DUT and must be an integer value between 8 and 64. |
Values: decimal from 8 to 64 | |
| Example: testvar ipv6LanPrefixLen 64 |
| ipv6MaxLanClients | This parameter specifies the maximum number of IPv6 LAN clients CDRouter will attempt to create during the scaling tests. If the IPv6 LAN mode is configured The default value is 10. If the IPv6 LAN mode is set to "dhcp", the DHCPv6 client pool will be used to determine the maximum number of LAN clients to create during the scaling tests if the pool size is less than ipv6MaxLanClients. Alternatively, if the DHCPv6 pool size is greater than ipv6MaxLanClients, the number of LAN clients created during the scaling tests will be capped at ipv6MaxLanClients. Note that the maximum number of clients that can be created during the scaling-v6.tcl test module is 512. |
Values: decimal from 2 to 512 | |
| Example: testvar ipv6MaxLanClients 10 |
| ipv6RAInterval | This parameter specifies the maximum expected Router Advertisement interval supported by the DUT. CDRouter will wait up to this number of seconds for Router Advertisements on the LAN. The default value is 300 seconds. |
Values: decimal from 1 | |
| Example: testvar ipv6RAInterval 300 |
| ipv6LanSubnetId | This parameter specifies a hex string which represents the subnet ID portion of the DUT's LAN IPv6 prefix. This parameter is only used by CDRouter when the WAN mode is "6to4" or "6rd", or when DHCPv6 prefix delegation is enabled. In 6to4 terminology the subnet ID is referred to as the SLA ID and is fixed at 16 bits. As a result, this parameter should be four or less hex characters when 6to4 is used. In 6rd and DHCPv6-PD modes the subnet ID field can be variable length. |
| Example: testvar ipv6LanSubnetId ffff testvar ipv6LanSubnetId 1 |
| dhcpv6ClientTimeout | This parameter specifies the amount of time, in seconds, that DHCPv6 clients created on the LAN by CDRouter will wait for a response from the DUT's DHCPv6 server. This timeout may need to be increased when testing slow DHCPv6 server implementations. |
Values: decimal | |
| Example: testvar dhcpv6ClientTimeout 5 |
| ipv6DhcpClientStart | This parameter specifies the host identifier portion of the first IPv6 address in the DUT's DHCPv6 address pool. This value should match the value configured on the DUT. CDRouter will automatically determine the correct prefix for this address based on the IPv6 WAN mode being used. If the IPv6 WAN mode is "6to4", CDRouter will use the expected 6to4 prefix for the prefix portion of the DHCPv6 address pool. If the IPv6 WAN mode is "static", CDRouter will calculate the IPv6 prefix based on the IPv6 LAN IP and prefix length. |
Values: A valid IPv6 address | |
| Example: testvar ipv6DhcpClientStart ::2 |
| ipv6DhcpClientEnd | This parameter specifies the host identifier portion of the final IPv6 address in the DUT's DHCPv6 address pool. This value should match the value configured on the DUT. CDRouter will automatically determine the correct prefix for this address based on the IPv6 WAN mode being used. If the IPv6 WAN mode is "6to4", CDRouter will use the expected 6to4 prefix for the prefix portion of the DHCPv6 address pool. If the IPv6 WAN mode is "static", CDRouter will calculate the IPv6 prefix based on the IPv6 LAN IP and prefix length. |
Values: A valid IPv6 address | |
| Example: testvar ipv6DhcpClientEnd ::1F |
| ipv6DhcpClientExclude | This parameter parameter specifies a list of IPv6 addresses that are excluded from the DHCPv6 pool. All excluded addresses must be contained within the configured DHCPv6 pool. |
| Example: testvar ipv6DhcpClientExclude "::3 ::7" |
| dhcpv6RapidCommit | This option defines whether or not the DHCPv6 server on the LAN side of the DUT supports the DHCPv6 Rapid-Commit Option. The default value is yes. Rapid-Commit testing on the LAN will be skipped if the value is set to no. |
Values: yes|no | |
| Example: testvar dhcpv6RapidCommit no |
| dhcpv6ClientOptionRequest | The testvar dhcpv6ClientOptionRequest can be used to request extra options from the DUT’s DHCPv6 server on the LAN. If configured, CDRouter’s LAN DHCPv6 client(s) will request these specific options from the server. |
| Example: testvar dhcpv6ClientOptionRequest "21 22" |
| dhcpv6ClientOptionCode* | CDRouter’s DHCPv6 LAN clients may be configured with up to 10 additional options using the dhcpv6ClientOptionCode* and dhcpClientOptionData* testvars. Client side options are configured the same way as the existing DHCPv6 server side options. Each DHCPv6 option is configured using a testvar entry for the option code and another for the raw hex data. The DHCP option data must be converted into the raw ascii hex format. The total option length will be computed automatically. |
Values: decimal from 1 to 255 | |
| Example: testvar dhcpv6ClientOptionCode 124 |
| dhcpv6ClientOptionData* | CDRouter’s DHCPv6 LAN clients may be configured with up to 10 additional options using the dhcpv6ClientOptionCode* and dhcpClientOptionData* testvars. Client side options are configured the same way as the existing DHCPv6 server side options. Each DHCPv6 option is configured using a testvar entry for the option code and another for the raw hex data. The DHCP option data must be converted into the raw ascii hex format. The total option length will be computed automatically. |
| Example: testvar dhcpv6ClientOptionData 000000000401020304 |
IPv6 DNS Configuration
The following testvars relate to the basic IPv6 DNS configuration of the test environment.
| ipv6DNStoLAN | This parameter specifies whether or not the DUT supports IPv6 DNS relay functionality. This option should be enabled if the DUT is configured to relay the IPv6 DNS servers learned on the WAN side to clients on the LAN via DHCPv6 options or the Neighbor Discovery RDNSS option. This parameter should be disabled if the DUT announces its LAN side IPv6 address as the DNS server to all clients on the LAN. |
Values: yes|no | |
| Example: testvar ipv6DNStoLAN no |
| ipv6WanDnsServer | This parameter specifies the IPv6 address of the primary DNS server created by CDRouter. |
Values: A valid IPv6 address | |
| Example: testvar ipv6WanDnsServer 3001:51a:cafe::2 |
| ipv6WanBackupDnsServer | This parameter specifies the IPv6 address of the backup DNS server created by CDRouter. |
Values: A valid IPv6 address | |
| Example: testvar ipv6WanBackupDnsServer 3001:51a:cafe::3 |
| ipv6RdnssSupport | This parameter specifies whether or not the DUT supports the Router Advertisement Recursive DNS Server (RDNSS) option (25) defined in RFC 6106. If the DUT does not support the RDNSS option, this parameter should be set to "no". |
Values: yes|no | |
| Example: testvar ipv6RdnssSupport yes |
| dnsHostname* | This parameter specifies the hostname portion of user configurable DNS entries which will be automatically added to CDRouter's DNS servers. Up to 100 custom DNS mappings may be defined. |
| Example: testvar dnsHostname1 foo.test.com testvar dnsIp1 5.5.5.5 testvar dnsHostname2 ipv6host.test.com testvar dnsIp2 3001:4860:0:2222::68 testvar dnsHostname3 test.qacafe.com testvar dnsIp3 “5.5.5.5 3001:cafe::1 7.7.7.7” |
| dnsIp* | This parameter specifies the IP address portion of user configurable DNS entries which will be automatically added to CDRouter's DNS servers. The IP address may be an IPv4 or IPv6 address. Up to 100 custom DNS mappings may be defined. |
| Example: testvar dnsHostname1 foo.test.com testvar dnsIp1 5.5.5.5 testvar dnsHostname2 ipv6host.test.com testvar dnsIp2 3001:4860:0:2222::68 testvar dnsHostname3 test.qacafe.com testvar dnsIp3 “5.5.5.5 3001:cafe::1 7.7.7.7” |
| dnsLookupTimeout | This parameter specifies the DNS lookup timeout. The default value of 5 seconds and can be adjusted if the DUT's DNS proxy implementation is slow to respond to DNS queries. |
Values: decimal | |
| Example: testvar dnsLookupTimeout 5 |
IPv6 General Purpose Networking Configuration
The following testvars define the CDRouter’s IPv6 remote host address and the IPv6 free network range.
| ipv6RemoteHost | This parameter specifies the IP address of an IPv6-enabled remote host created by CDRouter on the WAN side of the network. This host will be used for verification of LAN to WAN and WAN to LAN traffic through the DUT, and is commonly referred to as the **IPv6 Remote Host**. |
Values: A valid IPv6 address | |
| Example: testvar ipv6RemoteHost 3001:051a:cafe::1 |
| ipv6FreeNetworkStart | This parameter specifies the starting IPv6 address of a free network range on the WAN. IPv6 addresses from the free network range may be allocated to WAN hosts created by CDRouter during certain test cases, and should not conflict with any of the other IP addresses configured within CDRouter. |
Values: A valid IPv6 address | |
| Example: testvar ipv6FreeNetworkStart 3001:cafe:1:: |
| ipv6FreeNetworkStop | This parameter specifies the ending IPv6 address of a free network range on the WAN. IPv6 addresses from the free network range may be allocated to WAN hosts created by CDRouter during certain test cases, and should not conflict with any of the other IP addresses configured within CDRouter. |
Values: A valid IPv6 address | |
| Example: testvar ipv6FreeNetworkStop 3001:ffff:ffff:: |
| ipv6FreeNetworkPrefixLen | This parameter specifies the IPv6 prefix length of the IPv6 free network range. The prefix length must be between 8 and 64. |
Values: decimal from 8 to 64 | |
| Example: testvar ipv6FreeNetworkPrefixLen 64 |
IPv6 Firewall Configuration
The following testvars define the configuration of the DUT’s IPv6 firewall and the associated test environment.
| ipv6FirewallTcpClosedPorts | This parameter specifies a list of TCP ports that are expected to be closed by the DUT on the WAN interface for IPv6. These ports will be verified as closed ports during the port scan tests. The special keyword **all** may be used for non-stealth devices that report all TCP ports closed. To configure the range of ports that are scanned, please see the "Scan Start Port" and "Scan Stop Port" parameters in the **Port Scan/Firewall Configuration** section of this wizard. |
| Example: testvar ipv6FirewallTcpClosedPorts "2323" |
| ipv6FirewallUdpClosedPorts | This parameter specifies a list of UDP ports that are expected to be closed by the DUT on the WAN interface for IPv6. These ports will be verified as closed ports during the port scan tests. The special keyword **all** may be used for non-stealth devices that report all UDP ports closed. To configure the range of ports that are scanned, please see the "Scan Start Port" and "Scan Stop Port" parameters in the **Port Scan/Firewall Configuration** section of this wizard. |
| Example: testvar ipv6FirewallUdpClosedPorts "113" |
| ipv6FirewallTcpOpenPorts | This parameter specifies a list of TCP ports that are expected to be open or accessible from the DUT's WAN interface for IPv6. These ports will be verified as open ports during the port scan tests. To configure the range of ports that are scanned, please see the "Scan Start Port" and "Scan Stop Port" parameters in the **Port Scan/Firewall Configuration** section of this wizard. |
| Example: testvar ipv6FirewallTcpOpenPorts "22 443" |
| ipv6FirewallUdpOpenPorts | This parameter specifies a list of UDP ports that are expected to be open or accessible from the DUT's WAN interface for IPv6. These ports will be verified as open ports during the port scan tests. To configure the range of ports that are scanned, please see the "Scan Start Port" and "Scan Stop Port" parameters in the **Port Scan/Firewall Configuration** section of this wizard. |
| Example: testvar ipv6FirewallUdpOpenPorts "1234" |
| ipv6WanPingRespond | This parameter indicates if the DUT will respond to ICMPv6 Echo Requests on its WAN interface. The default value is 'no', indicating the DUT will not answer an ICMPv6 ping from the WAN. |
Values: yes|no | |
| Example: testvar ipv6WanPingRespond no |