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.