	NCSA Mosaic™  for Microsoft Windows
		     
	  Installation and Configuration Guide

Introduction 

NCSA Mosaic is an Internet navigation and data retrevial tool that will allow you to access information with the click of a mouse button.  Mosaic is capable of accessing data from World Wide Web servers (HTTP), Gopher servers, FTP servers and News servers (NNTP) and  Mosaic can access other data services through gateway servers.  These services provide you search capabilities in database environments such as PH, Archie, WAIS, and Veronica.  NCSA Mosaic was designed to provide its user transparent access to these information sources and services.  NCSA Mosaic software is copyrighted by The Board of Trustees of the University of Illinois (UI), 
and ownership remains with the UI. The UI grants you a license to use the Software for academic, research and internal business purposes only, without a fee. 

Mosaic is capable of running under the following processor architectures and  operating systems.   
Below are the naming schemes we are using for this release.

	With a Setup Program:
        	mos20b4.exe ....................................	Win3.x, WWG & NT (iX86 processor)

	Without a Setup Program:
	axp.mosaic.2.0.0b4.exe......................	NT for the DEC aXP 
        	mips.mosaic.2.0.0b4.exe....................	NT for the MipsPC
        	ppc.mosaic.2.0.0b4.exe......................	NT for the Power PC

Software Requirements

1.  Mosaic requires an absolute minimum of an 80386SX-based machine with 4M RAM 
operating in enhanced mode. Consult your Windows manual for more information about 
setting up your computer to run in Enhanced Memory Mode. 


2.  Mosaic requires one of the following Windows operating systems: 

Microsoft Windows NT  - Windows NT and Win95  are 32-bit operating systems which have built-in support for 32-bit applications, OLE and a the winsock.dll.   Windows NT and Windown 95 users should NOT install Win32s on their systems.

Windows v3.1 or Windows for Workgroups 3.11 -  Operating in enhanced mode and the latest version of Win32s software. 

3.  If you plan to explore the Internet, you will need a 1.1 compliant winsock.dll AND a 
Internet access provider. The Internet Service Provider will supply you with the necessary 
winsock.dll.  NCSA does not provide Internet access services to the general public.
See the FAQs for more information on these subjects. 

NOTE:  Mosaic is capable of operating in Stand-Alone mode on your local system. 
However, Mosaic is designed as an Internet information retrevial tool and to get the full 
affect of the World Wide Web you need access to the Internet. 

Tips for Windows 3.1 and WfW 3.11 users:
1. Defrag your hard drive. (For help type "HELP DEFRAG" at DOS prompt.)
2. Create at least a 12M of "Permanent" swap space. (See your Windows manual  for details.)



Mosaic is a 32-bit Application
  	 
Mosaic is a 32-bit application. This means that Mosaic is compatible with Windows 3.1, 
Windows for Workgroups, Windows NT and Win95.  The Windows NT operating system is
available for the following processors:
 
 iX86  - Intels 386, 486, and Pentium Processors
 aXP  - Digital Equipment Corporation (DEC) aXP 64-bit processor
 MIPS  - Mips Technology processor
 PPC- Motorola,IBM,Apple Power PC processor 
  

Windows NT  and Windows 95 Users:

Windows NT and Win95 are 32-bit operating systems with Win32s and OLE support built into the operating system. Users of Windows NT and Win95 should NOT install Win32s on their systems. 


Windows 3.1 and Windows for Workgroups Users:

You have a 16-bit operating system and you'll need to install Microsoft's Win32s software. This software will allow you to run 32-bit applications in Windows 3.1 or WfW 3.11. Since Mosaic is also an OLE compatible application, Mosaic users must use Win32s with the OLE. The latest version of Win32s is available at NCSA's ftp site, ftp.ncsa.uiuc.edu, in the /Mosaic/Windows directory. The file w32sOLE.exe is a self-extracting executable. After you download the file, put it in a temporary directory (c:\install), type w32sOLE, and all associated files will decompress. 

The latest version of Win32s version 1.25.  It was released by Micorsoft to address the National Language Support problem and the compobj.dll problem some Windows users were experiencing with version 1.20. We recommend you upgrade to this latest version if you prefer to use a language other than English(American) in your Windows environment, OR 
if you experiencing problems with the compobj.dll library while using Microsoft Office, Excel or Word. In general, if you are NOT experiencing problems with Win32s v1.20, upgrading to Win32s v1.25 is not required. 

	Win32s must be installed BEFORE you install attempt to install Mosaic.



Using Mosaic as an Internet Information Browser

The winsock.dll

