Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Make Ice 3.4 the minimum supported version #760

Merged
merged 10 commits into from May 5, 2014
8 changes: 3 additions & 5 deletions omero/developers/GettingStarted/AdvancedClientDevelopment.txt
Expand Up @@ -10,7 +10,7 @@ Developing OMERO clients
- This page is intended for developers already familiar with
client/server programming. If you are not, **your best starting
point is to read the**
:zeroc:`Hello World <doc/Ice-3.3.0/manual/Hello.html#22064>`
:zerocdoc:`Hello World <display/Ice/Hello+World+Application>`
**chapter of the Ice manual (or more)**. A deeper understanding of
Ice might not be necessary, but certainly understanding the Ice
basics will make reading this guide **much** easier.
Expand Down Expand Up @@ -1183,8 +1183,8 @@ Example: :source:`examples/OmeroClients/smartpointers.cpp`
a boolean or integer/long context, returns 1 for true (i.e. non-null) or
0 for false (i.e. null). Be especially careful with the RTypes.

For more information, see :zeroc:`6.14.6 Smart Pointers for
Classes <doc/Ice-3.3.0/manual/Cpp.7.14.html>` in the
For more information, see :zerocdoc:`6.14.6 Smart Pointers for
Classes <display/Ice/Smart+Pointers+for+Classes>` in the
Ice manual, which also describes the ``Ice.GC.Interval`` parameter which
determines how often garbage collection runs in C++ to reap objects.
This is necessary with the |OmeroModel|
Expand Down Expand Up @@ -2396,5 +2396,3 @@ Other
``ome.model.*`` interfaces
- Annotation-link-loading can behave strangely if
``AnnotationLink.child`` is not loaded.
- Python applications can segfault under certain orderings of imports:
See :zeroc:`Bus Error under Mac OX 10.4 and IcePy 3.3.0 <forums/bug-reports/3883-bus-error-under-mac-ox-10-4-icepy-3-3-0-a.html>`
41 changes: 2 additions & 39 deletions omero/sysadmins/unix/server-install-homebrew.txt
Expand Up @@ -127,14 +127,7 @@ simple Homebrew install is sufficient, e.g.

This should install OMERO along with most of the non-Python requirements.

The default version of Ice installed by the OMERO formula is Ice 3.5. To
install OMERO with Ice 3.4, use::

$ brew install omero --with-ice34

or to install OMERO with Ice 3.3, use::

$ brew install omero --with-ice33
The default version of Ice installed by the OMERO formula is currently Ice 3.5.

Additional installation options can be listed using the ``info`` command:

Expand All @@ -155,14 +148,7 @@ install the OMERO dependencies:
$ brew tap ome/alt
$ brew install `brew deps omero`

The default version of Ice installed by the OMERO formula is Ice 3.5. To
install the OMERO dependencies with Ice 3.4, use::

$ brew install `brew deps omero --with-ice34`

or to install the OMERO dependencies with Ice 3.3, use::

$ brew install `brew deps omero --with-ice33`
The default version of Ice installed by the OMERO formula is currently Ice 3.5.

Prepare a place for your OMERO code to live, e.g.

Expand Down Expand Up @@ -234,14 +220,6 @@ required entries and correspond to a Homebrew installation of OMERO |release|:
export PYTHONPATH=$(brew --prefix omero)/lib/python
export PATH=/usr/local/bin:/usr/local/sbin:/usr/local/lib/node_modules:$PATH

If you have installed Ice 3.3 or Ice 3.4, you will need to specify the path to
Ice Python and dynamic libraries::

export PYTHONPATH=$(brew --prefix omero)/lib/python:$ICE_HOME/python
export DYLD_LIBRARY_PATH=$ICE_HOME/lib:$DYLD_LIBRARY_PATH

where ``ICE_HOME`` needs to be replaced by ``$(brew --prefix zeroc-ice33)`` or ``$(brew --prefix zeroc-ice34)`` depending on your configuration.

.. note::
If you have a local :file:`.bash_profile` file, it will override your
:file:`.profile` configuration file.
Expand Down Expand Up @@ -454,21 +432,6 @@ Try:
$ brew cleanup
$ brew link ossp-uuid

Ice
^^^

::

Error: Failed executing: cd cpp && make M PP_HOME=/Users/sebastien/apps/ OMERO.libs/Cellar/mcpp/2.7.2 DB_HOME=/Users/sebastien/apps/OMERO.libs/Cellar/berkeley- db46/4.6.21 OPTIMIZE=yes prefix=/Users/sebastien/apps/OMERO.libs/Cellar/zeroc-ice33/3.3 embedded_runpath_prefix=/Users/sebastien/apps/OMERO.libs/Cellar/zeroc-ice33/3.3 install

