1.3 HOW TO INSTALL Z88 FOR UNIX AND LINUX

If you’ve got a LINUX system or a true UNIX system, you are to compile Z88 at first. This is fairly easy as you will see below. I won't build RPM installation files any longer because there are too many very different LINUX distributions around. Because of legal reasons the sources for the solver Z88PAR are not GNU-GPL - but the very good solvers Z88F and Z88I1/Z88I2 are included, of course.

#### 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 root, 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 z88src.tar.gz. Uncompress it:

- gunzip z88src.tar.gz
- tar -xvf z88src.tar

I suggest to set the file access rights to 777:

- chmod 777 *

#### 2nd Step: Compile Z88 for UNIX or LINUX:

You need: C compiler, make, X11, GTK+, OpenGL

Any UNIX-C or C++ compiler should work. I’ve tested the GNU gcc and the Intel C compiler.

- For LINUX: run COMPILE.GCC32 or COMPILE.GCC64

These or similar libraries must be installed on your system:

- xorg-x11-devel (X11 development library)

- xorg-x11-Mesa-devel (OpenGL development library)

- gtk+-devel (GTK+ development library)

- gtkglext (GTK+ Widget for OpenGL)

- UNIX systems: modify one of the Makefiles (*.mk.*) and one of the COMPILE.* files.
- The following Makefiles are included:

| for the solver programs | for the other programs | for the GTK+ programs
LINUX 32-Bit | z88.mk.kernel.gcc32 | z88.mk.other.gcc32 | z88.mk.gtk.gcc32
LINUX 64-Bit | z88.mk.kernel.gcc64 | z88.mk.other.gcc64 | z88.mk.gtk.gcc64

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 | Integer extended | Float normal | Float extended
FR_XLONG | FR_XLOLO | FR_XDOUB | FR_XQUAD
long | long long | double | long double
4 oder 8 Bytes | 8 Bytes | 8 Bytes | 16 Bytes
%ld | %lld | %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, Z88V) only FR_XDOUB is implemented because it makes no sense to run the plot program Z88O or the DXF converter Z88X with extended precision. Anyway, 64 Bit integers and pointers are possible. Therefore, three makefiles do exist and it's a good idea to run them one after another.

For example: make –f z88.mk.kernel.gcc32

#### 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. 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:

Firefox: file:///home/frank/z88run13/, assuming that the Z88 HTML, the GIF and the JPG files are located in the directory /home/frank/z88run13

You may easily find out the prefix for your browser if you start it from an X-term with a Z88 HTML file, e.g. firefox file:///home/frank/z88run13/e88ix.htm

The help system is easy to use: Clicking the Help button invokes context sensive online-help: 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. gedit is quite nice, too. Edit Z88.FCD.

5th step: Adjust system variables:

Allow the Z88 programs to start in your favourite directory. Modify your file .profile, .bashrc, .bash_profile :

- PATH=$PATH:. (mind the dot after the colon!)
- export PATH

If you’ve got a „GERMAN“ or another non-angloamerican LINUX then adjust the system variable LANG in every case in .profile, .bashrc, .bash_profile to:

- LANG=C
- export LANG

Otherwise, the dots in the Z88 files are wrong interpreted and the plot program Z88O prints fancy wrong colours. Why? Because the thousands in Great Britain and the USA are delimited by commas and the decimal point is the dot but in Germany and other European countries the thousands are delimited by dots and the decimal point is the comma!

LANG=C or LANG=en: 1.000 reads 1. (correct!)

LANG=de : 1.000 reads 1000. (wrong!)

To make the variable LANG work, log off and log on again.

6th step: Adjust Z88’s language:

Enter into the file Z88.DYN either the keyword ENGLISH or GERMAN. ENGLISH is default, thus, you may skip this step.

#### 7th step: 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 program Z88O must be started on an X-Window surface like gnome or 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 launch 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 Z88O cannot run without a correct Z88.FCD.

... and how do you remove Z88 ?

Simply delete all files in the directory containing Z88. Then delete the directory if necessary.