Upgrading 6381 1.0 to 1.1

bringing broadband to the world

6381 ADSL/R Router

Upgrading 6381 1.0 to 1.1

Applicable 1.0 Releases:	1.0.2, 1.0.3
Prerequisites:	telnet client ftp server capable of supporting "Passive Mode" Upgrade Package, 6381_0101xx.zip
Preparation:	Unzip the Upgrade Package and copy files to an ftp server directory as described in Preparing Files for Upgrade Review the section entitled Configuration Database Migration If the 6381 is configured as a bridge, see Configuring a Default Gateway Review the section entitled Password Migration Review the example shown in the section entitled Sample Session

Procedure

Step	Command	Description
1.	telnet ipaddr	Access the 6381 telnet UI: ipaddr is the 6381 IP address
2.	login	login: User name root Password abc123
3.	cd /var/tmp	Change to a writeable directory
4.	wget ftp://username:password@ipaddr/upgrade	Get the upgrade driver: username and password are used for ftp server login ipaddr is the ftp server IP address
5.	chmod 755 upgrade	Make the upgrade driver executable
6.	./upgrade ipaddr username password path	Run the upgrade driver: ipaddr is the ftp server IP address username and password are used for ftp server login path specifies the location of the files on the ftp server ("/" for ftproot) The upgrade driver will: Validate parameters, get and run the script 6381_upgrade.sh Analyze the current configuration Get a Configuration File template from the ftp server Prompt for a Default Gateway, if the unit is configured as a bridge Update the template and write it to flash Get and install the 1.1 firmware Reboot the unit

Note

After upgrading from 1.0 to 1.1 you must clear your web browser cache in order to gain access to the 1.1 web interface.

Preparing Files for Upgrade

The Upgrade Package zip file contains all files required for upgrade:

The binaries directory contains run-time files which are loaded into 6381 flash
The directory 01_00 contains files used specifically for upgrade from 1.0 to 1.1
The directory 01_01 contains files used for upgrade from 1.1 to a newer 1.1 release (not used in this procedure)

Directory	Filename	Contents	Format
binaries	6381_0101xx.bin	Kernel Binary	binary
	6381_0101xx.img	Filesystem Image	binary
01_00	upgrade	Upgrade driver script	ascii
	6381_upgrade.sh	Upgrade procedure script	ascii
	bridged.xml	Bridged Configuration Template	ascii
	dhcp.xml	DHCP Configuration Template	ascii
	static.xml	Static Configuration Template	ascii
	pppoe.xml	PPPoE Configuration Template	ascii
	pppoa.xml	PPPoA Configuration Template	ascii
	cfgupgrade	Configuration Upgrade Utility	binary
	download	Firmware Download Utility	binary
	crc	CRC Check Utility	binary
01_01		Files used to upgrade from a previous 1.1 release

To prepare the files for upgrade:

Unzip the Upgrade Package.
Create a new directory accessible to the ftp server.
Copy all files from both the binaries and the 01_00 directory into the new directory.

Configuration Database Migration

The 6381 1.0 Configuration Database is incompatible with 1.1 and is migrated during the upgrade. The primary purpose of database migration is to preserve enough of the configuration for the unit to function properly and to be managed in-band after the upgrade.

Firewall configuration is significantly different in 1.1 and, as such, is not migrated. The firewall will be disabled after the upgrade is complete.

The following table lists the items which are migrated during the upgrade. All listed items are automatically installed in the 1.1 configuration file. All items not listed must be manually configured after re-boot.

Category	Item
General	Hostname
	Password
	Ethernet IP Address
	Ethernet IP Subnet Mask
	VPI/VCI
Static	WAN IP Address
	WAN IP Subnet Mask
	WAN Gateway
	DNS 1-3
PPP	User
	Password
PPPoA	Protocol
DHCP	Enable/Disable
	Starting Address
	Ending Address

Configuring a Default Gateway

For units configured as a bridge, 6381 Release 1.1 requires configuration of a default gateway for upstream management traffic.

The user will be prompted during the upgrade, as follows:

This unit is in bridged mode.Release 1.1.x requires a default gateway for upstream management traffic.Please enter default gateway: 135.26.23.254You entered: 135.26.23.254OK? [y|n]: y

Password Migration

Release 1.0 allows a single, configurable password for web access and a fixed telnet user and password.

Release 1.1 supports a single configurable user id and password for web access, with the same password used for telnet.

The following table describes the Password Migration procedure.

	Release 1.0 Default	Release 1.1 Default	Release 1.1 After Upgrade
telnet	User: root Password: abc123	User: root Password: Admin	User: root Password: 1.0 web password (default admin)
web	Password: admin	User: Admin Password: Admin	User: Admin Password: 1.0 web password (default admin)

Sample Session

Following is a sample upgrade session.

In this example:

The IP Address of the 6381 is 135.26.23.81
The IP Address of the ftp server is 135.26.4.74
The ftp server username/password is anonymous/none
All files are installed in the directory 01_00 (relative to the ftp server root directory)
Bold text represents user-entered commands and responses

telnet 135.26.23.81
Trying 135.26.23.81...
Connected to 135.26.23.81.
Escape character is '^]'.

BusyBox on (none) login: root
Password:

BusyBox v0.61.pre (2003.03.07-19:23+0000) Built-in shell (ash)
Enter 'help' for a list of built-in commands.

# cd /var/tmp
# wget -q ftp://anonymous:none@135.26.4.74/01_00/upgrade
# chmod 755 upgrade
# ./upgrade 135.26.4.74 anonymous none 01_00

bin: AVSAR : Firmware Revision:[01.00.03]
AVSAR : DSP Firmware Revision:[t010000]
img: 01.00.03 Fri Mar 7 14:07:04 EST 2003

IP:       135.26.4.74
User:     anonymous
Password: none
Dir:      01_00

ping 135.26.4.74
OK

get 6381_upgrade.sh
OK

run 6381_upgrade.sh

Checking current firmware revision
OK (01.00.03)

Checking FTP server for required files
OK

Getting validation utility
OK

Validating 6381_010102.bin
OK

Validating 6381_010102.img
OK

Saving current configuration
OK

Getting configuration upgrade utility
OK

Upgrading configuration

Analyzing current configuration
OK

This unit is in bridged mode.

Release 1.1.x requires a default gateway for upstream management traffic.

Please enter default gateway: 135.26.23.254

You entered: 135.26.23.254

OK? [y|n]: y

Password:       admin
Protocol:       NONE
VPI/VCI:        0/35
Ethernet IP:    192.168.1.1
Ethernet Mask: 255.255.255.0
Name:
DHCP Server:    DISABLED
Mode:           Bridged
Template:       bridged.xml

Getting configuration template: bridged.xml
OK

Loading configuration template
OK

Updating configuration template
OK

Writing updated configuration
OK

Getting download utility
OK

Killing unnecessary processes
OK

FIRMWARE UPDATE IN PROGRESS: DO NOT REMOVE POWER UNTIL COMPLETE

Installing 6381_010102.bin
OK

Installing 6381_010102.img
OK