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 git clone https://github.com/eclipse/titan.core  titan
  15
  16 3. Configure the build
  17
  18 cd titan
  19 check  that MakefileFOSS.cfg is present   and  has the following content:
  20 cat MakefileFOSS.cfg
  21
  22 # Configurations for the Free Open Source Software version
  23 LICENSING := no
  24 USAGE_STATS := no
  25
  26
  27 Several build options are possible; for details on options , please read through the Makefile.cfg.
  28 Options can be overridden by the content of  a file named Makefile.personal which can be used to
  29 adapt to local installation directories, change config options etc.
  30 Below, a small number of typical scenarios are presented.
  31
  32 1) JNI  disabled
  33
  34 The JNI interface is used by the Eclipse Titan Executor or by the Java Executor API.
  35 If you don't need them , Titan can be compiled without JNI.
  36
  37 Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content:
  38 (replace paths with values relevant to your installation)
  39
  40 TTCN3_DIR := /home/<user id>/titan/Install
  41 OPENSSL_DIR := /usr
  42 #JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64
  43 XMLDIR := /usr
  44 JNI := no
  45 GEN_PDF := no
  46
  47
  48
  49
  50 2) JNI  enabled
  51
  52 install JDK   into /home/<user id>/jdk
  53
  54 Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content:
  55 (replace paths with values relevant to your installation)
  56
  57 TTCN3_DIR := /home/<user id>/titan/Install
  58 OPENSSL_DIR := /usr
  59 JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64
  60 XMLDIR := /usr
  61 JNI := yes
  62 GEN_PDF := no
  63
  64
  65
  66 3. Run make
  67
  68 make
  69
  70 4. Run make install
  71
  72 make install
  73
  74 This will install Titan into  /home/<user id>/titan/Install
  75
  76 5. Optionally , run function/regression tests
  77
  78 set environment variable TTCN3_DIR to /home/<user id>/titan/Install
  79
  80 (setenv  TTCN3_DIR /home/<user id>/titan/Install  for csh,
  81 export TTCN3_DIR=/home/<user id>/titan/Install for bash )
  82
  83
  84
  85 cd /home/<user id>/titan/function_test
  86
  87 in the following Makefiles
  88
  89 XER_EncDec/Makefile
  90 Text_EncDec/Makefile
  91 RAW_EncDec/Makefile
  92
  93 edit the value of XMLDIR to match your installation values
  94
  95 run the tests
  96
  97 make
  98
  99 ( or make |& tee outputfile if you want to save the output for verification)
 100
 101 cd /home/<user id>/titan/regression_test
 102 make run
 103
 104 ( or make run |& tee outputfile if you want to save the output for verification)
 105
 106 These tests might run for half an hour (regr.tests)  to two hours (func.tests)
 107
 108 6. Optionally , copy Titan into its' final directory.
 109 From here on, you can continue with the Titan installation guide, see /Install/docs, to set environment variables etc.
 110
 111
 112
 113