README.linux

   1 Build and install Titan on Linux
   2
   3 1.Install required libraries:
   4 (examples are given for Ubuntu 12.04/14.04; for other Linuxes, pls. use the relevant library installation method)
   5
   6 sudo apt-get install g++ expect libssl-dev libxml2-dev libncurses5-dev flex bison
   7 xutils-dev is needed by makedepend:
   8 sudo apt-get install xutils-dev
   9 The following packages may be needed for titan_eclipse/automatic_build:
  10 sudo apt-get install ant xsltproc
  11
  12 2.Clone the titan directory from git  into /home/<user_id>/titan
  13
  14 3. Configure the build
  15 cd titan
  16 check  that MakefileFOSS.cfg is present   and  has the following content:
  17 cat MakefileFOSS.cfg
  18
  19 # Configurations for the Free Open Source Software version
  20 LICENSING := no
  21 USAGE_STATS := no
  22
  23
  24 Several build options are possible; for details on options , please read through the Makefile.cfg.
  25 Options can be overridden by the content of  a file named Makefile.personal.
  26 Below, a small number of typical scenarios are presented.
  27
  28 1) JNI  disabled
  29
  30 The JNI interface is used by the Eclipse Titan Executor or by the Java Executor API.
  31 If you don't need them , Titan can be compiled without JNI. ( In this case, you won't be able to execute Titan test cases from the Eclipse plug-in)
  32
  33 Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content:
  34
  35 TTCN3_DIR := /home/<user id>/titan/Install
  36 JNI := no
  37 GEN_PDF := yes
  38
  39
  40
  41
  42 2) JNI  enabled
  43
  44 install JDK   into /home/<user id>/jdk
  45
  46 Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content:
  47
  48 TTCN3_DIR := /home/<user id>/titan/Install
  49 JDKDIR := /home/<user id>/jdk
  50 JNI := yes
  51 GEN_PDF := yes
  52
  53
  54
  55 3. Run make
  56
  57 make
  58
  59 4. Run make install
  60
  61 make install
  62
  63 This will install Titan into  /home/<user id>/titan/Install
  64
  65 5. Optionally , run function/regression tests
  66
  67 set environment variable TTCN3_DIR to /home/<user id>/titan/Install
  68
  69 (setenv  TTCN3_DIR /home/<user id>/titan/Install  for csh,
  70 export TTCN3_DIR=/home/<user id>/titan/Install for bash )
  71
  72
  73
  74 cd /home/<user id>/titan/function_test
  75 make
  76
  77 ( or make |& tee outputfile if you want to save the output for verification)
  78 cd /home/<user id>/titan/regression_test
  79 make run
  80 ( or make run |& tee outputfile if you want to save the output for verification)
  81
  82 These tests might run for half an hour (regr.tests)  to two hours (func.tests)
  83
  84 6. Optionally , copy Titan into its' final directory.
  85 From here on, you can continue with the Titan installation guide, see /Install/docs, to set environment variables etc.
  86
  87
  88
  89