We have had problems building ``zeroc-ice33`` under MacOS 10.7.3 and 10.6.8
(see :ticket:`8075`). You can try installing ``zeroc-ice34`` (Ice 3.4)
instead. If you decide to go with ``zeroc-ice33``, make sure that you do not
have :envvar:`DYLD_LIBRARY_PATH` set to an existing Ice's installation lib
directory path. In essence your ``.bash_profile`` shouldn't have any
OMERO-related environment variables set before executing the installation
script.

szip
^^^^

Expand Down
83 changes: 38 additions & 45 deletions omero/sysadmins/unix/server-installation.txt
Expand Up @@ -71,7 +71,7 @@ The following packages are required:
+--------------+-------------+---------+
| Package | Recommended | Minimum |
+==============+=============+=========+
| Ice | 3.5 | 3.3 |
| Ice | 3.5 | 3.4 |
+--------------+-------------+---------+
| Java | 1.7 | 1.6 |
+--------------+-------------+---------+
Expand Down Expand Up @@ -238,11 +238,9 @@ Ice

.. note::

OMERO |version| supports Ice 3.3, 3.4 and 3.5 on UNIX and UNIX-like
platforms, but you must install the correct version of OMERO.server (see
:downloads:`Downloads <>`). See :faq_plone:`"Do I use Ice 3.3 or
Ice 3.4?" <omero/do-i-use-ice-3.3-or-ice-3.4>` in
the FAQ. If you have further questions, consult the :forum:`Forums <>`.
OMERO |version| supports 3.4 and 3.5 on UNIX and UNIX-like platforms,
but you must install the correct version of OMERO.server (see
:downloads:`Downloads <>`).

If possible, install one of the following packages:

Expand All @@ -266,8 +264,6 @@ and `Ubuntu <https://wiki.ubuntu.com/Releases>`_ are shown below:
| Distribution | ZeroC Ice version | OMERO version |
+========+==============+===================+===============+
| Debian | 7.0 | 3.4 | 4.4.x, 5.x.x |
| +--------------+-------------------+---------------+
| | 6.0 | 3.3 | 4.4.x, 5.0.x |
+--------+--------------+-------------------+---------------+
| Ubuntu | 14.04 (LTS) | 3.5 | 4.4.x, 5.x.x |
| +--------------+-------------------+---------------+
Expand Down Expand Up @@ -833,60 +829,57 @@ output of the diagnostics command:
OMERO Diagnostics |release|
================================================================================

Commands: java -version 1.6.0 (/usr/bin/java)
Commands: python -V 2.6.5 (/usr/bin/python)
Commands: icegridnode --version 3.3.1 (/usr/bin/icegridnode)
Commands: icegridadmin --version 3.3.1 (/usr/bin/icegridadmin)
Commands: psql --version 8.4.12 (/usr/bin/psql)
Commands: java -version 1.7.0 (/usr/bin/java)
Commands: python -V 2.7.6 (/usr/bin/python)
Commands: icegridnode --version 3.5.1 (/usr/bin/icegridnode)
Commands: icegridadmin --version 3.5.1 (/usr/bin/icegridadmin)
Commands: psql --version 9.1.13 (/usr/bin/psql)

Server: icegridnode running
Server: Blitz-0 active (pid = 28933, enabled)
Server: DropBox active (pid = 28951, enabled)
Server: FileServer active (pid = 28954, enabled)
Server: Indexer-0 active (pid = 28957, enabled)
Server: MonitorServer active (pid = 28960, enabled)
Server: OMERO.Glacier2 active (pid = 28962, enabled)
Server: OMERO.IceStorm active (pid = 28964, enabled)
Server: PixelData-0 active (pid = 28963, enabled)
Server: Processor-0 active (pid = 28972, enabled)
Server: Tables-0 active (pid = 28974, enabled)
Server: Blitz-0 active (pid = 30324, enabled)
Server: DropBox active (pid = 30343, enabled)
Server: FileServer active (pid = 30345, enabled)
Server: Indexer-0 active (pid = 30348, enabled)
Server: MonitorServer active (pid = 30351, enabled)
Server: OMERO.Glacier2 active (pid = 30353, enabled)
Server: OMERO.IceStorm active (pid = 30376, enabled)
Server: PixelData-0 active (pid = 30393, enabled)
Server: Processor-0 active (pid = 30394, enabled)
Server: Tables-0 inactive (disabled)
Server: TestDropBox inactive (enabled)

Log dir: /home/omero/OMERO.server-|version|
OMERO: SSL port 4064
OMERO: TCP port 4063

Log dir: /home/omero/OMERO.server-5.0.1-ice35-b21/var/log exists

