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