Most of our ds-lite client tests are done on Linksys WRT-54GL V1.1.
In order to convert a Linksys WRT54GL into a DSLITE router, the following steps should be followed.
Download and decompress the following tarball, which contains all of the files that will be used in this procedure: dslite_gui_v1.0.tar.gz.
If the Linksys WRT54GL is running the Cisco Linksys firmware, you will need to flash it with the default Openwrt image: openwrt-wrt54g-squashfs.bin.
To start, connect the device’s factory firmware website at http://192.168.1.1. Once here, go to the administration screen, and then firmware upgrade. Here you will upload the file openwrt-wrt54g-squashfs.bin.
NOTE: The factory username is: admin The factory passwd is: admin
Once the upgrade is completed, reboot the box. But make sure to have waited several minutes for the firmware upgrade to have completed. After you installed the openwrt you must “telnet 192.168.1.1” and change the passwd. Once you change the passwd, telnet will no longer work. From this point on you will have to “ssh” into the Linksys box.
WARNING: You should only do this procedure if the linksys is running the original Linksys firmware. You MUST NOT do this if it has already been running Openwrt. If you “mtd” this image to your linksys, you will brick it.
This section describes installation steps for .trx image.
1) Telnet to router.
The router will have the default address 192.168.1.1.
2) Set a password for root.
3) Use SCP to do a secure copy of the .trx image into the router.
scp openwrt-brcm47xx-squashfs.trx email@example.com:/tmp
4) Login to router using SSH command
5) Go inside /tmp directory in router and install the newly copied firmware into the router using command:
mtd -r write openwrt-brcm47xx-squashfs.trx linux
Do not roboot till this operation is completed. On successful installation, router will automatically reboot. The IP address of the router will be set to 192.168.1.1.
NOTE: You will again need to telnet to the router and change the root password. After you changed the root password, you will have to ssh to the box from that point on.
If you want to change this IP address then goto /etc/config/network and change IP address for the LAN interface.
Afer you have completed loading the trx package, the next step is to load the firmware on the router. There is onloy one ipk file present in the DS-Lite release. It is called ipv6tunnel.ipk.
Use SCP to add the desired ipk file in the /tmp folder of the router:
scp ipv6tunnel.ipk firstname.lastname@example.org:/tmp
Then type the following command on the router command prompt:
opkg install ipv6tunnel.ipk -force-overwrite
Next, goto the /tmp directory of the router and type the following command:
After the setup.sh completes, the router will take around 40 seconds to reboot and you will need to ssh into the router once again.
You can then login to the GUI by typing:
You will see the release number at the top right of the web page.
Next, you will configure the DS-LITE Tunnel. This is done via the GUI interface of the DS-Lite Router. Open the browser and type the following URL:
Username/Password screen will be prompted. Type the username and password for the router. Upon successful login, the main GUI page for the X-Wrt will appear.
Click on the Ipv6tunnel tab.
You will see the Ipv6tunnel page as illustrated below:
Ensure that the Tunnel type is set to DS-Lite. You may ignore the other tunnel types.
In the beginning the tunnel settings default to DHCP DS-LITE for the tunnel automatically created without any user intervention. If DHCP values are not adjacent to the textboxes, refresh the webpage.
You may select dhcp or static. If you have selected DHCP the configured values will be shown in front of the respective parameter. It is important to note that the GUI allows the user to override “CGN IPv6 Address”, “IPv6 WAN Default Gateway”, and “Primary DNS”. This is done by the user manually entering the same in the textboxes provided. If you decide not to override these values, the DS-LITE tunnel will take all parameters from DHCP.
If STATIC is selected, you will enter the configuration parameters in the textboxes provided.
Next click on "Apply Changes" and the router will be rebooted.
After the router reboots the DS-LITE tunnel will be built using either DHCP or statically configured values depending on your selection above.
Your DS-LITE Router is ready. You may plug-in PC's on the LAN side of the router.
This optional section allows the user to configure and play with the fragmentation options. The various option settings are below:
DF bit set- this is a toggle for fragmentation checkbox. This checkbox has the following 2 conditions:
Case 1: When checked (Toggle ON) - DF bit is set, Packet is forwarded to DS-LITE and ICMP error message is sent to host.
Case 2: When unchecked (Toggle OFF) - DF bit is set, Packet is dropped and ICMP error message is sent to host.
IPv6SMTU - This textbox allows the user to set the size of IPv6 MTU of DS-LITE tunnel for fragmentation of DS-LITE IPv6 packets. If this value is not entered by the user, the OS default value will be considered. The maximum value can be 65535. Minimum value can be 1280.
IPv4SMTU - This textbox allows the user to set the size of system MTU for IPv4. If this value is not entered by user, OS default value will be considered. Maximum value can be 65535. Minimum Value can be 68. When IPv6SMTU is entered by user, IPv4SMTU is automatically calculated, the value would be Ipv6smtu minus 40. This value is not used for fragmentation, no Ipv4 fragmentation happens in DS-LITE.
When the “Apply changes” button at the bottom of the screen is pressed, current values on the screen will be saved and the behavior will be retained on reboot. On “Apply changes”, the reboot will only occur when there is a change in ‘Tunnel type’ or in ‘Configuration type’. In rest of the cases, on ‘Apply changes’, there is no router reboot, only the changes are saved.