Release Notes

Island Hopper is Case-Insensitive - It will not run properly against a SQL Server database which has its sort order set to case-sensitive. If you wish to run against case-sensitive SQL Server, modifications will need to be made to data access code in the COM components so that all queries to the database use table and field names of the proper case.

Installing Sample A and Sample C on the same machine is not supported. Make sure you completely uninstall one level of the sample before installing another.

If you experience intermittent access violations that refer to OLEChannelWnd:mtx.exe, they are the result of an operating system error. You can download a patch for this error at ftp://ftp.microsoft.com/bussys/winnt/winnt-public/fixes/usa/NT40/hotfixes-postSP3/roll-up/

The Island Hopper database includes a record for a sample customer. You can use this customer when you are exploring the Island Hopper sample. The e-mail address for the sample customer is "someone@microsoft.com" and the password is "microsoft".

Installing and Configuring Island Hopper News Level C

This topic describes the prerequisites and installation instructions for level C of the Island Hopper News sample. If you only want to take a quick look at the source code, run source.exe to unzip source files.

The Island Hopper News Sample is shipped on the MSDN Library CD. You can copy the Island Hopper News Sample installation files to your local drive or install the samples directly from the MSDN Library CD.

To copy the installation files for the Island Hopper News Sample to your local drive

1. Insert your MSDN Library CD in your CD-ROM drive and double-click Setup.
   
   
2. Click Add/Remove to add new components.
   
   
3. Select Island Hopper News Sample and click Continue.

The Island Hopper News Sample files are copied to Program Files\Microsoft Visual Studio\MSDN98\98VS\1033\Samples\Vs98\SampleC if you accept the default installation location.

Prerequisites

Level C of the Island Hopper News sample requires at least one machine for installation. Machines should meet the minimum system requirements for Visual Studio. See System Requirements online in MSDN Library Visual Studio 6.0 for complete information on machine requirements. You can install level C on as many as four different machines, each with a different role. You can think of these roles as follows:

• Developer machine -- the machine used to work with the source code.
  
  
• Client machine -- the machine where the Windows and Web clients for the sample are installed.
  
  
• Server machine -- the machine where the components that contain the business rules are deployed, as well as the ASP pages that make up the Web client.
  
  
• Database machine -- the machine where the sample application's database is installed.

You can use a different machine for each role, or you can choose to combine some roles onto one machine. Using one high-powered machine for all four roles also works. A separate setup program is included for each role. Run the setup programs on the machines you have chosen for each role. If you want to use one machine for all four roles, run all four setup programs on that machine.

Software Requirements

Before installing Level C, you must have installed the following software:

Other Information

Gather the following information before you begin the installation process. The setup programs will prompt you for this information.

• The name of your IIS/MTS server
  
  
• A server location in which to install the web content of the sample
  
  
• The name of the database machine
  
  
• Your SQL Server user ID and password

Installation Instructions

Important:   If you are installing all of the sample on the same machine, make sure you complete the following procedures in the order in which they appear. Make sure you run the server setup program after the client and source code setup programs.

The setup programs are self-extracting .zip files. Double-clicking any setup program first uncompresses the files required for the setup program, then launches the setup program automatically.

These instructions assume that you are installing the sample directly from the MSDN Library CD. If you have already copied the sample files to your local drive, substitute the correct location on your local drive for each location mentioned in the steps below.

To install the Island Hopper News clients

1. Insert the MSDN Library Disk 1 CD in the CD-ROM drive of the client machine.
   
   
2. Navigate to Samples\Vs98\SampleC.
   
   
3. Double-click Client.exe to uncompress and run the client setup program.

To install the Island Hopper News source code

1. Insert the MSDN Library Disk 1 CD in the CD-ROM drive of the developer machine.
   
   
2. Navigate to Samples\Vs98\SampleC.
   
   
3. Double-click Source.exe to uncompress and run the source code setup program.

To install the Island Hopper News server components

1. Insert the MSDN Library Disk 1 CD in the CD-ROM drive of the server machine.
   
   
2. Navigate to Samples\Vs98\SampleC.
   
   
3. Double-click Server.exe to uncompress and run the server setup program.

To install the Island Hopper News database

1. Insert the MSDN Library Disk 1 CD in the CD-ROM drive of the database machine.
   
   
2. Navigate to Samples\Vs98\SampleC.
   
   
3. Double-click Database.exe to uncompress and run the database setup program.

The last thing you need to do before running Island Hopper is to change the settings on some of the Island Hopper Microsoft Transaction Server (MTS) packages. Complete the following steps on the server machine if you have installed Island Hopper across multiple machines.

To change settings on the Island Hopper packages

1. Click Start, Programs, Windows NT 4.0 Option Pack, Microsoft Transaction Server, Transaction Server Explorer to start the Microsoft Management Console.
2. Expand the Microsoft Transaction Server folder and the Computers folder, then expand the folder for your computer (for example, My Computer).
3. Expand the Packages Installed folder.
4. Select the IsleHop_Utilities package, right-click to display the shortcut menu, and click Properties.
5. Click the Activation tab, click Library Package, and click OK.
6. Expand the IsleHop_Utilities package and the Components folder.
7. Select the TakeANumber component, right-click to display the shortcut menu, and click Properties.
8. Click the Transaction tab, click Supports transactions, and click OK.
9. Select the TakeANumberUpdate component, right-click to display the shortcut menu, and click Properties.
10. Click the Transaction tab, click Requires a new transaction, and click OK.
11. On the Console menu, click Exit. Click Yes when prompted to save the settings.

Level C of the Island Hopper News is now installed on your system. The source code is located on the developer machine in Program Files\IslandHopper\ScenarioC. You can run either the Windows or Web client for the application.

To start the Windows client:

1. Click Start on the client machine.
2. Point to Programs.
3. Point to Island Hopper.
4. Click Island Hopper C.

1. Start Internet Explorer on the client machine.
2. In the Address box, type the name of the Web server where you installed the Island Hopper sample and the directory for the Web client (islandhopperc). For example, http://myserver/islandhopperc.

For more information, see the following topics online in MSDN Library Visual Studio 6.0.

• The Island Hopper News Sample
• Finding and Running Level C
• Level C Specification