The Windows NT and Win95 operating systems have built-in support for the winsock. 
Windows NT and Windown 95 users do not need to install a third party winsock on their 
systems. 

The Windows 3.1 and Windows for Workgroups 3.11 operating systems do NOT have 
built-in support for the winsock and you will have to install on of the following winsocks on 
your system if you plan to search the World's Internet. 

There are a number of companies developing these winsock.dll. The winsock.dll provides 
the necessary TCP/IP networking environment under Windows. TCP/IP, (Transfer Control 
Protocol/Internet Protocol), is the data transfer method used by the World Wide Web and 
the Internet. 

The choice of which winsock to use is governed be a few factors. 

- The recommended winsock.dll from your Internet Service Provider. 
- The network environment you work under. If you have commerical networking software 
you must obtain that companies winsock.dll from your respective vendor. (For example, 
Novell networks) 
- Your personal choice. Even though the winsocks follow the same TCP/IP standard, they each have different features. 

NOTE: The winsock you choose must be compliant with version 1.1 of the winsock standard.

If you need a 1.1 compliant winsock you have three possible choices: 

1. Purchase a commercial product (if you already use network software, this is your only 
choice).

2. Download, evaluate and purchase the Shareware winsock.dll from Trumpet International 
Software.

3. Download and use the freely available Chameleon Sampler from NetManage Inc. 



COMMERCIAL options:
If you have commerical TCP/IP networking software you MUST obtain the winsock.dll 
from your respective vendor. 

FTP Inc.
Microsoft's TCP/IP-32 for Windows for Workgroups
NetManage's Chameleon 
Novell 
PC/NFS Pathworks 5.0a 
Spry Inc.


A SHAREWARE option:
The winsock Trumpet International Software can be found at the anonymous FTP server 
"ftp.utas.edu.au" in the /pc/trumpet/winsock directory. If you experience network delays 
from downloading a file from Austrailia, you can find a copy of this product on NCSA's 
anonymous ftp server. The file winsock.zip can be found in the /Mosaic/Windows/sockets 
directory. 

A COPYRIGHT SOFTWARE option:
The Chameleon Sampler(TM) is freely licensed courtesy of NetManage, Inc. for personal 
and educational use only. This product only supports modem connectivity to the network. 
The Chameleon Sampler software can be found at Netmanage's anonymous FTP site 
ftp.netmanage.com. You can find the public version of the Chameleon Sampler in the 
/pub/demos/sampler directory. For the convenience of our users, we maintain a copy of the 
this product on our ftp server, ftp.ncsa.uiuc.edu. In the /Mosaic/Windows/sockets/Chameleon directory, you will find the file "sampler.txt" which contains copyright and installation information and the file "sampler.exe" which contains the Chameleon Sampler software . 

For more information about ftp'ing software from any anonymous ftp server, please refer to the section "Acquiring Software from  NCSA".  For more information about winsock.dll's, please refer to the FAQs (Frequently Asked Questions) at the end of this file.



Using Mosaic as a local file browser

If you do not have a winsock.dll on your system or you envoke Mosaic with the "-s" command line option, Mosaic will automatically run in Stand-Alone mode.  In this mode you can use Mosaic to view locally stored HTML files.  For those of you who want to use Mosaic for presentations try ALT-P (Presentation Mode).


Acquiring Software from NCSA

Since you are reading this file, you probably have the latest version of Mosaic.  If you are running Windows 3.1 or Windows for Workgroups you need the latest version of Win32s with the OLE library extensions and a winsock.dll.  If you have Mosaic, Win32s with OLE and a winsock, you can skip this section. If you don't have a winsock.dll or the Win32s software you will find the information in this section useful, especially if you've never downloaded files from NCSA's anonymous ftp server.
 
To obtain software from NCSA's anonymous ftp server:

Envoke your local ftp client and log into NCSA's Anonymous FTP server.   The address for our anonymous server is ftp.ncsa.uiuc.edu.  

At the login prompt enter the name anonymous.  

		anonymous

 At the password prompt enter your email address as the password.  For example: 

		 johndoe@irs.gov  

Change directories to /Mosaic/Windows directory.

		cd  /Mosaic/Windows

 List the contents of the directory, using the command:

		 ls

Tell the ftp server you want to transfer a binary file by giving the command:

		bin

Get the Mosaic and the Win32s software using the command:

		get mos20b4.exe

If you need the Win32s   (v 1.25 with OLE)
then:

		get w32sOLE.exe 
If you need the Trumpet winsock, continue with the following commands:

        		cd sockets
        		get winsock.zip

