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
|
======================================================================
Requirements
======================================================================
Operating System
----------------
FreeBSD 5.1 for Intel x86.
C++ compiler
------------
- GCC 3.3
Third-party libraries
---------------------
- Berkeley DB 4.2.52 or 4.3.21 configured with --enable-cxx. You
can download the Berkeley DB source distribution from
http://www.sleepycat.com/download
- expat 1.9x
- OpenSSL 0.96 or 0.97
- bzip2 1.0
- readline and ncurses (optional, but used unless you set USE_READLINE
to no in config/Make.rules)
Berkeley DB, expat, OpenSSL, bzip2, readline and ncurses are usually
available with your FreeBSD distribution.
If you don't have them, you can download Berkeley DB from:
http://www.sleepycat.com/download
And expat from:
http://sourceforge.net/projects/expat
And OpenSSL from:
http://www.openssl.org
And bzip2 from:
http://sources.redhat.com/bzip2
And readline from:
http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html
And ncurses from:
http://www.gnu.org/software/ncurses/ncurses.html
Python 2.2 or 2.3
-----------------
To run the automated test suite, you will need Python. If you have
no interest in running the test scripts, Python is not required.
======================================================================
Compilation and Testing
======================================================================
Extract the Ice archive in any directory you like (for example, in
your home directory):
$ tar xvfz Ice-<version>.tar.gz
Change the working directory to Ice-<version>:
$ cd Ice-<version>
Edit the file config/Make.rules according to the comments in this
file. Make sure that the paths for the third-party libraries are set
correctly if they are not installed in the default location /usr/lib
and /usr/include.
Now you're ready to build Ice:
$ make
This will build the Ice core library, all add-ons, all tests, and all
examples. After a successful build, you can run the test suite,
provided that you installed Python:
$ make test
This is equivalent to:
$ python allTests.py
If everything worked out, you should see lots of "ok". In case of a
failure, the tests abort with "failed".
If you want to try out any of the demos, make sure to add "bin" to
PATH and "lib" to LD_LIBRARY_PATH:
$ export PATH=`pwd`/bin:$PATH
$ export LD_LIBRARY_PATH=`pwd`/lib:$LD_LIBRARY_PATH
======================================================================
Installation
======================================================================
Simply run "make install". This will install Ice in the "prefix"
directory specified in the file Make.rules.
After installation, make sure that the <prefix>/bin directory is in
your PATH, and the <prefix>/lib directory is in your
LD_LIBRARY_PATH. When compiling Ice programs, you must also make sure
to pass the location of the <prefix>/include directory to the compiler
with the -I option, and the location of the <prefix>/lib directory
with the -L option.
|