NOTE: The installation instructions in this section also apply to any Tornado-compatible Wind River product that you have purchased separately. Optional products should be installed in the same directory tree as the version of Tornado for which they have been released.

	NOTE: If you plan to install Tornado 2.2 on a system that has the Beta version already installed, you must first uninstall the Beta version.

Before you install Tornado 2.2 on a Windows host, make sure that TCP/IP networking is installed. Tornado 2.2 can operate over a raw serial connection between the host and target systems, and can operate on standalone systems that have no network connection with other hosts. However, the Tornado 2.2 tools use the TCP/IP protocol to communicate with one another, and you must therefore have TCP/IP on your host even if it is not on a networked system. The Windows TCP/IP package is generally installed with the operating system. (See Start>Settings>Control Panel>Network>Protocols.) Consult your Windows documentation for information on installing and configuring TCP/IP.

Before you install Tornado 2.2 on a Windows host, long file names must be enabled (the default setting).

Insert one of the Tornado 2.2 CD-ROMs in the drive. Install the Core CD first, followed by the BSP/driver CD. The SETUP program starts automatically the first time you run it. On subsequent occasions, you can start SETUP again on Windows by displaying the contents of the CD-ROM drive (using Windows Explorer or a comparable file manager) and double-clicking on SETUP.EXE, which is at the root of the CD-ROM file system.

The SETUP program has online help that provides detailed information about the installation and license configuration process. Click on the Help button to access help from any dialog where the button is enabled (starting with the User Registration page).

Each SETUP dialog box also has a Cancel button, which you can use to exit from the installation program. To continue to the next box, click the Next button. To return to the previous box to review or change information you have entered, click the Back button (which is grayed-out if it cannot be used).

When SETUP starts, the Welcome dialog box appears. To continue, click Next.

The README.TXT window appears next. When you have finished reviewing the information contained in the window, click Next.

Read the license agreement. If you agree with its conditions, click I Accept and Next to proceed with installation.

In the User Registration dialog, enter the primary user name, your company name, and the installation key.

	NOTE: Enter the key exactly as it appears on the Installation Keys sheet. The key is case sensitive, and all characters must be entered, including non-alphanumeric characters.

If you have already installed other products from the same CD-ROM, you can select the installation key from the drop-down list. Otherwise, copy it from the Installation Keys sheet.

	NOTE: The two CD-ROMs associated with Tornado 2.2 require different keys. Both are on the Installation Keys sheet.

To continue, click Next.

In the Installation Options dialog choose one of the following:

• Full Installation. Choose this option to install a complete copy of Tornado 2.2 for an end user on the local host. Click Next to continue. (This is the option most users will use.)

• Shortcuts Installation. Windows users can choose this option to configure the local host to use a copy of Tornado 2.2 that is installed on another host. Choosing this option does not install the program files on the local host. Click Next to continue, then proceed with Step 7 and Step 9.

• License Management Server Installation. This option installs and configures a floating license server on the local host. The floating license server manages a pool of licenses for use by installations on other hosts in a network. System administrators installing a floating license server should select this option and click Next to continue. See 2.5.1 Installing and Configuring a License Server, then follow the steps listed there.

	NOTE: A license server must be installed and available on a network before Tornado 2.2 can be configured to use floating licenses. Before you install Tornado and attempt to configure it to use a floating license, you should ensure a license server has been installed.

To continue, click Next.

The license number and number of seats is shown on the Tornado Installation Keys form that shipped with your product.

Tornado 2.2 and its related products are designed to be installed in a single directory tree. Specify the drive and root directory for that tree in the Select Directory dialog box (for example, c:\Tornado2.2).

	WARNING: Do not install Tornado 2.2 in a directory whose path includes embedded spaces (for example, c:\Program Files\Tornado2.2). Installing in such a path causes make and other essential utilities to malfunction.

	WARNING: Do not install Tornado 2.2 in the same directory as any prior installation of Tornado, or in the same directory as versions of Tornado for other target operating systems (such as Tornado for I2O). Unpredictable behavior may result. For more information about installing Tornado 2.2 alongside existing installations of Tornado, refer to the Tornado Release Notes.