You may also be interested in downloading some of the viewer applications we've made available on the server.  If you are interested in downloading these files at this time, give the command

		cd /Mosaic/Windows/viewers

Viewers are not necessary for installing Mosaic therefore you can postpone these downloads.  If you interested in more information about these applications, I suggest you check out the information we have online.  You can get to it by entering the following URL (Universal Resource Locator) in Open URL dialog box or the Mosaic command line.

	http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/viewers.htm
	

When you are finished downloading the files from our ftp server just give the command:

		bye

and the server will log you out.



Compressed Files

Files extended with .zip indicate that the file is in a compressed archive format.  The extension ".exe" can also indicate a self-extracting compressed archive file.   In the case of the ".zip" files you must have the latest version of the PKWare software.  Within the software you will find an executable called "pkunzip.exe".  This program will decompress ".zip" files.  Just execute the following command to retrieve the files from the compressed archive:

	pkunzip filename.zip

In the case of the ".exe" (self-extracting) files you should create a directory and simply type the name of the file to decompress its contents.  For example with the file "mos20b1.exe", just type mos20b1 and the file will decompress.

If you need a copy of the SHAREWARE utility PKWare (zip and unzip), you can find it on our ftp server in the /PC/Windows/Contrib directory.  The file, "pkz204g.exe", is a self extracting executable file.  We recommend you put it in it's own directory and just type pkz204g.  The software will unzip itself.  After you extract the software you will need to add this directory to the "PATH= ... " statement of your "autoexec.bat" file and reboot your machine so that the changes will take effect.



Installation Guide for "w32sOLE.exe":


Installing and Upgrading Win32s

Most people upgrading Win32s can follow these step-by-step instructions outlined below.  If you are installing Win32s for the first time, you'll need to follow all steps except 2 - 5 & 10. 

1.  Download the latest version of Win32s with Mosaic and place w32sOLE.exe into a temporary
directory. For example, c:\install

2.  Close Mosaic and all other Win32s applications.

3.  If you have Mosaic or any other Win32s application in your "Startup" program group, move
them to a another program group.

4.  Open File Manager

5.  Delete the c:\windows\system\win32s directory.

6.  Close Windows

7.  Change Directories to c:\install.

8.  Enter the command "w32ole". The w32sole.exe file will decompress and create two files:
install.bat and w32spack.exe

9.  Enter the command "install". Install will create two temporary directories (DISK1 & DISK2),
Open Windows and start the setup program.

NOTE:  When upgrading Win32s, Windows will give you the following error.

Cannot find a devise file that may be needed to run windows in 386 enhanced mode.
		You need to run the setup program again
		C:\windows\system\win32s\w32s.386

10.  Acknowledge the error.

11.  Follow the instructions from the Win32s setup program.

12.  After the setup program is complete, Windows will reboot.

13.  Delete the temporary files and directories in c:\install. (w32sOLE.exe, install.bat,
w32spack.exe, DISK1 & DISK2)

14.  The installation of Win32s is complete.




Installing NCSA Mosaic
 
We're trying to simplify the installation of Mosaic as much as we can.  However, we do not promote any particular Winsock.dll or network access provider.  Thus, these important decisions are left up you.  For more information about the available winsocks and Internet access providers see the FAQ # 7 & # 14 at the end of this file.  With this in mind, we must assume you already have your Internet access and your winsock is installed.  

 Ensure you have the appropriate Operating System and environment set up before you attempt to install Mosaic.  If you are using Windows 3.1 or Windows for Workgroups 3.11, you MUST install Win32s v1.25 with OLE v2.02 and a winsock.dll.  Windows NT and Windows 95 users have a native Win32s w/OLE environment and the winsock software is built into the Operating System.  

Note: You MUST install Win32s with OLE before you run the installation program for Mosaic. The Mosaic installation program is also a 32-bit application and it requires the existence of Win32s. 
The setup program installs Mosaic into the "c:\mosaic" directory by default. You may install Mosaic into a different directory if you wish.    Please do not try to install Mosaic into the same directory where you store  the installation files because the setup process will fail.


Windows 3.1 or Windows for Workgroups
	
	1.  Install your winsock software
	2.  Make sure your  w32sOLE.exe is properly installed
	3.  Decompress mos20b4.exe into a temporary directory
	4.  Run setup.exe
	5.  Delete the temporary files.
	6.  Double click on the Mosaic icon
	7.  Read the "relnotes.htm" file.  
	8.  Click on  "File",  "Open Local File"
	9.  Double click on relnotes.htm.
	10.  (Optional) Download and setup the associated viewer applications.  Enter this URL 		     into the URL Command line to find more information about the available viewers.
	    	http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/viewers.htm		 
		 
            11.  Have fun, Enjoy!


