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