Commit | Line | Data |
---|---|---|
af710487 | 1 | ****************************************************************************** |
d44e3c4f | 2 | * Copyright (c) 2000-2016 Ericsson Telecom AB |
af710487 | 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 | |
d44e3c4f | 7 | * Contributors: |
8 | * Balasko, Jeno | |
9 | * Baranyi, Botond | |
10 | * Lelik, Elemer | |
11 | * Pilisi, Gergely | |
12 | * Szabados, Kristof | |
af710487 | 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 | ||
3abe9331 | 26 | 2.Clone the titan directory from git into /home/<user_id>/titan.core |
af710487 | 27 | |
3abe9331 | 28 | git clone https://github.com/eclipse/titan.core titan.core |
af710487 | 29 | |
30 | 3. Configure the build | |
31 | ||
3abe9331 | 32 | cd titan.core |
a0fb1bec | 33 | check that MakefileFOSS.cfg is present and has the following content: |
af710487 | 34 | cat MakefileFOSS.cfg |
35 | ||
36 | # Configurations for the Free Open Source Software version | |
37 | LICENSING := no | |
38 | USAGE_STATS := no | |
39 | ||
40 | ||
ef855bc1 | 41 | Several build options are possible; for details on options please read through the Makefile.cfg. |
af710487 | 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 | ||
3abe9331 | 46 | a) JNI disabled |
af710487 | 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 | ||
3abe9331 | 51 | Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content: |
af710487 | 52 | (replace paths with values relevant to your installation) |
53 | ||
3abe9331 | 54 | TTCN3_DIR := /home/<user id>/titan.core/Install |
af710487 | 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 | ||
3abe9331 | 64 | b) JNI enabled |
af710487 | 65 | |
66 | install JDK into /home/<user id>/jdk | |
67 | ||
3abe9331 | 68 | Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content: |
af710487 | 69 | (replace paths with values relevant to your installation) |
70 | ||
3abe9331 | 71 | TTCN3_DIR := /home/<user id>/titan.core/Install |
af710487 | 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 | ||
f99e8b7f | 80 | 4. Run make |
af710487 | 81 | |
82 | make | |
83 | ||
f99e8b7f | 84 | 5. Set environment variables |
af710487 | 85 | |
3abe9331 | 86 | setenv TTCN3_DIR /home/<user id>/titan.core/Install |
775259be EL |
87 | setenv PATH /home/<userid>/titan.core/Install/bin/:${PATH} |
88 | setenv LD_LIBRARY_PATH /home/<userid>/titan.core/Install/lib:${LD_LIBRARY_PATH} | |
af710487 | 89 | |
775259be | 90 | for csh |
60f48d67 | 91 | |
775259be | 92 | or |
60f48d67 | 93 | |
3abe9331 | 94 | export TTCN3_DIR=/home/<user id>/titan.core/Install |
775259be EL |
95 | export PATH=/home/<userid>/titan.core/Install/bin/:${PATH} |
96 | export LD_LIBRARY_PATH=/home/<userid>/titan.core/Install/lib:${LD_LIBRARY_PATH} | |
60f48d67 | 97 | |
775259be | 98 | for bash |
60f48d67 | 99 | |
f99e8b7f | 100 | 6. Run make install |
60f48d67 | 101 | |
775259be | 102 | make install |
60f48d67 | 103 | |
3abe9331 | 104 | This will install Titan into /home/<user id>/titan.core/Install |
af710487 | 105 | |
106 | ||
d44e3c4f | 107 | 7. Optionally , run function/regression tests |
af710487 | 108 | |
3abe9331 | 109 | cd /home/<user id>/titan.core/function_test |
af710487 | 110 | |
111 | in the following Makefiles | |
112 | ||
3abe9331 | 113 | BER_EncDec/Makefile |
af710487 | 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 | ||
3abe9331 | 126 | cd /home/<user id>/titan.core/regression_test |
af710487 | 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 | ||
e79e2f13 | 133 | 8. Optionally, copy Titan into its final directory. |
97cee3b0 | 134 | From here on, you can continue with the Titan installation guide, see /Install/docs, to set/change environment variables etc. |
af710487 | 135 | |
9a925be4 | 136 | nagylenard |
3f4f6c16 | 137 | elnrnag |
c178585a | 138 | elnrnag2 |