]> Creatis software - creaToolsTools.git/blobdiff - Linux/README.txt
#2493 creaToolsTools Feature New Normal - Prepare and Install binary CreaTools...
[creaToolsTools.git] / Linux / README.txt
index 194f2f966680979b5e3396ae387900129a306b9d..f89ed0ccd4bd9a47a67d86956a14f2f63cb5ef8b 100644 (file)
-1) switch as root
+# ---------------------------------------------------------------------
+#
+# Copyright (c) CREATIS (Centre de Recherche en Acquisition et Traitement de l'Image 
+#                        pour la Santé)
+# Authors : Eduardo Davila, Frederic Cervenansky, Claire Mouton
+#
+#  This software is governed by the CeCILL-B license under French law and 
+#  abiding by the rules of distribution of free software. You can  use, 
+#  modify and/ or redistribute the software under the terms of the CeCILL-B 
+#  license as circulated by CEA, CNRS and INRIA at the following URL 
+#  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html 
+#  or in the file LICENSE.txt.
+#
+#  As a counterpart to the access to the source code and  rights to copy,
+#  modify and redistribute granted by the license, users are provided only
+#  with a limited warranty  and the software's author,  the holder of the
+#  economic rights,  and the successive licensors  have only  limited
+#  liability. 
+#
+#  The fact that you are presently reading this means that you have had
+#  knowledge of the CeCILL-B license and that you accept its terms.
+# ------------------------------------------------------------------------  
 
-2) sh menu.sh
+
+
+#######################################
+To install the CreaTools under Linux, use installscript.
+menu.sh is deprecated. This script should not be used. (It will disappear in a near future.)
+
+
+===================================
+Documentation for installscript
+===================================
+
+Launch 'installscript' in command line to see the list of options.
+
+===== How to Install =======
+0) Not forget:
+   A. Install your ssh key: https://www.creatis.insa-lyon.fr/mywiki/SSH
+       Note: -Put your key in .ssh directory.
+             -Change de right of your 
+                  chmod ugo-rwx  id_dsa 
+                  chmod u+rwx id_dsa 
+   B. Send an email to the web master Fabrice Bellet <fabrice.bellet@creatis.insa-lyon.fr> 
+      to be include in the DataBase-GIT of Creatools.
+
+1)
+./installscript config
+
+2)
+./installscript 3rd
+
+3)
+./installscript creatools
+
+
+
+
+
+==========================================
+==========================================
+==========================================
+
+
+Exemples of differents configurations :
+
+
+===== How to Install - HTML VERSION =======
+1)
+./installscript -os Fedora -ncore 8 -gdir  $HOME/Creatis/creaTools -instprefix  $HOME/Creatis/creaTools/creatools_install -instprefix3  $HOME/Creatis/creaTools/thirdparty_install -html -build Release config
+
+2) As root
+./installscript 3rd
+
+3) 
+./installscript creatools
+
+
+===== How to Install - GIT VERSION =======
+0) Not forget:
+   A. Install your ssh key: https://www.creatis.insa-lyon.fr/mywiki/SSH
+       Note: -Put your key in .ssh directory.
+             -Change de right of your 
+                  chmod ugo-rwx  id_dsa 
+                  chmod u+rwx id_dsa 
+   B. Send an email to the web master Fabrice Bellet <fabrice.bellet@creatis.insa-lyon.fr> 
+      to be include in the DataBase-GIT of Creatools.
+
+                          
+1)
+./installscript -os Fedora -ncore 8 -gdir  $HOME/Creatis/creaTools -instprefix  $HOME/Creatis/creaTools/creatools_install -instprefix3  $HOME/Creatis/creaTools/thirdparty_install -git -build Release config
+
+2) As root
+./installscript 3rd
+
+3) 
+./installscript creatools
+
+
+
+
+
+
+====================================
+
+-- Some examples:
+
+
+====
+
+# to configure only
+./installscript -gdir $HOME/Creatis/All/creainstall config
+or
+./installscript -git -ncore 4 -gdir $HOME/Creatis/All/creainstall config
+
+
+# to configure / compile-install all packages and the creatools themselves 
+./installscript -git -ncore 4 -gdir $HOME/work/creatools/creainstall all
+
+# compile-install only one part (vtk  for example) ONCE CONFIG HAS BEEN RUN 
+./installscript 3rd-vtk
+
+
+-- If you choose Git: 
+You must have shared your public key on Git CREATIS server.
+To do so, send your public SSH key to Fabrice Bellet specifying the Git repository name. You need to do it for the Git server, even if you already did it for the CVS or SVN server. 
+
+
+
+===================================
+Documentation for menu.sh
+===================================
+WARNING :
+Use always bash (never use sh!)
+
+A) bash menu.sh
 
 You will be prompted to say what you want to do :
 
