1	Installation

Introduction

This chapter explains the NCSA Mosaic copyright and how to install your copy 
of the software.

Copyright Software

NCSA Mosaic is copyright by the University of Illinois Board of Trustees. You 
may use the software under the public-with-copyright policy in place for indi-
vidual usersŃmeaning you may use NCSA Mosaic free of charge for academic, 
research, individual, or internal business purposes but you may not use the 
software commercially without contacting NCSA or the NCSA Mosaic master 
licensee Spyglass, Inc. (http://www.spyglass.com/).

The copyright statement is also online at the following URL:

http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/copyright.html

System Requirements

NCSA Mosaic for the X Window System can be installed on most UNIX-based 
workstations (e.g., Sun SPARC, IBM RS/6000, SGI, DEC). You must have the X 
Window System. If you intend to compile NCSA Mosaic, you need MOTIF 
(from the Open Software Foundation).

Installation Instructions

To download the software, ftp to the NCSA anonymous FTP server 
(ftp.ncsa.uiuc.edu) and change to the /Mosaic/Unix directory. 

The easiest way to download Mosaic is to retrieve an executable binary from 
the ftp subdirectory called binaries. The following binaries are distributed:

	        Mosaic-sun.gz	Sun 4, SunOS 4.1.x

	        Mosaic-sun-lresolv.gz	Sun 4, SunOS 4.1.x, no DNS

	        Mosaic-sgi.gz	Silicon Graphics, IRIX 4.x.

	        Mosaic-indy.gz	Silicon Graphics, IRIX 5.x.

	        Mosaic-ibm.gz	IBM RS/6000, AIX 3.2.

	        Mosaic-dec.gz	DEC MIPS Ultrix.

	        Mosaic-alpha.gz	DEC Alpha AXP, OSF/1.

	        Mosaic-hp700.gz	HP 9000/700, HP/UX 9.x

To download a binary file:

1.	Put your FTP session into binary mode (enter binary).

2.	Transfer the file with FTP.

3.	Quit the FTP session.

4.	Uncompress the binary (enter uncompress filename.Z).

5.	Make the binary executable (enter chmod 755 filename).

6.	Execute the binary.

See the appendix titled ŇHow to FTPÓ on pageĘBĐ1 for more information.

Run-time Problems

There are three problems that you may encounter when you run a Mosaic 
binary for the first time. They are discussed in order of decreasing severity.

Mosaic dumps core 

A core dump can occur if your system is slightly misconfigured. Try starting 
Mosaic back up with the following command-line flag: 

Mosaic-sun -ghbnie

If Mosaic works with the -ghbnie flag, then your system is core dumping 
while trying to discover its own fully qualified hostname with the 
gethostbyname() system call. For help, contact your system or network 
administrator.

If Mosaic still doesnŐt work, follow the instructions displayed as Mosaic dumps 
core and send a bug report to mosaic-x@ncsa.uiuc.edu.

Mosaic cannot retrieve a file

If Mosaic is looking for a file over the network and cannot retrieve it, an error 
message shows up in the Mosaic window. There are three possible explana-
tions:

1.	You arenŐt connected to the Internet.

2.	You are behind a firewall.

3.	Your system canŐt resolve the remote machine name 
www.ncsa.uiuc.edu.

There is the additional possibility that the central NCSA document server 
might be temporarily down, which happens in rare circumstances. Always try 
running Mosaic again after a few minutes to see if this is the problem. 

If the problem is (1) or (2), your network administrator must find a way to 
resolve the access issues. If the problem is (3) and youŐre running on a Sun, try 
the binary named Mosaic-sun-lresolv. If this still doesnŐt work (or if youŐre 
not on a Sun), contact your network administrator.

Warning Messages

You may see a multiple warning messages in your terminal window. 

If you get warning messages (generally about missing ŇkeysymsÓ or fonts) but 
the Mosaic window comes up and stays up, then the situation isnŐt serious and 
Mosaic runs normally.

Read the online Frequently Asked Questions (FAQ) for more information on 
how to make the warning messages stop showing up. The URL for the X Win-
dow System FAQ is:

http://www.ncsa.uiuc.edu/SDG/Software/XMosaic/mosaic-faq.html

Some X Window System servers refuse to run Mosaic when all of the fonts 
Mosaic requests upon startup are missing. If this happens, send mail to 
mosaic-x@ncsa.uiuc.edu for more help.

Source Code

The complete Mosaic source code distribution is located on the NCSA anony-
mous FTP server in a subdirectory named Mosaic/Unix/source. The distri-
bution comes as a single compressed tar file and can be compiled on most UNIX 
systems. You must have the X11R4 (or later) and Motif 1.1 (or later) header 
files and libraries on your system to compile Mosaic.

See the README in the source code distribution for more information on com-
piling Mosaic.

Access Providers

For full functionality you need access to the Internet. If you do not have access, 
see the appendix titled ŇAccess ProvidersÓ on pageĘDĐ1 for a list of providers 
and other references.