Clarify Ice PATH requirements in docs

[jamoore]

See: http://www.openmicroscopy.org/community/viewtopic.php?f=5&t=799

Showing all the possible ways that PATH may need to be modified in order to have icegridnode and glacier2router available could be difficult. Any ideas, guys, on the best way to do it? (Note: I think the snippet there currently is wrong since it adds ICE_HOME rather than something like ICE_HOME/bin to the PATH).

Another idea might be to tell users to run "bin/omero admin diagnostics" BEFORE running "bin/omero admin start" at least until #6980 is fixed.

[szwells]

Have added $ICE_HOME/bin to the $PATH statement in the example doc. Obviously on Mac OS X this would be a different location. I will add a note to suggest that omero admin diagnostics be run first. This is probably a good idea regardless of whether #6980 is fixed or not. Agreed that getting all of the potential prerequisite paths for OS X into the documentation will be difficult given the various ways in which it is installed. What I will do for now is to make some clarifications to the existing documentation, perhaps with an example of $ENV settings for OS X using the Glencoe ice build. I will then close the ticket as we can always re-open if this is insufficient or if a similar problem is raised again in the forums.

As an aside, one longer term solution might be to update the current docs in the short term but identify a single particular, robust, install method for each platform, e,g homebrew on OS X, as the supported installation path rather than the current mix of src, macports, pre-built software which appears to be increasingly flaky and complex.

[szwells]

I have added a short section to ​https://www.openmicroscopy.org/site/support/omero4/server/installation

that explains how to use the following shell command to identify the location of the icegridnode file:

$ find / -name "icegridnode" 2>/dev/null

The page then explains how to add the discovered location so that the correct $ICE_HOME value is set.

[jmoore]

Simon, I'm reopening because a find / -name icegridnode could take a substantial time on some systems, so it seems like at least attempting a which icegridnode first would be useful.

[szwells]

You're absolutely right. I forgot about the which command. I had considered locate but few OS X users update their db on a regular basis. Find was the next alternative but, as you say, it could take a while to run. Will add which before the find suggestion.

[szwells]

Added which command & streamlined the discussion of find. Also added a suggestion to use the forums if which fails.