Content Supported by Sourcelens Consulting
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text-html; charset=Windows-1252">
<title>Installing and Configuring Island Hopper News Level C</title>
<META NAME="DESCRIPTION CONTENT=" ">
<META NAME="MS.LOCALE" CONTENT="EN-US">
<META NAME="MS-HAID" CONTENT="islandhopperc">
<LINK REL=stylesheet TYPE="text/css" HREF="msdn.css">
</HEAD>
<BODY>
<FONT FACE="Verdana, arial">
<h1>Release Notes</h1></FONT>
<FONT FACE="Verdana, arial" SIZE=2>
<P>Island Hopper requires Microsoft Windows NT version 4 SP 3 or higher.</P>
<P>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.</P>
<P>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.</P>
<P>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/</P>
<P>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".</P>
<h1>Installing and Configuring Island Hopper News Level C</h1>
</FONT>
<FONT FACE="Verdana, arial" SIZE=2>
<p>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.</p>
<p>
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.</p>
</FONT>
<FONT FACE="Verdana, arial" SIZE=2>
<p>
<b>To copy the installation files for the Island Hopper News Sample to your local drive</b>
<ol>
<li>
Insert your MSDN Library CD in your CD-ROM drive and double-click <b>Setup</b>.<br><br></li>
<li>
Click <b>Add/Remove</b> to add new components.<br><br></li>
<li>
Select <b>Island Hopper News Sample</b> and click <b>Continue</b>.</li>
</ol>
<p>
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.</p>
</FONT>
<FONT FACE="Verdana, arial">
<h2>Prerequisites</h2>
</FONT>
<FONT FACE="Verdana, arial" SIZE=2>
<p>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:
<ul>
<li>
Developer machine -- the machine used to work with the source code.<br><br></li>
<li>
Client machine -- the machine where the Windows and Web clients for the sample are installed.<br><br></li>
<li>
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.<br><br></li>
<li>
Database machine -- the machine where the sample application's database is installed.</li>
</ul>
<p>
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.</p>
</FONT>
<FONT FACE="Verdana, arial">
<h2>Software Requirements</h2>
</FONT>
<FONT FACE="Verdana, arial" SIZE=2>
<p>
Before installing Level C, you must have installed the following software:</p>
<table>
<tr valign=top>
<td>
<b>Client Machine</b></td>
<td>
<b>Developer Machine</b></td>
<td>
<b>Server Machine</b></td>
<td>
<b>Database Machine</b></td>
</tr>
<tr valign=top>
<td>
Internet Explorer 4.0 or higher</td>
<td>
Visual Studio 6.0, Enterprise Edition<p>
NT Option Pack, version 4.0</p>
</td>
<td>
NT Option Pack version 4.0</td>
<td>
Microsoft SQL Server 6.5</td>
</tr>
</table><br>
</FONT>
<FONT FACE="Verdana, arial">
<h2>Other Information</h2>
</FONT>
<FONT FACE="Verdana, arial" SIZE=2>
<p>
Gather the following information before you begin the installation process. The setup programs will prompt you for this information.
<ul>
<li>
The name of your IIS/MTS server<br><br></li>
<li>
A server location in which to install the web content of the sample<br><br></li>
<li>
The name of the database machine<br><br></li>
<li>
Your SQL Server user ID and password</li>
</ul>
</FONT>
<FONT FACE="Verdana, arial">
<h2>Installation Instructions</h2>
</FONT>
<FONT FACE="Verdana, arial" SIZE=2>
<p>
<b>Important:</b> 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.</p>
<p>
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.</p>
<p>
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.</p>
<p>
<b>To install the Island Hopper News clients</b>
<ol>
<li>
Insert the MSDN Library Disk 1 CD in the CD-ROM drive of the client machine.<br><br></li>
<li>
Navigate to Samples\Vs98\SampleC.<br><br></li>
<li>
Double-click Client.exe to uncompress and run the client setup program.</li>
</ol>
<p>
<b>To install the Island Hopper News source code</b>
<ol>
<li>
Insert the MSDN Library Disk 1 CD in the CD-ROM drive of the developer machine.<br><br></li>
<li>
Navigate to Samples\Vs98\SampleC.<br><br></li>
<li>
Double-click Source.exe to uncompress and run the source code setup program.</li>
</ol>
<p>
<b>To install the Island Hopper News server components</b>
<ol>
<li>
Insert the MSDN Library Disk 1 CD in the CD-ROM drive of the server machine.<br><br></li>
<li>
Navigate to Samples\Vs98\SampleC.<br><br></li>
<li>
Double-click Server.exe to uncompress and run the server setup program.</li>
</ol>
<p>
<b>To install the Island Hopper News database</b>
<ol>
<li>
Insert the MSDN Library Disk 1 CD in the CD-ROM drive of the database machine.<br><br></li>
<li>
Navigate to Samples\Vs98\SampleC.<br><br></li>
<li>
Double-click Database.exe to uncompress and run the database setup program.</li>
</ol>
<P>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.</P>
<P><B>To change settings on the Island Hopper packages</B>
<OL>
<LI>Click <B>Start</B>, <B>Programs</B>, <B>Windows NT 4.0 Option Pack</B>,
<B>Microsoft Transaction Server</B>, <B>Transaction Server Explorer</B> to
start the Microsoft Management Console.</LI>
<LI>Expand the <B>Microsoft Transaction Server</B> folder and the <B>Computers</B> folder,
then expand the folder for your computer (for example, <B>My Computer</B>).</LI>
<LI>Expand the <B>Packages Installed</B> folder.</LI>
<LI>Select the <B>IsleHop_Utilities</B> package, right-click to display the shortcut menu,
and click <B>Properties</B>.</LI>
<LI>Click the <B>Activation</B> tab, click <B>Library Package</B>, and click <B>OK</B>.
<LI>Expand the <B>IsleHop_Utilities</B> package and the <B>Components</B> folder.
<LI>Select the <B>TakeANumber</B> component, right-click to display the shortcut menu,
and click <B>Properties</B>.</LI>
<LI>Click the <B>Transaction</B> tab, click <B>Supports transactions</B>, and click
<B>OK</B>.</LI>
<LI>Select the <B>TakeANumberUpdate</B> component, right-click to display the shortcut menu,
and click <B>Properties</B>.</LI>
<LI>Click the <B>Transaction</B> tab, click <B>Requires a new transaction</B>, and click <B>OK</B>.</LI>
<LI>On the <B>Console</B> menu, click <B>Exit</B>. Click <B>Yes</B> when prompted to save
the settings.</LI>
</OL>
<P>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.
<B><P>To start the Windows client:</P></B>
<OL>
<LI>Click <B>Start</B> on the client machine.</LI>
<LI>Point to <B>Programs</B>.</LI>
<LI>Point to <B>Island Hopper</B>.</LI>
<LI>Click <B>Island Hopper C</B>.</LI>
</OL>
<B><P>To start the Web client:</P></B>
<OL>
<LI>Start Internet Explorer on the client machine.</LI>
<LI>In the <B>Address</B> 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.</LI>
</OL>
<P>For more information, see the following topics online in <CIT>MSDN Library Visual Studio 6.0.</CIT></P>
<UL>
<LI>The Island Hopper News Sample</LI>
<LI>Finding and Running Level C</LI>
<LI>Level C Specification</LI>
</UL>
<FONT FACE="Verdana, arial">
<h2>Uninstallation Instructions</h2>
</FONT>
<FONT FACE="Verdana, arial" SIZE=2>
<p>
The client, source code, and server setup programs of the Island Hopper News sample each include an associated uninstall program. There is no uninstall program for the database. If you are using a single machine for more than one role, you need to execute the uninstall programs in the reverse order from the installs. For example, you might run the uninstall programs in the following order:
<ol>
<li>
Server uninstall<br><br></li>
<li>
Source code uninstall<br><br></li>
<li>
Client uninstall</li>
</ol>
<P>If you are using more than one machine for the sample, you need to execute uninstall programs on each machine. Additionally, if you have installed the clients or the source code on a machine different from the server machine, you will need to uninstall additional components on the client and developer machines.</P>
<P>The following procedures describe how to uninstall the Island Hopper News sample from a single machine and from multiple machines.</P>
<p>
<b>To uninstall Island Hopper News from a single machine</b></p>
<p>
Use these steps to remove the Island Hopper News sample if you installed all the pieces on a single machine.
<ol>
<li>
Insert your MSDN Library Disk 1 CD in the CD-ROM drive.<br><br></li>
<li>
Navigate to Samples\Vs98\SampleC.<br><br></li>
<li>
Double-click RempackC.exe to remove the Island Hopper packages from Microsoft Transaction Server.<br><br></li>
<li>
Click <b>Start</b>, point to <b>Settings</b>, and click <b>Control Panel</b>.<br><br></li>
<li>
Double-click <b>Add/Remove Programs</b>.<br><br></li>
<li>
Click <b>Install/Uninstall</b>, if necessary.<br><br></li>
<li>
Select <b>Island Hopper Scenario C Server</b> and click <b>Add/Remove</b>.<br><br></li>
<li>
Select <b>Island Hopper Scenario C Source</b> and click <b>Add/Remove</b>.<br><br></li>
<li>
Select <b>Island Hopper Scenario C Client</b> and click <b>Add/Remove</b>.</li>
</ol>
<p>
<b>To uninstall Island Hopper News from multiple machines</b></p>
<p>
Use these steps if you installed the client or source code on a different machine from the server machine.
<ol>
<li>
On the client machine, click <b>Start</b>, point to <b>Settings</b>, and click <b>Control Panel</b>.<br><br></li>
<li>
Double-click <b>Add/Remove Programs</b>.<br><br></li>
<li>
Click <b>Install/Uninstall</b>, if necessary.<br><br></li>
<li>
Select <b>Remote Application - IsleHop Accounting (remove only)</b> and click <b>Add/Remove</b>.<br><br></li>
<li>
Select <b>Remote Application - IsleHop Classifieds (remove only)</b> and click <b>Add/Remove</b>.<br><br></li>
<li>
Select <b>Remote Application - IsleHop Utilities (remove only)</b> and click <b>Add/Remove</b>.<br><br></li>
<li>
Select <b>Island Hopper Scenario C Client</b> and click <b>Add/Remove</b>.<br><br></li>
<li>
Repeat these steps on the machine where you installed the source code.<p>
<b>Note:</b> If you installed the client and the source code on the same machine, in step 7 remove <b>Island Hopper Scenario C Source</b> first, then remove <b>Island Hopper Scenario C Client</b>.</p>
</li>
<li>
On the server machine, insert your MSDN Library Disk 1 CD in the CD-ROM drive.<br><br></li>
<li>
Navigate to Samples\Vs98\SampleC.<br><br></li>
<li>
Double-click RempackC.exe to remove the Island Hopper packages from Microsoft Transaction Server.<br><br></li>
<li>
Click <b>Start</b>, point to <b>Settings</b>, and click <b>Control Panel</b>.<br><br></li>
<li>
Double-click <b>Add/Remove Programs</b>.<br><br></li>
<li>
Click <b>Install/Uninstall</b>, if necessary.<br><br></li>
<li>
Select <b>Island Hopper Scenario C Server</b> and click <b>Add/Remove</b>.</li>
</ol>
</BODY>
</HTML>