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
|
======================================================================
The Internet Communications Engine
======================================================================
Ice is a modern alternative to object middleware such as CORBA or
COM/DCOM/COM+. It is easy to learn, yet provides a powerful network
infrastructure for demanding technical applications. It features an
object-oriented specification language, easy to use C++, Java, Python,
PHP, C#, and Visual Basic mappings, a highly efficient protocol,
asynchronous method invocation and dispatch, dynamic transport
plug-ins, TCP/IP and UDP/IP support, SSL-based security, a firewall
solution, and much more.
Ice is available under the terms of the GNU General Public License
(GPL) (see LICENSE file). Commercial licenses are available for
customers who wish to use Ice with proprietary products. Please
contact sales@zeroc.com for more information about licensing Ice.
======================================================================
About this distribution
======================================================================
This distribution is a binary release of Ice @ver@ for Solaris 10 on
SPARC and includes the following components:
- The Ice runtime, including executables for the Ice services, HTML
documentation and Slice files.
- Run time libraries for C++ and Java. These libraries enable you to
execute Ice applications.
- Tools and libraries for developing Ice applications.
======================================================================
Requirements
======================================================================
This binary distribution was compiled on Solaris 10 using Sun CC
version 5.8.
The following Solaris 10 binary packages are required to use
this distribution:
- bzip2 (Sun package SUNWbzip)
- libexpat (Sun package SUNWlexpt)
- openssl (Sun packages SUNWopenssl-libraries SUNWopenssl-commands)
We also recommend to install the Solaris 10 Encryption Kit (Sun packages
SUNWcry and SUNWcryr) available at http://www.sun.com/download/index.jsp?cat=Security&tab=3&subcat=Cryptography%20%26%20Encryption
Java
----
Ice for Java requires J2SE 1.4.2 or 1.5.0. RPMs can be obtained from
JavaSoft at http://www.javasoft.com/j2se
======================================================================
Berkeley DB
======================================================================
This distribution includes the C++ and Java runtime for Berkeley DB
4.5.20. The C++ runtime was built using Sun CC version 5.8. The
Berkeley DB license is provided in the file THIRD_PARTY_LICENSE.
======================================================================
Ice extension for Python
======================================================================
Ice for Python is fully supported on Solaris. However it is not
included in this distribution because there is no suitable binary
distribution for Python itself available from Sun or
www.sunfreeware.com.
If you want to use Ice for Python on Solaris, you can build Ice for
Python using its source distribution, available at
http://www.zeroc.com/download.html.
======================================================================
64 bit builds
======================================================================
This distribution only contains 32-bit binaries. If you need a 64-bit
version, you can download the Ice sources from the ZeroC web site at
http://www.zeroc.com/download.html and build Ice in 64-bit mode. See
the INSTALL.SOLARIS file of the source distribution for more details.
======================================================================
Setting up your environment to use Ice
======================================================================
General
-------
The discussion below assumes you have defined the ICE_HOME variable
with the directory of your Ice installation.
In order to use Ice services and tools such as Slice translators, you
need to add $ICE_HOME/bin to your PATH as shown in the bash command
below:
$ export PATH=$ICE_HOME/bin:$PATH
Ice shared libraries and executables in this distribution contain
/opt/Ice-@mmver@/lib as embedded runpath. In order to run Ice services
and tools, you can either:
- create a symbolic link /opt/Ice-@mmver@ that points to your Ice
installation.
$ ln -s $ICE_HOME /opt/Ice-@mmver@
- or add $ICE_HOME/lib to your LD_LIBRARY_PATH environment variable
$ export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH
C++
---
When compiling Ice for C++ programs, you must pass $ICE_HOME/include
to the compiler with the -I option, and $ICE_HOME/lib with the -L
option. Furthermore, a C++ program needs to link with at least libIce
and libIceUtil, so a typical link command would look like this:
$ CC -o myprogram myprogram.o -L$ICE_HOME/lib -lIce -lIceUtil
Additional libraries are necessary if you are using an Ice service
such as IceGrid or Glacier2.
Java
----
To use Ice for Java, you must add $ICE_HOME/lib/Ice.jar to your
CLASSPATH, as shown below:
$ export CLASSPATH=$ICE_HOME/lib/Ice.jar:$CLASSPATH
To use the Java5 version of Ice instead, modify your CLASSPATH as
follows:
$ export CLASSPATH=$ICE_HOME/lib/java5/Ice.jar:$CLASSPATH
If you plan to use Freeze for persistence, you must also add the
Berkeley DB JAR file (db.jar) to your CLASSPATH:
$ export CLASSPATH=$ICE_HOME/lib/db.jar:$CLASSPATH
In addition, the JVM requires that the directory containing the
Berkeley DB libraries be listed in java.library.path, therefore you
must add this directory to LD_LIBRARY_PATH.
======================================================================
Using the IceGrid Administrative Console
======================================================================
A Java-based graphical tool for administering IceGrid applications
is included in this distribution. The Java archive file is installed
as
$ICE_HOME/lib/IceGridGUI.jar
With a suitable Java installation, you can execute the application
using the following command:
$ java -jar IceGridGUI.jar
======================================================================
Demos and documentation
======================================================================
Sample programs are provided in the Ice-@ver@-demos.tar.gz package,
which can be downloaded from the ZeroC web site at
http://www.zeroc.com/download.html
Please refer to the README.DEMOS file included in that package for
more information.
See doc/README.html for information on the documentation included with
this distribution.
======================================================================
Binary compatibility
======================================================================
Patch releases of Ice are binary compatible. For example, version
<x>.<y>.1 is compatible with <x>.<y>.0, so you can run applications
compiled with <x>.<y>.0 with the <x>.<y>.1 runtime without having to
recompile.
With the binary installers, simply uninstall the previous version of
Ice and install the new one. Already deployed applications that were
compiled against the <x>.<y>.0 runtime will automatically use the
<x>.<y>.1 runtime.
|