Windows NT for the Intel ix86 compatible processors:

	1.  Decompress the file "mos20b4.exe" into a temporary directory
	2.  Run setup.exe
	3.  Delete the temporary directory.
	4.  Double click on the Mosaic icon
	5.  Read the "relnotes.htm" file.  
	6.  Click on  "File",  "Open Local File"
	7.  Double click on relnotes.htm.
	8.  (Optional) Download and setup the associated viewer applications.  Enter this URL 		     into the URL Command line to find more information about the available viewers.
	    	http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/viewers.htm		 
	9.  Have fun, Enjoy!

Windows NT for the DEC aXP, Mips , Power PC processors:
	Note: There is no "setup" program built-in, just double click on "mosaic.exe" to 
	         execute Mosaic.	

	1.  Decompress  the respective binary file into a directory. 
	2.  Place the following files into the designated directory:

		MFCANS32.DLL:   WindowsNT\System32 Directory
		MFCUIA32.DLL :   WindowsNT\System32 Directory
		MSVCRT20.DLL:   WindowsNT\System32 Directory
		MOSAIC.EXE   :    a directory for Mosaic
		MOSAIC.INI       :   the same directory as mosaic.exe
		README.WRI   :     Place in the same directory as mosaic.exe
		RELNOTES.HTM:   Place in the same directory as mosaic.exe 

	3.  Drag and drop the mosaic.exe file from the File Manager to a Program Group
	4.  Double click on the Mosaic icon
	5.  Read the "relnotes.htm" file.  
	6.  Click on  "File",  "Open Local File"
	7.  Double click on relnotes.htm.
	8.  (Optional) Download and setup the associated viewer applications.  Enter this URL 		     into the URL Command line to find more information about the available viewers.
	    	http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/viewers.htm		 
	9.  Have fun, Enjoy!


Win95 Beta testers

Please note that Windows'95 is a beta product and many problems you are having may be due to the particular build of win95 that you're using.  The setup program for release candidates does not correctly create a shortcut to Mosaic. You will need to delete the shortcut and create a new one manually. This will mean that these release notes will not get automatically loaded (and you probably will never see this :)  unless you enter the command line option for Mosaic to load these notes.  Mosaic has scrolling/display problems with Windows 95. We're still trying to figure that one 
out. If you have any suggestions, please send them to us. There are no scrolling problems under NT, or Win3.1.



The mosaic.ini file

The installation program will copy a mosaic.ini file into your windows directory unless one already exists.   If you want  the mosaic.ini to be in another directory, you will have to remove the mosaic.ini file from the c:\windows directory and put the file into the desired directory.  Now define the environment variable MOSAIC.INI in your autoexec.bat.   The environment variable is defined as:

	set MOSAIC.INI=c:\complete\directory\path\mosaic.ini

After you have edited your autoexec.bat file, you will need to reboot your system so this change will take affect.

Note that it is no longer necessary to edit the mosaic.ini file by hand, as all information contained 
within it is now user-configurable from the Options, Preferences... menus within Mosaic.


Viewers
 
NCSA Mosaic for Microsoft Windows uses external viewers or other applications to display certain types of files, such as JPEG images, MPEG movies, etc.  These applications can be Commercial, Shareware, Freeware or Copyright Software.  The choice of viewer for a specific file type is a decision completly left up to you.  If you have commercial software then I'm sure you would like to the application you are most familiar with.  Go for it!  

We have amassed a collection of Shareware, Freeware and Copyright software viewers and applications that work well with Mosaic.  When we find an application that is legally distributable via ftp, we evaluate it and place a copy of it on our anonymous ftp server.  You can find these viewers by logging into our FTP server and cd'ing to the  /Mosaic/Windows/viewers directory.  

For information about viewers, see the following URL:

      http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/viewers.htm




Executing and Testing NCSA Mosaic
 
Ensure you have installed your winsock.dll, Win32s, and Mosaic Software.  Log into your Internet service provider and establish a SLIP or PPP connection.  If everything is properly configured,  Mosaic will load the Mosaic Home Page from NCSA's WWW server.  If the page doesn't load automatically, click on the red house icon in the toolbar.  This is a quick link to a home page and by default, we've set it to point to the Mosaic Home Page.  If all is well, we suggest you take time and learn more about the Windows version of Mosaic.  From the Main Mosaic Home Page, find the link "Mosaic for Microsoft Windows" and begin to explore the various links.

