NCSA Mosaic for Microsoft Windows Version 2.1.1 Installation and Configuration Guide Table of Contents: Introduction System Requirements Hardware Software (operating systems, Win32s, winsock) Supported Operating Systems Win32s and OLE Winsock Information Connecting to the Internet Obtaining Mosaic from NCSA Ways to obtain the software Command line FTP instructions Installing or Upgrading Win32s with OLE First Time Installation of Win32s with OLE Upgrading Win32s with OLE Installing NCSA Mosaic Introduction The Mosaic initialization file (mosaic.ini) Windows 3.1 or Windows for Workgroups Windows NT for the Intel ix86 compatible processors: Windows NT for the DEC aXP, Mips , Power PC processors Executing and Testing NCSA Mosaic Introduction NCSA Mosaic is an Internet navigation and data retrieval tool that allows you to access network 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 Usenet News servers (NNTP). Mosaic can also access other data services through gateway servers. These services provide search capabilities in database environments such as PH, Archie, WAIS, and Veronica. NCSA Mosaic provides transparent access to these information sources and services. NCSA Mosaic software is copyright The Board of Trustees of the University of Illinois (UI), and ownership remains with the UI. The UI grants you a license without a fee to use the Mosaic software for personal, academic, research, government and internal business purposes. For information about licensing or distributing Mosaic see the FAQs at the end of this document. Below are the naming schemes we are using for this release. With a Setup Program: mosaic21.exe ...................Win3.1x, WfW 3.1x, Win95 & WinNT(Intel) mosaic21Mips.exe.............Windows NT for the Mips processor System Requirements Hardware Mosaic operates under Microsoft Windows on one of the following processor architectures. Intel iX86 - Intel's 386, 486, and Pentium processors Mips - MIPS Technology Inc. The minimum requirement for the Intel processor is a 80386SX-based machine with 4MB RAM operating in enhanced mode. Consult your Windows manual for more information about running your system in enhanced memory mode. Software Operating System - Mosaic requires one of the following Windows operating systems: Intel (iX86) Microsoft Windows 3.1x, Windows for Workgroups 3.1x, Windows 95 or Microsoft Windows NT version 3.5x Win32s and OLE- Win32s is a subsystem created by Microsoft for the Windows 3.1x and Windows for Workgroups 3.1x 16-bit operating systems. The Win32s libraries allow Win3.1x and WfW 3.1x users to run Win32 (32-bit) applications on their 16-bit operating systems. Object Linking and Embedding (OLE) allows Mosaic to use its Common Client Interface (CCI) and communicate with other applications. Windows NT and Windows 95 Users: Windows NT v3.5 and Windows 95 are 32-bit operating systems with built-in support for OLE. WinNT and Win95 users should NOT install Win32s with OLE on their computers. Windows 3.1x and Windows for Workgroups 3.1x Users: Win32s v1.30c is available from: ftp://ftp.ncsa.uiuc.edu/Mosaic/Windows/Win31x/Win32s/ We recommend all users upgrade to this latest version. If you are not sure which version of Win32s you have on your system, the version number can be found in the /windows/system/win32s.ini file. If you are using a version earlier than 1.30.172 you should upgrade. NOTE: Install Win32s BEFORE you attempt to install Mosaic. Mosaic's installation program, setup.exe, is also a 32-bit application. Winsock Information The Windows Sockets specification provides a standard method of accessing data from a TCP/IP network. TCP/IP, Transmission Control Protocol/Internet Protocol, is the data transfer method used by the Internet and the World Wide Web. The Windows Sockets Dynamic Link Library, winsock.dll, contains the necessary functions and network calls to successfully negotiate data transfers over a TCP/IP network. The winsock software must be compliant with version 1.1 of the Windows Sockets Standard. Windows 95 and Windows NT - These operating systems have built-in support for the winsock.dll therefore you do not need to install a third party winsock software on these systems. See our FAQs for information about configuring the Win95 winsock.dll. Windows 3.1x and Windows for Workgroups 3.1x - These operating systems do NOT have built-in support for the Windows Sockets Standard and you will have to install a winsock.dll if you plan to use Mosaic as a World Wide Web browser. Mosaic will operate in stand alone mode if you do not have a winsock.dll on your system or you invoke Mosaic with the "-s" command line option. In stand- alone mode you can use Mosaic to view locally stored HTML files. Factors to consider when deciding which winsock.dll is best for you: - Does your Internet service provider recommend or provide specific winsock software? - Is your computer connected to a local area network (LAN)? (Microsoft, Novell, Pathworks, etc.) If you have commercial networking software you need to obtain that companies winsock.dll to ensure its compatibility with your LAN. - Personal choice is also a consideration. Not all winsocks are equal. Even though all winsock.dlls follow the same Windows Socket Standard, there are different companies developing the software and the feature set of each winsock product is different. The choice is yours. Winsock software is available from one of the following sources: - Commercial winsock products can be purchased from: FTP Inc., Microsoft's TCP/IP-32 for Windows for Workgroups, NetManage's Chameleon, Novell, PC/NFS Pathworks 5.0, and Spry Inc. - Download, evaluate and purchase a shareware winsock software from Trumpet International Software or download and use the free with copyright winsock package from NetManage Inc. The winsock Trumpet International Software is available from the anonymous FTP server "ftp.trumpet.au" in the /winsock directory. If you experience network delays from this Australian FTP site, you can find a copy of the Trumpet software on NCSA's anonymous FTP server, ftp.ncsa.uiuc.edu. The file winsock.zip is in the /Mosaic/Windows/sockets/Trumpet directory. The Chameleon Sampler software is licensed freely courtesy of NetManage Incorporated for personal and educational use only. This product only supports modem connectivity to the network. The Chameleon Sampler software is available from Netmanage's anonymous FTP site, ftp.netmanage.com, in /pub/demos/sampler directory. With permission from NetManage Inc., we maintain a copy of the this product on the our FTP server in the /Mosaic/Windows/sockets/Chameleon directory. For information about obtaining software from an anonymous FTP server, please refer to the section "Obtaining Mosaic from NCSA". For more information about winsock.dll's, please refer to the FAQs (Frequently Asked Questions) at the end of this file. Connecting to the Internet Many organizations that are already on-line offer their members or employees Internet access. Some typical organizations include Colleges, Universities, Government Agencies, and Corporate organizations. Check with the organization's computer services organization for more information about gaining access to the Internet. Another way to gain Internet access is to purchase on-line services from a commercial company. There are companies that provide Internet access for a monthly fee. See the FAQs for a list of Nationwide and International Internet Service Providers. Obtaining Mosaic from NCSA NCSA Mosaic is available for free from our anonymous FTP (File Transfer Protocol) or for a small fee on diskette. Hardcopy manuals and software disks are available through the NCSA Technical Resource Catalog. The NCSA Technical Resource Catalog is available from the NCSA Orders desk. You can request a copy of the catalog by email, phone or US mail. NCSA Orders 152 Computing Applications Bldg. 605 E. Springfield Ave. Champaign, IL 61820-5518 orders@ncsa.uiuc.edu (217) 244-4130 Obtaining the software via FTP is the fastest and most cost effective way of obtaining Mosaic. There are various FTP software interfaces. Some FTP clients have command line and some use a graphical user interface (GUI). Mosaic has a built-in FTP GUI client and if you are using an older copy of Mosaic you can download the latest version from the NCSA Mosaic for Microsoft Windows home page. (http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/HomePage.html) On the home page you will find a link to the latest release. If you do not have Mosaic but have access to a command line FTP client, you can use the following instructions to FTP Mosaic to your system. Command line FTP instructions 1. Invoke your local FTP client and open a session to ftp.ncsa.uiuc.edu. For example: open ftp.ncsa.uiuc.edu (The command line for the Microsoft command line FTP client) or ftp ftp.ncsa.uiuc.edu (The command line from a UNIX based command line FTP client) 2. At the login prompt enter the name anonymous. anonymous 3. At the password prompt enter your email address as the password. For example: yourname@your.company.com 4. Change directories to /Mosaic/Windows directory. cd /Mosaic/Windows 5. List the contents of the directory, using the command: ls 6. Tell the FTP server you want to transfer a binary file by giving the command: bin 7. Get the Mosaic and the Win32s software using the command: get mosaic21.exe If you need the Win32s software, v1.30c w/OLE, download it now using the command: get Win32s/OLE32S13.EXE If you need the Trumpet winsock, continue with the following commands: cd sockets/Trumpet get winsock.zip 8. When you are finished downloading files from our FTP server, give the bye command and the server will log you out. bye Installing or Upgrading Win32s with OLE Win32s with OLE is a subsystem created by Microsoft for the Windows 3.1x and Windows for Workgroups 3.1x operating systems. Win32s with OLE gives these 16-bit operating systems the ability to run Win32 applications. Win32s with OLE is freely available to all licensed Windows 3.1 or WfW 3.1x users and it is available from the NCSA anonymous FTP server. The file OLE32S13.EXE is available from the /Mosaic/Windows/Win31x/Win32s directory on our anonymous FTP server, ftp.ncsa.uiuc.edu. You can also hyperlink to the latest version of Win32s from the NCSA Mosaic for Microsoft Windows home page. http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/HomePage.htm If you use Windows NT v3.5 or Windows 95 do not install Win32s. First Time Installation of Win32s with OLE 1. Download the latest version of Win32s and place OLE32S13.EXE into a temporary directory. For example: c:\install 2. From DOS, change directories to c:\install. (cd c:\install) 3. Enter the command "OLE32S13". The OLE32S13.EXE file will decompress and create two files: install.bat and win32s13.exe 4. Enter the command "install". Install will start Windows and the setup program. 5. Follow the instructions from the Win32s setup program. 6. Install the game Freecell. Freecell is a 32-bit application that will test your Windows environment to ensure it’s Win32s compatible. 7. After the setup program is complete, Windows will reboot. 8. (optional) Delete the temporary files and directories in c:\install. (OLE32S13.EXE, install.bat, win32s13.exe, DISK 1, DISK 2 & DISK 3) The installation program put the necessary files in their proper places and these files are just taking up space. 9. The installation of Win32s is complete. Upgrading Win32s with OLE Most people upgrading Win32s can follow the step-by-step instructions outlined below. However, if you have had a problem upgrading Win32s in the past, if you have an S3 video card, or a printer driver by LaserMaster you should read the "Troubleshooting Win32s Installation Problems" guide, http://www.microsoft.com/pages/kb/DEVELOPR/win32dk/Q106715.htm, provided by Microsoft before you attempt to upgrade Win32s. 1. Download the latest version of Win32s with Mosaic and place OLE32S13.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, temporarily move them to a another program group. 4. Open File Manager 5. Delete the c:\windows\system\win32s directory. 6. Close Windows 7. From DOS, change directories to c:\install. (cd c:\install) 8. Enter the command "ole32s13". The OLE32S13.EXE.exe file will decompress and create two files: install.bat and win32s13.exe 9. Enter the command "install". Install will start Windows and the setup program.. NOTE: When upgrading Win32s, Windows will give you the following error. Cannot find a device 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. Install the game Freecell. Freecell is a 32-bit application that will test your Windows environment to ensure it’s Win32s compatible. 13. After the setup program is complete, Windows will reboot. 14. (Optional) Delete the temporary files and directories in c:\install. (OLE32S13.EXE, install.bat, win32s13.exe, DISK1, DISK 2 & DISK 3) The installation program put the necessary files in their proper places and these files are just taking up space. 15. The installation of Win32s is complete. Installing NCSA Mosaic We have simplified the installation of Mosaic as much as we can. However, to establish the proper network environment you will need winsock software and a Internet access provider. NCSA does not promote any particular winsock software nor a Internet Service Provider (ISP). For more information about the available winsocks and Internet access providers see the FAQs (Frequently Asked Questions) at the end of this file. With this in mind, we must assume you already have a winsock and an Internet access provider. Ensure you have the appropriate Operating System and environment set up before you attempt to install Mosaic. If you use Windows 3.1x or Windows for Workgroups 3.1x, you MUST run your computer in Enhanced mode and install Win32s v1.30c with OLE. If you plan to access information from the Internet, you will also need to install a winsock.dll. Windows NT and Windows 95 users have a native 32-bit operating system with built-in OLE support and winsock software. 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. The setup program installs Mosaic into the "c:\mosaic" directory by default however you may specify any directory. The only directory Mosaic will not install is in the same directory as the setup.exe program. The result of this action will cause the Mosaic setup process to fail. The Mosaic initialization file (mosaic.ini) The Mosaic initialization file, mosaic.ini, contains information that helps Mosaic remember information about its last known state and your preferences. All initialization information is configured through Mosaic and you should not edit the mosaic.ini file with an ASCII editor. By default, Mosaic looks for the initialization in the Windows directory and the installation program puts a copy of the mosaic.ini file into that directory unless one already exists. If you want to put the mosaic.ini in any other directory, you will need to define an environment variable for mosaic.ini. Windows 3.1x, Windows for Workgroups 3.1x and Windows 95 users define environment variable in the autoexec.bat file. 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 takes effect. Windows NT users define environment variables from the Control Panel's System program. This application opens a window that allows you to enter variable names and values. For example: Variable: MOSAIC.INI Value: c:\complete\directory\path\mosaic.ini Another way to force Mosaic to read an initialization file from another directory is to use the -i switch on the command line. To change the command line of the Mosaic program icon, single click on the Mosaic icon and select Properties from the Program Manager’s File menu. Windows opens a dialog box that defines the properties of the program. Place your cursor at the end of the command line and enter the -i information simular to the example below. Command Line: c:\mosaic\mosaic.exe -i c:\mosaic\mosaic.ini The name of the initialization file is arbitrary and if your computer has multiple users, each user could have a unique Mosaic initialization file and a unique name for each Mosaic icon. This can be achieved by opening both the File Manager and the Program Manager. Size both windows so you can drag and drop new copies of mosaic.exe into the Mosaic program group. Each time you drag and drop mosaic.exe from the File Manager to the Program Manager, Windows creates a new icon and link to the Mosaic executable. After you have enough Mosaic links for your users, edit the preference of each to personalize them for each user. For example: Description: Joe's Mosaic Command Line: c:\mosaic\mosaic.exe -i c:\mosaic\joe.ini Warning: Do not edit the Mosaic initialization file with an ASCII editor. All user configurable options are available from the Options, Preferences... menus. Windows 95 1. Put mosaic21.exe into a temporary directory (e.g., C:\install). 2. Double click on the My Computer icon. 3. Find the folder containing mosaic21.exe. 4. Double click on mosiac20.exe. 5. Close the My Computer window. 6. From the Start button select Settings, Control Panel. 7. Double click on the Add/Remove Programs icon. 8. Click Install 9. Click Next 10. Click Browse. 11. Find and open the folder containing the Mosaic files. 12. Select Setup file and click Open 13. Select Finish. 14. Follow the instructions in the Setup program. 15. Open Start, select Programs; select Mosaic and read the release notes. 16. (Optional) Delete the files in the temporary C:\install directory. 17. (Optional) Download and setup the associated viewer applications. Go to the Mosaic home page and click on the Viewers link. 18. Have fun, Enjoy! Windows NT for the Intel ix86 compatible processors: 1. With the File Manager, move mosaic21.exe into a temporary directory. For example, C:\install. 2. Double click on mosaic21.exe. 3. Double click on setup.exe. 4. Follow the instructions from the setup program. 5. Double click on the Mosaic icon. 6. Read the "relnotes.htm" file. 7. Delete the temporary files in c:\install. 8. Open Mosaic's Options, Preferences menu and configure Mosaic. 9. (Optional) Download and setup the associated viewer applications. See the following URL for more information: http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/viewers.htm 10. Have fun, Enjoy! Windows 3.1 or Windows for Workgroups 1. Install Win32s and your winsock software. 2. From the File Manager, move mosaic21.exe into a temporary directory. For example, C:\install. 3. Double click on mosaic21.exe. 4. Double click on setup.exe. 5. Follow the instructions from the setup program. 6. Double click on the Mosaic icon. 7. Read the "relnotes.htm" file. 8. Delete the temporary files in c:\install. 9. Open Mosaic's Options, Preferences menu and configure Mosaic. 10. (Optional) Download and setup the associated viewer applications. See the following URL for more information: http://www.ncsa.uiuc.edu/SDG/Software/WinMosaic/viewers.htm 11. Have fun, Enjoy!