You can use the Browse button to display a file browser for locating and choosing the installation directory. If the directory you specify does not exist, you will be prompted to create it.

If you are installing only shortcuts to a remote server, be sure that the destination directory you specify is the one where a full installation was performed. Continue with Step 9.

To continue, click Next.

All of the products you ordered are marked as selected in the Select Products dialog box by a check in the box to the left of the product name. Each item in the list represents a single product. To include or omit a product, click the checkbox next to the product name.

The line at the bottom indicates how many components comprise the selected product. If you highlight a product by clicking on it, the line at the bottom displays how many components within that product are selected. For example, in the Select Products dialog box, if Tornado Tools: x86win32 x ppc is highlighted, the dialog shows 4 out of 6 components are selected. To see a list of the individual components for a product, click the Details button. See Selecting Parts for more information.

A Tornado 2.2 installation requires the following minimum components:

• Tornado tools for the host system

• target processor and family

• driver objects and headers for the selected target (These are on your second, BSP/driver CD-ROM.)

By default, these components are chosen for installation. This ensures that the necessary base product is installed, and that other products will install successfully later. This is especially important when:

• Your installation key covers more than one product, or multiple run-time components such as TrueFFS or individual BSPs, and you choose to install them separately.

• You have more than one installation key covering different products.

• You have separate CD-ROMs containing add-on products.

Click Next to continue.

If there is not enough space for the selected products, SETUP warns you and gives you the option of going back to specify a directory on a larger disk or partition. You can also go back and omit some products. Click Go Back to return to the Select Directory dialog box, or No to continue. If you click No and continue, you will be prompted later to free up disk space.

	NOTE: Some components rely on other components. If you select one component without also selecting others it relies on, the SETUP program warns you and may require you to go back and change your selections before continuing to the next step.

Click Next to continue.

• Selecting Parts

If a product has more than one part, clicking Details opens the Select Parts dialog, which displays all the parts in a list. You can modify the default selection of parts using this list. Check or uncheck the boxes to the left of the names.

This dialog also displays the approximate amount of disk space required for the selected parts.

Click OK to accept any changes you make to the list of parts, or Cancel to ignore any changes.

Select a Windows Start menu program-folder name for Tornado with the Select Folder dialog box. By default, a Tornado entry is created under Programs in the Start menu. To continue, click Next.

The Tornado  registry is a service that keeps track of all available target servers. A target server is a service that runs on the host and manages communications between host tools, such as the shell, debugger, and browser, and the target system itself. A registry must be running before target servers can be started and before tools can communicate with a target.

In the Tornado Registry dialog box choose one of the following options:

Install Tornado Registry as an NT Service

Select this option to have the registry started on the local host at boot time. Click Next.

Install Tornado Registry in the Startup Group

Select this option to have the registry started automatically on the local host when the current user logs on. If you choose this option, you need to reboot your PC or run Tornado 2.2 before automatic startup of the registry takes effect. Click Next.

Install Tornado Registry manually

Select this option if you want to start the registry manually using the Windows Start menu before running Tornado 2.2. The registry automatically starts if none is running. Click Next.

	NOTE: For advanced users: If you want this installation to use a Tornado 2.2 registry located on another machine, select Install Tornado Registry manually. Then, when you start Tornado, go to Tools>Options. Select the Target Manager pane and enter the machine name in the WIND_REGISTRY field.

Configure to Use a Remote Tornado Registry

Select this option if the Tornado registry will be installed on another machine and you want to configure your machine to communicate with it. Click Next.

If you plan to use Tornado 1.0.1 and Tornado 2.2 tools in the same development environment, select yes in the Backward Compatibility dialog box. See the Tornado Release Notes for information about mixed-release development environments and portmapper usage.

	NOTE: If you chose to install the Tornado registry as a service in Step 10, you will be unable to use Tornado 1.0.1 tools with Tornado 2.2. You can use the Back button to return to the Tornado Registry dialog box, and change your selection.

