home *** CD-ROM | disk | FTP | other *** search
/ Chip 1994 February / CHIP0294.ISO / digital / magazin / mosaic / wmos20a2 / install.txt next >
Text File  |  1994-02-28  |  18KB  |  402 lines
  1.          NCSA Mosaic for Microsoft Windows
  2.         Installation and Configuration Guide
  3.  
  4. Introduction
  5. ------------
  6. This is a step-by-step guide to installing and configuring NCSA Mosaic for
  7. Microsoft Windows.  This guide assumes that the system on which you
  8. are installing NCSA Mosaic meets the following criteria:
  9.     Microsoft Windows is properly installed and configured.
  10.     Utilities such as ftp, pkunzip, and an ASCII editor are available.
  11.     The system is connected to the Internet.
  12.  
  13. Acquiring the Software
  14. ----------------------
  15. Since you are reading this file, you probably already have the NCSA
  16. Mosaic for Microsoft Windows software.  If that is the case, you can skip
  17. this section.
  18.  
  19. If you do not have the software, start by moving to a location where
  20. applications are normally installed on your system and create a
  21. subdirectory for NCSA Mosaic.  The subdirectory name is arbitrary; the
  22. name mosaic is used here to clarify the following discussion.  Move into
  23. the new subdirectory:
  24.     mkdir mosaic
  25.     cd mosaic
  26.  
  27. Now you are ready to log on to NCSA's FTP server and download the
  28. NCSA Mosaic files:
  29.     ftp ftp.ncsa.uiuc.edu
  30.     At the login prompt, enter anonymous
  31.     At the password prompt, enter your email address (e.g.,     
  32.         jdoe@business.com)
  33.     get README.FIRST
  34.     cd PC/Mosaic
  35.     ls        (To list the available files and directories)
  36.     bin        (To change to binary mode for the file transfer)
  37.     get wmos20a1.zip
  38.  
  39. The filename wmos20a1.zip will change with each release and update.  It
  40. will always be in the format wmosversion.zip where version is the current
  41. version number.  For example, wmos20a1.zip is the filename for NCSA
  42. Mosaic version 2.0, alpha release 1.  The next alpha release will be
  43. wmos20a2.zip, and the first beta release of 2.0 will be wmos20b1.zip.
  44.  
  45. If you have never downloaded PC files from NCSA's server, read the file
  46. README.FIRST now.  It provides useful information that may facilitate
  47. later steps in the installation process.
  48.  
  49. The file wmos20a1.zip is a compressed archive containing the NCSA
  50. Mosaic executable and several documents, including this guide and a
  51. tutorial when it is available.  Execute the following command to retrieve
  52. the files from the compressed archive:
  53.     pkunzip wmos20a1.zip
  54.  
  55. Confirming the Files
  56. --------------------
  57. Once you have downloaded and uncompressed the NCSA Mosaic files,
  58. the installation process is straightforward.  Check to make sure all of the
  59. following files exist in the mosaic\ directory:
  60.     update.txt    Current list of this version's enhancements and
  61.             bug fixes in ASCII format.
  62.     install.txt    This guide as an ASCII file
  63.     install.wri    This guide in Microsoft Write format
  64.     mosaic.exe    The NCSA Mosaic executable
  65.     mosaic.ini    The initialization and configuration file for Mosaic
  66.     readme.now    Last minute or emphasized information
  67.  
  68. Read the file readme.now.  It may contain last minute information that
  69. was not available when this document was prepared.
  70.  
  71. If you want to review the list of Mosaic enhancements and bug fixes since
  72. the last version, you should read the file update.txt.  Or you can wait
  73. until you have NCSA Mosaic running and read this list online (follow the
  74. links from the Windows Mosaic home page.)
  75.  
  76. Checking the WinSock DLL
  77. ------------------------
  78. NCSA Mosaic is a WinSock 1.1-compliant program and requires that you
  79. have a WinSock 1.1-compliant sockets DLL (winsock.dll) installed to
  80. provide the TCP/IP networking under windows.  Check your WinSock
  81. implementation's installation guide to see whether it is WinSock 1.1-
  82. compliant.
  83.  
  84. If you are using a commercial TCP/IP stack such as PC-NFS, or running
  85. a local area network such as Novell in addition to the TCP/IP, you must
  86. obtain the WinSock DLL directly from your network vendor.
  87.  
  88. If your WinSock DLL is not WinSock 1.1-compliant or you do not have a
  89. WinSock DLL installed, and if you are using a stand-alone system on the
  90. Internet, then you can use the shareware Trumpet WinSock.  A
  91. compressed copy of this WinSock implementation can be found on
  92. NCSA's FTP server in the directory PC/Mosaic/sockets/.  Download the
  93. files disclaim.txt and winsock.zip.  (If you want to make sure you have
  94. the latest version of the Trumpet WinSock, it can be acquired via
  95. anonymous FTP from the server biochemistry.bioc.cwru.edu in the
  96. directory /pub/trumpwsk.)
  97.  
  98. Configuring NCSA Mosaic
  99. -----------------------
  100. To configure NCSA Mosaic, first copy the file mosaic.ini to the directory
  101. \windows. This is important because NCSA Mosaic will not otherwise
  102. recognize and save configuration changes.  Be sure to leave a copy of
  103. mosaic.ini in the mosaic\ directory in case you need to restore any
  104. original entries.
  105.  
  106. If you are administrating a network site, and want to have one copy of
  107. Windows, and therefore can't put mosaic.ini in the Windows directory,
  108. use the environment variable MOSAIC.INI to specify the pathname of the
  109. INI file.
  110.  
  111. Edit the file \windows\mosaic.ini as follows using Notepad, edit, or any
  112. other ASCII editor.  General users will not usually need to modify fields
  113. that are not mentioned in the following discussion.
  114.  
  115. Main section:
  116. -------------
  117. If you can be reached via Internet email, put your full email address in
  118. quotes in the E-mail field.  This is used for annotations and for a return
  119. address when you select Mail to Developers.  If your login ID is jdoe and
  120. you work at Business, Inc., your email entry might read as follows:
  121.     E-mail="jdoe@business.com"
  122.  
  123. If you do not want NCSA Mosaic to automatically load a document every
  124. time you run it, set Autoload Home Page to no:
  125.     Autoload Home Page=no
  126.  
  127. If you want to change the first document that is automatically loaded
  128. when NCSA Mosaic is run, change the Home Page entry to point to the
  129. document you want to load.  As distributed, NCSA Mosaic points to a
  130. customized Home Page on NCSA's Web server:
  131. Home Page =
  132. http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/NCSAMosaicHome.html
  133.  
  134. If you will be using Mosaic over a slow network connection and do not
  135. want inline images to be automatically transferred, set Display Inline
  136. Images to no.  Inline images will be replaced with an NCSA logo:
  137.     Display Inline Images=no
  138.  
  139. The Grey Background entry allows you to specify whether the NCSA
  140. Mosaic window has a white (no) or grey (yes) background.  Many
  141. documents posted to the Web are tuned to a grey background:
  142.     Grey Background=yes
  143.  
  144. Fancy Rules toggles a different style of drawing horizontal rules in HTML
  145. documents (the <hr> tag.)
  146. Fancy Rules=yes
  147.  
  148. List bullets slow down drawing documents.  If you are a speed maven,
  149. you may wish to turn on simplified buillet drawing (line bullets instead of
  150. round bullets.)
  151. Round List Bullets=yes
  152.  
  153. Settings section:
  154. -----------------
  155. The anchor color is the color of the hyperlink anchors that appear in an
  156. NCSA Mosaic document.  You may set the anchor color to any valid RGB
  157. (red, green, blue) combination.  The RGB values must be separated by
  158. commas and can range from 0 to 255.  As posted on the FTP server, the
  159. default color is blue (0,0,255):
  160.     Anchor Color=0,0,255
  161.  
  162. In some instances, it is desirable to have NCSA Mosaic underline
  163. hyperlink anchors (e.g, when using a gray scale or monochrome
  164. monitor).  As distributed, NCSA Mosaic is set to underline hyperlink
  165. anchors.  Since underlining slows performance somewhat, you may wish
  166. to set Anchor Underline to no if your system has a color monitor:
  167.     Anchor Underline=no
  168.  
  169. Mail section:
  170. -------------
  171. Edit the Default Title to contain the message you want to have appear in
  172. the subject line when you send email to the NCSA developers via the
  173. Mail to Developers selection on the Help menu.  As distributed, NCSA
  174. Mosaic enters the phrase "WinMosaic auto-mail feedback":
  175.     Default Title="WinMosaic auto-mail feedback"
  176.  
  177. Services section:
  178. -----------------
  179. If you want to use NCSA Mosaic's news support, set your network news
  180. (NNTP) server here.  As distributed, NCSA Mosaic specifies the
  181. University of Illinois' NNTP server:
  182.     NNTP Server="news.cso.uiuc.edu"
  183.  
  184. NCSA Mosaic uses the SMTP server specified here to send mail back to
  185. the NCSA developers when you select Mail developers from the Help
  186. menu. As distributed, NCSA Mosaic specifies NCSA's FTP server
  187. because it is known and almost always available.   If you have a local
  188. SMTP server that you would rather use, edit the entry accordingly:
  189.     SMTP Server="ftp.ncsa.uiuc.edu"
  190.  
  191. Viewers section:
  192. ----------------
  193. This section contains two subsections.  The first subsection contains a
  194. list of file types in MIME (Multimedia mail) form.  The second subsection
  195. specifies the viewer for each of the listed file types.  This information is
  196. used to determine whether an external viewer must be launched to view
  197. a file and, if so, which viewer to launch.
  198.  
  199. If necessary, edit the */* entries in the second Viewers subsection to point
  200. to your viewers.  If you do not have a viewer for a file type, leave the line
  201. alone.  You may add arbitrary spawning of external viewers by defining a
  202. new TYPE#, specifying a viewer, and optionally providing a suffix list.
  203.  
  204. NCSA Mosaic must use telnet to connect to some information servers.
  205. To do so, NCSA Mosaic needs to know where to find the telnet
  206. application on your system.  Specify the full pathname for your telnet
  207. application in the telnet entry at the end of the Viewers section:
  208.     telnet="c:\trumpet\telw.exe"
  209.  
  210. Suffixes section:
  211. -----------------
  212. This section lists the filename suffixes used to identify the file types of
  213. files retrieved via FTP or from HTTP version 0.9 servers.  In such
  214. situations, NCSA Mosaic uses the information in this section and in the
  215. Viewers to determine whether an external viewer must be launched to
  216. view a file and, if so, which viewer to launch.  Files that reside on HTTP
  217. version 1.0 servers are typed by the server and only the information in the
  218. Viewers section is used.
  219.  
  220. NOTE: If you are retrieving information from an HTTP/1.0 server (most
  221. World Wide Web servers are), the server automatically types data for
  222. you.  The extensions you set up in the Suffixes section will not have any
  223. effect on what MIME type the document is assumed to be, because the
  224. data is already being typed by the server.
  225.  
  226. You may list any number of filename extensions for a given file type;
  227. simply separate them by commas.
  228.  
  229. The last suffix listed will be used when writing a file of that type to the
  230. local hard drive.  If your external viewer requires a particular extension,
  231. make sure that it is listed last.
  232.  
  233. Consider the example of the JPEG file type.  The line
  234.     image/jpeg=.jpeg,.jpe,.jpg
  235. indicates that any file with the suffix .jpeg, .jpe, or .jpg is a JPEG image.
  236. Now look at the preceding section of the file.  The lines
  237.     TYPE3="image/jpeg"
  238. and
  239.     image/jpeg="c:\windows\apps\lview\lview30 %ls"
  240. define a JPEG image as TYPE3 and identify the required external viewer.
  241. Using the information in the Suffixes and Viewers sections of this file,
  242. NCSA Mosaic will recognize files with the extensions .jpeg, .jpe, and .jpg
  243. as JPEG images and know that it must launch the external viewer
  244. lview31 when it encounters them.
  245.  
  246. Viewers specified in this section must be able to take a specified filename
  247. as a command line argument.
  248.  
  249. Annotations section:
  250. --------------------
  251. Change the Directory entry to point to the directory on your local hard disk
  252. where you want to store personal annotations.
  253.  
  254. Change the Default Title to the title you want to use for your personal
  255. annotations.
  256.  
  257. User Menu sections:
  258. -------------------
  259. This specifies the user-configured menus.  NCSA Mosaic will
  260. accommodate up to ten user-configured menus in any combination of top
  261. level and pop-out menus.  Top level menus (Menu_Type=TOPLEVEL)
  262. will show up in the main menu bar; otherwise, the menu must be listed as
  263. a pop-out from one of the top level menus.
  264.  
  265. YOU SHOULD REALLY USE THE MENU EDITOR IN MOSAIC TO EDIT THIS SECTION.
  266. Hand-editing can result in screwing up the menus.
  267.  
  268. User-configured menus are specified as follows.  The first line indicates
  269. the number of the menu while the next one or two lines name the menu
  270. and specify whether it is a top level menu.  If the second user-configured
  271. menu is to be a top level menu named Demos, the first three lines of the
  272. menu specification would be
  273.     [User Menu2]
  274.     Menu Type=TOPLEVEL
  275.     Menu Name="Demos"
  276. If the menu is to be a pop-out menu, omit the second line above.
  277.  
  278. These initial lines are followed by several lines specifying the items
  279. (Item#) in the menu.  Each Item# line must begin with Item#= and the
  280. rest of the line must be in one of the following formats.  A line specifying
  281. a hotlink must list a document and the URL with which it can be located
  282. separated by a comma:
  283.     Item1=Vatican Exhibit,http://www.ncsa.uiuc.edu/SDG/
  284.         Experimental/vatican.exhibit/Vatican.exhibit.html
  285.  
  286. A line specifying a menu separator must contain the word SEPARATOR:
  287.     Item2=SEPARATOR
  288.  
  289. A line specifying a pop-out menu must contain the word MENU and the
  290. number of the pop-out menu, taken from the first line of another user-
  291. configured menu, separated by a comma:
  292.     Item3=MENU,User Menu4
  293.  
  294. HotList section:
  295. ----------------
  296. You can maintain a hotlist of files you wish to have conveniently available.
  297. The hotlist is maintained here and displayed when you select Open URL
  298. on the File menu and press the arrow button on the right side of the
  299. window.
  300.  
  301. YOU SHOULD REALLY USE THE MENU EDITOR IN MOSAIC TO EDIT THIS SECTION.
  302. This "Hotlist" is also now know as the "QUICKLIST".
  303.  
  304. You can edit the hotlist directly in this section.  If you want to delete a file
  305. from the hotlist, delete the corresponding line from this section.   If you
  306. want to reorder the files, simply rearrange and renumber the URL# lines.
  307. Note that the entries must be numbered sequentially, starting with URL0.
  308. The easiest way to add a file to your hotlist is to bring the file up in NCSA
  309. Mosaic then select Add Current to Hotlist from the Hotlist menu; if you
  310. prefer, you can add files by editing this section directly.
  311.  
  312. The Hotlist menu will be merged with the user-configurable menus in a
  313. future release.
  314.  
  315. Document Caching section:
  316. -------------------------
  317. This sections tells NCSA Mosaic how many documents to cache so that
  318. you do not have to return to the network to retrieve a recently viewed
  319. document.  As distributed, NCSA Mosaic caches five documents:
  320.     Number=5
  321.  
  322. If you have lots of memory on your system, you can increase the cache
  323. number.  If you have little memory, you may wish to decrease the
  324. number.  If you want to turn caching off, set it to 0 (zero).
  325.  
  326. Do not modify the Type entry.
  327.  
  328. Font sections:
  329. --------------
  330. Do not edit this section directly; all font changes must be made from the
  331. Options menu.
  332.  
  333. Main Window section:
  334. --------------------
  335. Do not edit this section directly; adjust the NCSA Mosaic window size
  336. with the mouse and select Save Window Size on the File menu to save
  337. the new dimensions.
  338.  
  339. Finding Viewers
  340. ---------------
  341. NCSA Mosaic for Microsoft Windows uses external viewers and players
  342. to display certain types of files, such as JPEG images or MPEG movies.
  343. These viewers and players are separate applications and they are neither
  344. maintained nor formally distributed by NCSA.
  345.  
  346. However, NCSA is always watching for particularly suitable viewers and
  347. players.  When one is located that NCSA can legally distribute, a copy is
  348. placed on NCSA's FTP server in the directory PC/Mosaic/viewers.  If
  349. you do not have a good viewer or player for a particular file type, check
  350. this directory.  If you find a viewer or player for a common data type that
  351. is not in this directory, or is significantly more useful than the one on our
  352. server, please let us know about it.  (One way to communicate that
  353. information is to select Mail to Developers on the Help menu.)
  354.  
  355. Installing into Microsoft Windows
  356. ---------------------------------
  357. You are now ready to install NCSA Mosaic into the Microsoft Windows
  358. system. Select New... on the Program Manager's File menu.  Select
  359. Program Item and click on OK to add NCSA Mosaic to a Program
  360. Group.
  361.  
  362. Executing and Testing NCSA Mosaic
  363. ---------------------------------
  364. Execute NCSA Mosaic now.  If everything is properly configured and
  365. domain name serving is set up, NCSA Mosaic should be able to load
  366. documents successfully.  Test this by selecting Windows Mosaic Home
  367. Page from the Demos menu.
  368.  
  369. If NCSA Mosaic hangs on execution or misbehaves in any other
  370. unexplained fashion, the most likely source of the problem is the
  371. WinSock DLL.  See "Checking the WinSock DLL" near the beginning of
  372. this guide.
  373.  
  374. If you are able to execute NCSA Mosaic but selecting Windows Mosaic
  375. Home Page did not work, try the following exercises and include the
  376. results in your query to NCSA.  The results will help NCSA technical
  377. support determine the nature of your problem:
  378.     Select Open Local File on the File menu and try to open a file on
  379.     your system.
  380.     Select Open URL on the File menu and try to open an HTTP file on a
  381.     remote Web server.  The URL
  382.     http://cs.indiana.edu/home-page.html will provide a good test.
  383.     Select Open URL on the File menu and try to open an FTP file on a
  384.     remote Web server.  The URL
  385.     file://cs.uwp.edu/pub/music/kurzweil will provide a good test.
  386.  
  387. Feedback to NCSA
  388. ----------------
  389. Your comments on NCSA Mosaic are important; user feedback is an
  390. integral part of the Software Development Group's (SDG's) planning
  391. activities.  Bug reports are particularly valuable because SDG's tests
  392. cannot duplicate all user environments and equipment configurations.
  393. Bug reports should include enough information to enable SDG
  394. developers to reproduce the problem.  Please specify any information
  395. given by Mosaic, or give us a URL is your problem is reproducible.
  396.  
  397. To send bug reports, comments, and suggestions, select Mail to
  398. Developers on the Help menu, fill out the form that appears, and click on
  399. Send when it is ready to go.  If Mail to Developers does not work, send
  400. an email message  to the following address:
  401.     mosaic-win@ncsa.uiuc.edu
  402.