Log files: Blitz-0.log 360.0 MB errors=9 warnings=2458
Log files: DropBox.log 3.0 KB errors=0 warnings=1
Log files: Blitz-0.log 3.0 MB errors=0 warnings=9
Log files: DropBox.log 4.0 KB errors=0 warnings=1
Log files: FileServer.log 0.0 KB
Log files: Indexer-0.log 506.0 KB errors=0 warnings=90
Log files: Indexer-0.log 10.0 KB errors=0 warnings=5
Log files: MonitorServer.log 2.0 KB
Log files: OMEROweb.log 710.0 KB errors=5 warnings=2
Log files: OMEROweb.log.1 777.0 KB errors=0 warnings=1
Log files: OMEROweb.log.2 776.0 KB errors=0 warnings=2
Log files: OMEROweb.log.3 777.0 KB
Log files: OMEROweb.log.4 879.0 KB errors=1 warnings=2
Log files: OMEROweb.log.5 258.0 KB
Log files: OMEROweb_request.log 10.0 KB errors=3 warnings=3
Log files: PixelData-0.log 4.0 KB
Log files: Processor-0.log 315.0 KB errors=0 warnings=1
Log files: Tables-0.log 2.0 KB errors=0 warnings=1
Log files: OMEROweb.log 642.0 KB errors=0 warnings=1
Log files: OMEROweb_request.log 0.0 KB
Log files: PixelData-0.log 7.0 KB errors=0 warnings=4
Log files: Processor-0.log 2.0 KB errors=0 warnings=1
Log files: Tables-0.log n/a
Log files: TestDropBox.log n/a
Log files: master.err 0.0 KB
Log files: master.err 0.0 KB errors=2 warnings=0
Log files: master.out 0.0 KB
Log files: Total size 365.49 MB

Parsing Blitz-0.log:[line:30] => Server restarted <=
Parsing Blitz-0.log:[line:213] => Server restarted <=
Log files: Total size 3.83 MB

Environment:OMERO_HOME=(unset)
Environment:OMERO_NODE=(unset)
Environment:OMERO_MASTER=(unset)
Environment:PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games
Environment:OMERO_TEMPDIR=(unset)
Environment:PATH=/usr/local/bin:/usr/bin:/bin
Environment:ICE_HOME=(unset)
Environment:LD_LIBRARY_PATH=(unset)
Environment:DYLD_LIBRARY_PATH=(unset)

OMERO data dir: '/OMERO' Exists? True Is writable? True
OMERO.web status... [RUNNING] (PID 28736)
OMERO data dir: '/OMERO' Exists? True Is writable? True
OMERO temp dir: '/home/omero/tmp' Exists? True Is writable? True (Size: 0)
OMERO.web status... DEVELOPMENT: You will have to check status by hand!

.. toctree::
:hidden:
Expand Down
95 changes: 58 additions & 37 deletions omero/sysadmins/windows/server-installation.txt
Expand Up @@ -23,10 +23,8 @@ users/passwords described in this install guide, please see
:width: 35%
:alt:

- Installation on Windows XP is not explicitly supported, especially
for OMERO.web. Significant testing has taken place on Windows Server
2008 and we recommend this version.
- OMERO does not currently support Ice 3.5 or Python 3.
- Significant testing has taken place on Windows Server 2008 and we
recommend this version.
- :doc:`/sysadmins/omeromovie` is not supported on Windows at present.
- A reboot is required after installing the prerequisites.

Expand All @@ -53,23 +51,20 @@ Java SE Development Kit (JDK)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Java SE Downloads are available from `<http://www.oracle.com/technetwork/java/javase/downloads/index.html>`_. JDK 6
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove the "JDK 6" at the end?

and above are supported.
Java 7 is recommended, Java 6 is supported.

Ice (3.3.x or 3.4.x)
^^^^^^^^^^^^^^^^^^^^
Ice
^^^

.. note::

OMERO 5.0 supports both Ice 3.3 and 3.4 for Windows. You will need to pick
the appropriate server download for the version of Ice
you have installed locally. The downloads for Ice 3.4 have "ice34" in the
zip name.
OMERO |version| supports Ice 3.5 and 3.4. You will need to pick the
matching server download for the version of Ice you have installed.

If you are using precompiled packages of Ice and Python (recommended)
you should use the versions specified below. In particular since OMERO
does not support Python 3 **it will not work with the Ice 3.5 package for
Windows**. If you have previously installed Ice 3.5 you should uninstall
it.
Windows**. However, Ice 3.5 will work when built against Python 2.7.


