NetComm Whitepaper TR-069 User manual

Vodafone MachineLink 3G
TR-069 Whitepaper

2
Vodafone MachineLink 3G – TR-069 Whitepaper
vodafone.netcommwireless.com
Copyright
Copyright© 2013 NetComm Wireless Limited. All rights reserved.
Copyright© 2013 Vodafone Group Plc. All rights reserved.
The information contained herein is proprietary to NetComm Wireless and Vodafone. No part of this document may be translated, transcribed,
reproduced, in any form, or by any means without prior written consent of NetComm Wireless and Vodafone.
Please note: This document is subject to change without notice.
DOCUMENT VERSION DATE
Initial document release March 2013
Table 1 - Document Revision History
Note: Before performing the instructions in this guide, please ensure that you have the latest firmware version installed on your router.
Visit http://vodafone.netcommwireless.com to download the latest firmware.

Vodafone MachineLink 3G – TR-069 Whitepaper
3
vodafone.netcommwireless.com
Table of contents
Introduction ..................................................................................................................................................................................................................................................................................4
Considerations with TR-069................................................................................................................................................................................................................................................................. 4
TR-069 Remote CPE Management Connection Diagram..........................................................................................................................................................................................................5
Establishing a connection between a MachineLink 3G Router and Auto Configuration Server ..................................................................................................................................5
TR-069 ACS Server Configuration......................................................................................................................................................................................................................................................6
TR-069 CPE Configuration....................................................................................................................................................................................................................................................................9
MachineLink 3G Remote Firmware Upgrade/Downgrade Using TR-069 ......................................................................................................................................................................... 11
Triggering a connection request via SMS..................................................................................................................................................................................................................................... 15

4
Vodafone MachineLink 3G – TR-069 Whitepaper
vodafone.netcommwireless.com
Introduction
The Vodafone MachineLink 3G Router supports the Technical Report 069 (TR-069) standard published by the Broadband Forum for remote
customer-premises equipment (CPE) administration and management.
The TR-069 standard was developed for automatic configuration of CPE devices such as as modems, routers, gateways, set-top boxes, and VoIP-
phones with Auto Configuration Server (ACS). An increasing number of network carriers and ISPs are using TR-069 ACS to mass deploy, administer
and manage their TR-069-ready CPE remotely.
The purpose of this whitepaper is to demonstrate how to establish a connection between a Vodafone MachineLink 3G Router with an ACS server
and how to perform a firmware upgrade remotely via TR-069 on Vodafone MachineLink 3G Routers.
Other TR-069 operations are described in a separate document including:
GetParameterNames : Retrieve list of supported parameter names from the device.
GetParameterValues: Retrieve one or multiple the current monitoring parameters values.
SetParameterValues: Sets the value of one or multiple parameters.
GetParameterAttributes: Retrieves the current monitoring (Active/Passive/None) set on a parameter or multiple parameters.
SetParameterAttributes: Sets attributes of one or multiple parameters
Retrieve Device System Log from ACS Server
Reboot: reboot CPE remotely from ACS Server
Factory Reset: restore CPE to factory default settings from ACS Server
In this white paper, for the purpose of demonstrating how to perform a device firmware upgrade via TR-069, a particular ACS was chosen for taking
screenshots. The exact procedures and steps may vary depending on the type of ACS used by the user. For privacy reasons, the login credentials
to the management URL of the ACS Server in this white paper has been replaced with http://xxx.xxx.xxx/management/ and the CPE connection
URLs were replaced with http://xxx.xxx.xxx/cpe.php. The ACS user name, password and CPE TR-069 Connection Request user name and password
used in this white paper are for test purposes only.
Considerations with TR-069
When configuring your MachineLink 3G for TR-069, you should ensure that the following considerations are addressed:
•The device must have IP address access to the ACS server which may pose a problem on some private networks
•The device must have a publicly routable IP address for connection requests to work

