-
Notifications
You must be signed in to change notification settings - Fork 2
/
INSTALL
256 lines (191 loc) · 9.67 KB
/
INSTALL
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
249
250
251
252
253
254
255
256
11. Mai 10:34:54 CEST 2019 in Munich (Germany),
written by Klaus Wittig (klaus.wittig@calculix.de)
WARNING:
The cgx program knows the "sys" command which is used to issue any shell
command (unix or dos shell). For example to move files created by the 'send'
command to certain file names or/and locations and to start the analysis. But
if you use CGX to open an untrusted fbd file downloaded from the internet, it
might delete all your files or do whatever it wants as long as cgx has the
necessary rights.
Even an honest but carelessly written fbd file could be destructive if it
makes incorrect assumptions about the locations of files. For example, by
clearing the contents of a directory to clean up, it might delete important
files on someone else's computer.
To prevent the user from executing potential dangerous 'sys' commands the
program will stop at every 'sys' command and waits for the user to either
accept each single one or to accept the execution of every future 'sys'
command by writing "ALLOW_SYS" in the .cgx file in the $HOME directory.
If this functionallity is not desired then change "ALLOW_SYS_FLAG 0" in the
cgx.h file to "ALLOW_SYS_FLAG 1". The program accepts then all 'sys' commands
w/o warnings.
Basic Installation
==================
If you encounter problems please read the last section "Possible
problems and some hints" and the section "Known Problems" in the
documentation.
There are two ways of instalation:
- Section A: Installation of the 64bit-binary
- Section B: Instalation from the source:
recomended if you encounter problems with the binary
or if your hardware is not supported.
For full functionallity you need the following additional programs. Please
make sure that this programs are installed in a system known location. Or
extend the PATH variable (for example: export PATH=$PATH:$HOME/myfolder
in your .bashrc)
- convert (ImageMagick)
- pstops (from psutils)
- firefox or any other html-browser (modify cgx.h if not firefox )
- gv (ghostview) (modify cgx.h if not gv )
- gnuplot
- either tetgen, a command line driven tet mesher (searched by
default). The mesher can be changed either before compilation in cgx.h or
during run time with the command 'asgn'. You find tetgen in the package.
- or/and ng_vol from the netgen project. Replace the src file with the
one located in the folder cgx_2.17/netgen and build it in the netgen
directory. This allows tet-meshing with a target-element-size.
A: Installation of the binary
--------------------------
1. Get the binary and do the following
- bunzip2 cgx_2.17.bz2 (beware your browser could scip the ending
.bz2, then please rename the filename to the above one before unzipping )
It is necessary to have openGL on your system!
The libraries
/usr/lib64/libGL.so
/usr/lib64/libGLU.so
The libGLU should be the one from SGI. Otherwise the nurbs rendering is
not supported.
WARNING: To improve the stabillity of the GLU you may recompile the
library (after downloading from the internet) by regarding the following
hint:
after ./configure
open Makefile and
change:
CFLAGS = -g -O2
CXXFLAGS = -g -O2
to:
CFLAGS = -O -DNDEBUG
CXXFLAGS = -O -DNDEBUG
You might create links to other locations if the libraries are
stored at other places.
For example:
ln -s /usr/i486-linux-libc5/lib/libGL.so.3 /usr/lib/libGL.so
2. login as root
3. if possible rename the binary to /usr/local/bin/cgx
mv cgx_2.17 /usr/local/bin/cgx
chmod ao+rx /usr/local/bin/cgx
4. If you like the help-system to work then please do the following:
5. login as root if not already done.
4. get the documentation (html) and do the following:
- move the file containing the docu cgx_2.17.htm.tar.bz2 to /usr/local
- bunzip2 cgx_2.17.htm.tar.bz2 (beware sometimes the ending .bz2 is missed,
please rename the filename to the above one)
- tar -xvf cgx_2.17.htm.tar
- the html-browser must be known as "firefox"
so if you dont have firefox you should create an link like:
ln -s <your browser location> /usr/local/bin/firefox
7. Check the path /usr/local/CalculiX/cgx_2.17/doc/cgx
all the html files should be located there
8. Check the installation, if you performed step 3. type:
cgx -b dummy.fbd
a window should appear on your screen.
Go with the mouse-ponter outside the inner big black rectangle.
Press the left mouse button. The menu will appear. Go down to "Help" and
choose "Html Manual cgx".
The browser should open and the documentation should be vissible. If not be
sure that the documentation is in /usr/local/CalculiX/cgx_2.17/doc/cgx
9. get the examples and do the following
- move the file cgx_2.17.exa.tar.bz2 to /usr/local
- bunzip2 cgx_2.17.exa.tar.bz2
- tar -xvf cgx_2.17.exa.tar.bz2
10. get tetgen tetgen1.5.1 either from the internet or from the cgx package
- bunzip2 cgx_2.17.all.tar.bz2
Unpack tetgen1.5.1.tar and change to tetgen1.5.1 and run 'make'.
Place the program tetgen at /usr/local/bin/
Then you might change the protections:
chmod ao+rx /usr/local/bin/tetgen
B: Instalation from the source:
----------------------------
Make sure that you have the devel packages for the graphic system
installed (the headers for X11 etc.)
You need openGL on your system. Check your file system for the
two following libraries:
The openGL-library: libGL.so or libMesaGL.so
The higher level openGL-library: libGLU.so or libMesaGLU.so
The libGLU should be the one from SGI. Otherwise the nurbs rendering
is not supported.
On some systems the extension might also be ~.a instead of ~.so
You might search for this files with for example "locate libGL" or
"find /usr/* -name libGL* -print"
If you find only libMesaGL and libMesaGLU instead of libGL and libGLU
you have to create a link or a copy with the names libGL and libGLU
but ceep the extension .a or .so.
This files should be located in:
/usr/lib64/
otherwhise you have to modify the file:
/usr/local/CalculiX/cgx_2.17/src/Makefile
The original glut package from mark Kilgard is now in the distribution and
will be compiled with the other source files.
1. Unpack the file cgx_2.17.all.tar.bz2 in "/usr/local".
2. Then change to the following directory with:
cd /usr/local/CalculiX/cgx_2.17/src
3. Change the path names in the Makefile to the ones used on your system if
necessary.
4. If your installation path is not "/usr/local" then you must also change
the path for the html-help-files in "cgx.h",
see parameter "HELPFILE". If your web-browser is not firefox change the
parameter "BROWSER" also.
5. run "make" as root. On 32bit PCs you have to modify the Makefile.
Change lib64 to lib below LFLAGS .
If you have trouble with c++ code use Makefile_pure_c to use only c code.
But you will not be able to deal with nurbs any more.
Then copy the binary "cgx" to
"/usr/local/bin/cgx" with:
cp cgx /usr/local/bin/cgx
If /usr/local/bin does not exist, create it with:
mkdir /usr/local/bin
Then you might change the protections:
chmod ao+rx /usr/local/bin/cgx
6. If you have "latex" and "latex2html" on your system then run "latex cgx"
in "/usr/local/CalculiX/cgx_2.17/doc" (run it 3 times!!!) and then run
"latex2html cgx".
This creates the html-help-files. Alternatively you might download them
as well. Then get cgx_2.17.htm.tar.bz2 and unpack this package in
/usr/local/.
7. The program needs to write an info file to your home directory during run
time. Be sure that "HOME" is defined and that you have write permission to
this directory. Type "echo $HOME" and check your permissions for the
printed directory.
8. Unpack tetgen1.5.1.tar and change to tetgen1.5.1 and run 'make'.
Place the program tetgen at /usr/local/bin/
Then you might change the protections:
chmod ao+rx /usr/local/bin/tetgen
9. Check the installation, type:
cgx -b dummy.fbd
and a window should appear on your screen.
Go with the mouse-ponter outside the inner black rectangle.
Press the left mouse button. The menu will appear. Go down to "Help" and
choose "Html Manual (cgx)".
The browser should open and the documentation should be vissible. If not be
sure that the documentation is in /usr/local/CalculiX/cgx_2.17/doc/cgx
Possible problems and some hints:
---------------------------------
If you get some linker errors then you may have multiple libGL,
libglut or libGLU on your system.
If commands like "plot n all" are not recognized by the program
then your mouse pointer was probably not in the main window during
typing {;->)
If the loader complains that a specific lib is not there, then a
newer version may be available. Create a link with the required name to the
new lib (ln -s new-lib-name old-lib-name).
If the command 'rep all' causes a segmentation fault it may be solved by
using a manually compiled version of libGLU. Regard the hints written
under section 1.
If tet-meshing fails with the following messages:
ERROR: The input file "test.vol" could not be opened.
ERROR: No mesh-file found
then ng_vol from the netgen project might not be available or the surface-
mesh is not closed.
No tetmesh is created. Please make sure that you had installed tetgen or
ng_vol (see section Basic Installation). You find tetgen in the package.
Good luck,
Klaus Wittig