X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=README.linux;h=e851c5d98bfd779753ee1ec36303933980318d83;hb=refs%2Fheads%2FLTTngUSTLogger;hp=06666777f7d4f048ddb88964bbab25d3e5c04684;hpb=bab5bcd910e384402bf36ac40933000de4b4a4be;p=deliverable%2Ftitan.core.git diff --git a/README.linux b/README.linux index 0666677..e851c5d 100644 --- a/README.linux +++ b/README.linux @@ -1,113 +1,150 @@ -Build and install Titan on Linux - -1.Install required libraries: -(examples are given for Ubuntu 12.04/14.04; for other Linuxes, pls. use the relevant library installation method) - -sudo apt-get install g++ expect libssl-dev libxml2-dev libncurses5-dev flex bison -xutils-dev is needed by makedepend: -sudo apt-get install xutils-dev -The following packages may be needed for titan_eclipse/automatic_build: -sudo apt-get install ant xsltproc - -2.Clone the titan directory from git into /home//titan - -git clone https://github.com/eclipse/titan.core titan - -3. Configure the build - -cd titan -check that MakefileFOSS.cfg is present and has the following content: -cat MakefileFOSS.cfg - -# Configurations for the Free Open Source Software version -LICENSING := no -USAGE_STATS := no - - -Several build options are possible; for details on options , please read through the Makefile.cfg. -Options can be overridden by the content of a file named Makefile.personal which can be used to -adapt to local installation directories, change config options etc. -Below, a small number of typical scenarios are presented. - -1) JNI disabled - -The JNI interface is used by the Eclipse Titan Executor or by the Java Executor API. -If you don't need them , Titan can be compiled without JNI. - -Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content: -(replace paths with values relevant to your installation) - -TTCN3_DIR := /home//titan/Install -OPENSSL_DIR := /usr -#JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64 -XMLDIR := /usr -JNI := no -GEN_PDF := no - - - - -2) JNI enabled - -install JDK into /home//jdk - -Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content: -(replace paths with values relevant to your installation) - -TTCN3_DIR := /home//titan/Install -OPENSSL_DIR := /usr -JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64 -XMLDIR := /usr -JNI := yes -GEN_PDF := no - - - -3. Run make - -make - -4. Run make install - -make install - -This will install Titan into /home//titan/Install - -5. Optionally , run function/regression tests - -set environment variable TTCN3_DIR to /home//titan/Install - -(setenv TTCN3_DIR /home//titan/Install for csh, -export TTCN3_DIR=/home//titan/Install for bash ) - - - -cd /home//titan/function_test - -in the following Makefiles - -XER_EncDec/Makefile -Text_EncDec/Makefile -RAW_EncDec/Makefile - -edit the value of XMLDIR to match your installation values - -run the tests - -make - -( or make |& tee outputfile if you want to save the output for verification) - -cd /home//titan/regression_test -make run - -( or make run |& tee outputfile if you want to save the output for verification) - -These tests might run for half an hour (regr.tests) to two hours (func.tests) - -6. Optionally , copy Titan into its' final directory. -From here on, you can continue with the Titan installation guide, see /Install/docs, to set environment variables etc. - - - - +****************************************************************************** +* Copyright (c) 2000-2016 Ericsson Telecom AB +* All rights reserved. This program and the accompanying materials +* are made available under the terms of the Eclipse Public License v1.0 +* which accompanies this distribution, and is available at +* http://www.eclipse.org/legal/epl-v10.html +* Contributors: +* Balasko, Jeno +* Baranyi, Botond +* Lelik, Elemer +* Pilisi, Gergely +* Szabados, Kristof +****************************************************************************** + +Build and install Titan on Linux + +1.Install required libraries: +(examples are given for Ubuntu 12.04/14.04; for other Linuxes, pls. use the relevant library installation method) + +sudo apt-get install g++ expect libssl-dev libxml2-dev libncurses5-dev flex bison +xutils-dev is needed by makedepend: +sudo apt-get install xutils-dev +The following packages may be needed for titan_eclipse/automatic_build: +sudo apt-get install ant xsltproc + +2.Clone the titan directory from git into /home//titan.core + +git clone https://github.com/eclipse/titan.core titan.core + +3. Configure the build + +cd titan.core + +For open source users: check that MakefileFOSS.cfg is present and has the following content: +cat MakefileFOSS.cfg + +# Configurations for the Free Open Source Software version +LICENSING := no +USAGE_STATS := no + +If you want to use your build within teh Ericsson domain: delete MakefileFOSS.cfg +This will enable licensing. + +Several build options are possible; for details on options please read through the Makefile.cfg. +Options can be overridden by the content of a file named Makefile.personal which can be used to +adapt to local installation directories, change config options etc. +Below, a small number of typical scenarios are presented. + +a) JNI disabled, gcc compiler (default) + +The JNI interface is used by the Eclipse Titan Executor or by the Java Executor API. +If you don't need them , Titan can be compiled without JNI. + +Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content: +(replace paths with values relevant to your installation) + +TTCN3_DIR := /home//titan.core/Install +OPENSSL_DIR := /usr +#JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64 +XMLDIR := /usr +JNI := no +GEN_PDF := no + +b) JNI disabled, clang compiler ver. 3.8 + +Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content: +(replace paths with values relevant to your installation). + +TTCN3_DIR := /home//titan.core/Install +OPENSSL_DIR := /usr +#JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64 +XMLDIR := /usr +JNI := no +GEN_PDF := no +CXX := clang++-3.8 +CC := clang-3.8 + + +c) JNI enabled, gcc compiler (default) + +install JDK into /home//jdk + +Create ~/titan.core/Makefile.personal to override settings in Makefile.cfg with the following content: +(replace paths with values relevant to your installation). + +TTCN3_DIR := /home//titan.core/Install +OPENSSL_DIR := /usr +JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64 +XMLDIR := /usr +JNI := yes +GEN_PDF := no + + + +4. Run make + +make + +5. Set environment variables + +setenv TTCN3_DIR /home//titan.core/Install +setenv PATH /home//titan.core/Install/bin/:${PATH} +setenv LD_LIBRARY_PATH /home//titan.core/Install/lib:${LD_LIBRARY_PATH} + +for csh + +or + +export TTCN3_DIR=/home//titan.core/Install +export PATH=/home//titan.core/Install/bin/:${PATH} +export LD_LIBRARY_PATH=/home//titan.core/Install/lib:${LD_LIBRARY_PATH} + +for bash + +6. Run make install + +make install + +This will install Titan into /home//titan.core/Install + + +7. Optionally , run function/regression tests + +cd /home//titan.core/function_test + +in the following Makefiles + +BER_EncDec/Makefile +XER_EncDec/Makefile +Text_EncDec/Makefile +RAW_EncDec/Makefile + +edit the value of XMLDIR to match your installation values + +run the tests + +make + +( or make |& tee outputfile if you want to save the output for verification) + +cd /home//titan.core/regression_test +make run + +( or make run |& tee outputfile if you want to save the output for verification) + +These tests might run for half an hour (regr.tests) to two hours (func.tests) + +8. Optionally, copy Titan into its final directory. +From here on, you can continue with the Titan installation guide, see /Install/docs, to set/change environment variables etc. +