If you are not able to connect to the Mosaic Home Page, check your winsock and network configuration to ensure all IP numbers are correct.   After verifying that you don't have a typo, call your network service provider and verify that the IP numbers you were given are correct. 

NOTE:  IF you have more than one winsock.dll available to windows at any given time, you will have conflict problems!  Ensure you are only using one winsock and do NOT mix and match proprietary software.  ie.. I have DEC Pathworks and I'm trying to install the Trumpet winsock.  IT WON'T WORK!




	The NCSA Mosaic FAQ


Frequently Asked Questions:

1.  What version of the compression utility PKunzip do I need to unzip Mosaic?
2.  Do I need to change any of the settings in the mosaic.ini file?
3.  Are OS/2, Windows NT or Win95 supported?
4.  Can I run Mosaic without an Internet connection?
5.  What does the error message "Cannot find winsock.dll" mean?
6.  What does the error message "Unable to load TCP" mean?
7.  Where do I get a winsock.dll?
8.  I have a winsock.dll and Mosaic is not working?
9.  What does the error code "Failed DNS Lookup" mean?
10.  When I invoked Mosaic I didn't find the Starting Points menu.
11.  Viewers and the mosaic.ini file.
12.  Installing viewers
13.  How do I run Mosaic from home?
14.  How do I gain access to the Internet?
15.  How do I set up Proxy Gateway Support in NCSA Mosaic for Microsoft Windows
16.  Do I need to register NCSA Mosaic?  What is the copyright?
17.  Can I get the Source Code?
18.  Is NCSA Mosaic available on other platforms?
19.  Is NCSA Mosaic supported?

After Mosaic is installed, I strongly recommend you read the information that is online at the Mosaic for Microsoft Windows Home Page.   The URL is:
   
     http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/HomePage.htm



1.  What version of the compression utility PKunzip do I need to unzip Mosaic?

Mosaic is now a self extracting executable which means you don't need the PKunzip software to decompress the files.  However, you will find it useful to have the PK software for the other  softwares you will find on the network.   If you would like to obtain a copy of the latest PK software you can find this shareware product at the anonymous ftp site oak.oakland.edu.  The file pkz204g.exe is in the pub/msdos/zip directory.  You can find a copy of this software on our anonymous ftp site in the  /PC/Windows/Contrib directory.



2.  Do I need to change any of the settings in the mosaic.ini file?
All user configurable settings can now be changed from within Mosaic.  Simply choose Preferences under the Options menu to open the preferences pages.

3.  Are OS/2, Windows NT or Win95 supported?

OS/2

Unfortunately not, we do not have the resources to port Mosaic to the OS/2 environment.   However, version 3.0 of OS/2 Warp supports Win32s up to v1.15.  The last version of Mosaic that is compatible with Win32s v1.15 is version 2.0 Alpha 7.  Mosaic versions 2.0Alpha8 and greater are dependent on Win32s v1.25 with the OLE library extensions.   Mosaic is now an OLE compatible application.

Windows NT and Win95

Yes, The current version of Mosaic is a Win32 application and will operate in both Windows NT and Win95.  The OLE libraries are built into these Operating Systems.



4.  Can I run Mosaic without an Internet connection?

Yes.  If you envoke Mosaic with the "-s" command line option or Mosaic doesn't find a winsock.dll on your system, it will operate in stand-alone mode.


5. What does the error message "Cannot find winsock.dll" mean?

This is the most common error message users see during the installation.  However, when NCSA Mosaic v2.0 Beta 1 receives this error message from Windows, it will envoke under Windows in stand-alone mode.  If you do not want to run under your local environment and would like to connect to the Internet then consider the following. The error is caused when Windows can not find the winsock.dll.  To correct this problem, ensure the winsock.dll is in either the c:\windows\system directory or its directory is defined in the PATH= statement of the autoexec.bat.  One of the common misconceptions is that this is a Mosaic error, when in fact it is a Windows system error telling you it can't find a file.


6. What does the error message "Unable to load TCP" mean?

This is another Winsock.dll error message.  It can be caused when the winsock is dependent on other .dll files and the files can not be found or you your system doesn't have enough system resources to launch the program.   A solution to the first possible cause is to ensure you have installed your winsock properly (re-install the winsock).  A solution to the second possible cause is to close other applications or create a larger swap file.  See your windows documentation for details on Enhanced386 and virtual memory.   


7.  Where do I get a winsock.dll?

There are a number of companies that have created these winsock.dlls and you must ensure you have a "1.1 compliant" winsock.  If you don't have a 1.1 compliant winsock then you will get an error message like "unable to load TCP/IP" or "Winsock is not 1.1 compliant" and Mosaic will not run.

