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