SETUP can configure Windows to associate certain file extensions with Tornado 2.2 applications. This function of SETUP is only available if the Windows account you are using to install Tornado has system administrator privileges. In the Configure Default Application dialog, choose the file extensions you want to associate with Tornado as the default application. Click Next to continue.

SETUP begins to copy files from the CD-ROM. As installation progresses, the program displays information about the product as well as the names of the files being installed. The process may take several minutes.

	NOTE: If you have virus checking software running on Windows hosts, it may slow down the installation because it scans every file being copied. Temporarily disable virus checking functions to speed up the installation.

When SETUP has finished copying files, a dialog confirms installation of the products you selected for Tornado 2.2. You still need to install one or more BSPs from the second installation CD-ROM you received, but first, complete license manager installation. Click OK to close the dialog.

Next, SETUP configures Tornado 2.2 to reserve a license.

Tornado 2.2 obtains a license using one of two methods. In the License Management Configuration dialog, you choose the method for your installation to use. If you are unsure of which one to use, ask your system administrator or refer to your purchase order.

Configure a Floating License

Choose this method to reserve a license from a pool of shared licenses every time you run Tornado 2.2. When you exit Tornado 2.2, the license is released for other installations to use.

	NOTE: A license server must be installed and available on your network before Tornado 2.2 can be configured to use floating licenses. Before you install Tornado 2.2 and attempt to configure it to use a floating license, you should first ensure that a license server has been installed. See 2.5.1 Installing and Configuring a License Server for more information.

Configure a Node-Locked License

Choose this method to obtain a license and reserve it for use only on this computer. Laptop computers that are often disconnected from the local network (and therefore cannot connect to a floating license server) should use this method. The license is contained in a file stored in the local installation, and the installation uses it exclusively thereafter.

Recapture license previously configured for this machine

If a node-locked license for Tornado 2.2 was previously reserved for the host, and you want to configure the present installation to reuse that license, then check the box.

Choose an option and click Next to continue

To proceed with the floating license option for typical end users, see Obtaining a Floating License.

To proceed with the node-locked licensing option, see Obtaining a Node-Locked License.

	NOTE: A license server must be installed and available on your network before Tornado 2.2 can be configured to use floating licenses. Before you install Tornado 2.2 and attempt to configure it to use a floating license, you should first ensure that a license server has been installed. See 2.5.1 Installing and Configuring a License Server for more information.

1. Query the License Database

SETUP can automatically retrieve information from Wind River about the licenses you have purchased. In the Database Query Permission dialog, you give permission for SETUP to contact Wind River for this purpose. Your computer must have an active connection to the Internet to complete this step.

Yes, contact Wind River web site

Select this option to retrieve the information automatically, then click Next. SETUP transfers only the information necessary to configure a license for Tornado 2.2, and no other data, from your computer. See 2.Select License Server(s) to continue.

No, do not contact the Wind River web site

If you select this option, the installation of Tornado 2.2 is complete but it has not obtained a license. If you do not obtain your license now, there are two ways to initiate license configuration later:

• Start SETUP with the -L option.

• Start Tornado. When you run any Tornado 2.2 tool that is under license management, SETUP starts and steps you through obtaining a license.

Click Next to continue.

	NOTE: In the Finish dialog that appears when you choose not to contact the Wind River web site, SETUP displays information about manually configuring Tornado 2.2 to use a floating license. Make a note of the instructions, then click Exit to leave SETUP.

1. Select License Server(s)

The User License Management Configuration dialog displays the license servers on your network, from which Tornado 2.2 can request a floating license.

Click one or more server names listed in Available Server(s). To add them to the list of Selected Server(s) click on the button. Click on the button to remove them. Use the Up and Down buttons to prioritize the selected servers. Tornado 2.2 sends its request for a license to the server at the top of the list first.

To see more information about an individual server and the licenses available on it, click to highlight the server; then click the Details button while the server name is highlighted.

