F

FTP Server



F.1    Introduction

If you have an Ethernet or other fast IP connection between your development host and target, you can take advantage of the image-download facility that is built into the VxWorks boot ROMs. This facility allows you to establish a completely new VxWorks run-time system on your target when you change the VxWorks configuration or when you link your application statically into the run-time.

The boot-ROM download mechanism depends on the Internet transfer protocol known as FTP (file transfer protocol). Thus, to download new run-time images from your Windows host, you must configure and run an FTP server there.

We recommend that you install (as an NT service) the FTP server provided by the operating system, when you install TCP/IP.

As an alternative, Tornado includes an FTP server called WFTPD, a product of Texas Imperial Software. Your copy is licensed as part of the Tornado license. The remainder of this appendix discusses how to set up WFTPD as an FTP server.



F.2    Starting WFTPD

The WFTPD utility is distributed as installDir\host\x86-win32\bin\wftpd32.exe. If you plan to use FTP as the normal means of booting VxWorks, one of the following options may work for you:

  • To start wftpd32 manually, include it in the Tornado program group.

  • To start wftpd32 automatically when you start your Windows NT host, add wftpd32 to Start Menu Programs (Start>Settings>Taskbar>Start Menu Programs).

  • To start wftpd32 automatically when you start your Windows 2000 host, add wftpd32 to Startup Folder. From the Taskbar and Start Menu select the Advanced tab and the Add button. In the Create Shortcut wizard browse to wftpd32.exe and choose Start Menu>Programs>Startup Folder.



F.3    WFTPD Configuration

Before an FTP client can connect to WFTPD, you must specify the following information:

  • A user ID. Choose whatever arbitrary name you wish as the user ID for the VxWorks boot ROM. Be sure to specify the same name as the user (u) VxWorks boot parameter described in 2.5.4 Description of Boot Parameters.

  • A password for that user ID. Use any memorable arbitrary string, and be sure to specify the same string as the ftp password (pw) VxWorks boot parameter described in 2.5.4 Description of Boot Parameters.

  • A home directory. The VxWorks boot ROM does not require this information, but WFTPD refuses to connect to a client unless you specify a home directory. Any directory will do, so long as you permit sufficient disk access for the VxWorks boot ROM to read the boot image on your Windows disk.

To specify this information, carry out the following steps:

  1. Open the WFTPD window and select the Users/rights command from the Security menu (Figure F-1).

Figure F-1:   WFTPD Security Menu

  1. WFTPD displays the User / Rights Security Dialog box shown in Figure F-2. Click the New User button; another dialog box appears where you can enter the user name (also shown in Figure F-2).

Figure F-2:   Adding a New User for WFTPD

  1. After you specify the user name and click OK, WFTPD displays a third dialog box where you can specify the password (Figure F-3). Because the password does not display as you type it, you must type it twice to make sure the correct password is recorded.
  1. After defining the new user ID and password, be sure to fill in the Home Directory text box before dismissing the User / Rights Security Dialog box by clicking Done.

Figure F-3:   WFTPD Password Dialog Box


*      
NOTE: You can run the FTP server as a restricted user, but you cannot add new users and passwords if you are a restricted user. A non-restricted user must add the new users and passwords for you.