Commit | Line | Data |
---|---|---|
af710487 | 1 | ****************************************************************************** |
2 | * Copyright (c) 2000-2015 Ericsson Telecom AB | |
3 | * All rights reserved. This program and the accompanying materials | |
4 | * are made available under the terms of the Eclipse Public License v1.0 | |
5 | * which accompanies this distribution, and is available at | |
6 | * http://www.eclipse.org/legal/epl-v10.html | |
7 | ****************************************************************************** | |
8 | ||
970ed795 | 9 | Cygwin setup\r |
7a446eb8 | 10 | - If Cygwin is installed already, then refresh your Cygwin installation\r |
970ed795 EL |
11 | Titan is always build for the newest Cygwin version available. \r |
12 | Start the Cygwin setup utility (see below), it will refresh your\r | |
13 | installed Cygwin packages to the newest versions.\r | |
14 | - If Cygwin is not installed yet:\r | |
15 | \r | |
16 | (A) Download and execute the latest cygwin installer utility, \r | |
17 | please use the 64-bit version installer:\r | |
18 | https://cygwin.com/setup-x86_64.exe\r | |
19 | \r | |
20 | (B) Select Install from Internet (recommended to save local disk space)\r | |
21 | \r | |
22 | (C) Choose Cygwin installation root directory (C:\cygwin is recommended)\r | |
23 | Select All Users, or Just Me.\r | |
24 | \r | |
25 | (D) Select "Local Package Directory" (typically the same directory, \r | |
26 | where the setup....exe Cygwin installer utility is stored).\r | |
27 | \r | |
28 | (E) Use Internet Explorer Proxy Settings (recommended).\r | |
29 | \r | |
30 | (F) Select a download mirror site.\r | |
31 | \r | |
32 | (G) In the package selection dialog, \r | |
33 | Note: You can select different views to find the required packages\r | |
34 | easier and/or search the packages via the search field.\r | |
35 | \r | |
36 | There are 3 hierarchical levels of minimally required packages, \r | |
37 | depending on your task.\r | |
38 | Note: Cygwin installer will automatically select the packages the\r | |
39 | manually selected ones are depending on; do NOT deselect\r | |
40 | any automatically selected package!\r | |
41 | a) Test execution ONLY (command line or from Eclipse Executor):\r | |
42 | Base: <all packages> (Default setting of the installer)\r | |
43 | Net: openssl\r | |
44 | Tcl: expect\r | |
45 | b) Test case development: in addition to the above select the \r | |
46 | following packages:\r | |
47 | Devel: binutils\r | |
48 | Devel: gcc-g++\r | |
49 | Devel: make\r | |
50 | Libs: libxml2-devel\r | |
51 | Net: openssl-devel (automatically installs Net:openssl \r | |
52 | as well, if selected)\r | |
53 | c) To compile your own Titan Cygwin binary: in addition to the\r | |
54 | above, select the following packages:\r | |
55 | Devel: bison\r | |
56 | Devel: ctags \r | |
57 | Devel: cygwin32-expat\r | |
58 | Devel: diffstat\r | |
59 | Devel: flex\r | |
60 | Devel: gcc-core\r | |
61 | Editors: <any editor of your preference> (optional)\r | |
62 | Libs: libncurses-devel\r | |
63 | Libs: libreadline-devel\r | |
64 | \r | |
65 | If, after selecting the required packages and clicking on the \r | |
66 | "Next" button, a "Resolving Dependcies" window lists further \r | |
67 | required packages, ensure that the "Select required packages \r | |
68 | (RECOMMENDED)" checkbox is checked and click the "Next" button.\r | |
69 | \r | |
70 | (H) Select the Create icon on Desktop checkbox\r | |
71 | \r | |
72 | (I) (Optional)\r | |
73 | Your "unix" home directory, by default is:\r | |
74 | <your cygwin installation directory>/home/<yourUserId>\r | |
75 | If you are (also) working in command line mode, it is a good \r | |
76 | practice to change this to the folder where your TTCN-3 projects \r | |
77 | are. \r | |
78 | Edit the file <your cygwin installation directory>/etc/passw:\r | |
79 | In the line:\r | |
80 | <yourUserId>:unused:<xxxxxx>:<yyyyy>:U-<yourDomain>\<yourUserId>,\r | |
81 | S-1-5-21-nnnnnn...nnnnnn:/home/<yourUserId>:/bin/bash\r | |
82 | \r | |
83 | replace "/home/<yourUserId>" with the folder of your preference.\r | |
84 | Note: you can access all Windows drives from Cygwin as\r | |
85 | /cygdrive/<windowsDriveLetter>".\r | |
86 | Example: to set your "unix" home directory to the "My_Home" folder \r | |
87 | within your Windows Documents folder, you should replace \r | |
88 | "/home/<yourUserId>" by \r | |
89 | "/cygdrive/c/Users/<yourUserId>/Documents/My_Home"\r | |
90 | WARNING: The path of your "unix" home directory shall not contain\r | |
91 | any space!\r | |
92 | \r | |
93 | (J) Using the bynary Titan package: download the Titan package for from\r | |
94 | GitHub. Unpack the Titan package into a folder of your choice.\r | |
95 | Note: It is not a requirement, but is a kind of best practice to \r | |
96 | place Titan into a subfolder within your "unix" home directory.\r | |
97 | Edit the <your cygwin installation directory>/home/<yourUserId>/.bashrc\r | |
98 | file. Add these lines to it:\r | |
99 | export PATH=${TTCN3_DIR}/bin:${PATH}\r | |
100 | export LD_LIBRARY_PATH=${TTCN3_DIR}/lib:${LD_LIBRARY_PATH}\r | |
101 | \r | |
102 | (K) Compile Titan with Cygwin:\r | |
103 | Get the latest source code from GitHub.\r | |
104 | Download and install JDK from Oracle's download site:\r | |
105 | http://www.oracle.com/technetwork/java/javase/downloads/index.html\r | |
106 | Edit the <your cygwin installation directory>/home/<yourUserId>/.bashrc\r | |
107 | as above.\r | |
108 | Create titan/Makefile.personal with the following content: \r | |
109 | TTCN3_DIR := /home/<user id>/git/titan/Install\r | |
110 | JDKDIR := /home/<user id>/jdk\r | |
111 | JNI := no\r | |
112 | GUI := no\r | |
113 | GEN_PDF := no\r | |
114 | DEBUG := no\r | |
115 | Compile Titan:\r | |
116 | cd titan\r | |
117 | make -j \r | |
118 | make install \r | |
119 | The compiled files will be placed into the titan/Install directory. \r | |
120 | \r | |
f14b2732 | 121 | (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:\r |
970ed795 EL |
122 | http://x.cygwin.com/docs/ug/cygwin-x-ug.html \r |
123 | \r |