No Servers Available

If no entries appear under Available Server(s), this means SETUP cannot locate any license servers. Possible reasons for this and their solutions are:

• No license server is installed on an accessible host in your network; contact your system administrator to have one installed.

• The license server is installed on an accessible host but is not active; contact your system administrator to activate it.

• The host is not connected to the network; troubleshoot the connection. If the machine is normally not connected to the network (for example, a laptop), consider assigning a node-locked license. See Obtaining a Node-Locked License.

Click Next to continue.

1. Confirm License Servers

In the License Management Registration dialog you can review your choice of license servers. Click Next to accept the choice, or Back to modify it. When you click Next, SETUP displays the Finish dialog.

SETUP updates the registry with the license information. There are no further steps to complete. Congratulations! You have configured Tornado 2.2 to obtain a floating license, and it is now ready to run.

In the License Management Installation Options dialog, select a method for SETUP to contact Wind River and request the license file.

Automatic License Installation

Recommended because it is the quickest and easiest method, and when you exit the SETUP program the license file is installed. This method requires an active Internet connection. See Automatic License Installation, if you choose this method.

Manual License Installation

Choose one of the manual options (e-mail, phone, or fax) if the host is not connected to the Internet, or if you are located behind a firewall or a proxy server that prevents automatic installation from completing. When you request a license file using one of these methods, the file is sent to you through e-mail and you must install it manually. Click Next and see 3.Select Node-Locked Licenses to Configure or Reload to continue.

If the host has no Internet access and cannot send e-mail, a final option for obtaining a license file is to visit the Wind River Web site using another computer that does have network access. Visit http://www.windriver.com/ali and follow the instructions there. Once you have the file, copy it to a diskette and transfer it to the install host, as described in 3.Install the WRSLicense.lic License File Manually.

This section describes the steps to follow when requesting a node-locked license using the Automatic License Installation option.

1. Query the License Database

In order to obtain the license file, SETUP automatically retrieves information from Wind River about the licenses you have purchased. In the Database Query Permission dialog, you give permission for SETUP to contact Wind River for this purpose. Your computer must have an active connection to the Internet to complete this step.

Use Disk Serial Number for host ID

Select this option if you are installing a Tornado product on a laptop with multiple NIC cards. Click the Details button for more information.

Yes, contact Wind River web site

Select this option to retrieve the information automatically. Before you click Next, review the information that will be transferred. SETUP transfers only the information necessary to configure a license, and no other data from your computer.

You may wish to use your disk serial number as your host ID instead of using your MAC address (the default). This option is recommended if you have a laptop with multiple NIC cards and you switch between the cards. For more information, see http://www.windriver.com/corporate/support/license.html. Click Next to continue.

No, do not contact the Wind River Web Site

If you select this option, SETUP displays instructions for manually installing a license file (see 3.Install the WRSLicense.lic File Manually). If you wish, you can return to the previous dialog, where you can choose one of the manual methods of requesting the license file instead. See Choose a Method for Requesting the License File.

1. Provide Contact Information/User Authorization

Choosing Yes from the dialog above opens the Contact Information/User Authorization dialog. Enter contact information for the person who coordinates license configuration and management at your site. SETUP includes this information in the request for a license file.

Authorization Code

Your purchase agreement for Tornado 2.2 may have included a request for an authorization code, used to restrict access to licenses. If so, this dialog is labeled User Authorization and it includes a field for the code. You can find the code on the Installation Keys sheet. You must enter the code before you can request or reserve any licenses.

Click Next to continue.

1. Select Node-Locked Licenses to Configure or Reload

If you are requesting new licenses, the Node Locked License Configuration dialog displays the number of licenses still available out of the total purchased. Select the licenses you want to reserve by checking the boxes next to the product name. Each node-locked license you reserve in this dialog reduces the number of licenses available for other Tornado 2.2 installations.

If you are reloading a license that was previously assigned to this host, the Reload Existing License dialog appears instead. This dialog displays information about the license(s) to be restored. You can review this information but you cannot alter it.

