Titan Core Initial Contribution
[deliverable/titan.core.git] / README.linux
CommitLineData
970ed795
EL
1Build and install Titan on Linux\r
2\r
31.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
6sudo apt-get install g++ expect libssl-dev libxml2-dev libncurses5-dev flex bison\r
7xutils-dev is needed by makedepend:\r
8sudo apt-get install xutils-dev\r
9The following packages may be needed for titan_eclipse/automatic_build:\r
10sudo apt-get install ant xsltproc\r
11\r
122.Clone the titan directory from git into /home/<user_id>/titan\r
13\r
143. Configure the build \r
15cd titan\r
16check that MakefileFOSS.cfg is present and has the following content:\r
17cat MakefileFOSS.cfg\r
18\r
19# Configurations for the Free Open Source Software version\r
20LICENSING := no\r
21USAGE_STATS := no\r
22\r
23\r
24Several build options are possible; for details on options , please read through the Makefile.cfg.\r
25Options can be overridden by the content of a file named Makefile.personal.\r
26Below, a small number of typical scenarios are presented.\r
27\r
281) JNI disabled\r
29\r
30The JNI interface is used by the Eclipse Titan Executor or by the Java Executor API.\r
31If 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
33Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content:\r
34\r
35TTCN3_DIR := /home/<user id>/titan/Install\r
36JNI := no\r
37GEN_PDF := yes\r
38\r
39\r
40\r
41\r
422) JNI enabled\r
43\r
44install JDK into /home/<user id>/jdk\r
45\r
46Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content:\r
47\r
48TTCN3_DIR := /home/<user id>/titan/Install\r
49JDKDIR := /home/<user id>/jdk\r
50JNI := yes\r
51GEN_PDF := yes\r
52\r
53\r
54\r
553. Run make\r
56\r
57make\r
58\r
594. Run make install\r
60\r
61make install\r
62\r
63This will install Titan into /home/<user id>/titan/Install\r
64\r
655. Optionally , run function/regression tests\r
66\r
67set 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
70export TTCN3_DIR=/home/<user id>/titan/Install for bash )\r
71\r
72\r
73\r
74cd /home/<user id>/titan/function_test\r
75make\r
76\r
77( or make |& tee outputfile if you want to save the output for verification)\r
78cd /home/<user id>/titan/regression_test\r
79make run\r
80( or make run |& tee outputfile if you want to save the output for verification)\r
81\r
82These tests might run for half an hour (regr.tests) to two hours (func.tests)\r
83\r
846. Optionally , copy Titan into its' final directory.\r
85From 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
This page took 0.031504 seconds and 5 git commands to generate.