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.