1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
# Building Ice for C++ for Windows Applications
This file describes the Ice source distribution, including information about
compiler requirements, third-party dependencies, and instructions for building
and testing the distribution. If you prefer, you can download a [Windows
installer][1] that contains pre-compiled debug and release libraries,
executables, and everything else necessary to build Ice applications on Windows.
## Build Requirements
### Operating Systems and Compilers
Ice was extensively tested using the operating systems and compiler versions
listed for our [supported platforms][2].
### Third-Party Libraries
Ice has dependencies on a number of third-party libraries:
- [expat][3] 2.0
- [bzip][4] 1.0
- [Berkeley DB][5] 5.3
- [mcpp][6] 2.7.2 (with patches)
You do not need to build these packages yourself, as ZeroC supplies a separate
[Windows installer][7] that contains release and debug libraries for all of the
third-party dependencies.
### Monotonic Clock
Ice uses the `QueryPerformanceCounter` Windows API function to measure time with
a monotonic clock. If you are experiencing timing or performance issues, there
are two knowledgebase articles that may be relevant for your system:
- [KB 896256](http://support.microsoft.com/?id=896256)
- [KB 895980](http://support.microsoft.com/?id=895980)
## Building Ice
Open a command prompt that is configured for your target architecture. For
example, when using Visual Studio 2013, you have several alternatives:
- Developer Command Prompt
- VS2013 x86 Native Tools Command Prompt
- VS2013 x64 Native Tools Command Prompt
- VS2013 x64 Cross Tools Command Prompt
Using the first two configurations produces 32-bit binaries, while the third and
fourth configurations produce 64-bit binaries.
In the command window, change to the `cpp` subdirectory:
$ cd cpp
Edit `config\Make.rules.mak` to establish your build configuration. The comments
in the file provide more information.
Now you're ready to build Ice:
> nmake /f Makefile.mak
This will build the Ice core libraries, services, and tests.
### x64 Platform
Building Ice on x64 with the Visual Studio C++ compiler is like building Ice on
x86. You just need to perform the build in an "x64 Command Prompt", and not in a
regular "Developer Command Prompt".
## Installing a C++ Source Build
Simply run `nmake /f Makefile.mak install`. This will install Ice in the
directory specified by the `prefix` variable in `config\Make.rules.mak`.
If you built a 64-bit version of Ice, the binaries are installed in the
`bin\x64` directory and the libraries are installed in the `lib\x64` directory.
## Running the Test Suite
Python is required to run the test suite. Additionally, the Glacier2 tests
require the Python module `passlib`, which you can install with the command:
> pip install passlib
After a successful source build, you can run the tests as follows:
> python allTests.py
If everything worked out, you should see lots of `ok` messages. In case of a
failure, the tests abort with `failed`.
[1]: https://doc.zeroc.com/display/Ice36/Using+the+Windows+Binary+Distribution
[2]: https://doc.zeroc.com/display/Ice36/Supported+Platforms+for+Ice+3.6.0
[3]: http://expat.sourceforge.net
[4]: http://bzip.org
[5]: http://www.oracle.com/us/products/database/berkeley-db/overview/index.htm
[6]: https://github.com/zeroc-ice/mcpp
[7]: https://zeroc.com/download/Ice/3.6/Ice-3.6.0-ThirdParty.msi
|
