1.3 HOW TO INSTALL Z88 FOR UNIX AND LINUX

1.3.1 LINUX installation for RedHat LINUX (from 8.0) and SuSE LINUX (from 8.1)

Z88 for LINUX installs easily with RPM – the RedHat Package Manager- which is part of all well- known LINUX distributions. Login as root and proceed as follows:

Check if these packages are installed: Mozilla, Nedit and OpenMotif. How to check? Do this:

- rpm –q mozilla
- rpm –q nedit
- rpm –q openmotif

Install these programs if necessary. They are part of RedHat and SuSE LINUX.

Install Z88 by running RPM:

- rpm –i z88-11.0-1.i386.rpm

Now login as a normal user, change to any (working-) directory and launch Z88 by the command from an X-Terminal (i.e. a command window):

- z88

The Z88 commander Z88COM is started and important parameter files are loaded. When running z88 for the first time, the first example is loaded, too. Therefore, you may instantly do your first Z88 calculation. The other examples reside in /usr/share/z88. Put Z88COM and the X-term, which started Z88COM by the z88 command, side-by-side or over-and-under to see both.

1.3.2 Installation for UNIX machines and other LINUX versions

If you’ve got an older or a newer LINUX system (but be sure to check if the RPM procedure (see above) works) or a true UNIX system, you are to compile Z88 at first. This is fairly easy as you will see below.

LINUX or UNIX installation in 4 steps:

For reasons of clarity all uppercased modules and file names are actually written in lower case, as is usual with UNIX.

1st step: Copy the Z88 files into a new or existing directory:

Simply put all Z88 files into an existing or new directory. Take care to do this as normal user and that you have read/write/execute permissions. This should be true for your home directory or an underlying subdirectory. Of course, it's all possible as superuser, too, but then paths must be adjusted. Again: Make sure that all permissions are properly set. Use umask if necessary. Internet distributions of Z88 feature only one single compressed file z88.tar.gz. Uncompress it:

- gunzip z88.tar.gz
- tar -xvf z88.tar

2nd step: Compile Z88 for UNIX or LINUX:

# You need: C compiler, make, X11, Motif, OpenMotif or Lesstif

Any UNIX- C or C++ compiler should work properly. I found the GNU gcc and the compilers from SGI and HP doing a good job.

For LINUX: COMPILE.LINUX (mit Open Motif)

For SGI: COMPILE.SGI or for large SGI machines COMPILE.ORIGIN

For HP: COMPILE.HP

For others: Adjust one of the Make files (*.mk.*) and one of the COMPILE.* files. Then

adjust the file Z88.FCD so that the Motif programs Z88COM, Z88O and Z88P are

properly displayed.

For the experienced user (skip this for a first reading and proceed with the 3rd step)

This is the default procedure. On large computers you sometimes have the choice to use 8 Bytes instead of 4 Bytes for integers and 16 Bytes instead of 8 Bytes for floats. You may adjust this in the makefiles by defines:

Integer normal | Float normal | Integer extended | Float extended
FR_XLONG | FR_XDOUB | FR_XLOLO | FR_XQUAD
long | double | long long | long double
4 Bytes | 8 Bytes | 8 Bytes | 16 Bytes
%ld | %lf | %lld | %LF, %LE, %LG

This is possible for the solver modules Z88F, Z88I1 and Z88I2 along with their subroutines. The following combinations are possible: FR_XLONG and FR_XDOUB (default), FR_XLONG and FR_XQUAD, FR_XLOLO and FR_XDOUB plus FR_XLOLO and FR_XQUAD.

For the rest of the Z88 modules (Z88COM, Z88D, Z88E, Z88G, Z88H, Z88N, Z88P, Z88V) this is not completly coded because it makes no sense to run the plot program Z88P or the DXF converter Z88X with extended precision. Anyway, some of the sources are prepared for extended precision. But caution: The solver modules use the same finite element functions like the nodal force processor Z88E. Therefore, two makefiles do exist and it's a good idea to run them one after another:

