OMERO

Downloads
Feature List
Licensing

Previous topic

OMERO.web walkthrough installation Ubuntu 16.04 and IcePy 3.6

Next topic

Installing additional features

This Page

Note

This documentation is for the new OMERO 5.3 version. See the latest OMERO 5.2.x version or the previous versions page to find documentation for the OMERO version you are using if you have not upgraded yet.

OMERO.web walkthrough installation Mac OS X and IcePy 3.6ΒΆ

For convenience in this walkthrough the main OMERO.web configuration options have been defined as environment variables. When following this walkthrough you can either use your own values, or alternatively source the following file:

OMERO_USER=
WEBPORT=80
WEBSERVER_NAME=localhost

Install Homebrew in /usr/local:

xcode-select --install


ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

brew update
brew doctor

Install other dependencies:

brew install python
pip install --upgrade virtualenv

Install VirtualEnv - optional (run as root):

virtualenv ~/omerowebvenv

Install OMERO.web (run as ):

cd ~
curl -o OMERO.py.zip -L https://downloads.openmicroscopy.org/latest/omero5.3/py.zip
unzip -q OMERO.py*

zip=$(ls OMERO.py*.zip)
rm -f $zip
ln -s OMERO.py-* OMERO.py

Install in the virtualenv created previously (run as root):

~/omerowebvenv/bin/pip install --upgrade -r ~/OMERO.py/share/web/requirements-py27-all.txt

Configure OMERO.web and generate nginx template (run as ):

source ~/omerowebvenv/bin/activate
# By default no value is set for WEBPREFIX but for example it can be set to /omero
if [[ $WEBPREFIX = *[!\ ]* ]]; then
    ~/OMERO.py/bin/omero config set omero.web.prefix "${WEBPREFIX}"
    ~/OMERO.py/bin/omero config set omero.web.static_url "${WEBPREFIX}/static/"
fi

~/OMERO.py/bin/omero config set omero.web.application_server wsgi-tcp
~/OMERO.py/bin/omero web config nginx --http "${WEBPORT}" --servername "${WEBSERVER_NAME}" > ~/nginx.conf.tmp

cat ~/nginx.conf.tmp

Install NGINX:

brew install nginx

cp ~/nginx.conf.tmp /usr/local/etc/nginx/servers/omeroweb-nginx.conf

# Restart webserver
brew services restart nginx

Start up services:

source ~/omerowebvenv/bin/activate

# Start OMERO.web
~/OMERO.py/bin/omero web start