Note: Information about various winsocks is provided for the convenience of our users and we do not endorse any particular product.  Since we did not develop this software, we can not provide support. If you are having problems with any of these products, then please contact the respective author. 


The Common Commercial winsock.dll providers:

		- DEC Pathworks

		- FTP Inc.

		- Microsoft's TCP/IP-32 for Windows for Workgroups

		- NetManage Inc.

		- Novell

		- PC/NFS 

		- Spry Inc.


A Shareware winsock.dll provider:
Trumpet Software International Winsock was successfully tested during the development of Mosaic.  If you are interested in obtaining a copy of this software you can find it at the anonymous ftp site ftp.utas.edu.au in the /pc/trumpet/winsock directory.  We also maintain a currrent copy of this winsock on our ftp server, ftp.ncsa.uiuc.edu, in the /Mosaic/Windows/sockets directory.  The file is winsock.zip.

A Freeware winsock.dll provider
The Chameleon sampler software can be found at the anonymous FTP server: ftp.netmanage.com in the /pub/demos/sampler directory.


8.  I have a winsock.dll and Mosaic is not working?

Are you using a 1.1 compliant winsock?  If your winsock is 1.1 compliant then it will be documented as such.  When in doubt upgrade to the latest version of your network software.  A common error message is "Winsock is not 1.1 compliant".  


9.  What does the error code "Failed DNS Lookup" mean?

This error could be caused by a few things.  First, the IP number you typed in to the Name server field or  DNS field is wrong.  Second, the machine name you type in the URL is wrong or  is not associated with an IP number.  Third,  this error message occurs when the Name Server is down.



10.  When I invoked Mosaic I didn't find the Starting Points menu.

This occurs when the mosaic.ini file is NOT in your windows directory or the enviroment variable is wrong.  To correct this problem either copy the mosaic.ini file to your windows directory or ensure you've defined the environment variable properly.  The environmental variable is defined in your autoexec.bat file.  ie.

	set MOSAIC.INI=c:\complete\directory\path\mosaic.ini



11.  Viewers and the mosaic.ini file.

The real beauty of Mosaic is it's ability to use other already existing products for viewing image files, movie files, post script files, sound files, etc.  If you already have some product that you would like to use as a viewer, you can simply define it in the mosaic.ini file. (See #12 Installing viewers)  If you need to obtain a viewer I suggest you check our on-line information.  See the following URL for more information.

      http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/viewers.htm

This URL will point you to a number of viewers that have been tested with Mosaic.  After you have selected a viewer you can transfer it to your machine by selecting Options, Load to Disk... or just hold Shift and click on the link.  If you want to download these viewers without using Mosaic you can find them on our anonymous ftp server in the /Mosaic/Windows/viewers directory.



12.  Installing viewers

The selected application or viewers must be able to accept command line arguments.

This is a general example for defining a new viewer to Mosaic.  Mosaic needs to know which application to call when it reads a file type that it can't handle.  For example, Configuring Mosaic to read MPEG movie files.

1) Click on Preferences, under the Options Menu.

2) Click on the Viewers Preference Sheet

3) Choose the MIME type you wish to define (in this case, video/mpeg), in the
   "Associate Mime Type of:" Window.  Click on the down arrow to see the list
   of types Mosaic is currently aware of.  If you don't see the MIME type you
   are trying to define, click the Add button to add it.

4) Define the file extensions that correspond to this MIME type in the
   "With this/these extensions" window.  In this case:

   .mpeg, .mpe, .mpg

   What does this mean?  If Mosaic sees a file with any of these file name
   extensions, it will assume that it is a file this MIME type (video/mpeg).
   This allows Mosaic to determine what type of file this is if the server
   does not provide MIME types, or when loading local files.

   Note:  Mosaic will use the last extension listed for naming files it
          receives.  (eg. all .mpeg, .mpe and .mpg files will be stored as .mpg
          files)

5) Define the application to use as a viewer.  Choose the Browse button and
   use the browse window to locate the program on your harddrive.  Select it,
   and click OK.

6) You can now close preferences by clicking the OK button at the bottom of the
   window.
        
IMPORTANT:  Since we did not develop the viewers we do not support them.  If you have specific questions regarding one of your viewers, please direct them to the developers of the software



13.  How do I run Mosaic from home?

	Mosaic is capable of operating through a Modem as long as you have an Internet Service Provider that can provide a SLIP (Serial Line Internet Protocol) or PPP (Point to Point Protocol)  connection.  NCSA does not provide these services.  If you don't have an Internet access provider, stop here and see FAQ #14.  This FAQ contains a list of some nationwide Internet access providers.  

	If you already have access to a networked environment such as America on Line,
