Creating the Run-Time Images for the IPv6 Test Lab (Windows CE 5.0)
The IPv6 test lab uses specific Windows CE-based run-time images. To build each run-time image and download it to a Windows CE-based device, follow the instructions in the order provided.
**Note **You must build CLIENT2 first because you need its IP address when building CLIENT1.
To build ROUTER1, you will follow some of the instructions in How to Create a Gateway. Before performing these steps, you must know the network cards and associated interface names in the target device. For information on network cards and interface names, see Configuring the Gateway Registry.
To build CLIENT2
In Platform Builder, create a new OS design. The following list shows the choices to make in the New Platform Wizard:
- Name the OS design CLIENT2.
- Choose the CEPC x86 BSP.
- Choose the EnterpriseWeb Pad design template.
- Ignore the Applications and Media Wizard page.
- Make sure Tcp/IPv6 support is selected.
For information about creating a new OS design, see Creating an OS Design.
To build the CLIENT2 run-time image, from the Build OS menu, ensure that the following are selected:
Copy Files to Release Directory after Build
Make Run-Time Image After Build
From the Build OS menu, choose Build and Sysgen.
The time required to build the run-time image depends on the Catalog items included in the OS design. You can observe the build process on the Build tab and by looking at the status icon at the bottom right of the IDE.
Configure a connection from the development workstation to the CLIENT2 CEPC target device. For more information about configuring this connection, see Configuring an Ethernet Remote Connection.
If you have not previously created a boot floppy disk for the CEPC, do so now. For more information, see Creating a Boot Floppy Disk for an x86 SDB.
To download the operating system (OS) image to the CEPC, from the Target menu, choose Attach Device.
If the download does not start within a few minutes, restart the CEPC.
After the image is downloaded, the UI appears on the CEPC.
On the CEPC, from a command prompt, run IPConfig.
Capture the IPv4 and IPv6 addresses for use later in these procedures.
To disconnect from the CEPC, perform the following steps:
- From the Debug menu, choose Stop Debugging.
- From the Target menu, choose Detach Device.
To build CLIENT1
In Platform Builder, create a new OS design. The following list shows the choices to make in the New Platform Wizard:
- Name the OS design CLIENT2.
- Choose the CEPC x86 BSP.
- Choose the EnterpriseWeb Pad design template.
- Ignore the Applications and Media Wizard page.
- Make sure Tcp/IPv6 support is selected.
For information about creating a new OS design, see Creating an OS Design.
To set up the Hosts file, perform the following steps. For more information, see Setting up a Hosts File.
From the Workspace window, choose the ParameterView tab.
Expand the nodes until you find the CEPC folder.
Expand the CEPC folder, and then expand the Project SpecificFiles folder.
Open the Project.reg file.
Type the following information:
;Set up Hosts file
[HKEY_LOCAL_MACHINE\Comm\Tcpip\Hosts\IPv6 CLIENT2]
"ExpireTime"=hex:FF,FF,FF,FF,FF,FF,FF,FF
"Ipaddr6"=hex:<CLIENT2IPv6 address><CLIENT2 ScopeID>
"Ipaddr"=hex:0a,00,03,02
Before you convert the addresses and scope ID to hexadecimal, you must expand them. Expand the IPv6 address to the full 16-bytes, expand the scope ID to 4-bytes, and then separate byte boundaries with a space.
You must also convert IPv4 to hexadecimal. For example, if the CLIENT2 IPv6 address and scope ID is 2000:::f1b3:240:5ff:fe70:2628%1, and the IPv4 address is 10.0.3.2, you would type:
"Ipaddr6"=hex:20,20,00,00,00,00,f1,b3,02,40,05,ff,fe,70,26,28,01,00,00,00
"Ipaddr"=hex:0a,00,03,02
For more information, see Expanding an IPv6 Address and Converting Decimal to Hexadecimal.
Save and close the Project.reg file.
To build the CLIENT1 run-time image, from the Build OS menu, ensure that the following are selected:
Copy Files to Release Directory after Build
Make Run-Time Image After Build
From the Build OS menu, choose Build and Sysgen.
The time required to build the run-time image depends on the Catalog items included in the OS design. You can observe the build process on the Build tab and by looking at the status icon at the bottom right of the IDE.
If an error occurs in the build, verify that you typed the information correctly in the Project.reg file. For more information, see Troubleshooting: Setting Up and Using the IPv6 Test Lab.
Configure a connection from a development workstation to the CEPC target device. For more information about configuring this connection, see Configuring the Connection to a Target Device Using Platform Manager.
If you have not previously created a boot floppy disk for the CEPC, do so now. For more information, see Creating a Boot Floppy Disk for an x86 SDB.
To download the run-time image to the CEPC, from the Target menu, choose Attach Device.
If the download does not start within a few minutes, restart the CEPC.
After the image is downloaded, the UI appears on the CEPC.
To disconnect from the CEPC, perform the following steps:
- From the Debug menu, choose Stop Debugging.
- From the Target menu, choose Detach Device.
To build ROUTER1
Follow the instructions in Creating a Gateway Run-time Image for a CEPC, with the following changes:
- Name the OS design ROUTER1.
- Select the Tcp/IPv6 support check box.
To configure the TCP/IP protocol, you must change the registry. Perform the following steps to open the Project.reg file:
- From the Workspace window, choose the ParameterView tab.
- Expand the nodes until you find the CEPC folder.
- Expand the CEPC folder, and then expand the Project Specific Files folder.
- Open the Project.reg file.
To configure the TCP/IP protocol for the interface on Subnet1, type the following information:
; Configure TCP/IP for the private interface, Subnet1
[HKEY_LOCAL_MACHINE\Comm\<Private Network Interface Name (Adapter 1)>\Parms\Tcpip]
"EnableDHCP"=dword:0
"IPAddress"="10.0.1.1"
"SubnetMask"="255.255.255.0"
To configure the TCP/IP protocol for the public interface on Subnet2, type the following information:
; Configure TCP/IP for the public interface, Subnet2
[HKEY_LOCAL_MACHINE\Comm\<Public Network Interface Name (Adapter 2)>\Parms\Tcpip]
"EnableDHCP"=dword:0
"IPAddress"="10.0.2.1"
"SubnetMask"="255.255.255.0"
Save and close the Project.reg file.
To build the ROUTER1 run-time image, from from the Build OS menu, ensure that the following are selected:
Copy Files to Release Directory after Build
Make Run-Time Image After Build
From the Build OS menu, choose Build and Sysgen.
The time required to build the run-time image depends on the number of Catalog items included in the OS design. You can observe the build process on the Build tab and by looking at the status icon at the bottom right of the IDE.
If an error occurs in the build, verify that you typed the information correctly in the Project.reg file. For more information, see Troubleshooting: Setting Up and Using the IPv6 Test Lab.
Configure a connection from a development workstation to the ROUTER1 CEPC target device. For more information about configuring this connection, see Configuring the Connection to a Target Device Using Platform Manager.
If you have not previously created a boot floppy disk for the CEPC, do so now. For more information, see Creating a Boot Floppy Disk for an x86 SDB.
To download the run-time image to the CEPC, from the Target menu, choose Attach Device.
If the download does not start within a few minutes, restart the CEPC.
To verify ROUTER1, perform the following steps:
- On the Target menu, choose CE Target Control.
- In the Target Control window, type s ipconfig /d.
- Verify that the IP addresses displayed are the ones that you entered.
See Also
How to Set Up and Use an IPv6 Test Lab | IPConfig
Send Feedback on this topic to the authors