Windows installers of Ice can be found on the :zeroc:`ZeroC Ice 3.4.2 download
Expand Down Expand Up @@ -800,40 +795,66 @@ your server installation:

.. parsed-literal::

C:\\OMERO.server> bin\\omero admin diagnostics
C:\\opt\\OMERO.server> bin\\omero admin diagnostics

================================================================================
OMERO Diagnostics |release|
================================================================================

Commands: java -version 1.6.0 (C:\\WINDOWS\\system32\\java.EXE -- 3 others)
Commands: python -V 2.6 (C:\\Python26\\python.EXE)
Commands: icegridnode --version 3.3 (C:\\Ice-3.3.1\\bin\\x64\\icegridnode.EXE -- 2 others)
Commands: icegridadmin --version 3.3 (C:\\Ice-3.3.1\\bin\\x64\\icegridadmin.EXE -- 2 others)
Commands: psql --version 8.3 (C:\\Program Files (x86)\\PostgreSQL\\8.3\\bin\\psql.EXE -- 2 others)

Commands: java -version 1.8.0 (C:\\Program Files\\Java\\jdk1.7.0_51\\bin\\java.EXE -- 2 others)
Commands: python -V 2.7.6 (C:\\Python27\\python.EXE -- 2 others)
Commands: icegridnode --version 3.5.1 (c:\\opt\\Ice-3.5.1-win-x64-Release\\bin\\icegridnode.EXE)
Commands: icegridadmin --version 3.5.1 (c:\\opt\\Ice-3.5.1-win-x64-Release\\bin\\icegridadmin.EXE)
Commands: psql --version 9.3.4 (C:\\Program Files\\PostgreSQL\\9.3\\bin\\psql.EXE)

Server: icegridnode running
Server: Blitz-0 active (pid = 7704, enabled)
Server: DropBox active (pid = 8008, enabled)
Server: FSServer active (pid = 7088, enabled)
Server: Indexer-0 active (pid = 4728, enabled)
Server: OMERO.Glacier2 active (pid = 5456, enabled)
Server: OMERO.IceStorm active (pid = 800, enabled)
Server: Processor-0 active (pid = 7316, enabled)
Server: Tables-0 active (pid = 4420, enabled)
Server: Blitz-0 active (pid = 1384, enabled)
Server: DropBox inactive (disabled)
Server: FileServer inactive (disabled)
Server: Indexer-0 active (pid = 3872, enabled)
Server: MonitorServer inactive (disabled)
Server: OMERO.Glacier2 active (pid = 5744, enabled)
Server: OMERO.IceStorm active (pid = 3520, enabled)
Server: PixelData-0 active (pid = 3096, enabled)
Server: Processor-0 inactive (disabled)
Server: Tables-0 inactive (disabled)
Server: TestDropBox inactive (enabled)
Server: Web inactive (enabled)
Server: OMERO.master active (running as LocalSystem)

Log dir: C:\\hudson\\trunk\\dist\\var\\log exists
OMERO: SSL port 4064
OMERO: TCP port 4063

Log dir: C:\\opt\\OMERO.server-5.0.1-ice35-b21\\var\\log exists

Log files: Blitz-0.log 10.0 MB errors=4 warnings=26
Log files: DropBox.log 2.0 KB
Log files: FSServer.log 1.0 KB
Log files: Indexer-0.log 8.0 MB errors=18 warnings=1870
Log files: Blitz-0.log 38.0 KB
Log files: DropBox.log n/a
Log files: FileServer.log n/a
Log files: Indexer-0.log 64.0 KB errors=0 warnings=2

Log files: MonitorServer.log n/a
Log files: OMEROweb.log n/a
Log files: Processor-0.log 0.0 KB
Log files: Tables-0.log 0.0 KB
Log files: PixelData-0.log 3.0 KB errors=0 warnings=2

Log files: Processor-0.log n/a
Log files: Tables-0.log n/a
Log files: TestDropBox.log n/a
Log files: master.err 0.0 KB
Log files: master.err 1.0 KB errors=2 warnings=2

Log files: master.out 0.0 KB
Log files: Total size 18.94 MB
Log files: Total size 0.11 MB


Environment:OMERO_HOME=(unset)
Environment:OMERO_NODE=(unset)
Environment:OMERO_MASTER=(unset)
Environment:OMERO_TEMPDIR=(unset)
Environment:PATH=C:\\Program Files\\PostgreSQL\\9.3\\bin;C:\\Python27;c:\\opt\\Ice-3.5.1-win-x64-Release\\bin;C:\\Program Files\\Java\\jdk1.7.0_51\\bin;C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\
Environment:ICE_HOME=c:\\opt\\Ice-3.5.1-win-x64-Release
Environment:LD_LIBRARY_PATH=(unset)
Environment:DYLD_LIBRARY_PATH=(unset)

OMERO data dir: 'C:\\\\opt\\\\omerodata' Exists? True Is writable? True
OMERO temp dir: 'C:\\Users\\omero\\AppData\\Roaming\\omero\\tmp' Exists? True
Is writable? True (Size: 0)
OMERO.web status... [NOT STARTED]