When you have selected new licenses to reserve, or reviewed the licenses to be restored, click Next to continue and see 4.Review License Management Summary.

This section describes the steps to follow when requesting a node-locked license using one of the manual methods.

1. Select Products to License

The Email License Configuration dialog or the Phone/Fax License Configuration dialog appears, depending on the manual method you have chosen. The following image shows the Phone/Fax dialog, but the contents of the two dialogs are the same for both methods. The dialog displays the products you have installed, and for which you can request a node-locked license. Select the licenses you want to reserve by checking the appropriate boxes next to the product names.

Click Next to continue.

1. Request the License

Next, you must provide information gathered by SETUP to Wind River. After Wind River has the information, you will receive the license file through e-mail.

• Request the License File by E-mail

To use this method, the host must have network access to a mail server.

1. SETUP inserts all the necessary information into an e-mail message that you can preview in the Email License dialog. When you have viewed the message, click Next to continue.

2. In the Mail Confirmation dialog, enter the e-mail address where you want the license file to be sent. Select a mail protocol and enter the name of the mail server to use.

3. Click Send in the Mail Confirmation dialog. The request is sent from the current host to license@windriver.com.

4. See 3.Install the WRSLicense.lic License File Manually.

• Request the License File by Phone

1. SETUP copies all the necessary information into a file that you can preview in the Contact Wind River dialog and print for your reference.

2. Call Wind River at the number listed on the dialog and give the information to the license representative.

3. Click on Finish to exit the SETUP program.

4. See 3.Install the WRSLicense.lic License File Manually.

1. Install the WRSLicense.lic License File Manually

When you receive the license file WRSLicense.lic, do not alter its contents or change the file name. Copy it to the directory installDir\.wind\license, where installDir is the directory in which Tornado 2.2 is installed.

1. Review License Management Summary

The Summary dialog shows the license(s) or server(s) you have configured for this installation. If the information is correct, click Next to accept the results. To go back and change the configuration, click on Back or Cancel.

One final step is necessary for certain installations. You need to set some host environment variables on UNIX hosts, and on Windows hosts if you have configured node-locked licensing and you received the license file WRSLicense.lic by e-mail.

In these cases, see page 4.Complete Installation to complete this step. Otherwise, you are done installing Tornado 2.2 and configuring a license for it.

For an introductory tutorial on Tornado 2.2 usage, see 3. Tornado Tutorial.

	WARNING: Before uninstalling Tornado 2.2, make copies of any Tornado files you have modified. Uninstalling Tornado removes all files that were part of the original distribution list.

To remove Tornado 2.2 from a Windows host system, you can use standard Windows Control Panel facilities or the Tornado Uninstall program. Before you remove Tornado 2.2, you must shut down all Tornado 2.2 tools and components, including those you may have arranged to start automatically, such as the Tornado 2.2 target server and registry.

To use the Windows Control Panel facilities to uninstall Tornado 2.2:

1. Select Start>Settings>Control Panel.

1. Double-click Add/Remove Programs.

1. Select Tornado 2.2 from the list.

1. Click the Add/Remove button.

To use the Uninstall program:

1. Select the Tornado program folder from the Start menu under the Programs folder. (This is the default folder name and location; another may have been selected at installation.)

1. Select Tornado 2.2 Uninstall.

	NOTE: A license server must be installed and available on a network before Tornado 2.2 can be configured to use floating licenses. Before users install Tornado 2.2 and attempt to configure it to use a floating license, ensure that a license server is installed.

The initial steps required for installing a license server are the same as 2.3 Product Installation Procedure. Follow Step 1 through Step 6 first. When the Installation Options dialog appears, select License Management Service Installation and click Next.

	NOTE: To install only license management daemons and utilities files, you can invoke SETUP with the -F or /F option. If you use -F or /F, SETUP takes you directly to Step 2.

SETUP asks you to confirm that this is the correct host on which to install the license manager software before proceeding. If it is not, exit the program now. Choose a local directory for the license management files. Click Next to continue.

