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