Compuserv, Delphi or Prodigy you will need to contact the respective company to determine if they can provide you SLIP or PPP access in your area.

	Below is a brief description about establishing a SLIP connection using the Shareware product called Trumpet Software International Winsock version 2.0b.  This particular product has an internal modem dialer, a SLIP driver,  a PPP driver and a convenient login script that will prompt you for the phone number of the provider, your name and your password.   If you need to obtain a copy of this shareware product you can find it at the anonymous ftp site, ftp.utas.edu.au.  The file is located in the /pc/trumpet/winsock directory.  For the convenience of our users we also keep a copy of this Shareware product on our anonymous ftp server, ftp.ncsa.uiuc.edu. The file, winsock.zip, is in the /Mosaic/Windows/sockets directory.

	After you have installed the Trumpet Winsock according to it's instructions, envoke tcpman.exe and select "Setup".  Trumpet will prompt you for the following information about your network connection.  You can get this information from the company or the system administrator that provided you with the SLIP connection.

	Check "Internal SLIP"  or "Internal PPP",  enter in the port number your modem uses, the baud rate of your modem and any other option you would like to use.  Save the information, click OK, and exit the program.  Now, your system should be configured properly.  Next, envoke Trumpet and select the "Dialler, Login" option.  The Trumpet winsock will prompt you for the phone number of your Internet access provider.  Next it will prompt you for your login name and you password.  Once the data is entered, the Trumpet winsock make the call to your Internet access provider and log you in.


Login steps:

1.  From the Trumpet executable, select Dialler, Login
2.  After Trumpet Logs in you will see a slip or ppp enabled command appear at the bottom of 
your screen.  At this point you can iconify the Trumpet windows to get it out of the way.
3.  Double click on the Mosaic icon.
4.  Enjoy.  ;^)


A couple of notes:

1. The Trumpet winsock saves the phone number, login name and password information.  If you need to change any of these parameters you will need to run the "Dialler, Other, setup.cmd"  and Trumpet will prompt you with the phone number, login name and password dialog boxes.

2.If you don't use the Dialler, Options, Logout on command, you must use the "Dialler, Bye" command.  Otherwise your modem will remain logged into your Internet Service Provider at your
expense.



14. How do I gain access to the Internet?

Here is a list of some of the companies that can provide nationwide SLIP and PPP access to the Internet.  These companies are listed in alphabetical order and we do NOT endorse any particular provider.

Colorado Supernet (info@csn.org)
Colorado School of Mines
1500 Illinois Street
Golden, CO 80401
(800)748-0800

DATABANK, Inc  (info@databank.com)  SLIP/PPP 1-800 Service
1473 Hwy 40
Lawrence, KS 66044
Voice 913-842-6699
FAX   913-842-8518

