X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=README;h=fa1a5f1a9cbb43d52a322cdb7f2c0ea04a368e49;hb=b0a22d84b4ffa96c45d700d89c4c43986f0ddfea;hp=ead7b1b893e898a317b688be50253fc72ade7cff;hpb=0278a344a3356b726b718373d7e404c33f82f314;p=tools%2Finstall.git diff --git a/README b/README index ead7b1b..fa1a5f1 100644 --- a/README +++ b/README @@ -27,9 +27,9 @@ The Installation Wizard can be launched in two modes: GUI and batch. The root directory of the Installation Wizard contains Python script runInstall. To run the Installation Wizard just type - runInstall in the terminal window: + ./runInstall in the terminal window: - [ python ] runInstall [] + [ python ] ./runInstall [] Without any option this script will launch the SALOME Installation Wizard in the default mode (GUI) with the default installation @@ -122,13 +122,13 @@ source salome.csh where is KERNEL binaries directory, e.g. - KERNEL_5.1.0 for the 5.1.0 version. + KERNEL_5.1.3 for the 5.1.3 version. 2.2. Launching of SALOME After you set environment you can start SALOME. Go to the KERNEL - module's binaries directory (KERNEL_5.1.0/bin/salome for the version - 5.1.0) by using of 'cd' command and then type: + module's binaries directory (KERNEL_5.1.3/bin/salome for the version + 5.1.3) by using of 'cd' command and then type: runSalome [] @@ -154,7 +154,7 @@ - + @@ -162,25 +162,81 @@ Some parameters described in configuration file can be overridden by using of corresponding command-line options for runSalome script: - --gui - Launch GUI desktop - --logger - Use logger server - --xterm - Start each server in its own xterm console window - --portkill - Kill SALOME, running on the current port - --killall - Kill SALOME, running on all ports - --modules=,,..., - Use module(s), possible values are GEOM,SMESH,VISU,MED,SUPERV,etc. - --embedded=,,... - Start specified server/container(s) embedded in SALOME Session server - (i.e. running in the same process), possible values are registry, - study, moduleCatalog, cppContainer, registry - --standalone=,,... - Start standalone server/container(s), possible values are registry, - study, registry, moduleCatalog, cppContainer, pyContainer, supervContainer. + -t, --terminal + Launch without GUI (in the terminal mode). + -g, --gui + Launch in GUI mode [default]. + -d <1/0>, --show-desktop=<1/0> + 1 to activate GUI desktop [default], 0 to not activate + GUI desktop (Session_Server starts, but GUI is not + shown). Ignored in the terminal mode. + -o, --hide-desktop + Do not activate GUI desktop (Session_Server starts, + but GUI is not shown). The same as --show-desktop=0. + -b, --batch + Launch in Batch Mode. (Without GUI on batch machine) + -l, --logger + Redirect messages to the CORBA collector. + -f , --log-file= + Redirect messages to the + -u , --execute= + Python script(s) to be imported. Python scripts are + imported in the order of their appearance. In GUI mode + python scripts are imported in the embedded python + interpreter of current study, otherwise in an external + python interpreter + -r , --resources= + Parse application settings from the instead of + default $(HOME)/.SalomeApprc.$(version) + -x, --xterm + Launch each SALOME server in own xterm console + -m , --modules= + SALOME modules list (where , are + the names of SALOME modules which should be available + in the SALOME session) + -e , --embedded= + CORBA servers to be launched in the Session embedded + mode. Valid values for : registry, study, + moduleCatalog, cppContainer, SalomeAppEngine [by + default the value from the configuration files is + used] + -s , --standalone= + CORBA servers to be launched in the standalone mode + (as separate processes). Valid values for : + registry, study, moduleCatalog, cppContainer, + pyContainer, supervContainer [by default the value + from the configuration files is used] + -p, --portkill + Kill SALOME with the current port + -k, --killall + Kill all running SALOME sessions + -i , --interp= + The number of additional external python interpreters + to run. Each additional python interpreter is run in + separate xterm session with properly set SALOME + environment + -z <1/0>, --splash=<1/0> + 1 to display splash screen [default], 0 to disable + splash screen. This option is ignored in the terminal + mode. It is also ignored if --show-desktop=0 option is + used. + -c <1/0>, --catch-exceptions=<1/0> + 1 (yes,true,on,ok) to enable centralized exception + handling [default], 0 (no,false,off,cancel) to disable + centralized exception handling. + --print-port + Print free port and exit + --nosave-config + Do not save current configuration + ${HOME}/.omniORB_last.cfg + --pinter + Launch with interactive python console. + --ns-port-log= + Print Naming Service Port into a user file. + --gdb-session + Launch session with gdb + --version + Show program's version number and exit Additional launch settings are given in other sections, which refer to certain modules. For example, SMESH plugins which should be used in the SALOME launch @@ -237,7 +293,7 @@ import salome_test When running, the script loads different modules (Geometry, Mesh, Med, - Post-Pro and Supervisor) and tests various functionalities of these + Post-Pro) and tests various functionalities of these modules. You can watch the script execution progress in the embedded python console window. @@ -260,9 +316,9 @@ products, required for the platform and SALOME modules sources. Then follow the scenario described below. In this scenario it is supposed that you have installed SALOME - modules sources in the /home/salome directory. The name of each module + modules sources in the /home/user/salome directory. The name of each module sources directory depends on the version of the platform, for example, - KERNEL_SRC_5.1.0 for KERNEL module of SALOME version 5.1.0. + KERNEL_SRC_5.1.3 for KERNEL module of SALOME version 5.1.3. Compilation and installation should be performed according to the dependencies between modules: @@ -275,15 +331,15 @@ * MED -> KERNEL, GUI * SMESH -> KERNEL, GUI, GEOM, MED * VISU -> KERNEL, GUI, MED - * SUPERV -> KERNEL, GUI + * YACS -> KERNEL, GUI SMESH plugins: - * NETGENPLUGIN -> KERNEL, GUI, SMESH - * GHS3DPLUGIN -> KERNEL, GUI, SMESH - * GHS3DPRLPLUGIN -> KERNEL, GUI, SMESH - * HexoticPLUGIN -> KERNEL, GUI, SMESH - * BLSURFPLUGIN -> KERNEL, GUI, SMESH + * NETGENPLUGIN -> KERNEL, GUI, MED, GEOM, SMESH + * GHS3DPLUGIN -> KERNEL, GUI, MED, GEOM, SMESH + * GHS3DPRLPLUGIN -> KERNEL, GUI, MED, GEOM, SMESH + * HexoticPLUGIN -> KERNEL, GUI, MED, GEOM, SMESH + * BLSURFPLUGIN -> KERNEL, GUI, MED, GEOM, SMESH Sample modules: @@ -291,15 +347,23 @@ * PYCALCULATOR -> KERNEL, MED * CALCULATOR -> KERNEL, MED * HELLO -> KERNEL, GUI - * PYHELLO -> KERNEL + * PYHELLO -> KERNEL, GUI * LIGHT -> KERNEL, GUI + * PYLIGHT -> KERNEL, GUI * RANDOMIZER -> KERNEL, GUI - * SIERPINSKY -> KERNEL, GUI, VISU, RANDOMIZER + * SIERPINSKY -> KERNEL, GUI, MED, 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. + Note: Meshing plug-ins BLSURFPLUGIN, HexoticPLUGIN and + GHS3DPRLPLUGIN require commercial license for the Distene + meshers in runtime mode. Moreover, BLSURFPLUGIN requires + blsurf product at the compilation time. Without it, the + BLSURFPLUGIN meshing plugin compilation will fail. Refer + to http://www.distene.com/ for more details. + 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 @@ -307,9 +371,9 @@ To build KERNEL module: - - go to installation root directory (/home/salome in this example): + - go to installation root directory (/home/user/salome in this example): - cd /home/salome + cd /home/user/salome - to set environment variables use bash or csh script, depending on your shell: @@ -325,12 +389,12 @@ - create a configuration script by typing - ../KERNEL_SRC_5.1.0/build_configure + ../KERNEL_SRC_5.1.3/build_configure - run configure script which will check the environment and create Makefile files: - ../KERNEL_SRC_5.1.0/configure --prefix=/home/salome/KERNEL_install + ../KERNEL_SRC_5.1.3/configure --prefix=/home/user/salome/KERNEL-5.1.3 Note, that --prefix option defines the directory where you want to install KERNEL module after 'make install' procedure. configure script @@ -339,29 +403,23 @@ You can learn more about the configure of any modules by using --help (-h) parameter. - - build and (optionally) install KERNEL module: + - build and install KERNEL module: make make install After you have completed this scenario, KERNEL module is built and - installed into /home/salome/KERNEL_install directory. + installed into /home/user/salome/KERNEL-5.1.3 directory. - modify your environment scripts: * for bash: - export KERNEL_ROOT_DIR=/home/salome/KERNEL_install - or - export KERNEL_ROOT_DIR=/home/salome/KERNEL_build - (if make install step was not performed). + export KERNEL_ROOT_DIR=/home/user/salome/KERNEL-5.1.3 * for csh: - setenv KERNEL_ROOT_DIR /home/salome/KERNEL_install - or - setenv KERNEL_ROOT_DIR /home/salome/KERNEL_build - (if make install step was not performed). + setenv KERNEL_ROOT_DIR /home/user/salome/KERNEL-5.1.3 - then repeat this scenario for other modules you want to build taking into account the dependencies between modules (see dependencies table @@ -373,13 +431,13 @@ * for bash: - export MODULE_ROOT_DIR=/home/salome/ + export MODULE_ROOT_DIR=/home/user/salome/ * for csh: - setenv MODULE_ROOT_DIR /home/salome/ + setenv MODULE_ROOT_DIR /home/user/salome/ - where is a MODULE_build or MODULE_install (see above). + where is a MODULE-5.1.3 (see above). 4.2. Automatic build procedure: build.csh and build.sh scripts @@ -400,15 +458,16 @@ ./build.csh - 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 where is the + By default, build.csh builds and installs all SALOME + modules. All modules are installed to the INSTALL subfolder + of the current directory. If you need to change the installation + directory, you can use -p option where 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.: + If you want to build only some subset of SALOME modules, + just pass them as parameters, e.g.: - ./build.csh -i KERNEL MED GEOM + ./build.csh -p /home/user/salome KERNEL MED GEOM The script also provides other options which specify compiling and installation parameters. You can learn about these options by using @@ -417,7 +476,7 @@ ./build.csh -h 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 + -b or -c parameters. The script detects if build procedure has not yet been performed and in this case runs build_configure, configure scripts automatically. @@ -429,12 +488,6 @@ Note: use -d option carefully because in this case the script removes the existing (previously installed) SALOME modules. - Note: please, take into your account that 'make install' step is - obligatory for the KERNEL module. Build directory of KERNEL - 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.