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:

 

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

 

Install Z88 by running 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):

 

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:

 

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.