README.cygwin 5.75 KB
Newer Older
Elemer Lelik's avatar
Elemer Lelik committed
1
******************************************************************************
Elemer Lelik's avatar
Elemer Lelik committed
2
* Copyright (c) 2000-2016 Ericsson Telecom AB
Elemer Lelik's avatar
Elemer Lelik committed
3
4
5
6
* 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
Elemer Lelik's avatar
Elemer Lelik committed
7
8
9
10
*  Contributors:
*   Balasko, Jeno
*   Baranyi, Botond
*   Pilisi, Gergely
Elemer Lelik's avatar
Elemer Lelik committed
11
******************************************************************************
Elemer Lelik's avatar
Elemer Lelik committed
12
13
14
15
16
17
Cygwin setup
    - If Cygwin is installed already, refresh your Cygwin installation
      Titan is always build for the newest Cygwin version available. 
      Start the Cygwin setup utility (see below), it will refresh your
      installed Cygwin packages to the newest versions.
    - If Cygwin is not installed yet:
balaskoa's avatar
balaskoa committed
18
  
Elemer Lelik's avatar
Elemer Lelik committed
19
20
21
   (A) Download and execute the latest cygwin installer utility, 
       please use the 64-bit version installer:
       https://cygwin.com/setup-x86_64.exe
balaskoa's avatar
balaskoa committed
22
  
Elemer Lelik's avatar
Elemer Lelik committed
23
24
25
26
   (B) Select Install from Internet (recommended to save local disk space)
   
   (C) Choose Cygwin installation root directory (C:\cygwin is recommended)
       Select All Users, or Just Me.
balaskoa's avatar
balaskoa committed
27
   
Elemer Lelik's avatar
Elemer Lelik committed
28
29
   (D) Select "Local Package Directory" (typically the same directory,  
       where the setup....exe Cygwin installer utility is stored).
balaskoa's avatar
balaskoa committed
30
   
Elemer Lelik's avatar
Elemer Lelik committed
31
32
33
34
35
36
37
38
39
40
41
42
43
   (E) Use Internet Explorer Proxy Settings (recommended).
   
   (F) Select a download mirror site.
   
   (G) In the package selection dialog, 
       Note: You can select different views to find the required packages
       easier and/or search the packages via the search field.
       
       There are 3 hierarchical levels of minimally required packages, 
       depending on your task.
       Note: Cygwin installer will automatically select the packages the
             manually selected ones are depending on; do NOT deselect
             any automatically selected package!
balaskoa's avatar
balaskoa committed
44
45
46
47
48
49
50
51
52
53
54
55
  a) Test execution ONLY (command line or from Eclipse Executor):
    Base: <all packages> (Default setting of the installer)
    Net: openssl
    Tcl: expect
  b) Test case development: in addition to the above select the 
     following packages:
    Devel: binutils
    Devel: gcc-g++
    Devel: make
    Libs: libxml2-devel
      Net: openssl-devel (automatically installs Net:openssl 
                        as well, if selected)
Elemer Lelik's avatar
Elemer Lelik committed
56
57
        c) To compile your own Titan Cygwin binary: in addition to the
           above, select the following packages:
balaskoa's avatar
balaskoa committed
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
    Devel: bison
    Devel: ctags 
    Devel: cygwin32-expat
    Devel: diffstat
    Devel: flex
    Devel: gcc-core
    Editors: <any editor of your preference> (optional)
    Libs: libncurses-devel
    Libs: libreadline-devel
    
  If, after selecting the required packages and clicking on the 
  "Next" button, a "Resolving Dependcies" window lists further 
  required packages, ensure that the "Select required packages 
  (RECOMMENDED)" checkbox is checked and click the "Next" button.
  
Elemer Lelik's avatar
Elemer Lelik committed
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
   (H) Select the Create icon on Desktop checkbox
   
   (I) (Optional)
       Your "unix" home directory, by default is:
       <your cygwin installation directory>/home/<yourUserId>
       If you are (also) working in command line mode, it is a good 
       practice to change this to the folder where your TTCN-3 projects 
       are.       
       Edit the file <your cygwin installation directory>/etc/passw:
       In the line:
       <yourUserId>:unused:<xxxxxx>:<yyyyy>:U-<yourDomain>\<yourUserId>,
       S-1-5-21-nnnnnn...nnnnnn:/home/<yourUserId>:/bin/bash
      
       replace "/home/<yourUserId>" with the folder of your preference.
       Note: you can access all Windows drives from Cygwin as
       /cygdrive/<windowsDriveLetter>".
       Example: to set your "unix" home directory to the "My_Home" folder 
       within your Windows Documents folder, you should replace 
       "/home/<yourUserId>" by 
       "/cygdrive/c/Users/<yourUserId>/Documents/My_Home"
       WARNING: The path of your "unix" home directory shall not contain
                any space!
balaskoa's avatar
balaskoa committed
95
96
97
98
99
100

    (I1)If you are working with Titan plugins for Eclipse or any Windows based program 
        using cygwin commands, insert the Windows equivalent path of cygwin folders "/bin" or/and "/usr/bin" 
        into the Windows environment variable "Path". For example if the cygwin root is "C:\cygwin64" then 
        Path should contain  "C:\cygwin64\bin;C:\cygwin64\usr\bin".

101
  (J) Using the binary Titan package: download the Titan package for from
Elemer Lelik's avatar
Elemer Lelik committed
102
103
104
105
    GitHub. Unpack the Titan package into a folder of your choice.
      Note: It is not a requirement, but is a kind of best practice to 
            place Titan into a subfolder within your "unix" home directory.
      Edit the <your cygwin installation directory>/home/<yourUserId>/.bashrc
balaskoa's avatar
balaskoa committed
106
107
108
      file. Add these lines to it:
        export PATH=${TTCN3_DIR}/bin:${PATH}
        export LD_LIBRARY_PATH=${TTCN3_DIR}/lib:${LD_LIBRARY_PATH}
Elemer Lelik's avatar
Elemer Lelik committed
109
110

  (K) Compile Titan with Cygwin:
balaskoa's avatar
balaskoa committed
111
112
113
114
115
116
117
   Get the latest source code from GitHub.
   Download and install JDK from Oracle's download site:
     http://www.oracle.com/technetwork/java/javase/downloads/index.html
   Edit the <your cygwin installation directory>/home/<yourUserId>/.bashrc
   as above.
   Create titan/Makefile.personal with the following content:    
            TTCN3_DIR := /home/<user id>/git/titan/Install
Elemer Lelik's avatar
Elemer Lelik committed
118
119
120
121
122
            JDKDIR := /home/<user id>/jdk
            JNI := no
            GUI := no
            GEN_PDF := no
            DEBUG := no
balaskoa's avatar
balaskoa committed
123
124
125
126
127
128
   Compile Titan:
          cd titan
          make -j  
          make install 
   The compiled files will be placed into the titan/Install directory. 
  
Elemer Lelik's avatar
Elemer Lelik committed
129
130
  (L) If you want to use graphical tools (like nedit for example), then you need to install the Cygwin/X
      component too. The install procedure can be found at the homepage:
balaskoa's avatar
balaskoa committed
131
      http://x.cygwin.com/docs/ug/cygwin-x-ug.html
132