-" Configure :                     0"
-" Install Third Party Libraries : 1"
-" Compile   the CreaTools :       2"
-" Install   the CreaTools :       3"
-" Uninstall the CreaTools :       4"
+ Configure :........................0 
+ Install Third Party Libraries :....1 (as root)
+ Get and Install the 'CreaTools':...2
+ or
+ Get the 'CreaTools' source files :.2.1 (GIT : as user!)
+ Compile   the CreaTools :..........2.2
+ Install   the CreaTools :..........2.3
+ Use compact menu :.................5
+ or
+ Use expanded menu :................5
+ Uninstall the CreaTools :..........6 
+ Help ..............................7 Help about this menu
+
+ Show some Environment Variables ...8
+ Exit :.............................9
+
+
+B) As a user, choose 'Configure' (0)
+
+You will be prompted to give your preferences :
 
-3) Choose 'Configure' (0)
+"Operating System : Fedora/Ubuntu/MacOS"
+"Number of Cores"
+"Name of the Generation Directory"
+"Boolean for Doc Generation : YES/NO"
+"Where do you want to get source files from : GIT/HTML"
 
-You will be prompted to give yiur preferences :
+-> if you chose GIT: 
+1/ you must have shared your public key on CREATIS server
 
-"Operating System : Fedora/Ubuntu/MacOS (mandatory!)"
-"Name of the Generation Directory (default is /tmp/myGenerationDir)"
-"Boolean For Doc Generation : YES/NO (default is NO)"
-"Where do you want to get source files from : CVS/HTML (default is HTML)"
--> if you choosed CVS 
-"CVS User Name (mandatory!)"
-"LINUX/MacOS User Name (mandatory!)"
-"Build type : Release/Debug (default is Release)"
-"Gdcm version : GDCM1/GDCM2 (default is GDCM1)"
+"GIT User name"
+"Login 'User' name"
+"Login 'Group' name"
+"Build type : Release/Debug"
+"Gdcm version : GDCM1/GDCM2"
+"ITK version : ITK3/ITK4"
 
-4) If 'Third Party Libraries' are not yet installed,
-choose 'Install Third Party Libraries' (1)
+Note : Currently, only GDCM1 and ITK 3 are supported.
 
-5) Close the window and open a new one.
-   switch as root again
-   sh menu.sh
-   
-6) Choose 'Compile the CreaTools' (2)
+C)  - Exit the menu (9).
+    - Switch as root and run 'bash menu.sh'.
+    - Choose 'Install Third Party Libraries' (1).
+    - Close the terminal window.
 
-7) Choose 'Install the CreaTools' (3)
+D) - Open a new terminal window.
+   - Switch as a user.
+   - Launch 'bash menu.sh'. 
+   - Choose 'Get and Install the CreaTools source files' (2).
+   - Close the terminal window.
 
-8) Close the window and open a new one.
-   You can work, now.
+E) Open a new terminal window.
+   You can work, by launching creaTools.sh!