1 ================================================================================
3 SALOME Installation Wizard
4 ================================================================================
8 1. Running of the Installation Wizard
11 2.1. Setting of the environment for SALOME
12 2.2. Launching of SALOME
15 3.1. Time required for the installation
17 3.3. Testing of the installed SALOME platform
19 4. How to build SALOME modules from sources
20 4.1. General procedure
21 4.2. Automatic build procedure: build.sh script
22 4.3. Build SALOME using cmake
24 ================================================================================
26 1. Running of the Installation Wizard
28 The Installation Wizard can be launched in two modes: GUI and batch.
29 The root directory of the Installation Wizard contains Python
30 script runInstall. To run the Installation Wizard just type
31 ./runInstall in the terminal window:
33 [ python ] ./runInstall [<options>]
35 Without any option this script will launch the SALOME Installation
36 Wizard in the default mode (GUI) with the default installation
37 parameters. The default mode can be overridden by using command
38 line options. Each option has short and long notations:
42 Runs the Installation Wizard in the GUI mode (this is the default
47 Runs the Installation Wizard in command-line mode.
51 Defines the XML configuration file to be used by the Installation Wizard.
52 If the appropriate file is not found, the warning message is shown.
53 If this option is not used then the installation script tries to
54 define the Linux version and use the corresponding XML file.
55 For example, for the Linux Mandriva 2010.0 the config_Mandriva_2010.0.xml
56 file will be used by default.
60 Defines the target directory for SALOME platform installation.
61 If used, this option overrides the default target directory,
62 indicated in the configuration XML file (usually
63 ${HOME}/salome_<version>).
67 Defines the directory for temporary files. If used, this
68 option overrides the default temporary directory, indicated in
69 the configuration xml file (usually /tmp).
71 -a / --all-from-sources
73 Forces all products to be installed from sources including SALOME
74 modules. If this option is used all the default installation modes
77 -s / --single-directory
79 Install all SALOME binaries packages to one directory (SALOME_<version>,
80 where <version> is SALOME version).
81 Note: this option is ignored when --all-from-sources (-a) option is used.
85 Prints help information about available options.
89 Prints version information (Note: this is the version number of
90 the Installation Wizard, not of the SALOME platform).
92 For more detailed information about the Installation Wizard refer to the
93 readme.html file in the doc directory.
95 ================================================================================
99 This section describes how to run SALOME platform after its installation
100 with the Installation Wizard.
102 2.1. Setting of the environment for SALOME
104 Installation Wizard creates some environment files to simplify
105 the procedure of launching SALOME. These shell scripts set all
106 necessary environment variables for all products you have installed.
108 * env_products.csh + env_products.sh in the target directory;
109 these files can be used for the launching of SALOME.
110 * salome.csh + salome.sh in the KERNEL module's sources/binaries
111 root directories; these files are the copies of the
112 corresponding env_products.* files.
113 * env_build.csh + env_build.sh in the target directory;
114 these files contain minimal environment settings necessary
115 to build SALOME packages from sources (see paragraph 4).
117 To set SALOME environment just type in the terminal window:
125 where <KERNEL_ROOT_DIR> is KERNEL binaries directory, e.g.
126 KERNEL_7.5.1 for the 7.5.1 version.
128 2.2. Launching of SALOME
130 After you set environment you can start SALOME. Go to the KERNEL
131 module's binaries directory (KERNEL_7.5.1/bin/salome for the version
132 7.5.1) by using of 'cd' command and then type:
134 runSalome [<parameters>]
136 This will start SALOME according to the launching parameters which
137 are described in the configuration files: SalomeApp.xml in the
138 <GUI_ROOT_DIR>/share/salome/resources/gui folder and
139 .SalomeApprc.<version_number> file, located in your home
140 directory (where <version_number> is SALOME version number).
141 If the user configuration file does not exist, it is automatically
142 created when exiting SALOME GUI.
144 You can modify SALOME launching options by editing your
145 ~/.SalomeApprc.<version_number> file (not all the options are
148 <section name="launch">
149 <parameter name="gui" value="yes"/>
150 <parameter name="splash" value="yes"/>
151 <parameter name="file" value="no"/>
152 <parameter name="key" value="no"/>
153 <parameter name="interp" value="no"/>
154 <parameter name="logger" value="no"/>
155 <parameter name="xterm" value="no"/>
156 <parameter name="portkill" value="no"/>
157 <parameter name="killall" value="no"/>
158 <parameter name="modules" value="GEOM,SMESH,MED,YACS,PARAVIS"/>
159 <parameter name="embedded" value="SalomeAppEngine"/>
160 <parameter name="standalone" value="study,pyContainer,cppContainer,registry,moduleCatalog"/>
163 Some parameters described in configuration file can be overridden by
164 using of corresponding command-line options for runSalome script:
167 Launch without GUI (in the terminal mode).
169 Launch in GUI mode [default].
170 -d <1/0>, --show-desktop=<1/0>
171 1 to activate GUI desktop [default], 0 to not activate
172 GUI desktop (Session_Server starts, but GUI is not
173 shown). Ignored in the terminal mode.
175 Do not activate GUI desktop (Session_Server starts,
176 but GUI is not shown). The same as --show-desktop=0.
178 Launch in Batch Mode. (Without GUI on batch machine)
180 Redirect messages to the CORBA collector.
181 -f <log-file>, --log-file=<log-file>
182 Redirect messages to the <log-file>
183 -u <script1,script2,...>, --execute=<script1,script2,...>
184 Python script(s) to be imported. Python scripts are
185 imported in the order of their appearance. In GUI mode
186 python scripts are imported in the embedded python
187 interpreter of current study, otherwise in an external
189 -r <file>, --resources=<file>
190 Parse application settings from the <file> instead of
191 default $(HOME)/.SalomeApprc.$(version)
193 Launch each SALOME server in own xterm console
194 -m <module1,module2,...>, --modules=<module1,module2,...>
195 SALOME modules list (where <module1>, <module2> are
196 the names of SALOME modules which should be available
197 in the SALOME session)
198 -e <server1,server2,...>, --embedded=<server1,server2,...>
199 CORBA servers to be launched in the Session embedded
200 mode. Valid values for <serverN>: registry, study,
201 moduleCatalog, cppContainer, SalomeAppEngine [by
202 default the value from the configuration files is
204 -s <server1,server2,...>, --standalone=<server1,server2,...>
205 CORBA servers to be launched in the standalone mode
206 (as separate processes). Valid values for <serverN>:
207 registry, study, moduleCatalog, cppContainer,
208 pyContainer, supervContainer [by default the value
209 from the configuration files is used]
211 Kill SALOME with the current port
213 Kill all running SALOME sessions
215 The number of additional external python interpreters
216 to run. Each additional python interpreter is run in
217 separate xterm session with properly set SALOME
219 -z <1/0>, --splash=<1/0>
220 1 to display splash screen [default], 0 to disable
221 splash screen. This option is ignored in the terminal
222 mode. It is also ignored if --show-desktop=0 option is
224 -c <1/0>, --catch-exceptions=<1/0>
225 1 (yes,true,on,ok) to enable centralized exception
226 handling [default], 0 (no,false,off,cancel) to disable
227 centralized exception handling.
229 Print free port and exit
231 Do not save current configuration
232 ${HOME}/.omniORB_last.cfg
234 Launch with interactive python console.
235 --ns-port-log=<ns_port_log_file>
236 Print Naming Service Port into a user file.
238 Launch session with gdb
240 Show program's version number and exit
242 Additional launch settings are given in other sections, which refer to certain
243 modules. For example, SMESH plugins which should be used in the SALOME launch
244 session can be mentioned in the <SMESH> section, e.g.:
246 <section name="SMESH">
247 <parameter name="name" value="Mesh"/>
248 <parameter name="icon" value="ModuleMesh.png"/>
249 <parameter name="plugins" value="StdMeshers,NETGENPlugin"/>
252 ================================================================================
254 3. Installation notes
256 3.1. Time required for the installation
258 Installation of all products which are necessary to build and
259 start SALOME is a time-consuming process and needs from the user to be
261 The quickest way to install SALOME is installation from the binaries.
262 In this mode the Installation Wizard just extracts all precompiled
263 products from the corresponding archives (except for the products
264 which can be installed only by compiling from sources).
265 The installation from sources requires much more time than from
266 binaries because in this case the Installation Wizard extracts and
267 then builds each product using the product's own compilation
269 The installation time also depends on the computer and platform used.
270 For example, to install SALOME on Pentium IV-3GHz, Linux Mandriva 2010.0,
271 time of the installation is:
273 - from binaries: ~15 minutes;
274 - from sources: more than 20 hours.
278 The Installation Wizard displays the installation progress in the
279 corresponding windows (see readme.html). The Wizard uses a temporary
280 directory to store and build the products. During the installation
281 it produces some log files in this directory. If you suspect that
282 the program hangs you can check the log files. These files have names
283 in capital letters like CONFIGURE.LOG, MAKE.LOG, MAKEINSTALL.LOG, etc.
285 3.3. Testing of installed SALOME platform
287 There is a python script which allows quickly testing all SALOME
288 modules. This script can help to check if SALOME has been installed
290 To test SALOME platform, run SALOME desktop (see section 2), then
291 create a new study window (menu command 'File/New') and then type
292 in the study's embedded python console window:
296 When running, the script loads different modules (Geometry, Mesh, Med,
297 Post-Pro) and tests various functionalities of these
298 modules. You can watch the script execution progress in the embedded
299 python console window.
301 Note: salome_test.py scripts require SALOME samples module
302 (SAMPLES_SRC) to be installed (this module includes a set of sample
303 MED, Python, Supervisor graph, etc files).
304 Environment variable DATA_DIR should point at the SALOME
305 samples module directory.
307 ================================================================================
309 4. How to build SALOME modules from sources
311 This section describes how to build SALOME modules manually
312 from the sources distribution provided with the Installation Wizard.
314 4.1. General procedure
316 SALOME build procedure is based on the GNU auto-tools:
317 automake, autoconf, libtool, etc. This chapter describes the
318 steps that should be done in order to compile and install
319 SALOME modules using GNU aotu-tools. Note, that some modules support also
320 cmake-based build procedure as alternative, moreover, for
321 PARAVIS module only cmake-based procedure is
322 available. Please refer to the paragraph 4.3 for more
323 details about cmake-based build procedure.
325 If you want to build SALOME modules from sources, install all prerequisite
326 products, required for the platform and SALOME modules sources.
327 Then follow the scenario described below.
328 In this scenario it is supposed that you have installed SALOME
329 modules sources in the /home/user/salome directory. The name of each module
330 sources directory depends on the version of the platform, for example,
331 KERNEL_SRC_7.5.1 for KERNEL module of SALOME version 7.5.1.
333 Compilation and installation should be performed according to
334 the dependencies between modules:
338 * KERNEL -> no dependencies
340 * GEOM -> KERNEL, GUI
342 * SMESH -> KERNEL, GUI, GEOM
343 * YACS -> KERNEL, GUI
344 * PARAVIS -> KERNEL, GUI, MED
345 * HEXABLOCK -> KERNEL, GUI, GEOM
346 * HOMARD -> KERNEL, GUI, GEOM, SMESH
347 * JOBMANAGER -> KERNEL, GUI
351 * NETGENPLUGIN -> KERNEL, GUI, GEOM, SMESH
352 * GHS3DPLUGIN -> KERNEL, GUI, GEOM, SMESH
353 * GHS3DPRLPLUGIN -> KERNEL, GUI, GEOM, SMESH
354 * BLSURFPLUGIN -> KERNEL, GUI, GEOM, SMESH
355 * HexoticPLUGIN -> KERNEL, GUI, GEOM, SMESH, BLSURFPLUGIN
356 * HYBRIDPLUGIN -> KERNEL, GUI, GEOM, SMESH
357 * HEXABLOCKPLUGIN -> KERNEL, GUI, GEOM, SMESH, HEXABLOCK
361 * COMPONENT -> KERNEL, MED
362 * CALCULATOR -> KERNEL, MED
363 * PYCALCULATOR -> KERNEL, MED
364 * HELLO -> KERNEL, GUI
365 * PYHELLO -> KERNEL, GUI
366 * LIGHT -> KERNEL, GUI
367 * PYLIGHT -> KERNEL, GUI
368 * ATOMIC -> KERNEL, GUI
369 * ATOMGEN -> KERNEL, GUI
370 * ATOMSOLV -> KERNEL, GUI, ATOMGEN
371 * RANDOMIZER -> KERNEL
372 * SIERPINSKY -> KERNEL, GUI, RANDOMIZER, SMESH
376 * DOCUMENTATION -> no dependencies
378 Note: SMESH plugins and sample modules are optional. You may skip
379 compiling them if you do not plan to use NETGEN and/or GHS3D meshing
380 algorithms and do not want to build samples.
382 Note: Meshing plug-ins BLSURFPLUGIN, HexoticPLUGIN, GHS3DPLUGIN,
383 GHS3DPRLPLUGIN and HYBRIDPLUGIN require commercial license for the Distene
384 meshers in runtime mode. Moreover, BLSURFPLUGIN requires
385 blsurf product at the compilation time. Without it, the
386 BLSURFPLUGIN meshing plugin compilation will fail. Refer
387 to http://www.distene.com/ for more details.
389 In general, each module (except for KERNEL and GUI) is
390 optional for SALOME. If you do not need a certain module, just do not
391 compile or install it. But remember that some modules require others
392 to be built first (see dependencies table above).
394 To build KERNEL module:
396 - go to installation root directory (/home/user/salome in this example):
400 - to set environment variables use bash or csh script, depending on
403 source ./env_products.csh
405 source ./env_products.sh
407 - create build directory for the KERNEL module:
412 - create a configuration script by typing
414 ../KERNEL_SRC_7.5.1/build_configure
416 - run configure script which will check the environment and create
419 ../KERNEL_SRC_7.5.1/configure --prefix=/home/user/salome/KERNEL-7.5.1
421 Note, that --prefix option defines the directory where you want to
422 install KERNEL module after 'make install' procedure. configure script
423 also accepts a lot of other parameters (for example, to build the module
424 in the Release mode use --disable-debug --enable-production keys).
425 You can learn more about the configure of any modules by using --help (-h)
428 - build and install KERNEL module:
433 After you have completed this scenario, KERNEL module is built and
434 installed into /home/user/salome/KERNEL-7.5.1 directory.
436 - modify your environment scripts:
440 export KERNEL_ROOT_DIR=/home/user/salome/KERNEL-7.5.1
444 setenv KERNEL_ROOT_DIR /home/user/salome/KERNEL-7.5.1
446 - then repeat this scenario for other modules you want to build taking
447 into account the dependencies between modules (see dependencies table
450 Note: if the compilation fails it may be caused by bad environment.
451 In this case you should check if the environment script that you use
452 (salome.csh or salome.sh) contains the following lines for each module MODULE:
456 export MODULE_ROOT_DIR=/home/user/salome/<MODULE_distribution>
460 setenv MODULE_ROOT_DIR /home/user/salome/<MODULE_distribution>
462 where <MODULE_distribution> is a MODULE-7.5.1 (see above).
464 4.2. Automatic build procedure: build.sh script
466 SALOME Installation Wizard includes build.sh script which can be used
467 for automatic building of SALOME modules from sources packages.
468 This script is copied into the top-level installation directory
469 (the same directory where env_products.[c]sh files are generated).
471 To use the script just install SALOME sources packages with the
472 Installation Wizard, then cd to the SALOME installation directory
477 By default, build.sh builds and installs all SALOME
478 modules. All modules are installed to the INSTALL subfolder
479 of the current directory. If you need to change the installation
480 directory, you can use -p <prefix> option where <prefix> is the
481 directory SALOME modules should be installed to.
483 If you want to build only some subset of SALOME modules,
484 just pass them as parameters, e.g.:
486 ./build.sh -p /home/user/salome KERNEL MED GEOM
488 The script also provides other options which specify compiling and
489 installation parameters. You can learn about these options by using
494 Note: to avoid collisions it is recommended to avoid installation of
495 SALOME binaries packages with Installation Wizard if you plan to build
496 SALOME modules from sources packages; if you still install binary
497 packages of SALOME module, you can manually edit env_products.[c]sh
498 scripts by commenting all rows concerning environment of SALOME
501 Note: use -d option of the build.sh script carefully because
502 when this option is specified to the script, it can remove
503 the existing (previously installed) SALOME modules.
505 Note: build.sh script does not modify the environment files
506 (env_products.[c]sh, env_build.[c]sh). You should do it by yourself.
508 4.3. Build SALOME modules manually
510 The build procedure of all SALOME modules is implemented with
511 CMake. This paragraph describes the steps that can be done in
512 order to build SALOME modules manually.
514 For example, to build KERNEL module:
516 - go to installation root directory (/home/user/salome in this example):
520 - to set environment variables use bash or csh script, depending on
523 source ./env_products.csh
525 source ./env_products.sh
527 - create build directory for the KERNEL module:
534 cmake -DCMAKE_INSTALL_PREFIX=/home/user/salome/KERNEL-7.5.1 ../KERNEL_SRC_7.5.1
536 Note, that -DCMAKE_INSTALL_PREFIX option defines the directory where you want to
537 install KERNEL module after 'make install' procedure. You
538 can supply additional options to the cmake (for example, to
539 build the module in the Release mode use -DCMAKE_BUILD_TYPE=Release option).
541 - build and install KERNEL module:
546 After you have completed this scenario, KERNEL module is built and
547 installed into /home/user/salome/KERNEL-7.5.1 directory.
549 - modify your environment scripts:
553 export KERNEL_ROOT_DIR=/home/user/salome/KERNEL-7.5.1
557 setenv KERNEL_ROOT_DIR /home/user/salome/KERNEL-7.5.1
559 ================================================================================