[ python ] runInstall [<options>]
- Without opstions this script will launch the SALOME Installation
- Wizard in the default mode (GUI). The default mode can be
- overriden by using command line options. Each option has short
- and long notations:
+ Without any option this script will launch the SALOME Installation
+ Wizard in the default mode (GUI) with the default installation
+ parameters. The default mode can be overridden by using command
+ line options. Each option has short and long notations:
-g / --gui
- Runs the Installation Wizard in the GUI mode (this is default
+ Runs the Installation Wizard in the GUI mode (this is the default
mode).
-b / --batch
-f FILE / --file=FILE
- The XML configuration file to be used by the Installation Wizard.
+ Defines the XML configuration file to be used by the Installation Wizard.
+ If the appropriate file is not found, the warning message is shown.
If this option is not used then the installation script tries to
- define the Linux version and use the corresponding XML file if it
- is present. For examle, for the Linux Mandrake 10.1 the
- config_Mandrake_10.1.xml file will be used by default. If the
- appropriate file is not found, the file config.xml will be
- used. This file refers to the basic target platform which is
- Linux Mandrake 10.1 for SALOME 3.0 and newer. If config.xml file
- is also not found, the warning message box is shown (in GUI mode)
- or printed to the console (in batch mode) and the Installation
- Wizard quits.
+ define the Linux version and use the corresponding XML file.
+ For example, for the Linux Mandriva 2006.0 the config_Mandriva_2006.0.xml
+ file will be used by default.
-d DIR / --target=DIR
- The target directory SALOME platform to be installed to. If used,
- this option overrides the default target directory, given in the
- configuration XML file (usually ${HOME}/salome_<version>, see
- here for more detail).
+ Defines the target directory for SALOME platform installation.
+ If used, this option overrides the default target directory,
+ indicated in the configuration XML file (usually
+ ${HOME}/salome_<version>).
-t DIR / --tmp=DIR
- The directory, which is used for temporary files. If used, this
- option overrides the default temporary directory, given in the
- configuration xml file (usually /tmp, see here for more detail).
+ Defines the directory for temporary files. If used, this
+ option overrides the default temporary directory, indicated in
+ the configuration xml file (usually /tmp).
+ -a / --all-from-sources
+
+ Forces all products to be installed from sources including SALOME
+ modules. If this option is used all the default installation modes
+ are ignored.
+
+ -s / --single-directory
+
+ Install all SALOME binaries packages to one directory (SALOME_<version>,
+ where <version> is SALOME version).
+ Note: this option is ignored when --all-from-sources (-a) option is used.
+
-h / --help
Prints help information about available options.
-v / --version
- Prints version information (Note: this is the Installation
- Wizard's version number, not of SALOME platform).
+ Prints version information (Note: this is the version number of
+ the Installation Wizard, not of the SALOME platform).
For more detailed information about the Installation Wizard refer to the
readme.html file in the doc directory.
2.1. Setting of the environment for SALOME
Installation Wizard creates some environment files to simplify
- the procedure of launching of SALOME. These shell scripts set all
+ the procedure of launching SALOME. These shell scripts set all
necessary environment variables for all products you have installed.
These files are:
* env_products.csh + env_products.sh in the target directory;
source salome.csh
where <KERNEL_ROOT_DIR> is KERNEL binaries directory, e.g.
- KERNEL_3.2.1 for the 3.2.1 version.
+ KERNEL_4.1.4 for the 4.1.4 version.
2.2. Launching of SALOME
After you set environment you can start SALOME. Go to the KERNEL
- module's binaries directory (KERNEL_3.2.1/bin/salome for the version
- 3.2.1) by using of 'cd' command and then type:
+ module's binaries directory (KERNEL_4.1.4/bin/salome for the version
+ 4.1.4) by using of 'cd' command and then type:
runSalome [<parameters>]
This will start SALOME according to the launching parameters which
are described in the configuration files: SalomeApp.xml in the
- <GUI_ROOT_DIR>/share/salome/resources folder and .SalomeApprc.<version_number>
- file, located in your home directory (where <version_number> is number
- of SALOME version). If the latest file does not exist, it is automatically
- created during the first launch of SALOME.
+ <GUI_ROOT_DIR>/share/salome/resources/gui folder and
+ .SalomeApprc.<version_number> file, located in your home
+ directory (where <version_number> is SALOME version number).
+ If the user configuration file does not exist, it is automatically
+ created when exiting SALOME GUI.
You can modify SALOME launching options by editing your
- ~/.SalomeApprc.<version_number> file:
+ ~/.SalomeApprc.<version_number> file (not all the options are
+ listed below):
<section name="launch">
<parameter name="gui" value="yes"/>
<parameter name="standalone" value="study,pyContainer,cppContainer,registry,moduleCatalog"/>
</section>
- Some parameters described in configuration file can be overrided by
+ Some parameters described in configuration file can be overridden by
using of corresponding command-line options for runSalome script:
--gui
patient.
The quickest way to install SALOME is installation from the binaries.
In this mode the Installation Wizard just extracts all precompiled
- products from the corresponding archives (except those products
+ products from the corresponding archives (except for the products
which can be installed only by compiling from sources).
The installation from sources requires much more time than from
binaries because in this case the Installation Wizard extracts and
then builds each product using the product's own compilation
procedure.
The installation time also depends on the computer and platform used.
- For example, to install SALOME on Pentium IV-2GHz, Linux Mandrake 10.1,
+ For example, to install SALOME on Pentium IV-3GHz, Linux Mandriva 2006.0,
time of the installation is:
- - from binaries: ~10 minutes;
+ - from binaries: ~15 minutes;
- from sources: more than 24 hours.
- Note, the most time-consuming process is compiling of CASCADE libraries from
- sources - it takes about 90% of time needed for compilation of all products.
-
3.2. Log files
The Installation Wizard displays the installation progress in the
corresponding windows (see readme.html). The Wizard uses a temporary
directory to store and build the products. During the installation
it produces some log files in this directory. If you suspect that
- program hangs you can check the log files. These files have names
+ the program hangs you can check the log files. These files have names
in capital letters like CONFIGURE.LOG, MAKE.LOG, MAKEINSTALL.LOG, etc.
3.3. Testing of installed SALOME platform
- There is a python script which allows to test shortly all SALOME
+ There is a python script which allows quickly testing all SALOME
modules. This script can help to check if SALOME has been installed
successfully.
To test SALOME platform, run SALOME desktop (see section 2), then
import salome_test
When running, the script loads different modules (Geometry, Mesh, Med,
- Post-Pro and Supervisor) and tests different functionality of these
- modules. You can watch script running progress in the embedded
+ Post-Pro and Supervisor) and tests various functionalities of these
+ modules. You can watch the script execution progress in the embedded
python console window.
+ Note: salome_test.py scripts require SALOME samples module
+ (SAMPLES_SRC) to be installed (this module includes a set of sample
+ MED, Python, Supervisor graph, etc files).
+ Environment variable DATA_DIR should point at the SALOME
+ samples module directory.
+
================================================================================
4. How to build SALOME modules from sources
- This section describes the way how to build SALOME modules manually from
- sources distribution provided with Installation Wizard.
+ This section describes how to build SALOME modules manually
+ from the sources distribution provided with the Installation Wizard.
4.1. General procedure
In this scenario it is supposed that you have installed SALOME
modules sources in the /home/salome directory. The name of each module
sources directory depends on the version of the platform, for example,
- KERNEL_SRC_3.2.1 for KERNEL module of SALOME version 3.2.1.
+ KERNEL_SRC_4.1.4 for KERNEL module of SALOME version 4.1.4.
- The order of compilation and installation should be performed according
- to the dependancies between modules:
+ Compilation and installation should be performed according to
+ the dependencies between modules:
Main SALOME modules:
- * KERNEL -> no dependancies
+ * KERNEL -> no dependencies
* GUI -> KERNEL
* GEOM -> KERNEL, GUI
* MED -> KERNEL, GUI
* NETGENPLUGIN -> KERNEL, GUI, SMESH
* GHS3DPLUGIN -> KERNEL, GUI, SMESH
+ * GHS3DPRLPLUGIN -> KERNEL, GUI, SMESH
+ * HexoticPLUGIN -> KERNEL, GUI, SMESH
+ * BLSURFPLUGIN -> KERNEL, GUI, SMESH
Sample modules:
* HELLO -> KERNEL, GUI
* PYHELLO -> KERNEL
* LIGHT -> KERNEL, GUI
+ * RANDOMIZER -> KERNEL, GUI
+ * SIERPINSKY -> KERNEL, GUI, VISU, RANDOMIZER
Note: SMESH plugins and sample modules are optional. You may skip
compiling them if you do not plan to use NETGEN and/or GHS3D meshing
algorithms and do not want to build samples.
- In general, each module (except KERNEL and GUI, of course) is optional for
- SALOME. If you do not need any module, just do not compile or install
- it. But remember that some modules require other ones to be built first
- (see dependancies table above).
+ In general, each module (except for KERNEL and GUI, of course) is
+ optional for SALOME. If you do not need a certain module, just do not
+ compile or install it. But remember that some modules require others
+ to be built first (see dependencies table above).
To build KERNEL module:
- create a configuration script by typing
- ../KERNEL_SRC_3.2.1/build_configure
+ ../KERNEL_SRC_4.1.4/build_configure
- run configure script which will check the environment and create
Makefile files:
- ../KERNEL_SRC_3.2.1/configure --prefix=/home/salome/KERNEL_install
+ ../KERNEL_SRC_4.1.4/configure --prefix=/home/salome/KERNEL_install
Note, that --prefix option defines the directory where you want to
install KERNEL module after 'make install' procedure. configure script
- accepts also a lot of other parameters (for example, to build the module
+ also accepts a lot of other parameters (for example, to build the module
in the optimized mode use --disable-debug --enable-production keys).
- More about certain module's configure options you can learn by using
- --help (-h) parameter.
+ You can learn more about the configure of any modules by using --help (-h)
+ parameter.
- build and (optionally) install KERNEL module:
(if make install step was not performed).
- then repeat this scenario for other modules you want to build taking
- into account the dependancies between modules (see dependancies table
+ into account the dependencies between modules (see dependencies table
above).
Note: if the compilation fails it may be caused by bad environment.
- In this case you should check that environment script you use
+ In this case you should check if the environment script that you use
(salome.csh or salome.sh) contains the following lines for each module MODULE:
* for bash:
where <MODULE_distribution> is a MODULE_build or MODULE_install (see above).
- 4.2. Automatic build procedure: build.csh script
+ 4.2. Automatic build procedure: build.csh and build.sh scripts
- From version 2.2.0 SALOME Installation Wizard includes the script
+ SALOME Installation Wizard includes two scripts which can be used
for automatic building of SALOME modules from sources packages:
- build.csh. It is installed into the top-level target directory
- (the same directory where env_products.[c]sh files are generated.
+ build.csh and build.sh. The scripts are installed into the top-level
+ installation directory (the same directory where env_products.[c]sh
+ files are generated).
+
+ The build.csh and buils.sh scripts implement the same functionality
+ and support the same set of options, but for different shells.
+ Use build.csh script for csh and build.sh for bash.
+ The description below refers to both scripts.
- To use this script just install SALOME sources packages with
+ To use the script just install SALOME sources packages with the
Installation Wizard, then cd to the SALOME installation directory
and type:
By default, build.csh only compiles the modules but does not install them,
i.e. does not perform 'make install' step.
- To do this, use -i option or -p <prefix> where <prefix> is target
- directory.
+ To do this, use -i option or -p <prefix> where <prefix> is the
+ directory SALOME modules should be installed to.
If you want to build only some SALOME modules, just pass them as
parameters, e.g.:
./build.csh -i KERNEL MED GEOM
- The script also provides some other options which specify compiling
- and installation parameters. You can learn about options by using
+ The script also provides other options which specify compiling and
+ installation parameters. You can learn about these options by using
-h key:
./build.csh -h
- When you run build.csh at first time it is not necessary to pass
+ When you run build.csh for the first time it is not necessary to pass
-b, -c parameters. The script detects if build procedure has not yet
- been performed and runs build_configure, configure scripts
- in this case automatically.
+ been performed and in this case runs build_configure, configure scripts
+ automatically.
- Note: for avoiding of collisions it is recommended not to install
+ Note: to avoid collisions it is recommended not to install
SALOME binaries packages with Installation Wizard if you plan to build
SALOME modules from sources packages or to edit/comment all rows
in env_products.csh file concerning binaries packages.
Note: use -d option carefully because in this case the script removes
- existing (previously installed) SALOME modules.
+ the existing (previously installed) SALOME modules.
- Note: please, take into account 'make install' step is
+ Note: please, take into your account that 'make install' step is
obligatory for the KERNEL module. Build directory of KERNEL
- can not be pointed as KERNEL_ROOT_DIR. This is an exception
- for the SALOME modules. So you should use one of options -i
+ can not be indicated as KERNEL_ROOT_DIR. This is an exception
+ for the SALOME modules. So you should use either option -i
or -p of build.sch script when building KERNEL module.
+ Note: build.(c)sh scripts do not modify the environment files
+ (env_products.csh, etc). You should do it by yourself.
+
================================================================================
