These files are example
config.boot
configuration files that can be be loaded on a factory-default Ubiquiti EdgeRouterLite (ERLite-3) or EdgeRouter POE (ERPOE-5) to enable dual-stack IPv4 & IPv6 networking on residential Comcast Xfinity networks.This channel type uses MAC message type 29 in the Upstream Channel Descriptor (UCD) sent on the downstream (DS) channel to ensure that only 2.0 CMs attempt to register. Provisioning a cable modem (CM) with its configuration file—in either 1.0 or 1.1 mode—is. DOCSISConfig-properties and open it with a text editor.
config.boot.erl
- Comcast Xfinity configuration file for EdgeRouter Liteconfig.boot.erx
- Comcast Xfinity configuration file for EdgeRouter Xconfig.boot.poe
- Comcast Xfinity configuration file for EdgeRouter POEconfig.gateway.json
- JSON-formatted file for UniFi Security Gateway (runs EdgeOS)
The default port/interface settings for each version of the example Comcast Xfinity
config.boot
files are:###Comcast config.boot.erl####
eth0
= WAN (Cable Modem)eth1
= Local Config Porteth2
= LAN
###Comcast Fiber config.boot.erx####
eth0
= WAN (Cable Modem)eth1
,eth2
,eth3
, ð4
= LAN (combined asswitch0
)
###Comcast config.boot.poe####
eth0
= WAN (Cable Modem)eth1
= Local Config Porteth2
,eth3
,eth4
= LAN (combined asswitch0
)
###Comcast config.gateway.json####
eth0
= WAN (Cable Modem)eth2
= LAN
For all the files,
eth0
is always the WAN interface and eth2
is always a valid LAN port to use during testing.Copy the raw contents of the appropriate
config.boot
file into your local clipboard.Then create a blank config.boot
file in /home/ubnt
with:Once inside the vi editor, turn off the auto-indenting feature before you paste by typing
and pressing
ENTER
. If you’re not familiar with vi, make sure you type the :
whenever they’re shown in this guide.Now enter “insert” mode by pressing lowercase
i
(you don’t need ENTER
after the i
command).Paste the copied raw
config.boot
file from your local system’s clipboard using your terminal client’sPaste menu item or keyboard shortcut (usually CTRL-V
on PC, Command-V
on Mac, etc.). Now write and quitthe file by typing:and then
ENTER
.Now you’re ready to copy your new
config.boot
file over the EdgeRouter’s default config.boot
file with:You can apply the new
config.boot
file by rebooting the router with the reboot
command, or with:Following the instructions in this guide to learn more about how to apply the settings in the included
config.gateway.json
file to a USG via the UniFi Controller:Be extremely careful when creating or editing a
config.gateway.json
file, as including malformed configuration options in a config.gateway.json
file can lead to a provisioning loop. This is considered an advanced configuration option.Based on the most recent IPv6 information from Comcast, residential customers should be requesting IPv6 addressing with a prefix length of
/60
(which is what is used in these examples). Commercial customers should use a prefix length of /56
.If you edit the IPv6 settings in your
config.boot
and want to apply them immediately, do:Change
eth0
as needed to match your configuration's WAN interface.Test your connection for IPv6 support by visiting these websites:
Contents
Introduction
Cisco Cable Modem (CM) cards allow you to connect CMs on the Hybrid Fiber Coaxial (HFC) network to a Cisco uBR7200 series in a Cable Television (CATV) headend facility. The CM cards provide the interface between the Cisco uBR7200 series Peripheral Component Interconnect (PCI) bus and the Radio Frequency (RF) signal on the HFC network.
Before You Begin
Conventions
For more information on document conventions, see the Cisco Technical Tips Conventions.
Prerequisites
Readers of this document should be knowledgeable of the following:
![Editor Editor](/uploads/1/2/6/4/126400877/630670903.jpg)
- Dynamic Host Configuration Protocol (DHCP) and option MUST be included, with the hardware type set to 1, and the value set to the same 48 bit MAC address as the chaddr field.
- The 'parameter request list' option MUST be included. The option codes that MUST be included in the list are:
- Option code 1 (Subnet Mask).
- Option code 2 (Time Offset).
- Option code 3 (Router Option).
- Option code 4 (Time Server Option).
- Option code 7 (Log Server Option).
- For DOCSIS 1.0 cable modems, the Vendor Class Identifier (Option 60) MAY be set to include the string 'docsis 1.0'. For modems running higher versions of DOCSIS a string indicating the capabilities of the Cable Modem MUST be included in the Vendor Class Identifier (Option 60) (For example 'docsis1.1:xxxxxx' where xxxxxx is an ASCII representation of the modem capabilities.
The following fields are expected in the DHCP response returned to the CM. The CM MUST configure itself based on the DHCP response.
- The IP address to be used by the CM (yiaddr).
- The IP address of the TFTP server for use in the next phase of the bootstrap process (siaddr).
- If the DHCP server is on a different network (requiring a relay agent), then the IP address of the relay agent (giaddr).Note: This MAY differ from the IP address of the first hop router.
- The name of the CM configuration file to be read from the TFTP server by the CM (file).
- The subnet mask to be used by the CM (Subnet Mask, option 1).
- The time offset of the CM from Universal Coordinated Time (UTC) (Time Offset, option 2). This is used by the CM to calculate the local time for use in time-stamping error logs.
- A list of addresses of one or more routers to be used for forwarding CM-originated IP traffic (Router Option, option 3). The CM is not required to use more than one router IP address for forwarding.
- A list of [RFC-868] time-servers from which the current time MAY be obtained (Time Server Option, option 4).
- A list of SYSLOG servers to which logging information MAY be sent (Log Server Option, option 7); please see the CableLabs DOCSIS Specifications .
Configuration File Settings
The following configuration settings MUST be included in the configuration file and MUST be supported by all CMs.
- Network Access Configuration Setting.
- Class of Service Configuration Setting.
- End Configuration Setting.
In order for CPE devices connected to the CM to be granted network connectivity, the Network Access value must be set to 1. Also, the CM needs a profile for Class of Service depending on the service level agreement with the customer.
Cisco supplies sample DOCSIS 1.0 configuration files in the 'Downloadable DOCSIS configuration Files' section of the document Building DOCSIS 1.0 Configuration Files Using Cisco DOCSIS Configurator.
Lastly, the configuration file MUST have an 'End of File' marker. This in done by a data maker, the values MUST be ff..
The following configuration settings MAY be included in the configuration file and if present MUST be supported by all CMs.
- Downstream Frequency Configuration Setting
- Upstream Channel ID Configuration SettingOne important note to make is that on the CM configuration file the value is entered from 1-6 and the Cisco uBR72xx router sends a UCD from 0-5. If a value of zero is used for the Upstream Channel ID configuration setting, this typically indicates to a dual modem telephone company (telco)-return/two-way CM that it should use the telco-return mode of operation.
- Baseline Privacy Configuration Setting. In order for this to work, there are four conditions:
- The CM MUST have a software image that supports baseline privacy.
- The CMTS MUST have software image that supports baseline privacy.
- The Baseline Privacy field MUST be enabled with a 1.
- If the CMTS is DOCSIS 1.1 enabled then at least one of the Baseline Privacy configurations settings must be configured. This means that one of Authorize Wait Timeout, Reauthorize Wait Timeout, Authorization Grace Time, Operational Wait Timeout, Rekey Wait Timeout, TEK Grace Time or Authorize Reject Wait Timeout must be set.
- Software Upgrade Filename Configuration Setting.
- Simple Network Management Protocol (SNMP) Write-Access Control.
- SNMP MIB Object.
- Software Server IP Address.
- Customer premises equipment (CPE) Ethernet MAC Address.
- Maximum Number of Hosts on the ethernet port of the CM (CPEs) in the range 1 through to 255. If a value is not set, the default is set to 1.
- Pad Configuration Setting.
The Telephone Settings Option configuration MAY be included in the configuration file and if present, and applicable to this type of modem, MUST be supported.
The Vendor-Specific Configuration Settings MAY be included in the configuration file, and if present, MAY be supported by a CM.
Depending on the RF design and the services provided by the Multiple Service Operator (MSO), additional fields are used in the CM configuration file.
If you have further questions or want to get full details on this document, refer to CableLabs .