<div dir="ltr">Hi everyone,<div><br></div><div>Following up on some discussion in devteam, there are some changes I think we should make to the docs to make installation of OMERO easier on OS X.</div><div><br></div><div>My use case is "install OMERO on OS X, as easily and quickly as possible."</div><div><br></div><div>More specifically, I need an installation for developer testing, so don't need a production web server, automatically started server, or any of that. But that's secondary...</div><div><br></div><div>Currently there are two relevant guides:</div><div><br></div><div>1) The Homebrew guide - <a href="https://www.openmicroscopy.org/site/support/omero5.1/sysadmins/unix/server-install-homebrew.html">https://www.openmicroscopy.org/site/support/omero5.1/sysadmins/unix/server-install-homebrew.html</a></div><div><br></div><div>2) The Unix guide - <a href="https://www.openmicroscopy.org/site/support/omero5.1/sysadmins/unix/server-installation.html">https://www.openmicroscopy.org/site/support/omero5.1/sysadmins/unix/server-installation.html</a></div><div><br></div><div>I figured the Homebrew approach would be the most painless on OS X, so I went for that. But, at the top of the page, it says:</div><div><br></div><div><div>> Note that this demonstrates how to install OMERO.server from the</div><div>> source code via Homebrew, in addition to all its prerequisites. The</div><div>> default instructions for UNIX platforms in the OMERO.server</div><div>> installation guide are all you need to install the prerequisites with</div><div>> Homebrew and then install the server zip from the downloads page or</div><div>> build from source.</div></div><div><br></div><div>Since I wanted to install OMERO from the binary distribution, and not from source, I then switched to the generic Unix guide.</div><div><br></div><div>The Homebrew guide mentions the fact that there is an ome tap, and that you can install the dependencies only (without omero itself) using:</div><div><br></div><div>  brew install omero --only-dependencies</div><div><br></div><div>However, the Unix guide does not mention this; instead, it lists all the dependencies individually (in boxes along with several other package managers).</div><div><br></div><div>It would have saved me time to use the invocation above, rather than manually installing everything by hand, had it occurred to me. In particular, the ice dependency _must_ be installed with the "--with-python" option, or else OMERO cannot talk to Ice via Python [1].</div><div><br></div><div>Given the large number of dependencies, my suggestion would be to streamline the information: purge the list of Homebrew deps, in favor of putting the ome tap front and center. In general, having installed/upgraded OMERO a few times recently on both Linux and OS X, my impression is that there are too many shell commands required, making it easy to encounter problems. The Homebrew tap is a great way to cut down on the amount of user interaction required to get things up and running.</div><div><br></div><div>Regards,</div><div>Curtis</div><div><br></div><div>P.S. Another great way to go would be Docker. It's awesome that boot2docker launches in 4 seconds on OS X.</div><div><br></div><div>[1] In this scenario, the omero CLI reports that the "installation is incomplete" because omero.cli cannot be imported, but does not identify the root cause: a failing "import Ice" command.</div><div><br></div></div>