1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248
|
README
(C)rebro University 2004-09-30
===============================
Installation guide for binary version of VARKON 1.18A
for GNU/Linux.
Contents:
--------
1. Unpacking and installing the files
2. Basic configuration
3. Linux VARKON and OpenGL
4. Linux VARKON and ODBC
5. Configuration of the help system
6. Configuration of the plotting system
7. Compiling VARKON from the sources
1. Unpacking and installing the files
-------------------------------------
First step is to decide where (in what directory) to place
the VARKON-system. A usual place is /usr or /user or /u but
any place in a filesystem will do. Make sure you have the
proper priveliges ! If you have an earlier version of VARKON
installed you can use the same directory but we recommend that
you install the new version in a new diretory.
Now move yourself to this directory and extract the files
using gunzip and tar...
cd /directory_to_use_for_installation
gunzip varkon.tar.gz
tar xf varkon.tar
All files on the distribution will be placed in a subdirectory
named varkon_1.18X where X is a different letter depending
on what revision of VARKON you are installing. This directory
becomes the root-directory of your installation and is called
VARKON_ROOT. If you install varkon 1.18A in /usr VARKON_ROOT
is:
/usr/varkon_1.18A
The idea with this installation procedure is to make it
possible to install a new version of VARKON at any time
without interfearing with previously installed versions.
This way you can easily switch between two versions if you
like to.
If you want to remove a VARKON-installation the only thing
you need to do is to remove its root-directory.
NOTE!!! Varkon version 1.18A is not fully compatible with
previous versions of Varkon. You cannot use MBO-
or RES-files from 1.17D or earlier. MBS files are
compatible.
2. Basic configuration.
-----------------------
Having installed the files in your filesystem the next step
is to configure the system to work properly in this location.
This is done by editing the startscript template included in
the distribution. Move to VARKON_ROOT/com and edit a file
named varkon.
If your VARKON_ROOT is /usr/varkon_1.18A and your editor is
vi this means:
cd /usr/varkon_1.18A/com/english
vi varkon
for the english verision of VARKON or..
cd /usr/varkon_1.18A/com/swedish
vi varkon
for the swedish version of the system.
Later you may want to rename this file to something else or
you may want to connect it with an icon on your desktop.
The first thing to check is the line defining VARKON's root-
directory VARKON_ROOT.
VARKON_ROOT=/usr/varkon_1.18X
Where X is a letter depending on the current revision.
If this is not the place where you installed the system
you must modify this line to point to the right location.
Having done this it is time to start the system for the first
time. Save the file and exit from the editor. Write..
./varkon
If everything is Ok VARKON will now start up without any
error messages.
Things that usually dont work at this stage are either related
to X-Windows or to LINUX. Some possible causes of errors are:
- No X11-server running.
- DISPLAY-variable has wrong value.
- X-Font is missing.
- File ownership or permissions not right.
- Shared library module(s) missing or
- Wrong version of shared C-library, see below.
However, if other X-windows applications run on your computer
and if you have access rights to all the files in the VARKON-
installation there are usually no problems.
All users running VARKON need read access to all files
in the distribution. Users also need write access to the
$VARKON_TMP, $VARKON_PID, $VARKON_PRD and $VARKON_PLT
directories. Check the comments in the varkon start script
for more info on these directories.
Version 1.18 of VARKON is dynamically linked to the
following Linux libray modules:
libX11.so.6
libXext.so.6
libGL.so.1
libGLU.so.1
libm.so.6
libc.so.6
libdl.so.2
libpthread.so.0
libXxf86vm.so.1
libstdc++.so.5
libgcc_s.so.1
/lib/ld-linux.so.2
These files are not included in varkon_1.18X.tar.gz.
If you don't have these files on your Linux system we
recommend you to download them from your Linux site or
try an older version of VARKON. VARKON 1.15C is based
on libc.so.5 and might work better if you have an older
version of Linux.
In order to make VARKON's start script more available you
might want to include the path to $VARKON_ROOT/com/english
or $VARKON_ROOT/com/swedish in your PATH-variable. This is
usually done in your .profile or .login. (If you connect the
start script to an icon on a desktop this is not needed)
3. Linux VARKON and OpenGL
--------------------------
The shading function in VARKON is based on the OpenGL
library originally developed by Silicon Graphics. OpenGL is
now available from many sources and on many platforms. The
original Linux version of VARKON used the Mesa 3D graphics
library developed by Brian Paul, distributed under the GNU
Library General Public License. You can read more about
this or download a free copy of the library with sources
at: http://www.mesa3d.org
The binary version of VARKON 1.18 is comiled and linked on
a Linux system with Suse Linux 9.1. This Linux distribution
and many others of recent date include support for OpenGL so
normally you should not need to do anything to get OpenGL
working.
If your system does not include support for OpenGL you can
either try to install OpenGL on your system or you can build
your own version of Varkon without support for OpenGL from the
sources. How to do this is described in the source distribution
of VARKON.
4. Linux VARKON and ODBC
------------------------
The binary version of VARKON for Linux does not include support
for ODBC. If you need ODBC support you must build VARKON from
the sources. See README_ODBC in the VARKON sources directory.
5. Configuration of help system.
--------------------------------
VARKON supports context sensitive help by typing <CTRL>a
in any situation or clicking a help-button when available.
In order to get the help system working you must first:
1. Download the VARKON documentation and install it in the
VARKON_DOC directory as described on the download pages.
2. Edit the VARKON ini file $VARKON_INI/linux and set
the resource "varkon.html_viewer" to whatever viewer
you want to use.
If you don't want to use the help system you don't have
to. VARKON will work as usual but will not be able to
display help when you request it.
6. Configuration of plotting system.
------------------------------------
Configuration files for VARKON's plotting system reside in
VARKON_PLT usually the same as VARKON_ROOT/cnf/plt. Look
at the file CONFIG.TXT for information regarding the setup
for different plotters and printers.
The following plotter drivers are included in the binary
distribution of VARKON:
epson 24 pin printer
gerber Photo plotter
hp7475 Pen plotter
hpcl5 Laser printer
hpgl2 Laser printer
ibmpro 24 pin printer
postscript Works well with ghostscript
7. Compiling VARKON from the sources
------------------------------------
If you want to compile the varkon binaries from the
C-sources, download the sources and install them in
$VARKON_ROOT. You will then find further instructions
in the README file in $VARKON_ROOT/sources.
Good Luck
The CAD research group
Department of Technology
rebro University
S-70182 rebro
SWEDEN
URL: http://www.oru.se/tech/cad
|