Vodafone MachineLink 3G – TR-069 Whitepaper
5
vodafone.netcommwireless.com
TR-069 Remote CPE Management Connection Diagram
Figure 1: Vodafone MachineLink 3G TR-069 Remote CPE Management
Establishing a connection between a MachineLink 3G Router and Auto
Configuration Server
Before establishing the connection between the Vodafone MachineLink 3G Router and the ACS server, please check the following:
Ensure the relevant version of firmware is loaded in the MachineLink 3G Router that supports TR-069
Ensure the MachineLink 3G Router is loaded with a test SIM that supports an accessible WAN IP address. In this white paper, the SIM
used in the MachineLink 3G Router has a public IP address.
You have the ACS management URL, administrator user name and password for remote management
The MachineLink 3G Router TR-069 device product class name and serial number (SN) is registered in the ACS
You have the MachineLink 3G Router ACS CPE connection URL, ACS user name and password
You have the MachineLink 3G Router CPE TR-069 Connection Request user name and password
You have read the device manual and know how to connect and make device configuration via its web management interface

6
Vodafone MachineLink 3G – TR-069 Whitepaper
vodafone.netcommwireless.com
TR-069 ACS Server Configuration
Prior to configuring the MachineLink 3G Router, the device product class name and serial number must be registered on the Auto Configuration
Server.
Login to the ACS management URL
ACS server management URL: http://xxx.xxx.xxx/management/
Username: xxxx
Password: xxxx
Create the Device Model on ACS server
1. Navigate to Home > Manage Device Types
Figure 2: Manage Device Types option
2. Navigate to Home > Manage Device Models > Add Device Type
Figure 1: Add Device Type link
When creating a device model on the ACS, the OUI and the product class need to match the settings shown in Figure 3 below.
Figure 2: Vodafone MachineLink 3G product class name

Vodafone MachineLink 3G – TR-069 Whitepaper
7
vodafone.netcommwireless.com
Add the Device on the ACS server
1. Navigate to Home > Manage Devices > Add Device and fill in the add device form, then click Manage Devices.
Figure 3: Register TR-069 CPE serial number on ACS
2. Click the Add Device link.
Figure 4: Add Device link
The serial number is the last 6 digits of the MAC address of the device.
Figure 5: Adding the device to the ACS Server

8
Vodafone MachineLink 3G – TR-069 Whitepaper
vodafone.netcommwireless.com
To add multiple devices at once:
1. Click Import Device(s)
2. Click the Browse button and open a CSV file which is formatted as illustrated below:

Vodafone MachineLink 3G – TR-069 Whitepaper
9
vodafone.netcommwireless.com
TR-069 CPE Configuration
By default, the Vodafone MachineLink 3G Router is not pre-configured with active TR-069 client settings and the TR-069 feature is disabled.
To test the TR-069 features, you need to manually login via the router’s Ethernet interface to enable the TR-069 feature and configure it with the
relevant TR-069 client settings.
An example of the MachineLink 3G Router TR-069 client configuration is shown in Figure 8.
Figure 6: An example MachineLink3G Router TR-069 client configuration
The Auto Configuration Server relies on the router’s first device boot up or initial inform to learn the router’s WAN IP address. This can be triggered
by manually disabling and enabling the CPE TR-069 configuration or waiting for the periodic inform message from the CPE to the ACS server.
After the inform period has elapsed (600 seconds by default), the Last Contacted field shows the time of the last inform message indicating that
the MachineLink 3G Router is now part of the group and communicating with the ACS server.
Note: The ACS uses the last 6 characters of the device MAC address as the serial number.
Figure 7: First inform time stamp

10
Vodafone MachineLink 3G – TR-069 Whitepaper
vodafone.netcommwireless.com
The device inform message will contain the device’s current WAN IP address. This is viewable by clicking on the Device Data tab.
Figure 8: Viewing the device data tab
The TR-069 ACS Server and TR-069 M2M Router CPE connection has now been established. You may now start to perform a device firmware
upgrade remotely via TR-069.
Figure 9: ACS learns CPE WAN IP address