README.cygwin

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