Computer/OS | for the solver modules | for the remaining modules
LINUX | z88.mk.kernel.linux | z88.mk.other.linux
HP | z88.mk.kernel.hp | z88.mk.other.hp
SGI (-n32) | z88.mk.kernel.sgi | z88.mk.other.sgi
ORIGIN (-64) | z88.mk.kernel.origin | z88.mk.other.origin
others | analogously | analogously

The default procedure i.e. using the same defines for both the makefiles is as follows:

LINUX | cp z88.fcd.linux z88.fcd
| make -f z88.mk.kernel.linux kernel
| make -f z88.mk.other.linux other clean ready
SGI (-n32) | cp z88.fcd.sgi z88.fcd
| make -f z88.mk.kernel.sgi kernel
| make -f z88.mk.other.sgi other clean ready
... | ... analogously

But if you want to use extended precision (FR_XLONG and FR_XQUAD or FR_XLOLO and FR_XQUAD) for the solver modules, but normal precision for the other modules (FR_XLONG and FR_XDOUB, the default) then you must re- compile the modules used by Z88E (which were for the solvers compiled with extended precision) with normal precision or will confuse the linker:

LINUX | cp z88.fcd.linux z88.fcd
| make -f z88.mk.kernel.linux clean kernel
| make -f z88.mk.other.linux caution other clean ready
SGI (-n32) | cp z88.fcd.sgi z88.fcd
| make -f z88.mk.kernel.sgi clean kernel
| make -f z88.mk.other.sgi caution other clean ready
... | ... analogously

3rd step: Enter your favourite Internet-Browser into Z88:

You should have installed a fancy browser on your system in order to display the Z88 online help. Use any internet browser e.g. Netscape, Mozilla, Arena, Mosaic or Chimera: Edit the header file Z88.FCD. Be sure to enter the proper browser prefix (keyword CPREFIX) matching your browser. The prefix tells the browser to load a specific HTML file from your machine rather from the Internet. For example:

· Arena does not need any prefix at all.

· Mozilla: file:///home/yourname/z88/, assuming that the Z88- HTML, the GIF- and the JPG- files are located in the directory /home/yourname/z88

You can easily find out the prefix for your browser if you start it from an X-term with a Z88-HTML-file, e.g. arena e88ix.htm or mozilla file:///home/yourname/z88/e88ix.htm

The help system is easy to use:

· Clicking the large Z88 Commander button invokes the directory for all Z88 chapters. Now enjoy browsing. If nothing happens - please wait a moment (some of those fat browsers need an endless time to load)

· Clicking the Help button invokes context sensive online-help: The Help button reverses its color indicating that help mode is active. Now click a command button to open the browser with the proper help chapter. Help mode stays active until you click the Help button again.

4th step: Enter your favourite editor into Z88:

You may use any ASCII editor. I found joe (WordStar-like) under LINUX a nice substitute for good old vi. Nedit is quite nice, too. Edit Z88.FCD.

And now: Run Z88:

You can start the various Z88 modules from a text console, from an X-term or by a shell-script. The Z88-Commander Z88COM and the plot programs Z88O and Z88P must be started on an X-Window surface like Gnome, fvwm2, icewm, cde, kde. Thus, it is good practice to launch all Z88 modules from an X-term using the Z88-Commander Z88COM ... so

Start your X-Window system, open an X-term and lauch Z88COM. Put Z88COM and the X-term, which started Z88COM, side-by-side or over-and-under to see both. The X-term is used for console input/output for the text-mode programs Z88F, Z88I1, Z88I2, Z88N, Z88D, Z88E, Z88X, Z88G, Z88H, Z88V.

If you are not pleased with my choice of colors and fonts, then edit the header file Z88.FCD. Be sure to store the original Z88.FCD file in order to have a ready-to-run file if something goes wrong as Z88COM and Z88P cannot run without a correct Z88.FCD.

... And how do you remove Z88 ?

If you’ve installed Z88 by RPM, simply type with root permissions: rpm –e z88.

If you’ve compiled Z88: Simply delete all files in the directory containing Z88. Then delete the directory if necessary.