README.linux

   1 ******************************************************************************
   2 * Copyright (c) 2000-2016 Ericsson Telecom AB
   3 * All rights reserved. This program and the accompanying materials
   4 * are made available under the terms of the Eclipse Public License v1.0
   5 * which accompanies this distribution, and is available at
   6 * http://www.eclipse.org/legal/epl-v10.html
   7 *  Contributors:
   8 *   Balasko, Jeno
   9 *   Baranyi, Botond
  10 *   Lelik, Elemer
  11 *   Pilisi, Gergely
  12 *   Szabados, Kristof
  13 ******************************************************************************
  14
  15 Build and install Titan on Linux
  16
  17 1.Install required libraries:
  18 (examples are given for Ubuntu 12.04/14.04; for other Linuxes, pls. use the relevant library installation method)
  19
  20 sudo apt-get install g++ expect libssl-dev libxml2-dev libncurses5-dev flex bison
  21 xutils-dev is needed by makedepend:
  22 sudo apt-get install xutils-dev
  23 The following packages may be needed for titan_eclipse/automatic_build:
  24 sudo apt-get install ant xsltproc
  25
  26 2.Clone the titan directory from git  into /home/<user_id>/titan.core
  27
  28 git clone https://github.com/eclipse/titan.core  titan.core
  29
  30 3. Configure the build
  31
  32 cd titan.core
  33 check that MakefileFOSS.cfg is present and has the following content:
  34 cat MakefileFOSS.cfg
  35
  36 # Configurations for the Free Open Source Software version
  37 LICENSING := no
  38 USAGE_STATS := no
  39
  40
  41 Several build options are possible; for details on options please read through the Makefile.cfg.
  42 Options can be overridden by the content of  a file named Makefile.personal which can be used to
  43 adapt to local installation directories, change config options etc.
  44 Below, a small number of typical scenarios are presented.
  45
  46 a) JNI  disabled
  47
  48 The JNI interface is used by the Eclipse Titan Executor or by the Java Executor API.
  49 If you don't need them , Titan can be compiled without JNI.
  50
  51 Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content:
  52 (replace paths with values relevant to your installation)
  53
  54 TTCN3_DIR := /home/<user id>/titan.core/Install
  55 OPENSSL_DIR := /usr
  56 #JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64
  57 XMLDIR := /usr
  58 JNI := no
  59 GEN_PDF := no
  60
  61
  62
  63
  64 b) JNI  enabled
  65
  66 install JDK   into /home/<user id>/jdk
  67
  68 Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content:
  69 (replace paths with values relevant to your installation)
  70
  71 TTCN3_DIR := /home/<user id>/titan.core/Install
  72 OPENSSL_DIR := /usr
  73 JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64
  74 XMLDIR := /usr
  75 JNI := yes
  76 GEN_PDF := no
  77
  78
  79
  80 4. Run make
  81
  82 make
  83
  84 5. Set environment variables
  85
  86 setenv TTCN3_DIR /home/<user id>/titan.core/Install
  87 setenv PATH /home/<userid>/titan.core/Install/bin/:${PATH}
  88 setenv LD_LIBRARY_PATH /home/<userid>/titan.core/Install/lib:${LD_LIBRARY_PATH}
  89
  90 for csh
  91
  92 or
  93
  94 export TTCN3_DIR=/home/<user id>/titan.core/Install
  95 export PATH=/home/<userid>/titan.core/Install/bin/:${PATH}
  96 export LD_LIBRARY_PATH=/home/<userid>/titan.core/Install/lib:${LD_LIBRARY_PATH}
  97
  98 for bash
  99
 100 6. Run make install
 101
 102 make install
 103
 104 This will install Titan into  /home/<user id>/titan.core/Install
 105
 106
 107 7. Optionally , run function/regression tests
 108
 109 cd /home/<user id>/titan.core/function_test
 110
 111 in the following Makefiles
 112
 113 BER_EncDec/Makefile
 114 XER_EncDec/Makefile
 115 Text_EncDec/Makefile
 116 RAW_EncDec/Makefile
 117
 118 edit the value of XMLDIR to match your installation values
 119
 120 run the tests
 121
 122 make
 123
 124 ( or make |& tee outputfile if you want to save the output for verification)
 125
 126 cd /home/<user id>/titan.core/regression_test
 127 make run
 128
 129 ( or make run |& tee outputfile if you want to save the output for verification)
 130
 131 These tests might run for half an hour (regr.tests)  to two hours (func.tests)
 132
 133 8. Optionally, copy Titan into its final directory.
 134 From here on, you can continue with the Titan installation guide, see /Install/docs, to set/change environment variables etc.
 135
 136 nagylenard
 137 elnrnag
 138 elnrnag2