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.
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:
I
suggest to set the file access rights to 777:
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.
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)
|
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
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.
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.
Allow
the Z88 programs to start in your favourite
directory.
Modify your file .profile,
.bashrc, .bash_profile
:
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:
Otherwise, the
dots in the Z88 files are wrong
interpreted and the plot program Z88O prints fancy wrong colours. Why?
Because
the thousands in
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.
Enter into the file Z88.DYN
either the keyword ENGLISH or GERMAN. ENGLISH
is default, thus, you may skip this step.
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.