Use LTTngUSTLogger logger plugin in logtest regression test
[deliverable/titan.core.git] / README.linux
index 06666777f7d4f048ddb88964bbab25d3e5c04684..e851c5d98bfd779753ee1ec36303933980318d83 100644 (file)
-Build and install Titan on Linux\r
-\r
-1.Install required libraries: \r
-(examples are given for Ubuntu 12.04/14.04; for other Linuxes, pls. use the relevant library installation method)\r
-\r
-sudo apt-get install g++ expect libssl-dev libxml2-dev libncurses5-dev flex bison\r
-xutils-dev is needed by makedepend:\r
-sudo apt-get install xutils-dev\r
-The following packages may be needed for titan_eclipse/automatic_build:\r
-sudo apt-get install ant xsltproc\r
-\r
-2.Clone the titan directory from git  into /home/<user_id>/titan\r
-\r
-git clone https://github.com/eclipse/titan.core  titan\r
-\r
-3. Configure the build \r
-\r
-cd titan\r
-check  that MakefileFOSS.cfg is present   and  has the following content:\r
-cat MakefileFOSS.cfg\r
-\r
-# Configurations for the Free Open Source Software version\r
-LICENSING := no\r
-USAGE_STATS := no\r
-\r
-\r
-Several build options are possible; for details on options , please read through the Makefile.cfg.\r
-Options can be overridden by the content of  a file named Makefile.personal which can be used to \r
-adapt to local installation directories, change config options etc.\r
-Below, a small number of typical scenarios are presented.\r
-\r
-1) JNI  disabled\r
-\r
-The JNI interface is used by the Eclipse Titan Executor or by the Java Executor API.\r
-If you don't need them , Titan can be compiled without JNI. \r
-\r
-Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content:\r
-(replace paths with values relevant to your installation)\r
-\r
-TTCN3_DIR := /home/<user id>/titan/Install\r
-OPENSSL_DIR := /usr\r
-#JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64\r
-XMLDIR := /usr\r
-JNI := no\r
-GEN_PDF := no\r
-\r
-\r
-\r
-\r
-2) JNI  enabled\r
-\r
-install JDK   into /home/<user id>/jdk\r
-\r
-Create ~/titan/Makefile.personal to override settings in Makefile.cfg with the following content:\r
-(replace paths with values relevant to your installation)\r
-\r
-TTCN3_DIR := /home/<user id>/titan/Install\r
-OPENSSL_DIR := /usr\r
-JDKDIR := /usr/lib/jvm/java-7-openjdk-amd64\r
-XMLDIR := /usr\r
-JNI := yes\r
-GEN_PDF := no\r
-\r
-\r
-\r
-3. Run make\r
-\r
-make\r
-\r
-4. Run make install\r
-\r
-make install\r
-\r
-This will install Titan into  /home/<user id>/titan/Install\r
-\r
-5. Optionally , run function/regression tests\r
-\r
-set environment variable TTCN3_DIR to /home/<user id>/titan/Install\r
-\r
-(setenv  TTCN3_DIR /home/<user id>/titan/Install  for csh,\r
-export TTCN3_DIR=/home/<user id>/titan/Install for bash )\r
-\r
-\r
-\r
-cd /home/<user id>/titan/function_test\r
-\r
-in the following Makefiles \r
-\r
-XER_EncDec/Makefile\r
-Text_EncDec/Makefile\r
-RAW_EncDec/Makefile\r
-\r
-edit the value of XMLDIR to match your installation values \r
-\r
-run the tests\r
-\r
-make\r
-\r
-( or make |& tee outputfile if you want to save the output for verification)\r
-\r
-cd /home/<user id>/titan/regression_test\r
-make run\r
-\r
-( or make run |& tee outputfile if you want to save the output for verification)\r
-\r
-These tests might run for half an hour (regr.tests)  to two hours (func.tests)\r
-\r
-6. Optionally , copy Titan into its' final directory.\r
-From here on, you can continue with the Titan installation guide, see /Install/docs, to set environment variables etc.\r
-\r
-\r
-\r
-\r
+******************************************************************************
+* 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/<user_id>/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/<user id>/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/<user id>/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/<user id>/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/<user id>/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/<user id>/titan.core/Install
+setenv PATH /home/<userid>/titan.core/Install/bin/:${PATH}
+setenv LD_LIBRARY_PATH /home/<userid>/titan.core/Install/lib:${LD_LIBRARY_PATH}
+
+for csh
+
+or 
+
+export TTCN3_DIR=/home/<user id>/titan.core/Install
+export PATH=/home/<userid>/titan.core/Install/bin/:${PATH}
+export LD_LIBRARY_PATH=/home/<userid>/titan.core/Install/lib:${LD_LIBRARY_PATH}
+
+for bash
+
+6. Run make install
+
+make install
+
+This will install Titan into  /home/<user id>/titan.core/Install
+
+
+7. Optionally , run function/regression tests
+
+cd /home/<user id>/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/<user id>/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.
+
This page took 0.027371 seconds and 5 git commands to generate.