...

The subsections below provide additional information about upgrading to Ice 3.4.2, including administrative procedures for the supported platforms.

On this page:

Upgrading from Ice 3.4.x on Linux (RPMs)

...

For a Mono application, the ice-mono RPM for Ice 3.4.2 installs the updated Ice run time assemblies into the Global Assembly Cache (GAC) along with policy assemblies that enable backward compatibility with Ice 3.4.0 and 3.4.1.

Upgrading from Ice 3.4.x on Windows

...

• Open Windows Explorer and navigate to the directory C:\WINDOWS\assembly. Next, drag and drop (or copy and paste) the assemblies into the right-hand pane to install them in the GAC.

• Use gacutil from the command line:

  Wiki Markup
  {zcode} > gacutil -i <policy.dll> {zcode}

...

On a development system, it is not necessary to remove your existing Ice installation prior to installing Ice 3.4.2 unless you intend to install Ice 3.4.2 in the same directory as your existing installation. You may need to update your PATH setting and modify your Visual C++ directory configurations to reflect the installation directory for Ice 3.4.2.

Upgrading from Ice 3.4.x with Binary Archives (

...

OS X, Solaris)

The README file included in each binary distribution archive describes how to configure your environment so that the embedded path names in the Ice for C++ shared libraries are resolved correctly. For example, if you extracted the binary distribution for Ice 3.4.1 into /opt/Ice-3.4.1, the README file instructs you to create the following symbolic link:

...

{zcode}
export PYTHONPATH=/opt/Ice-3.4/python
export RUBYLIB=/opt/Ice-3.4/ruby
{zcode}

Upgrading from Ice 3.4.x with a Source Distribution (Linux,

...

OS X, Solaris)

If you compiled an Ice 3.4.1 source distribution and installed it via make install, the default installation directory uses a version-specific name such as /opt/Ice-3.4.1. Consequently, you can build and install the Ice 3.4.2 source distribution without affecting your existing Ice 3.4.1 installation.

You may need to update your application's build settings to use the new installation directory for location locating include and library files. You may also need to update your shared library search path.

The relevant environment variables for each language mapping are detailed below.

• C++, Ruby, Python, PHP

  Wiki Markup
  {zcode} export LD_LIBRARY_PATH=/opt/Ice-3.4.2/lib (32-bit Linux & 32-bit Solaris) export LD_LIBRARY_PATH=/opt/Ice-3.4.2/lib64 (64-bit Linux) export LD_LIBRARY_PATH_64=/opt/Ice-3.4.2/lib/amd64 (64-bit Solaris Intel) export LD_LIBRARY_PATH_64=/opt/Ice-3.4.2/lib/sparcv9 (64-bit Solaris SPARC) export DYLD_LIBRARY_PATH=/opt/Ice-3.4.2/lib (Mac OS X) {zcode}

• Python

  Wiki Markup
  {zcode} export PYTHONPATH=/opt/Ice-3.4.2/python {zcode}

• Ruby

  Wiki Markup
  {zcode} export RUBYLIB=/opt/Ice-3.4.2/ruby {zcode}

• Java

  Wiki Markup
  {zcode} export CLASSPATH=/opt/Ice-3.4.2/lib/Ice.jar:=/opt/Ice-3.4.2/lib/Freeze.jar {zcode}

• Mono

  Wiki Markup
  {zcode} export MONO_PATH=/opt/Ice-3.4.2/bin {zcode}

  Ztop

Deprecated APIs in Ice 3.4.2

...