Changes between Version 10 and Version 11 of Guide


Ignore:
Timestamp:
Dec 16, 2016, 5:54:42 AM (4 years ago)
Author:
Maxim Reznik
Comment:

Add windows 64 instructions

Legend:

Unmodified
Added
Removed
Modified
  • Guide

    v10 v11  
    55== Installation ==
    66
     7=== Linux and other POSIX environment ===
    78To install Matreshka unpack its source code archive and run
    89
     
    1415Automatic configuration utility will be build and run to configure Matreshka to meet your machine and operating system.
    1516
     17=== Windows 32bit ===
     18
    1619On Windows system you need 'make', 'install' and a few other commands.
    1720The easiest way to get them is to install
     
    1922[http://gnuwin32.sourceforge.net/packages/coreutils.htm CoreUtils]
    2023packages from GnuWin32 port. Another option - install MinGW or Cygwin environment.
     24
     25=== Windows 64bit ===
     26
     27On Windows 64 bits the only 'working' compiler (capable to run gprbuild) is one of [https://msys2.github.io/ msys2] distribution.
     28To run Matreshka on Windows 64:
     29 * Download and install msys2 as described on https://msys2.github.io/
     30 * Install Ada compiler `pacman -S mingw-w64-gcc-ada
     31 * Now you need to replace unworking *.dll.a with corresponding dll. Do this in msys2 console:
     32{{{
     33adalib=$(dirname `gcc -print-libgcc-file-name`)/adalib
     34bin_dir=$(dirname `which gcc`)
     35rm -f ${adalib}/libgna{t,rl}-6.dll.a
     36cp ${bin_dir}/libgna{t,rl}-6.dll ${adalib}/
     37}}}
     38 * To install gprbuild setup our repository with precompiled packages:
     39{{{
     40echo [ci.mingw] >> /etc/pacman.conf
     41echo SigLevel = Optional >> /etc/pacman.conf
     42echo Server = https://dl.bintray.com/reznikmm/msys2/ >> /etc/pacman.conf
     43}}}
     44 * Install gprbuild-gpl (and asis if you like a2js):
     45{{{
     46pacman -S mingw-w64-gprbuild-gpl mingw-w64-asis
     47}}}
     48 * Continue with `make && make install`
     49
     50=== Mac OS ===
     51
     52You may use GNAT GPL 2016 or
     53[https://sourceforge.net/projects/gnuada/files/GNAT_GCC%20Mac%20OS%20X/6.1.0/native-2016/ GCC 6.1 from sf.net].
    2154
    2255On Mac OS system you need "Command Line Tools" installed. You can install this from Xcode menu > Preferences > Downloads or, alternatively, there are stand-alone installation packages both for
     
    2760
    2861
    29 === Advanced installation ===
     62== Advanced installation ==
    3063
    3164Sometimes, it is needed to have more control over configuration and build of Matreshka. One example is use Matreshka on Windows, where detection of non-standard libraries is problematic. Another example is binary packages supporters.
     
    3871 - installation of package.
    3972
    40 ==== Build of configuration utility ====
     73=== Build of configuration utility ===
    4174
    4275Configuration utility can be build by using
     
    4679}}}
    4780
    48 ==== Execution of configuration utility ====
     81=== Execution of configuration utility ===
    4982
    5083Execution of configuration utility in its simplest form looks like:
     
    74107}}}
    75108
    76 ==== Build of Matreshka ====
     109=== Build of Matreshka ===
    77110
    78111To build Matreshka after manual configuration it is sufficient to run
     
    87120 - GNAT_OPTFLAGS can be used to pass additional user defined switches for compiler.
    88121
    89 ==== Installation of Matreshka ====
     122=== Installation of Matreshka ===
    90123
    91124And to install Matreshka:
     
    97130Install target is used DESTDIR environment variable to adjust root directory, it is very useful for binary packages supporters.
    98131
    99 ==== Run test suite ====
     132=== Run test suite ===
    100133
    101134To run test suite execute
     
    107140This will start tests corresponding to configured settings.
    108141
    109 ===== Configuration to run Oracle tests =====
     142==== Configuration to run Oracle tests ====
    110143
    111144To start SQL Oracle driver tests you need an account on Oracle database server.
     
    125158}}}
    126159
    127 ===== Configuration to run MySQL tests =====
     160==== Configuration to run MySQL tests ====
    128161
    129162Tests of MySQL driver needs to establish connection to MySQL server. 'test' database must be created and accessible to read/write by current user before run of Matreshka configuration utility. Configuration utility do some checks using mysql command line client to detect whether MySQL server is accessible. Note, MySQL tests are disabled when these checks fail.