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