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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
|
# Building Ice for C++ on AIX
This document provides step-by-step instructions for building Ice for C++
from sources on AIX.
## Unsupported Platform
AIX is currently an unsupported platform. Only minimal testing was performed
on AIX, and there is no guarantee future releases of Ice will build or run
on this platform.
## Recommended Operating System and C++ Compiler
- AIX 6.1, AIX 7.1
- IBM XL C/C++ 12.1 with latest Fix Pack
- 32 bit or 64 bit
## Build Pre-Requisites
Before building Ice, you need to install or build a number of third-party
packages that Ice depends on, and install some build tools.
### Third-Party Packages
Ice depends on several open-source packages: Berkeley DB 5.3, bzip2 1.0,
expat 2.x, mcpp 2.7.2 (+patches) and OpenSSL.
OpenSSL is a system package on AIX. RPM packages for bzip2 and expat are
available in the [AIX Toolbox for Linux Applications][1]. You can install
them as follows:
```
# As root
rpm -i ftp://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/bzip2/bzip2-1.0.5-3.aix5.3.ppc.rpm
rpm -i ftp://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/expat/expat-2.0.1-2.aix5.3.ppc.rpm
rpm -i ftp://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/expat/expat-devel-2.0.1-2.aix5.3.ppc.rpm
```
Berkeley DB and mcpp must be built from sources, as described below.
### Build Tools
You need GNU make (gmake) to build Ice:
```
# As root
rpm -i ftp://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/make/make-4.1-2.aix6.1.ppc.rpm
```
The preferred way to retrieve the Ice and mcpp source distributions is with
git. A RPM for git is available from [bullfreeware.com][2].
You also need wget, GNU tar and GNU patch to retrieve and build Berkeley DB:
```
# As root
rpm -i ftp://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/wget/wget-1.9.1-1.aix5.1.ppc.rpm
rpm -i ftp://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/tar/tar-1.22-1.aix6.1.ppc.rpm
rpm -i ftp://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/patch/patch-2.5.4-4.aix4.3.ppc.rpm
```
### Building mcpp from Sources
If building 64-bit binaries, set `OBJECT_MODE` to 64:
```
export OBJECT_MODE=64
```
Otherwise, leave `OBJECT_MODE` unset.
Then clone the zeroc-ice/mcpp repository and build with gmake:
```
git clone https://github.com/zeroc-ice/mcpp.git
cd mcpp
gmake
```
This build creates a static library, `lib/libmcpp.a`. `libmcpp.a` is used
only when building Ice from sources, and does not need to be installed.
### Building Berkeley DB from Sources
#### Download Sources
Download the Berkeley DB 5.3.28 source archive from [Oracle][3] or ZeroC. You
may use the distribution with encryption or without encryption. Since Ice does
not use Berkeley DB's encryption features, we recommend downloading the
no-encryption (-NC) source archive:
```
wget http://zeroc.com/download/berkeley-db/db-5.3.28.NC.tar.gz
```
Then unpack this archive:
```
gtar xzf db-5.3.28.NC.tar.gz
```
#### Patch
Patch Berkeley DB with GNU patch:
```
wget http://zeroc.com/download/berkeley-db/berkeley-db.5.3.28.patch
cd db-5.3.28.NC
/opt/freeware/bin/patch -p0 < ../berkeley-db.5.3.28.patch
```
#### Configure
If building 64-bit binaries, set `OBJECT_MODE` to 64:
```
export OBJECT_MODE=64
```
Otherwise, leave `OBJECT_MODE` unset.
Then configure Berkeley DB with C++ support, and set the installation prefix,
for example:
```
cd build_unix
../dist/configure --enable-cxx --prefix=/opt/db53
```
#### Build and Install
```
gmake
...
# run gmake install as root or change permissions on /opt/db53 before install
gmake install
```
## Building Ice for C++
### Clone zeroc-ice/ice
```
git clone -b 3.6 https://github.com/zeroc-ice/ice.git
cd ice/cpp
```
### Configure
Edit `config/Make.rules` to establish your build configuration. The comments
in the file provide more information.
Make sure to set `DB_HOME` to your Berkeley DB 5.3 installation directory
(`/opt/db53` if built as described above), and `MCPP_HOME` to your mcpp build
directory (for example `$(HOME)/builds/mcpp`).
`LP64` is not used on AIX. To build 64 bit binaries, set the environment
variable `OBJECT_MODE` to 64:
```
export OBJECT_MODE=64
```
Otherwise, leave this environment variable unset.
### Build
Use the gmake `-j` option to speed up the build:
```
gmake -j8
```
This builds the Ice core libraries, services, and tests.
### Install
```
gmake install
```
This installs Ice for C++ in the directory specified by `prefix` in
`config/Make.rules`. By default, all Ice binaries embed the library path
`prefix/lib:$DB_HOME/lib:/usr/lib`.
After installation, make sure that the `prefix/bin` directory is in your `PATH`.
### Run the Test Suite (Optional)
Python is required to run the test suite. You can install Python as follows:
```
# As root
rpm -i ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/python/python-2.7.10-1.aix6.1.ppc.rpm
rpm -i ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/python/python-tools-2.7.10-1.aix6.1.ppc.rpm
rpm -i ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/python/python-devel-2.7.10-1.aix6.1.ppc.rpm
```
Additionally, the Glacier2 tests require the Python module `passlib`, available
from the Python Package Index:
```
# As root
wget https://bootstrap.pypa.io/get-pip.py
python get-pip.py
export PATH=/opt/freeware/bin:$PATH
pip install passlib
```
Then run the test suite with:
```
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]: http://www-03.ibm.com/systems/power/software/aix/linux
[2]: http://www.bullfreeware.com
[3]: http://www.oracle.com/technetwork/database/database-technologies/berkeleydb/downloads/index.html
|
