1.3 HOW TO INSTALL Z88 FOR UNIX AND LINUX

 

1.3.1 LINUX installation for Fedora and SuSE

 

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:

 

Automatically for SuSE LINUX:

Insert the CD, change to directory /unix/rpm, click the RPM file and let Yast install Z88. This works with Z88-RPMs downloaded from the Internet, too.

 

Manually for other distributions:

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

Install these programs if necessary. They are part of RedHat (Fedora) and SuSE LINUX and most other distributions. You may exchange later the browser Mozilla and the editor Gedit against programs of your choice. However, you can force the installation without these programs by use of --nodeps. OpenMotif must exist, anyway. Mount the CD, if nesserary:

If the mount point /cdrom does not exist: go into the root directory and enter:

Go to /cdrom/unix/rpm and install Z88 for 32-Bit LINUX:

For AMD Athlon64-LINUX systems the installation command for 64-Bit Z88 is as follows:

 

Launch Z88:

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:

I suggest to set the file access rights to 777:

 

2nd step: Compile Z88 for UNIX or LINUX:

You need: C compiler, make, X11, Motif or OpenMotif, OpenGL

 

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

 

       these libraries must be installed on your computer:

                   - xorg-x11-devel                     (X11)

                   - xorg-x11-Mesa-devel           (OpenGL)

                   - openmotiv-devel        (Motif)

 

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

Float extended

FR_XLONG

FR_XDOUB

FR_XQUAD

long

double

long double

4 Bytes

8 Bytes

16 Bytes

%ld

%lf

%LF, %LE, %LG

 

This is possible for the solver modules Z88F, Z88I1 and Z88I2 along with their subroutines and the stress processor Z88D and the nodal force program Z88E. For the rest of the Z88 modules (Z88COM, Z88G, Z88H, Z88N, Z88O, Z88P, Z88V) only FR_XDOUB is implemented because it makes no sense to run the plot programs Z88O or Z88P or the DXF converter Z88X with extended precision. Anyway, 64 Bit integers and pointers are possible. Therefore, two makefiles do exist and it's a good idea to run them one after another:

 

Computer/OS

 the solver moduls

 the remaining moduls

LINUX 32-Bit (I586)

z88.mk.kernel.linux32

z88.mk.other.linux32

LINUX 64-Bit (AMD Atlon64)

z88.mk.kernel.linux64

z88.mk.other.linux64

SGI64 (-n32)

z88.mk.kernel.sgi32

z88.mk.other.sgi32

SGI64 (-64)

z88.mk.kernel.sgi64

z88.mk.other.sgi64

SGI128 (-64) und FR_XQUAD

z88.mk.kernel.sgi128

z88.mk.other.sgi64

SUN64 (-xarch=v9)

z88.mk.kernel.sun64

z88.mk.other.sun64

SUN128 (-xarch=v9) und FR_XQUAD

z88.mk.kernel.sun128

z88.mk.other.sun64

 

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

 

LINUX 32 Bit

cp z88.fcd.linux z88.fcd

make -f z88.mk.kernel.linux32 kernel

make -f z88.mk.other.linux32 other ready

SGI (-64), i.e. with 64 Bit for Intergers and Pointers

cp z88.fcd.sgi z88.fcd

make -f z88.mk.kernel.sgi64 clean kernel

make -f z88.mk.other.sgi64 other clean ready

...

... analogously

 

If you want to use extended precision:

example: SGI with 64 Bit Integers and 128 Bit Floats for the Solvers

cp z88.fcd.sgi z88.fcd

make -f z88.mk.kernel.sgi128 clean kernel

make -f z88.mk.other.sgi64 other clean ready

example: SUN with 64 Bit Integers and 128 Bit Floats for the Solvers

cp z88.fcd.sun z88.fcd

make -f z88.mk.kernel.sun128  clean kernel

make -f z88.mk.other.sun64 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, Firefox: 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:

 

·      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. 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.