EUnet Communications Services BV  (info@EU.net,  http://www.eu.net/)
Singel 540		** International Provider **
1017 AZ Amsterdam	   
The Netherlands
Tel. +31 20 623 3803
Fax. +31 20 622 4657
                           
Institute for Global Communications (support@igc.apc.org)
PeaceNet/EcoNet/ConflictNet/LaborNet   ** International Provider **
18 deBoom St.
San Francisco, CA  94107
tel: +1-415-442-0220
fax: +1-415-546-1794

JVNCnet (market@jvnc.net)  ** SLIP only **
Global Enterprise Services
3 Independence Way
Princeton, NJ 08540

NetCom On-Line Communication Services (info@netcom.com)
4000 Moorpark Avenue
Suite 209
San Jose, CA 95117
(408)554-8649

Performance Systems International  (info@psi.com)  ** World Wide Provider **
11800 Sunrise Valley Drive
Suite 1100
Reston, VA  22019
(703)620-6651

The Portal Information Network (info@portal.com) 
20863 Stevens Creek Boulevard 
Suite 200 
Cupertino, CA 95014 
408.973.9111 voice 
408.725.1580 fax 

UUNET  (info@uunet.uu.net)  ** World Wide Provider **
3110 Fairview Park DR
Suite 570
Falls Church, VA 22042

(If you know of another National or International SLIP or PPP service provider,  send me email and I'll add them to this list.  tmclaren@ncsa.uiuc.edu) 


15.  How do I set up Proxy Gateway Support in NCSA Mosaic for Microsoft Windows

The proxy gateway services allow Mosaic to pass on a network request (in the form of a URL) to an outside agent which will perform the request for Mosaic, and return the results to Mosaic. The intended effect of this is to allow Mosaic clients that are behind firewalls to pass their network requests off to a machine that can access the internet for Mosaic. A  Mosaic client using a proxy gateway should feel as if they were directly connected to the internet. 

Proxy gateways in Mosaic are expected to talk the HTTP/1.0 protocol.  The URL that Mosaic wants to access is passed to the proxy in the form of an HTTP/1.0 GET request. The proxy then accesses the URL, and returns its results back to Mosaic. 

Proxy gateways are currently implemented on a per access method basis. This means each URL access method can send its requests to a different proxy. The current access methods are ftp, gopher, wais, news, and http. 

To get Mosaic to use the proxy gateway support,  select the Options.. Preferences menu.
Select the Proxy tab, and a dialog box appears. 
Enter the command in each appropriate  box:

BOX                            	COMMAND

http_proxy                    	http://your.firewall.machine:portnumber/
ftp_proxy                     	ftp://your.firewall.machine:portnumber/
wais_proxy                  	wais://your.firewall.machine:portnumber/
gopher_proxy		gopher://your.firewall.machine:portnumber/

Where "your.firewall.machine.portnumber" is unique to your environment.  for example "aixtest.cc.ukans.edu:911".


Since proxy gateways are expected to be used to pass through firewalls, you need to trust your proxy gateway, the best way to get a gateway you trust is to write it yourself.   For information about obtaining an web server that supports proxy services, see:

	http://www.w3.org/hypertext/WWW/Daemon/Overview.html



16. Do I need to register NCSA Mosaic?  What is the copyright?

You do not need to register NCSA Mosaic however, Mosaic is copyrighted by the University of Illinois.  Mosaic is available at no cost to individual users, Academic organizations, Government organizations and for internal business use.  If you plan to redistribute Mosaic or profit from the use of Mosaic, you are subject to licensing.  If you  are interested in licensing Mosaic for commercial use then please refer to the next question.



17. Can I get the Source Code?

The source code is available by licensing agreement only.  In order to obtain a copy of it you must fill out a licensing agreement and mail it to us via some postal service.  We will not accept electronic versions of the agreement!    Just download the agreement and print it out. You can obtain a copy of this agreement in either of the following ways:

	a. Download the form from the /Web/Mosaic/Licensing directory of our ftp server.  There are various formats of this agreement for your convenience.

	b. Use NCSA Mosaic and enter the following URL:

        http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/General.htm#source

Just select Options... Load to Disk or hold the Shift key and click on one of the available formats. 



18. Is NCSA Mosaic available on other platforms?

Yes, besides the Microsoft Windows version, NCSA Mosaic is available for the Macintosh and X-Windows platforms. If you interested in obtaining either of these versions you can find more information about them on our ftp server.  Mosaic for the X platform can be found in the /Mosaic/Unix directory and Mosaic for the Mac platform can be found in /Mosaic/Mac directory.  Please download the respective files and read them before you contact us for technical support.  If you can not find an answer to your question then send email to the appropriate address:

	 mosaic-x@ncsa.uiuc.edu: For X-specific help. 
	 mosaic-mac@ncsa.uiuc.edu: For Mac-specific help. 


19. Is NCSA Mosaic supported?

Yes, we provide as much information as we can about our browser online.  Please see the following URL if you have a question about Mosaic.

	http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/HomePage.htm


Feedback to NCSA
 
Your comments on NCSA Mosaic are important; user feedback is an integral part of the Software Development Group's (SDG's) planning activities.  Bug reports are particularly valuable because SDG's tests cannot duplicate all user environments and equipment configurations.  Bug reports should include enough information to enable SDG developers to reproduce the problem.  Please specify any information given by Mosaic, and give us a URL so we can successfully reproduce the problem.  However, before you send any bug reports, comments, or suggestions, please check our on line information to ensure your information hasn't already been reported. This will be very helpful to us because we are swamped with email!  You can find on-line information about known bugs, enhancement requests, FAQ's, viewers, etc. from our home page. 

        http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/HomePage.htm
                                                                     
If the answer to your question is not included in the above source of information, we will attempt to reply as quickly as possible.  Please remember we are supporting NCSA Mosaic and we can not provide information about the location of specific resources on the net.  The easiest way to mail us is to click on Help, Mail Technical Support... and write your message.  When you are finished just select Send and we will receive your message.

Thank you,


Mosaic for Windows Technical Support
mosaic-w@ncsa.uiuc.edu
The NCSA Software Development Group
The University of Illinois Urbana-Champaign (USA)

