MidasWWW UNIX Installation Instructions UNIX INSTALLATION INSTRUCTIONS These instructions are for UNIX. See the README_VMS file for VMS installation instructions. Requirements To install this version of MidasWWW you will need a Unix system with X windows (X11R4 or X11R5) and Motif (version 1.1.0 or greater). The current version has been tested on the following systems: SGI - Indigo (4.0.5) RS6000 (AIX 3.2.2) HP-UX MidasWWW should be portable to other unix systems. Please let me know if you port it to other systems, and let me know of any changes you had to make. Obtaining MidasWWW You can obtain MidasWWW as a compressed TAR file via anonymous FTP from FreeHEP.Scri.Fsu.Edu, in directory /pub/freehep/networking_email_news/midaswww After obtaining the TAR file, uncompress it and detar it using the commands: uncompress midaswww-1.0.tar.Z tar -xvf midaswww-1.0.tar cd midaswww-1.0 Building There are two ways to go about building MidasWWW. The way that is in principle recommended is to use the standard X-windows utility xmkmf (x-make-makefile). This facility is supposed to take into account any machine dependencies, and to correctly link against the correct libraries on your machine. I have found a number of problems with using xmkmf however: It appears not to be installed on many machines It doesn't appear to always do as good a job as one would like in removing machine dependencies. Consequently we support two ways of building MidasWWW, with xmkmf or without xmkmf, choose one! WITH XMKMF Build MidasWWW as follows: xmkmf make WITHOUT XMKMF Choose the one of the following makefiles: Makefile.sgi Makefile.aix32 Makefile.hp If a standard makefile doesn't exist for your machine, then either try using xmkmf or try making one yourself using one of the above as a starting point. If you succeed please send the new Makefile back to me so that others can benefit from your work. Then use the following commands (where MMMM is the makefile you chose): cp MMMM Makefile make Testing To try out MidasWWW first make sure your DISPLAY envirnonment variable is set up correctly. Then issue the command: $ make test Please ignore the message X Toolkit Warning: Urm__FetchLiteral: Can't find literal 'MidasWWWIcon' - MrmNO T_FOUND This is a known bug. NOTES On HP machines these extra error messages are generated: Warning: translation table syntax error: Missing ':'after event sequence. Warning: ... found while parsing '' I have no idea why but they don't seem to do any harm. Installation At run time there are five files that must be successfully accessed in order for MidasWWW to run correctly. These files are: midaswww The binary executable file midas.uid User Interface Description file midaswww.uid User Interface Description file Midas.ad X-Applications Default File Midaswww.ad X-Applications Default File If you do not install all five files MidasWWW will not run. The following commands will install MidasWWW for public use on most systems. cp midaswww /usr/bin/X11/midaswww cp midas.uid /usr/lib/X11/uid/midas.uid cp midaswww.uid /usr/lib/X11/uid/midaswww.uid cp Midas.ad /usr/lib/X11/app-defaults/Midas cp Midaswww.ad /usr/lib/X11/app-defaults/Midaswww Once this is done the MidasWWW browser can be run using the command midaswww NOTES The directory /usr/lib/X11/uid often doesn't exist and must be greated using mkdir. The uid files must be installed in a directory searched by the routine MrmOpenHierarchy. See the man page for that routine for more details. The .ad files must be installed in the appropriate app-defaults directory, WITHOUT the .ad suffix.