README.txt

   1 === === ===   (new way) UNIX / LINUX users === === ===
   2
   3
   4 1) Make sure everything you'll need is properly installed :
   5 crea_Developers_tools, crea_ThirdParty_Libraries
   6 have a look at :
   7 http://www.creatis.insa-lyon.fr/site/fr/CreatoolsDownload
   8 and/or :
   9 cd Install_ThirdParty
  10 follow the Readme.txt
  11
  12 2) make sure VTK_DIR environment variable is set properly :
  13 echo $VTK_DIR
  14 Set it, if not OK:
  15 export VTK_DIR=/usr/local/lib/vtk-5.4, for instance
  16
  17 3) make sure LATEX_COMPILER environment variable is set properly :
  18 echo $LATEX_COMPILER
  19 Set it, if not OK:
  20 export LATEX_COMPILER=/usr/bin/latex, for instance
  21
  22 4) Make sure you got the last version of creaToolsTools.
  23 cvs update -dP creaToolsTools
  24
  25 a) cd Install
  26
  27 b) cp configure.sh_TEMPLATE  configure.sh
  28
  29 c) modify (only once) the file configure.sh, according to your preferences:
  30 vim configure.sh
  31 as follows :
  32 -- configure.sh ---------------------
  33 generationdir=<name of the Generation Directory>
  34 docGeneration=<Boolean For Doc Generation> : ON / OFF
  35 cvsUserName=<user Name For CVS>
  36 installPrefix=<installPrefix> : /usr/local or $generationdir/creatools_install
  37 buildType=<buildType> : Release / Debug
  38 gdcmVersion=<GDCM Version> : GDCM1 / GDCM2
  39 sourcesFrom=<where do you want to get them from> : CVS / HTML
  40 --------------------------------------
  41
  42
  43 d) if you choosed  'sourcesFrom=CVS' :
  44 ssh-add
  45 <type your cvs password>
  46
  47 e) sh scripts/make.sh
  48
  49 f) make sure everything is OK
  50
  51 g) switch as root
  52
  53 h) sh scripts/make-install.sh
  54
  55
  56
  57
  58
  59
  60 === === ===  (old way) UNIX / LINUX users === === ===
  61
  62 0)  Make sure you are a 'sudoer'.
  63 have a look at :
  64 --sudo configuration--
  65 https://fedoraproject.org/wiki/Configuring_Sudo
  66
  67 1) ssh-add
  68 <type your cvs password>
  69
  70 2) Make sure you got the last version of creaToolsTools.
  71 cvs update -dP creaToolsTools
  72
  73 3) Make sure everything you'll need is properly installed :
  74 crea_Developers_tools, crea_ThirdParty_Libraries
  75 have a look at :
  76 http://www.creatis.insa-lyon.fr/site/fr/CreatoolsDownload
  77 and/or :
  78 cd Install_ThirdParty
  79 follow the Readme.txt
  80
  81 4) make sure VTK_DIR environment variable is set properly :
  82 echo $VTK_DIR
  83 Set it, if not OK:
  84 export VTK_DIR=/usr/local/lib/vtk-5.4, for instance
  85
  86 5) make sure LATEX_COMPILER environment variable is set properly :
  87 echo $LATEX_COMPILER
  88 Set it, if not OK:
  89 export LATEX_COMPILER=/usr/bin/latex, for instance
  90
  91 6)cd Install
  92 cp creatools.sh_TEMPLATE creatools.sh
  93
  94 7) modify the file creatools.sh, according to your preferences, modify (only once) creatools.sh
  95 vim creatools.sh
  96 as follows :
  97 -- creatools.sh ---------------------
  98 creatoolsGeneration=<directory you want to generate in>
  99 installPrefix=<your Install dir> or </usr/local>
 100 cvsUser=<USER>
 101 docGeneration=<OFF|ON> let it to OFF!
 102 buildType=<Release|Debug>
 103 cd scripts
 104 sh All.sh $creatoolsGeneration $docGeneration $cvsUser $installPrefix $buildType
 105 cd ..
 106 -----------------------
 107
 108 7) Run the whole stuff :
 109 sh creatools.sh
 110
 111 8) if you performed a 'local install' (i.e : you *didn't* use installPrefix=/usr/local)
 112 edit your .bash_profile
 113 PATH=$PATH:<fullPathnameOfYourInstallPrefix>/creatools_install/bin
 114 export PATH
 115 LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<fullPathnameOfYourInstallPrefix>/creatools_install/lib
 116 export LD_LIBRARY_PATH
 117
 118
 119
 120 === === === WINDOWS users === === ===
 121
 122
 123
 124 0) Make sure everything you'll need is properly installed :
 125 crea_Developers_tools, crea_ThirdParty_dlls, and VisualStudioExpress2008
 126 Have a look at :
 127 http://www.creatis.insa-lyon.fr/site/fr/CreatoolsDownload
 128
 129 Change your CVS user in the file All.bat
 130
 131 Copy all the .bat files into one directoy where the tests are going to be run
 132 execute All.bat
 133
 134 Not forget to run your ssh key with puttyAgent
 135
 136 All the creatools projects are downloaded from the CVS, compiled and the CTest for the dashboard is run.
 137
 138
 139
 140
 141
 142
 143
 144
 145
 146
 147
 148 Forget the following lines !
 149
 150 Tools to manage the creaTools suite (build, test, submit to dashboard, package, ...)
 151 ====================================================================================
 152
 153 * ctest:
 154 ctest scripts and instructions to perform automated build/testing and submission to creatis cdash dashboard
 155 * windows:
 156 windows installers of the suite and instructions to package the suite for windows. subdirs:
 157   * creaThirdParty_dlls:
 158     project which creates the creaThirdParty_dlls win installer (using cmake and NSIS)
 159   * CreaTools_win32_installers:
 160     batch installers of the suite
 161