X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Freadme.html;h=137f24800cebd8501c2b72842f35f4fb857c42f1;hb=57a88d00ae1e926c9854ea7377647e7fd039a103;hp=9e16af3305174bcf1452d88b65791c3efbbc2569;hpb=eb9de328d5830612894de3a1a8524f176a625aa5;p=tools%2Finstall.git diff --git a/doc/readme.html b/doc/readme.html index 9e16af3..137f248 100755 --- a/doc/readme.html +++ b/doc/readme.html @@ -1,827 +1,1239 @@ - +
- - - -
-
-
- |
-
-
-SALOME Professional Installation Wizard -Help |
-
-- - | -
+ |
+
+ SALOME Installation +Wizard Help+ |
+ + + | +
[ python ] runInstall [ -g | b ] [ -f <xml-file> ] [ -t <target-dir> -] [ -tmp <tmp-dir> ] -
-g
-Runs the Installation Wizard in the GUI mode. In this case only <xml-file>
-key is taken into account. This option is used by default.
-
-b
-Runs the Installation Wizard in the batch mode.
-
-f <xml-file> The configuration
-file to be used by the Installation Wizard. If this parameter is
-missed then the script tries to define the Red Hat version and use
-corresponding xml file. For examle, for the Red Hat 8.0 config_RedHat8_0.xml
-file is supposed to be used by default. If the appropriate file is not
-found, config.xml is used by default.
-
-t <target-dir> The target directory, SALOME products
-to be installed to. If used, overloads target directory, described in the
-configuration file.
-
-tmp <tmp-dir> The directory, which is used to contain
-temporary files. If used, overloads temporary directory, described
-in the configuration file.
-
So, to run the Installation Wizard in the GUI mode, just type runInstall. -
The installation procedure can support some different Linux platforms
-(currently it provides configuration scripts for RedHat-7.1 and
-RedHat-8.0)
-and various number of products.
-
The using of configuration xml files gives flexible way to modify the
-list of products to be installed by the Installation Wizard without changing
-program's source code. Just create your own configuration file and implement
-installation scripts for products you want to be provided by Wizard. See
-modifying
-XML configuration file and implementing installation
-scripts for the new products for more information.
-
The Installation Wizard was built with -using of the Qt library. The program contains several -pages. To navigate between pages use "Next" and "Back" buttons -in the lower part of the wizard window. "Cancel" button closes dialog -window and quits the installation procedure. To invoke this help information -click -"Help" button. -
Skip the first "Introduction" page by pressing "Next" -button. -
In the second page you are proposed to enter the target directory where
-all selected products will be installed to. You can also press "Browse..."
-button and choose the folder for installation using standard Qt
-browse directory dialog box.
-
If the directory you want to install products does not exist you will
-be prompted to confirm directory creation. If you type wrong directory
-path, or if you have no permission for the directory you use, the corresponding
-message box will raise.
-
The Installation Wizard has two modes of the installation: basic and -advanced. In the basic mode it is necessary just to enter target directory. -If you want to use advanced mode, click "More..." button. -
In the advanced mode you have the possibility to select products to
-be installed (see Fig.1 ). Each product has
-several options of installation: you have a possibility to use native products,
-install already precompiled binaries, build product from the sources or
-not installed at all. Possible options and default choice are provided
-by the configuration file. You can mark the products, you want to install,
-by clicking the corresponding radiobuttons in the list view in the left
-part of the page. Note that some products can be installed only together
-with other products (or these prerequisite products should be already installed
-on your computer). The installation procedure has a special feature to
-automatically mark these products in the list view. For example, in order
-to install pyqt it's necessary to have
-gcc, python,
-qt and
-sip installed. Therefore all these products
-will be marked when you check on
-pyqt. This feature can be
-switched off by clicking "Auto set prerequisites products" checkbox.
-
Special button in the right part of the page - "Unselect All" -
-allows to reset quickly all products to the "not install" state.
-
If you want to use native Linux Red Hat 8.0 products (these are gcc,
-tcl, Python, Qt, Sip and PyQt), select "use native" option.
-
The box at the right side of the page displays the information about -currently highlighted product: name, version, required disk space, temporary -files disk space and list of prerequisites. -
Figure 1: "Installation settings" page in the advanced mode
The "Total disk space required:" field displays how much disk
-space on the hard drive is required for installation of selected products.
-
Note: Please, take into account that displayed amount of required
-disk space is approximate and may differ when you install products on your
-hard drive.
-
Installation procedure uses a special directory to store temporary files. -The "Space for temporary files:" field shows the information about -required disk space on the hard drive for extracting and compiling of the -selected products. You can change the default directory - just type path -to the folder you want to use or click on the corresponding "Browse..." +
[ python ] ./runInstall [options]
+
Without options this script will launch the SALOME Installation
+Wizard in the GUI mode.
+The default installation settings can be overridden by using of command
+line options. Each option has short and long notations:
+
-g / --gui
+
-b / --batch
+
-f FILE / --file=FILE
+
-d DIR / --target=DIR
+
-t DIR / --tmp=DIR
+-a / --all-from-sources
+-s / --single-directory
+-h / --help
+
+-v / --version
+
+
+The installation procedure supports different Linux
+platforms and installs various 3d-party installation prerequisite products, which
+are required by SALOME platform. Among supported Linux platforms there are Mandriva 2008
+(32bit and 64bit), Mandriva 2010 (32bit and 64bit), Debian 4.0 Etch (32bit and 64bit),
+Debian 5.0 Lenny 64bit, Debian 6.0 Squeeze 64bit and other ones.
+The usage of configuration XML files provides a flexible way to modify
+the list of products to be installed by the Installation Wizard without
+changing the source code of the application. Just create your own XML
+configuration file and implement installation scripts for the prerequisite products you
+need and then use this XML file with the Installation Wizard. This can
+be done, for example, for some Linux
+platform which is not supported directly by the
+Installation Wizard. See Modifying XML
+configuration file and Implementing installation
+scripts for the new products sections for more information.
The GUI of the Installation Wizard has been +developed with Qt +3.3.8 toolkit by +Trolltech . After launching the Installation Wizard +in the GUI mode the wizard window is shown to the user. This wizard +guides the user through several subsequent pages. To navigate between +the pages use "Next" and "Back" +buttons in the lower part of the wizard window. "Cancel" button +closes the wizard window and quits the installation procedure after user +confirmation. "Help" button opens a window with the help information.
+The first "Introduction" +page is shown in Figure 1. +Skip this page by pressing "Next" button: +
+Figure 1: "Introduction" page
+In the second page you are proposed to select the type of the
+SALOME installation.
+
+At this step three possible types of installation are available:
+
In case you select "Install sources and make compilation" +installation type, then you can also check "Remove sources and +temporary files after compilation" option. +
+Figure 2: "Type of installation" page +
+After the installation type has been selected you click "Next" +button and the Installation Wizard tries to determine the Linux +platform to load the corresponding configuration file. If the operating +system is not defined or the current SALOME package does not support +this system, the warning message will appear ("Install binaries" +and "Install sources" installation types only): +
+Figure 3: "Installation platform" page +
+If "Install sources and make compilation"
+installation type has been selected, the warning message will be
+slightly different: "Your Linux platform is not supported by
+this SALOME package and compilation is not tested on this one".
+There is a list of all platforms supported by SALOME, but only those
+supported by the current package are available for selection. in this
+page you need to to select the reference platform, if you wish to
+proceed with the present installation procedure.
+Note: this page is not displayed if the installation
+platform has been defined automatically.
+
In the next page you are proposed to enter the target
+installation directory for SALOME platform. You can also press "Browse..."
+button and choose the destination folder using the standard browse
+directory dialog box.
+If the necessary directory does not exist you are
+prompted to confirm the directory creation. If you type a wrong
+directory
+path, or if you do not have the permissions to write to the chosen
+directory, the corresponding message box is shown.
+
Note: you are strongly recommended to avoid using +directory names containing spaces. Otherwise you can +experience some troubles with the +installation. +
+Figure 4: "Installation directory" page +
+You can select the products to be installed in the "Choice of
+the products to be installed" page.
+In the default mode it gives you the possibility to view and select
+SALOME modules only. There is a hidden list of 3d-party prerequisite
+products. To show it, just click "Show prerequisites..."
button.
-
The installation procedure also checks available disk space on the selected -directories according to the products selected. If there is no enough disk -space on your hard drive you will see the corresponding error message box. -
Note: Unfortunately, the configure procedure has a very annoying -bug under Linux platform. The directory should be obligatory entered without -spaces. For example, the configure procedure for gcc won't -work if you pass the following parameter: --prefix="/New Folder 1". -Therefore -you are strongly recommended not to use directory names containing spaces. -
To proceed further click "Next" button. At this moment program -will make some tests to check installation settings: if there is enough -disk space on the hard drive, if native products are preinstalled, dependencies -(prerequisites) for each product you have selected to be installed. -If any test fails you will see corresponding warning message box. Otherwise -wizard will follow to the next page: -
Figure 2: "Check your choice" page
This page summarizes the installation settings you've made on the previous
-pages. You can check again your choice to change it if necessary.
-
When you are sure that everything is OK, press "Next" button
-to follow to the next page.
-
Figure 3: "Installation progress" page
To start installation of the selected products click "Start"
-button. It launches the shell installation script and you will be able
-to see the output of the script in the topmost dialog's frame. In case
-of any installation problems (for example, you have accidentally removed
-the temporary directory) the script will ask you:
-"Would you like to
-continue : (Y,N) ?". You can answer this question by typing [Y] or
-[N] in the middle text edit control frame.
-
Note: press [Enter] when you finish typing data.
-
The "Installation Status" frame window shows you the progress -of installation. It contains a list of all selected products with brief -descriptions. "Waiting" description means -that installation of this product have not started yet. Currently installing -product is marked as "Processing". All installed -products have "Completed" description. -
You can abort installation and close the installation procedure using -"Cancel" -button. It sends the signal "SIGTERM" to the shell script. The script has -a signal handler and will try to clear all temporary files. The process -of removing temporary files can take some time, so the installation wizard -will wait 3 seconds before closing. -
At the end of installation (all selected products have been installed -successfully) you can go back to the previous pages to start a new installation -or click "Next" button to go the Readme page: -
Figure 4: "Finish installation" page
In this page you can read important information about the Instalation
-Wizard itself and some hints: how to run and test SALOME or how to build
-SALOME from the sources. This is the contents of the README file which
-you can find in the root directory of the Installation Wizard.
-
You can also launch SALOME Desktop from this page by clicking "Launch
-SALOME" button.
-
During the process of installation the script creates some environment -files to simplify procedure of launching SALOME. These shell scripts set -all necessary environment variables for all products you have installed. -To learn how installation scripts collects the environment, see -here. These files are: salome.csh + salome.sh in the -SALOME -PRO sources and SALOME PRO binaries root directories -and env_products.csh + env_products.sh -in the target directory. +
+Figure 5: Choice of the SALOME modules +
+In the full mode you also have the possibility to select
+prerequisites.
+The checkbox before each product indicates if this one will be
+installed or not (checked or unchecked). The second column shows the
+disk space occupied by the corresponding module. This value depends on
+the selected type of installation.
+To hide the prerequisites list - click "Hide prerequisites"
+button.
Figure 6: Choice of the prerequisites +
++Some products may require some other prerequisite products to be +installed. So the installation procedure has a special feature to +automatically mark these products in the list view. For example, to +install PyQt it is necessary to have gcc, Python, Qt and Sip installed, +and these products will be also turned on when you check on PyQt. GEOM +module requires KERNEL, GUI modules and such prerequisites as: +OpenCascade, Python, Swig, Qt, etc. +
+The dependencies between SALOME modules are managed in the +following way: +
+Dependency between modules and prerequisites is realized in +the following way: +
+Figure 7: Dependencies between modules and +prerequisites +
+The "Installation with GUI" checkbox allows
+managing the installation of the graphical interface. Only modules for that
+'woguimode' attribute is set to "true" value in the XML file
+(see here for more information about
+customizing this installation mode) support without GUI mode and
+will be checked and installed with their necessary prerequisites in
+case of installation without GUI. And other modules are unchecked with no
+possibility to check them in this mode (see figure below).
+By default 'Installation with GUI' checkbox is switched on.
+
Figure 8: Installation without GUI mode +
+The box at the right side of the page displays the information +about the currently selected product: name, version and short description, +required disk space, disk space required for the temporary files and +the list of prerequisites (this information is provided in the XML +file). +
+The "Disk space required:" field displays
+how much
+disk space on the hard drive is required for installation of the
+selected
+products.
+Note: please, take into account that the displayed
+amount of
+the required disk space is approximate and may differ when you actually
+install products on your hard drive.
+
The installation procedure uses a special directory to store
+temporary files. The "Space for temporary files"
+field shows
+the information about the required disk space on the hard drive for
+extracting and compiling the selected products. You can change the
+temporary directory (this information is provided in the XML file) to
+the folder you want.
+Note:
+actually, the temporary files
+are not stored directly in the directory selected by the user. The
+Installation Wizard creates in this directory an additional folder
+named
+like INSTALLWORKXXXXX
+where XXXXX is a unique number. This allows launching several
+Installation Wizards simultaneously. This temporary directory is
+removed automatically when the installation finishes.
+
The installation procedure also checks the available disk +space. If +there is not enough disk space on your hard drive you will see the +corresponding error message box. +
+Also in the current version of Installation Wizard is possible
+to install all binaries of the selected SALOME modules into a single
+directory. It is "SALOME" directory.
+For this purpose there is a checkbox "Install modules to a
+single directory" checkbox exists (see Fig.8).
+This feature helps to get shorter PYTHONPATH and LD_LIBRARY_PATH
+environment variables.
+Note: the installation into a single directory is
+available with the binaries installation type only.
+
To proceed further, click "Next" button. +At this moment +the program will make some tests to check the installation settings: if +there is enough disk space on the hard drive, check for the +dependencies for each product you have selected to be installed. If any +test fails you will see the corresponding warning message box. +Otherwise the wizard will proceed to the next page: +
+Figure 9: "Check your choice" page +
+This page summarizes the installation options you've selected
+in the
+previous pages. You can review again your choices and change them if
+necessary returning to the previous pages.
+When you are sure that everything is OK, press "Next"
+button to
+follow to the progress page.
+
Figure 10: "Installation progress" page: +not started yet +
+Note:
+in the current
+implementation it is not possible to resume the stopped installation
+process; the installation will restart from the very beginning.
+
Figure 11: "Installation progress" page: +installation in +progress +
+The "Installation Status" frame window +shows you the +progress of installation. "Waiting" +status +means that the installation of this product has not started +yet. The product currently being installed is marked as "Processing" and is displayed in +the status bar under "Installation Status" view. All installed products +have "Completed" +status. +
+You can abort the installation and close the installation
+procedure
+using "Cancel" button.
+Note: this
+button sends the
+signal "SIGTERM" to the shell script.
+The script tries to clear all temporary files.
+The process of removing the temporary files can take some time, so the
+installation wizard will wait for 3 seconds before closing.
+
At the end of the installation "Installation completed" +message will appear in the status bar. You can return to the previous +pages to start a new installation or click "Next" +button to go to the readme page:
+Figure 12: "Finish installation" page +
+In this page you can read important information about the
+Installation Wizard itself and some tips: how to run and test SALOME or
+how to build SALOME from the sources. This is also described the
+README file which you can find in the root directory of the
+Installation Wizard.
+You can also launch SALOME Desktop from this
+page or read the Release Notes file by clicking on the corresponding
+buttons in the lower part of the page (see here
+and here for more
+information about
+customizing these buttons).
+
Figure 9: Batch mode
+During the process of installation the
+script creates some
+environment files to simplify the procedure of launching SALOME. These
+shell scripts set
+all necessary environment variables for all products you have
+installed.
+To learn how the installation scripts collect the environment, see here. These files are: salome.csh
++ salome.sh
+in the KERNEL module
+sources
+and KERNEL
+module binaries
+root directories and env_products.csh
++ env_products.sh and env_build.csh
++ env_build.sh
+in the
+target installation directory.
+
- |
-
-
- |
-
-
- of installation procedure |
-
-
- |
-
---|---|---|---|
gcc 3.2 | - -ver=`/usr/bin/gcc --version | grep 'gcc (GCC) .*' | cut -b 11-13` | - -
- |
-
-ver should be equal 3.2
- It is recommended to use native gcc on Linux RedHat 8.0 |
-
tcl 8.3 | - -existence of TCLHOME
- existence of tclsh8.3 - existence of wish8.3 - existence of libtcl8.3.so - existence of libtk8.3.so - existence of libtclx8.3.so - existence of libtkx8.3.so |
-
-set TCLHOME if you have preinstalled version of tcl.
- set LD_LIBRARY_PATH on a directory where libs can be found. |
-
-It is recommended to use native tcl on Linux RedHat 8.0 | -
Cascade 4.0 | - -existence of CASROOT environment variable | - -set CASROOT if you have preinstalled version of CASCADE | - -Unfortunately we can't say anything exactly about CASCADE 4.0 and we -only check CASROOT environment variable. If you have problem with preinstalled -version of CASCADE reinstall it | -
Python 2.2.1 | - -existence of PYTHONHOME
- isPython=`which python` - ver=`python -V` |
-
-set PYTHONHOME to root Python folder
- set PATH on a directory where python can be found |
-
-Python should exist and ver should be equal to 2.2.1
- It is recommended to use native Python on Linux RedHat 8.0 |
-
Mesa 3.4.2 | - -existence of libGL.so.1.2.030402 | - -set LD_LIBRARY_PATH on a directory where libGL.so.1.2.030402 can be -found | - -You have a possibility to build products (vtk & qt) with Mesa drivers -from the package supplied with this installation procedure or to use OpenGL -drivers installed on your computer locally. This check procedure concerns -only supplied Mesa driver. | -
Swig 1.3.17 | - -isSwig=`which swig`
- ver=`swig -version` - ver=`echo $ver | awk '{print $3}'` |
-
-set PATH on a directory where swig can be found | - -Swig should exist and ver should be equal to 1.3.17 | -
Qt 3.0.5 | - -existence of QTDIR
- existence of libqt-mt.so.3.0.5 |
-
-set QTDIR if you have preinstalled version of qt | - -We try to find libqt-mt.so.3.0.5 in ${QTDIR}/lib folder.
- You should set MESA_HOME only if you have preinstalled version of Mesa -3.4.2. - It is recommended to use native Qt on Linux RedHat 8.0 |
-
Qwt 0.4.1 | - -existence of QWTHOME
- existence of libqwt.so.0.4.1 |
-
-set QWTHOME if you have preinstalled version of qwt | - -We try to find libqwt.so.0.4.1 in the ${QWTHOME}/lib folder. | -
Hdf 5-1.4.4 | - -existence of HDF5HOME
- existence of libhdf5.so.0.0.0 - existence of libhdf5.settings |
-
-set HDF5HOME if you have preinstalled version of hdf | - -We try to find libhdf5.so.0.0.0 and libhdf5.settings in ${HDF5HOME}/lib
-folder.
- File libhdf5.settings should contain the following entry: - HDF5 Version: 1.4.4 |
-
Med 2.1.6 | - -existence of MED2HOME
- existence of libmed.so.0.0.0 |
-
-set MED2HOME if you have preinstalled version of med | - -Unfortunately we can't check version number.
- We try to find libmed.so.0.0.0 in ${MED2HOME}/lib folder. - If you have problem with preinstalled version of med reinstall it. |
-
Vtk 4.2 | - -existence of VTKHOME
- existence of libvtkCommon.so |
-
-set VTKHOME if you have preinstalled version of vtk | - -Unfortunately we can't check the version number.
- We try to find libvtkCommon.so in ${VTKHOME}/lib/vtk folder. - If you have problem with preinstalled version of vtk reinstall it. |
-
OmniORB 3.0.5,
- OmniORBpy 1.5, - OmniNotify 1.2 |
-
-existence of OMNIORBDIR
- existence of libomniORB3.so.0.5 - existence of _omnipymodule.so.0.5 - existence of libCOSNotify3.so.0.5 - existence of notifd - existence of THIS_IS_omniORB_3_0_5 - existence of THIS_IS_omniNotify_1_2 - existence of THIS_IS_OMNIORBPY_1_5 |
-
-set OMNIORBDIR if you have preinstalled version of omni | - -We try to find libomniORB3.so.0.5, _omnipymodule.so.0.5 and libCOSNotify3.so.0.5
-in ${OMNIORBDIR}/lib/i586_linux_2.0_glibc2.1 folder.
- We try to find notifd in ${OMNIORBDIR}/bin/i586_linux_2.0_glibc2.1 -folder. - Additional checking - omni add special files THIS_IS_... - We try to find THIS_IS_omniORB_3_0_5 in ${OMNIORBDIR} folder. - We try to find THIS_IS_omniNotify_1_2 in ${OMNIORBDIR}/src/services/omniNotify. - We try to find THIS_IS_OMNIORBPY_1_5 in ${OMNIORBDIR}/src/lib/omniORBpy -folder. |
-
Numeric 22.0 | - -existence of Numeric folder
- existence of _numpy.so |
-
-set PYTHONHOME if you have preinstalled version of python | - -Unfortunately we can't check the version number.
- We try to find Numeric folder in ${PYTHONHOME}/lib/python2.2/site-packages/Numeric -folder. - If you have problem with preinstalled version of numeric 22.0 reinstall -it. |
-
Sip 3.3.2 | - -existence of SIPDIR
- existence of sip - existence of libsip.so.9.1.0 |
-
-set SIPDIR to directory where you have sip preinstalled | - -We try to find sip and libsip.so.9.1.0 in $SIPDIR folder if you set
-SIPDIR , otherwise searching is done using $PATH and $LD_LIBRARY_PATH accordingly.
- It is recommended to use native Sip on Linux RedHat 8.0 |
-
PyQt 3.3.2 | - -existence of PYQTDIR
- existence of libqtxmlcmodule.so.1.0.0 |
-
-set PYQTDIR to directory where you have sip preinstalled | - -Unfortunately we can't check the version number.
- We try to find libqtxmlcmodule.so.1.0.0 in $PYQTDIR folder if you set -PYQTDIR, otherwise searching is done using $LD_LIBRARY_PATH . - If you have problem with preinstalled version of PyQt 3.3.2 reinstall -it. - It is recommended to use native PyQt on Linux RedHat 8.0 |
-
HappyDoc 2.1 | - -existence of happydoc
- ver=`happydoc | grep "HappyDoc version 2.1"` |
-
-set PYTHONHOME if you have preinstalled version of python | - -We try to find happydoc in $PYTHONHOME/bin folder.
- ver should not be empty. - This product is not obligatory. It was added only for your comfort. |
-
Doxygen 1.3-rc2 | - -existence of doxygen
- existence of doxysearch - existence of doxytag - existence of doxywizard |
-
-set QTDIR if you have preinstalled version of qt
- set PATH on a directory where doxygen, doxysearch, doxytag and doxywizard -can be found |
-
-Unfortunately we can't check the version number.
- It's necessary to have compiled Qt in order to build doxywizard. - If you have problem with preinstalled version of doxygen 1.3-rc2 reinstall -it. - This product is not obligatory. It was added only for your comfort. |
-
Graphviz 1.9 | - -existence of dot | - -add GraphViz's bin directory to the PATH environment variable | - -Unfortunately we can't check the version number.
- We try to find dot program in the $PATH |
-
SALOME PRO binaries | - -existence of SALOME_ROOT_DIR
- existence of VERSION file - ver=`cat $SALOME_ROOT_DIR/bin/VERSION | awk -F: '{print $2}' | tr -d -'[:space:]'` |
-
-set SALOME_ROOT_DIR if you have preinstalled binaries of SALOME PRO -version 1.2d | - -SALOME PRO binaries should exist and ver should be equal to 1.2d | -
SALOME PRO sources | - -existence of SALOMEPRO_SRC
- existence of VERSION file - ver=`cat $SALOMEPRO_SRC/bin/VERSION | awk -F: '{print $2}' | tr -d -'[:space:]'` |
-
-set SALOMEPRO_SRC if you have preinstalled sources of SALOME PRO version -1.2d | - -SALOME PRO sources should exist and ver should be equal to 1.2d | -
Note: For native products installation procedure sets proper environment
-variables itself, and you do not need to set such variables like, e.g.
-TCLHOME
-or PYTHONHOME.
-
If you have native products installed to different from default directories
-(not /usr/bin, /usr/lib...), it is recommended to follow
-above description. Or you should set properly $PATH and $LD_LIBRARY_PATH
-variables before starting Installation
-Wizard. Otherwise installation script will fail to find preinstalled products.
-
After installing each product shell script creates in the product root -folder special environment file. The name of the file is generated from -the name of product by the following scheme: env_<product_name>.sh. -This file includes all necessary product settings. For example for Vtk -the file is env_Vtk.sh. Environment files allows to pick up all -environment settings which are necessary to build and launch SALOME. When -installing SALOME sources and/or binaries, installation procedure picks -up all the settings files and generate two scripts: salome.sh and -salome.csh -for -sh and csh correspondingly. Such approach helps to save time when reinstalling -products and you may not to care about setting all environment variables -manually to build/launch SALOME. What you need is just to use one of these -scripts. -
This concerns also those products which are not currently installed.
-For example, you install some SALOME binaries to the directory where you
-have previously installed other products. Installation procedure
-still tries to collect environment files from the target directory if it
-find necessary products there. If some product is not found in the target
-directory the corresponding section of salome.sh/salome.csh files
-will be skipped.
-
For native products (gcc, tcl, python, qt, sip, pyqt for
-RedHat-8.0) instal script tries to find them using $PATH
-/ $LD_LIBRARY_PATH variables and then in the system default directories
-(/usr/bin, /usr/lib etc., depending on the product).
-
In any case you may edit salome.* files after installation procedure -finishes, as you want. -
+
After the installation of each product the shell script +creates a special +environment file for the product in its installation folder. The name +of the file is generated from the name of the product by the following +scheme: env_<product_name>.sh +(for example env_Vtk.sh for the Vtk). +This file includes all necessary environment settings. At the final +step of the installation the script picks up all settings files and +generates from them two common environment files: salome.sh +and salome.csh +for bash +and csh +shells correspondingly. This +approach helps to save time when reinstalling products and you may can +avoid setting all environment variables +manually to build/launch SALOME. What you need is to source one of +these environment files.
+This also concerns the products which are not being installed.
+For example, you install some SALOME binaries to the directory where
+you have previously installed other products. The
+installation
+procedure tries to collect the environment files from the target
+directory if it finds necessary products installed there. If a
+product is not found in the target directory the corresponding
+section of salome.sh/salome.csh files will be
+commented.
+For the native products (like gcc, tcl, etc...)
+the installation procedure tries to find them first using PATH
+/ LD_LIBRARY_PATH variables and then in the system
+default
+directories (/usr/bin, /usr/lib etc., depending on
+the product).
+
In any case you are able to edit salome.*
+files after the installation procedure finished.
+
+Note: as it has been mentioned above
+there
+are other environment files generated by the installation procedure: env_products.csh + env_products.sh and env_build.csh + env_build.sh. These
+files can be
+found in the target installation root directory.
+
<document>
-
[<config
-[version=<install_wizard_version>]
-
-[caption=<install_wizard_caption>]
-
-[copyright=<install_wizard_copyright>]
-
-[license=<install_wizard_license_info>]
-
-[os=<target_paltform>]/>]
-
[<path
-[targetdir=<target_directory>]
-
-[tempdir=<temp_directory>]/>]
-
[<product
-name=<product_name>
-
-version=<product_version>
-
-install=<installation_mode>
-
-supported=<supported_installation_modes>
-
-disable=<disable_flag>
-
-dependancies=<list_of_prerequisites>
-
-installdiskspace=<install_disk_space>
-
-temporarydiskspace=<tmp_disk_space>
-
-script=<installation_script_name>/>]
-
[<product
-... />]
-
...
-
</document>
-
<document>
+
+
+
+<config
+[ version=<application_version>
+ ]
+
+
+ [
+caption=<application_caption>
+ ]
+
+
+ [
+copyright=<application_copyright> ]
+
+
+
+ [
+license=<application_license_info> ]
+
+
+
+platforms=<target_platform>
+
+
+ [
+targetdir=<target_directory>
+ ]
+
+
+
+
+[
+tempdir=<temp_directory>
+ ]
+
+ [
+optionallibs=<optional_libraries> ]
+
+ />
+
+
+[ <buttons>
+
+
+[ <button
+
+label=<button_label>
+
+
+
+[ tooltip=<button_tooltip> ]
+
+
+
+script=<button_script>
+
+
+
+[ disable=<disable_flag> ]
+ />
+
+ ]
+
+[
+<button
+...
+ />
+
+
+]
+
+...
+
+ </buttons>
+
+ ]
+ [ <products>
+
+
+[
+<product
+name=<product_name>
+
+
+
+type=<product_type>
+
+ [
+description=<product_description> ]
+
+
+<installation
+os=<installation_platform>
+
+
+
+
+version=<product_version>
+
+
+
+ [
+disable=<disable_flag>
+ ]
+
+
+
+ [
+woguimode=<without_gui_mode_flag> ]
+
+
+
+installdiskspace=<install_disk_space>
+
+
+ [
+pickupenv=<pickup_env_flag>
+ ]
+
+
+
+
+
+script=<installation_script_name>
+
+/>
+
+...
+
+ />
+
+ ]
+ [ <product ...
+ />
+ ]
+
+...
+ </products>
+
+ ]
+ [ <dependencies>
+
+
+[
+<product
+name=<product_name> >
+
+[
+<dep> <prerequisite_name>
+ </dep>
+]
+
+...
+ </product>
+
+
+]
+
+...
+ </dependencies>
+
+ ]
+
+</document>
+The application main window caption +- if this +string contains '%1' text the title will contain +the version number in this place (see above). +
+
where
-
<product_script_name> - installation
-script name (described in configuration xml file);
-
<function_name> - the name of function,
-corresponding to the selected installation mode: try_native, install_source,
-install_binary or try_preinstalled;
-
<temp_folder> - temporary files directory;
-
<products_directory> - directory where
-the sources/binaries package can be found. You should provide sources package
-in the <Install_Wizard_root_directory>/Products/SOURCES directory
-and binaries package in the <InstallWizard_root_directory>/Products/BINARIES/<os_version>,
-where <os_version> is target platform description, which appears in
-the corresponding section of the configuration xml
-file.
-
<target_directory> - root target directory
-where product should be installed to;
-
<dependancies> - single-quoted list
-of prerequisite products, separated by space;
-
<product_name> - product name itself.
-
Example:
-
med-2.1.6.sh install_binary /tmp/work ./Products/BINARIES/RedHat8.0
-/usr/salome 'gcc Hdf' med
-
Copy created script into the <Install_Wizard_root_directory>/config_files -sub-directory. File common.sh contains some service functions which -can be used in your installation script. -
-
where
+
<product_script_name>
+-
+the name of the installation script (described in the configuration XML
+file);
+<function_name>
+- the name of
+the function, corresponding to the selected installation type and
+currently installed product;
+
+<temp_folder> - the directory for the
+temporary files;
+<products_directory>
+- the directory
+where the sources/binaries package can be found. You should provide
+sources package in the <Install_Wizard_root_directory>/Products/SOURCES
+directory and binaries package in the <InstallWizard_root_directory>/Products/BINARIES/<os_version>,
+where <os_version> is the target platform description,
+which appears
+in the corresponding section of the configuration
+xml
+file.
+
+<target_directory> - the root target
+directory where the product should be installed to;
+
+<all_products> - single-quoted list
+of all products, separated by space;
+
+<product_name> - product name
+itself;
+
+<install_products> - single-quoted list
+of all products to be installed, separated by space;
+
+<sources_directory> - the directory
+where the sources package can be found (it is usable if the
+<products_directory> parameter gives the binaries
+directory path);
+
+<remove_sources_flag> - bool parameter, that
+is equal to 'TRUE' if 'Remove sources and temporary files after
+compilation' option has been selected by the user (see Fig.2 in the GUI part);
+
+<binaries_directory> - the directory
+where the binaries package can be found (it is usable if the
+<products_directory> parameter gives the sources
+directory path);
+
+<single_directory_flag> - bool parameter,
+that is equal to 'TRUE' if 'Install modules to a single directory'
+option is selected by the user (see Fig.5
+above).
+
Example:
+med.sh install_binary
+/tmp/INSTALLWORK21797
+./Products/BINARIES/Mandriva2010.0
+'gcc tcltk tcltk_src Python Python_src Qt Qt_src ... DOCUMENTATION
+DOCUMENTATION_src'
+Med
+'gcc Hdf Med'
+./Products/SOURCES
+FALSE
+./Products/BINARIES/Mandriva2010.0
+
Copy the created script +into +the <Install_Wizard_root_directory>/config_files +sub-directory where all installation scripts are stored. The Installation +Wizard will automatically search and call your script during the +installation +procedure. +
+where
+
<product_script_name>
+-
+the script name itself (retrieved from the XML configuration xml
+file);
+<function_name>
+- the name of the function;
+<target_directory>
+- the root target
+directory where the product is
+installed to;
+<temp_folder>
+ - the directory for the temporary files.
+
+Note: The standard Installation Wizard buttons
+"Launch
+SALOME" and "Release Notes" are implemented with this
+feature. Refer to the scripts start_salome.sh and
+release_notes.sh for the sample implementation.
+
+Note: Any button (even standard) can be ignored by
+the
+Installation Wizard if the attribute <disable>
+in the XML
+configuration file is set to the "true" value.
+