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
13 ******************************************************************************
15 Build and install Titan on Linux
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)
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
26 2.Clone the titan directory from git into /home/<user_id>/titan.core
28 git clone https://github.com/eclipse/titan.core titan.core
30 3. Configure the build
34 For open source users: check that MakefileFOSS.cfg is present and has the following content:
37 # Configurations for the Free Open Source Software version
41 If you want to use your build within teh Ericsson domain: delete MakefileFOSS.cfg
42 This will enable licensing.
44 Several build options are possible; for details on options please read through the Makefile.cfg.
45 Options can be overridden by the content of a file named Makefile.personal which can be used to
46 adapt to local installation directories, change config options etc.
47 Below, a small number of typical scenarios are presented.
49 a) JNI disabled, gcc compiler (default)
51 The JNI interface is used by the Eclipse Titan Executor or by the Java Executor API.
52 If you don't need them , Titan can be compiled without JNI.
54 Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content:
55 (replace paths with values relevant to your installation)
57 TTCN3_DIR := /home/<user id>/titan.core/Install
59 #JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64
64 b) JNI disabled, clang compiler ver. 3.8
66 Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content:
67 (replace paths with values relevant to your installation).
69 TTCN3_DIR := /home/<user id>/titan.core/Install
71 #JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64
79 c) JNI enabled, gcc compiler (default)
81 install JDK into /home/<user id>/jdk
83 Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content:
84 (replace paths with values relevant to your installation).
86 TTCN3_DIR := /home/<user id>/titan.core/Install
88 JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64
99 5. Set environment variables
101 setenv TTCN3_DIR /home/<user id>/titan.core/Install
102 setenv PATH /home/<userid>/titan.core/Install/bin/:${PATH}
103 setenv LD_LIBRARY_PATH /home/<userid>/titan.core/Install/lib:${LD_LIBRARY_PATH}
109 export TTCN3_DIR=/home/<user id>/titan.core/Install
110 export PATH=/home/<userid>/titan.core/Install/bin/:${PATH}
111 export LD_LIBRARY_PATH=/home/<userid>/titan.core/Install/lib:${LD_LIBRARY_PATH}
119 This will install Titan into /home/<user id>/titan.core/Install
122 7. Optionally , run function/regression tests
124 cd /home/<user id>/titan.core/function_test
126 in the following Makefiles
133 edit the value of XMLDIR to match your installation values
139 ( or make |& tee outputfile if you want to save the output for verification)
141 cd /home/<user id>/titan.core/regression_test
144 ( or make run |& tee outputfile if you want to save the output for verification)
146 These tests might run for half an hour (regr.tests) to two hours (func.tests)
148 8. Optionally, copy Titan into its final directory.
149 From here on, you can continue with the Titan installation guide, see /Install/docs, to set/change environment variables etc.