If you wish to reinstall your existing license file without adding licenses or making any other changes, check the box.

The license manager requires a license file installed locally on the server machine. The file is generated upon request by Wind River. In the License Management Installation Options dialog, select a method for contacting Wind River to request the license file.

Automatic License Installation

Recommended because it is the quickest and easiest method if you have an active connection to the Internet. When you exit the SETUP program, the license file is installed. Click Next and see Automatic License File Installation, if you choose this method.

Email option or the Phone or Fax option

Choose one of these manual options if the host is not connected to the Internet, or if you are located behind a firewall. When you request a license file using one of these methods, the file is sent to you through e-mail and you must install it manually. Click Next and see Manual License File Installation to continue.

If the host has no network access and cannot send e-mail, you can visit the Wind River Web site using another computer that does have network access. Visit http://www.windriver.com/ali and follow the instructions there. Once you have the file, copy it to a diskette and transfer it to the install host, as described in 3.Install the WRSLicense.lic File Manually.

	WARNING: If you install more floating seats than appear on your purchase order, Wind River will contact you to reconcile the difference. Please review your purchase order before installing to be sure that you install only as many licenses as you have purchased or wish to purchase.

When you have made your selection, click Next to continue. The Summary: Floating License dialog shows the total number of licenses you have configured for the license server to manage. To accept the configuration, click OK. To go back and change the configuration, click Cancel.

1. License Manager Startup Options

The License Management Startup Options dialog offers the following options.

Install License Manager locally as an NT Service

Select this option to have the license manager start on the local host at boot time.

Install License Manager in the Startup Group

Select this option to have the license manager start automatically on the local host when the current user logs on.

Install License Manager to be run Manually

Select this option if you want to start the license manager manually using the Windows Start menu.

Click Next to continue.

	NOTE: The host ID is a number that the license manager software uses to uniquely identify the host machine. SETUP determines this number for you automatically, but you can also find it manually by issuing the command lmutil lmhostid from a host command line in the installDir\SETUP\X86\WIN32\ directory.

• Request the License File by E-mail

1. All the necessary information is put in an e-mail message. You can preview the message in the Email License dialog. Click Next to continue.

2. In the Mail Confirmation dialog enter the e-mail address where you want the license file to be sent. Select a mail protocol and the ID of the mail server used by the host.

3. Click Send. The request is sent from the current host to license@windriver.com, and an automated system receives it.

• Request the License File by Phone

1. All the necessary information is copied to a file which you can preview in the Contact Wind River dialog and print for your reference.

2. When you call Wind River at the number listed on the dialog, have the information available to provide to the representative.

3. Click on Finish to exit the SETUP program.

1. Install the WRSLicense.lic File Manually

When you receive the license file WRSLicense.lic, do not alter its contents in any way or change the file name. Copy it to the directory installLic\.wind\license. The installLic directory is where license management software is installed.

	CAUTION: In most cases you should not alter the file contents or its filename. If you do wish to rename the license file, relocate the file to a path other than installLic\.wind\license, or combine the contents of the license file with other license files, please consult the user documentation from Globetrotter at http://www.globetrotter.com.

1. Complete Installation

After running the SETUP installation program, you may need to set environment variables. You must set host environment variables if you installed Tornado 2.2 or the license server, but you received the license file WRSLicense.lic by e-mail and installed the file manually.

• Windows 2000 Pro and XP Pro:

1. Go to Control Panel>System.

2. Click on the Advanced tab.

3. Click on the Environment Variables button.

4. Click on the New button under the System Variables section.

5. In the Variable Name edit box, enter LM_LICENSE_FILE.

6. In the Variable Value edit box, enter the full path location of the license file.

• Windows NT 4.0:

1. Log on to Windows using the same account that was used to install the license manager.

2. Go to Start>Settings>Control Panel>System.

3. Choose the Environment tab.

4. In the Variable edit box, enter LM_LICENSE_FILE.

5. In the Value edit box, set the value of the variable to the full path location of the license file.

6. Click OK.