Welcome to OpenREM’s documentation!¶

Install Python 2.7.x¶

• Linux – likely to be installed already
• Windows – https://www.python.org/downloads

;C:\Python27\;C:\Python27\Scripts\

Setuptools and pip¶

Install setuptools and pip – for details go to http://www.pip-installer.org/en/latest/installing.html. The quick version is as follows:

Linux

Download the latest version using the same method as for Windows, or get the version in your package manager, for example:

sudo apt-get install python-pip

Windows

Download the installer script get-pip.py and save it locally – right click and Save link as... or equivalent.

Open a command window (Start menu, cmd.exe) and navigate to the place you saved the get‑pip.py file:

python get-pip.py

pip -V

Install RabbitMQ¶

(New for version 0.4.3)

• Linux - Follow the guide at http://www.rabbitmq.com/install-debian.html
• Windows - Follow the guide at http://www.rabbitmq.com/install-windows.html

For either install, just follow the defaults – no special configurations required.

Install latest beta version¶

pip install openrem

Will need ``sudo`` or equivalent if installing on linux without using a virtualenv

Configure¶

Locate install location

• Linux: /usr/local/lib/python2.7/dist-packages/openrem/ or /usr/lib/python2.7/site-packages/openrem/
• Windows: C:\Python27\Lib\site-packages\openrem\

There are two files that need renaming:

• openremproject/local_settings.py.example to openremproject/local_settings.py
• openremproject/wsgi.py.example to openremproject/wsgi.py

In the local_settings.py file, set the database details, the MEDIA_ROOT path, the secret key and the ALLOWED_HOSTS.

'ENGINE': 'django.db.backends.sqlite3',
'NAME': '/ENTER/PATH/WHERE/DB/FILE/CAN/GO',

MEDIA_ROOT = "/var/openrem/media/"

MEDIA_ROOT = "C:/Users/myusername/Documents/OpenREM/media/"

ALLOWED_HOSTS = [
    '192.168.56.102',
    '.doseserver.',
    'localhost',
]

Create the database¶

Linux:

python /usr/local/lib/python2.7/dist-packages/openrem/manage.py syncdb

Windows:

python C:\Python27\Lib\site-packages\openrem\manage.py syncdb

Answer each question as it is asked, do setup a superuser. This username and password wil be used to log into the admin interface to create the usernames for using the web interface. See the Start using it! section below.

python /usr/local/lib/python2.7/dist-packages/openrem/manage.py convert_to_south remapp

python C:\Python27\Lib\site-packages\openrem\manage.py convert_to_south remapp

Start test web server¶

Linux:

python /usr/local/lib/python2.7/dist-packages/openrem/manage.py runserver --insecure

Windows:

python C:\Python27\Lib\site-packages\openrem\manage.py runserver --insecure

If you are using a headless server and need to be able to see the web interface from another machine, use python /usr/lib/python2.7/dist-packages/openrem/manage.py runserver x.x.x.x:8000 --insecure (or Windows equivalent) replacing the x with the IP address of the server and 8000 with the port you wish to use.

Open the web addesss given, appending /openrem (http://localhost:8000/openrem)

Start the Celery task queue¶

(New for version 0.4.3)

Celery will have been automatically installed with OpenREM, and along with RabbitMQ allows for asynchronous task processing for imports and exports.

In a new shell:

Linux:

cd /usr/local/lib/python2.7/dist-packages/openrem/
celery -A openremproject worker -l info

Windows:

cd C:\Python27\Lib\site-packages\openrem\
celery -A openremproject worker -l info

For production use, see Daemonising Celery below

Start using it!¶

Add some data!

openrem_rdsr.py rdsrfile.dcm

Add some users (New in version 0.4.0)

• Go to the admin interface (eg http://localhost:8000/admin) and log in with the user created when you created the database (syncdb)

• Create some users and add them to the appropriate groups (if there are no groups, go to the OpenREM homepage and they should be created).

  • viewgroup can browse the data only
  • exportgroup can do as view group plus export data to a spreadsheet
  • admingroup can delete studies and import height and weight data in addition to anything the export group can do

• Return to the OpenREM interface (eg http://localhost:8000/openrem) and log out of the superuser in the top right corner and log in again using one of the new users you have just created.

Database options¶

SQLite is great for getting things running quickly and testing if the setup works, but is really not recommended for production use on any scale. Therefore it is recommended to use a different database such as PostgreSQL or MySQL.

Here are instructions for installing PostgreSQL on linux and on Windows:

Database migrations¶

South is a django application to manage database migrations. Using South means that future changes to the database model can be calculated and executed automatically with simple commands when OpenREM is upgraded.

Production webservers¶

Unlike the database, the production webserver can be left till later and can be changed again at any time.

For performance it is recommended that a production webserver is used instead of the inbuilt ‘runserver’. Popular choices would be either Apache or you can do as the cool kids do and use Gunicorn with nginx.

The django website has instructions and links to get you set up with Apache.

Daemonising Celery¶

(New for version 0.4.3)

In a production environment, Celery will need to start automatically and not depend on a particular user being logged in. Therefore, much like the webserver, it will need to be daemonised. For now, please refer to the instructions and links at http://celery.readthedocs.org/en/latest/tutorials/daemonizing.html.

Virtualenv and virtualenvwrapper¶

If the server is to be used for more than one python application, or you wish to be able to test different versions of OpenREM or do any development, it is highly recommended that you use virtualenv or maybe virtualenvwrapper

Virtualenv sets up an isolated python environment and is relatively easy to use.

If you do use virtualenv, all the paths referred to in the documentation will be changed to:

• Linux: lib/python2.7/site-packages/openrem/
• Windows: Lib\site-packages\openrem

In Windows, even when the virtualenv is activated you will need to call python and provide the full path to script in the Scripts folder. If you call the script (such as openrem_rdsr.py) without prefixing it with python, the system wide Python will be used instead. This doesn’t apply to Linux, where once activated, the scripts can be called without a python prefix from anywhere.

Advanced guides for developers¶

Installing Apache on Windows Server 2012 with auto-restart¶

Note

Author JA Cole

These instructions are for installing OpenREM under Apache on Windows as a developers alternative to the built-in HTTP server. They have been written using Windows Server 2012, and feature automatic restarts of the Apache server when the code changes, much as the built-in server does.

Get and Install Apache¶

• Download the zip of the appropriate version from https://www.apachelounge.com/
• Extract the zip somewhere useful. For this guide we will assume C:\apache24\

Get and Install MOD_WSGI¶

• Download mod_wsgi that matches your Windows, Apache and Python versions from http://www.lfd.uci.edu/~gohlke/pythonlibs/#mod_wsgi

• Extract the mod_wsgi.so file to C:\apache24\modules\

• Add the following module C:\apache24\conf\httpd.conf:

  LoadModule wsgi_module modules/mod_wsgi.so
  

• At the end of C:\apache24\conf\httpd.conf add the following:

  WSGIScriptAlias / "c:/Python27/Lib/site-packages/openrem/openremproject/wsgi.py"
  WSGIPythonPath "c:/Python27/Lib/site-packages/openrem"
  
  <Directory "c:/Python27/Lib/site-packages/openrem/openremproject">
  <Files wsgi.py>
  Order deny,allow
  Require all granted
  </Files>
  </Directory>
  

Get and Install wsgi.py and monitor.py¶

Detailed instructions are available here: https://code.google.com/p/modwsgi/wiki/ReloadingSourceCode

• Change wsgi.py in the openrem/openremproject folder to the following

"""
WSGI config for OpenREM project.

This module contains the WSGI application used by Django's development server
and any production WSGI deployments. It should expose a module-level variable
named ``application``. Django's ``runserver`` and ``runfcgi`` commands discover
this application via the ``WSGI_APPLICATION`` setting.

Usually you will have the standard Django WSGI application here, but it also
might make sense to replace the whole Django WSGI application with a custom one
that later delegates to the Django one. For example, you could introduce WSGI
middleware here, or combine a Django application with an application of another
framework.

"""
import os
import sys

path = 'C:/Python27/Lib/site-packages/openrem'
if path not in sys.path:
sys.path.append(path)

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "openremproject.settings")

# Apply WSGI middleware here.

import django.core.handlers.wsgi
application = django.core.handlers.wsgi.WSGIHandler()

import openremproject.monitor
openremproject.monitor.start(interval=1.0)

• Create a file monitor.py in the openrem/openremproject folder with the following contents

# Code from the modwsgi wiki at https://code.google.com/p/modwsgi/wiki/ReloadingSourceCode
# Copyright 2007-2011 GRAHAM DUMPLETON
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#     http://www.apache.org/licenses/LICENSE-2.0
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#


import os
import sys
import time
import signal
import threading
import atexit
import Queue

_interval = 1.0
_times = {}
_files = []

_running = False
_queue = Queue.Queue()
_lock = threading.Lock()

def _restart(path):
    _queue.put(True)
    prefix = 'monitor (pid=%d):' % os.getpid()
    print >> sys.stderr, '%s Change detected to \'%s\'.' % (prefix, path)
    print >> sys.stderr, '%s Triggering Apache restart.' % prefix
    import ctypes
    ctypes.windll.libhttpd.ap_signal_parent(1)

def _modified(path):
    try:
        # If path doesn't denote a file and were previously
        # tracking it, then it has been removed or the file type
        # has changed so force a restart. If not previously
        # tracking the file then we can ignore it as probably
        # pseudo reference such as when file extracted from a
        # collection of modules contained in a zip file.

        if not os.path.isfile(path):
            return path in _times

        # Check for when file last modified.

        mtime = os.stat(path).st_mtime
        if path not in _times:
            _times[path] = mtime

        # Force restart when modification time has changed, even
        # if time now older, as that could indicate older file
        # has been restored.

        if mtime != _times[path]:
            return True
    except:
        # If any exception occured, likely that file has been
        # been removed just before stat(), so force a restart.

        return True

    return False

def _monitor():
    while 1:
        # Check modification times on all files in sys.modules.

        for module in sys.modules.values():
            if not hasattr(module, '__file__'):
                continue
            path = getattr(module, '__file__')
            if not path:
                continue
            if os.path.splitext(path)[1] in ['.pyc', '.pyo', '.pyd']:
                path = path[:-1]
            if _modified(path):
                return _restart(path)

        # Check modification times on files which have
        # specifically been registered for monitoring.

        for path in _files:
            if _modified(path):
                return _restart(path)

        # Go to sleep for specified interval.

        try:
            return _queue.get(timeout=_interval)
        except:
            pass

_thread = threading.Thread(target=_monitor)
_thread.setDaemon(True)

def _exiting():
    try:
        _queue.put(True)
    except:
        pass
    _thread.join()

atexit.register(_exiting)

def track(path):
    if not path in _files:
        _files.append(path)

def start(interval=1.0):
    global _interval
    if interval < _interval:
        _interval = interval

    global _running
    _lock.acquire()
    if not _running:
        prefix = 'monitor (pid=%d):' % os.getpid()
        print >> sys.stderr, '%s Starting change monitor.' % prefix
        _running = True
        _thread.start()
_lock.release()

Install Micosoft C++ Distributable¶

Install the microsoft C++ distributable making sure the version number matches the version number for the apache and mod_wsgi downloads. http://www.microsoft.com/en-us/download/details.aspx?id=30679#

Optional: Install apache as a service¶

Run a terminal as administrator.:

c:\apache24\bin\httpd -k install

Setup the URLs¶

Add the following to the openrem urls.py file:

from django.conf import settings
if settings.DEBUG:
    urlpatterns += patterns('django.contrib.staticfiles.views',
        url(r'^static/(?P<path>.*)$', 'serve'),
    )

Collect the static files¶

Collect your static files by running:

python manage.py collectstatic

If this fails because openrem lacks a static folder either copy the static folder from remapp to the openrem directory, adjust the openrem settings or set up a link. To setup a link run:

mklink /D c:\python27\lib\site-packages\openrem\static c:\python27\lib\site-packages\openrem\remapp\static

Upgrading from version 0.3.9 or earlier¶

• Back up your database

  • For PostgreSQL you can refer to Backing up a PostgreSQL database
  • For a non-production SQLite3 database, simply make a copy of the database file

• pip install openrem==0.4.2

• Migrate the schema

  # Linux: Debian/Ubuntu and derivatives
  python /usr/local/lib/python2.7/dist-packages/openrem/manage.py schemamigration --auto remapp
  # Linux: other distros. In a virtualenv replace all up to lib/ as appropriate
  python /usr/local/lib/python2.7/site-packages/openrem/manage.py schemamigration --auto remapp
  # Windows:
  python C:\Python27\Lib\site-packages\openrem\manage.py schemamigration --auto remapp
  

  When South has considered the changes to the schema, you will see the following message:

  ? The field 'Observer_context.device_observer_name' does not have a default specified, yet is NOT NULL.
  ? Since you are making this field nullable, you MUST specify a default
  ? value to use for existing rows. Would you like to:
  ?  1. Quit now.
  ?  2. Specify a one-off value to use for existing columns now
  ?  3. Disable the backwards migration by raising an exception; you can edit the migration to fix it later
  ? Please select a choice: 3
  

  • As per the final line above, please select option 3, and then execute the migration:

  # Linux: Debian/Ubuntu and derivatives
  python /usr/local/lib/python2.7/dist-packages/openrem/manage.py migrate remapp
  # Linux: other distros. In a virtualenv replace all up to lib/ as appropriate
  python /usr/local/lib/python2.7/site-packages/openrem/manage.py migrate remapp
  
  # Windows, assuming no virtualenv
  python C:\Python27\Lib\site-packages\openrem\manage.py migrate remapp
  

• Create and populate the database settings in the new local_settings.py file

  The openrem/openrem folder can be found at:

  # Linux: Debian/Ubuntu and derivatives
  /usr/lib/python2.7/dist-packages/openrem/openrem
  # Linux: other distros. In a virtualenv replace all up to lib/ as appropriate
  /usr/lib/python2.7/site-packages/openrem/openrem
  # Windows:
  C:\Python27\Lib\site-packages\openrem\openrem
  

  In the openrem/openrem folder, create a new file called local_settings.py and copy the contents of this link into a the file and save it. Alternatively, rename local_settings.py.example to local_settings.py - this is an older version of the file.

  Copy the database details from settings.py into local_settings.py

• Change the secret key - you can use http://www.miniwebtool.com/django-secret-key-generator/ to generate a new one

• Move the existing settings.py out of the python directories (delete or move somewhere as a backup)

• Rename the settings.py.new to settings.py

• Restart your webserver to check everything looks ok

• Add some users

  • Go to the admin interface (eg http://localhost:8000/admin) and log in with the user created when you originally created the database (the manage.py syncdb command - Do you want to create a superuser)

  • Create some users and add them to the appropriate groups (if there are no groups, go to the OpenREM homepage and they should be there when you go back to admin).

    • viewgroup can browse the data only
    • exportgroup can do as view group plus export data to a spreadsheet, and will be able to import height and weight data in due course (See Issue #21)
    • admingroup can delete studies in addition to anything the export group can do

Upgrading from versions 0.4.0 - 0.4.2¶

• Back up your database

  • For PostgreSQL you can refer to Backing up a PostgreSQL database
  • For a non-production SQLite3 database, simply make a copy of the database file

• Install version 0.5.0

  • pip install openrem==0.5.0

• Install RabbitMQ

  • Linux - Follow the guide at http://www.rabbitmq.com/install-debian.html
  • Windows - Follow the guide at http://www.rabbitmq.com/install-windows.html

• Move local_settings.py details from openrem to openremproject

  The inner openrem Django project folder has now been renamed openremproject The customised local_settings.py file and the wsgi.py file have remain in the old openrem folder. The openrem/openrem folder can be found as detailed in the upgrade from ‘0.3.9 or earlier’ instructions above, and the new openrem/openremproject folder is in the same place.

  • Move local_settings.py to openremproject. If you have kept the older local_settings file, you may like to instead rename the local_settings.py.example file instead, then transfer the database settings and change the secret key.
  • Set the path for MEDIA_ROOT. The webserver needs to be able to write to this location - it is where OpenREM will store export files etc so that they can be downloaded. For suggestions, see the main _install instructions.
  • Set ALLOWED_HOSTS. For details see the Django docs A '*' allows any host - see the Django docs for the risk of this.

• Move wsgi.py from openrem to openremproject or rename wsgi.py.example in openremproject

  If you haven’t edited it, simply rename the new version in openremproject. Otherwise, move the old version and edit the following line as follows:

  # Old:
  os.environ.setdefault("DJANGO_SETTINGS_MODULE", "openrem.settings")
  # New:
  os.environ.setdefault("DJANGO_SETTINGS_MODULE", "openremproject.settings")
  

• Tidying up - you should delete the old openrem folder - you might like to take a backup first!

• Update web server configuration

  The configuration of the webserver will need to be updated to reflect the new location for the settings.py file and the wsgi.py file.

  If you are using the built-in test webserver, static files will no-longer be served unless you use the insecure option:

  python manage.py runserver x.x.x.x:8000 --insecure
  

• Migrate the schema

  # Linux: Debian/Ubuntu and derivatives
  python /usr/local/lib/python2.7/dist-packages/openrem/manage.py schemamigration --auto remapp
  python /usr/local/lib/python2.7/dist-packages/openrem/manage.py migrate remapp
  # Linux: other distros. In a virtualenv replace all up to lib/ as appropriate
  python /usr/local/lib/python2.7/site-packages/openrem/manage.py schemamigration --auto remapp
  python /usr/local/lib/python2.7/site-packages/openrem/manage.py migrate remapp
  # Windows:
  python C:\Python27\Lib\site-packages\openrem\manage.py schemamigration --auto remapp
  python C:\Python27\Lib\site-packages\openrem\manage.py migrate remapp
  

After restarting the webserver, you should now have OpenREM 0.5.0 up and running. If you wish to test export functionality at this stage, start the Celery task queue - instructions in the Installation instructions docs or at the end of this guide.

Now move to Upgrading from version 0.5.0.

Upgrading from version 0.4.3¶

• Back up your database

  • For PostgreSQL you can refer to Backing up a PostgreSQL database
  • For a non-production SQLite3 database, simply make a copy of the database file

• The 0.5.1 upgrade must be made from a 0.5.0 database, so a schema migration is required:

  pip install openrem==0.5.0
  
      # Linux: Debian/Ubuntu and derivatives
      python /usr/local/lib/python2.7/dist-packages/openrem/manage.py schemamigration --auto remapp
      python /usr/local/lib/python2.7/dist-packages/openrem/manage.py migrate remapp
      # Linux: other distros. In a virtualenv replace all up to lib/ as appropriate
      python /usr/local/lib/python2.7/site-packages/openrem/manage.py schemamigration --auto remapp
      python /usr/local/lib/python2.7/site-packages/openrem/manage.py migrate remapp
      # Windows:
      python C:\Python27\Lib\site-packages\openrem\manage.py schemamigration --auto remapp
      python C:\Python27\Lib\site-packages\openrem\manage.py migrate remapp
  

Restart the web server¶

If you are using the built-in test web server (not for production use):

python manage.py runserver x.x.x.x:8000 --insecure

Otherwise restart using the command for your web server

Restart the Celery task queue¶

For testing, in a new shell:

# Linux: Debian/Ubuntu and derivatives
cd /usr/local/lib/python2.7/dist-packages/openrem/
# Linux: other distros. In a virtualenv replace all up to lib/ as appropriate
cd /usr/local/lib/python2.7/site-packages/openrem/
# Windows
cd C:\Python27\Lib\site-packages\openrem\

# All
celery -A openremproject worker -l info

For production use, see http://celery.readthedocs.org/en/latest/tutorials/daemonizing.html

Version specific information¶

OpenREM Release Notes version 0.5.0¶

Headline changes¶

• Import, display and export of CR/DX data from image headers
• Export of study data from fluoroscopy to xlsx files
• Importing data from Windows using *.dcm style wildcards
• Hologic tomography projection images are no longer excluded if part of a Combo exposure

Specific upgrade instructions¶

Always make sure you have converted your database to South before attempting an upgrade

Quick reminder of how, if you haven’t done it already:

Linux:

python /usr/local/lib/python2.7/dist-packages/openrem/manage.py convert_to_south remapp

Windows:

python C:\Python27\Lib\site-packages\openrem\manage.py convert_to_south remapp

Upgrading from versions before 0.4.3¶

If you are upgrading from 0.3.9 or earlier, you will need to upgrade to version 0.4.2 first. See the OpenREM Release Notes version 0.4.3.

If you are upgrading from 0.4.0 or later, the instructions in OpenREM Release Notes version 0.4.3 still need to be followed to install/setup RabbitMQ and Celery and to update the configuration files, but you can go straight to 0.5.0 rather than installing 0.4.3.

Upgrading from version 0.4.3¶

pip install openrem==0.5.0

(Will need sudo or equivalent if using linux without a virtualenv)

Database migration¶

Assuming no virtualenv

Linux:

python /usr/local/lib/python2.7/dist-packages/openrem/manage.py schemamigration --auto remapp
python /usr/local/lib/python2.7/dist-packages/openrem/manage.py migrate remapp

Windows:

C:\Python27\Lib\site-packages\openrem\manage.py schemamigration --auto remapp
C:\Python27\Lib\site-packages\openrem\manage.py migrate remapp

Restart the web server¶

If you are using the built-in test web server (not for production use):

python manage.py runserver x.x.x.x:8000 --insecure

Otherwise restart using the command for your web server

Restart the Celery task queue¶

For testing, in a new shell: (assuming no virtualenv)

Linux:

cd /usr/local/lib/python2.7/dist-packages/openrem/
celery -A openremproject worker -l info

Windows:

cd C:\Python27\Lib\site-packages\openrem\
celery -A openremproject worker -l info

For production use, see http://celery.readthedocs.org/en/latest/tutorials/daemonizing.html

OpenREM Release Notes version 0.4.3¶

Headline changes¶

• Export of study information is now handled by a task queue - no more export time-outs.
• Patient size information in csv files can now be uploaded and imported via a web interface.
• Proprietary projection image object created by Hologic tomography units can now be interrogated for details of the tomosynthesis exam.
• Settings.py now ships with its proper name, this will overwrite important local settings if upgrade is from 0.3.9 or earlier.
• Time since last study is no longer wrong just because of daylight saving time!
• Django release set to 1.6; OpenREM isn’t ready for Django 1.7 yet
• The inner openrem Django project folder is now called openremproject to avoid import conflicts with Celery on Windows
• DEBUG mode now defaults to False

Specific upgrade instructions¶

Always make sure you have converted your database to South before attempting an upgrade

Quick reminder of how, if you haven’t done it already:

Linux:

python /usr/local/lib/python2.7/dist-packages/openrem/manage.py convert_to_south remapp

Windows:

python C:\Python27\Lib\site-packages\openrem\manage.py convert_to_south remapp

Upgrading from 0.3.9 or earlier¶

It is essential that you upgrade to at least 0.4.0 first, then upgrade to 0.4.3. Otherwise the settings file will be overwritten and you will lose your database settings. There is also a trickier than usual database migration and instructions for setting up users. Fresh installs should start with the latest version.

Upgrade to version 0.4.2

pip install openrem==0.4.2

(Will need sudo or equivalent if using linux without a virtualenv)

Then follow the instructions in OpenREM Release Notes version 0.4.0 from migrating the database onwards, before coming back to these instructions.

Upgrading from 0.4.0 or above¶

Install OpenREM version 0.4.3¶

pip install openrem==0.4.3

(Will need sudo or equivalent if using linux without a virtualenv)

RabbitMQ¶

The message broker RabbitMQ needs to be installed to enable the export and upload features

• Linux - Follow the guide at http://www.rabbitmq.com/install-debian.html
• Windows - Follow the guide at http://www.rabbitmq.com/install-windows.html

Move and edit local_settings.py file and wsgi.py files¶

The inner openrem Django project folder has now been renamed openremproject to avoid import confusion that prevented Celery working on Windows.

When you upgrade, the local_settings.py file and the wsgi.py file will remain in the old openrem folder. Both need to be moved across to the openremproject folder, and edited as below.

The new and old folders will be found in:

• Linux: /usr/local/lib/python2.7/dist-packages/openrem/
• Linux with virtualenv: /home/myname/openrem/lib/python2.7/site-packages/openrem/
• Windows: C:\Python27\Lib\site-packages\openrem\

Edit the local_settings.py file¶

The MEDIA_ROOT path needs to be defined. This is the place where the study exports will be stored for download and where the patient size information csv files will be stored temporarily whilst they are bing processed.

The path set for MEDIA_ROOT is up to you, but the user that runs the webserver must have read/write access to the location specified because it is the webserver than reads and writes the files. In a debian linux, this is likely to be www-data for a production install. Remember to use forward slashes in the config file, even for Windows.

Linux example:

MEDIA_ROOT = "/var/openrem/media/"

Windows example:

MEDIA_ROOT = "C:/Users/myusername/Documents/OpenREM/media/"

The ALLOWED_HOSTS needs to be defined, as the DEBUG mode is now set to False. This needs to contain the server name or IP address that will be used in the URL in the web browser. For example:

ALLOWED_HOSTS = [
    '192.168.56.102',
    '.doseserver.',
    'localhost',
]

A dot before a hostname allows for subdomains (eg www.doseserver), a dot after a hostname allows for FQDNs (eg doseserver.ad.trust.nhs.uk). Alternatively, a single '*' allows any host, but removes the security the feature gives you.

Edit the wsgi.py file with the new project folder name¶

If you aren’t using the wsgi.py file as part of your webserver setup, you might like to simply rename the wsgi.py.example file in the openremproject folder.

If you are using it, edit the line:

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "openrem.settings")

to read:

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "openremproject.settings")

Tidying up¶

Finally, you should delete the old openrem folder - you might like to take a backup first!

Database migration¶

Assuming no virtualenv

Linux:

python /usr/local/lib/python2.7/dist-packages/openrem/manage.py schemamigration --auto remapp
python /usr/local/lib/python2.7/dist-packages/openrem/manage.py migrate remapp

Windows:

C:\Python27\Lib\site-packages\openrem\manage.py schemamigration --auto remapp
C:\Python27\Lib\site-packages\openrem\manage.py migrate remapp

Web server¶

If you are using a production webserver, you will probably need to edit some of the configuration to reflect the change in location of settings.py, for example DJANGO_SETTINGS_MODULE = openremproject.settings, and then restart the web server. You may need to do something similar for the location of wsgi.py.

If you are using the built-in test web server (not for production use), then the static files will not be served unless you add --insecure to the command. This is one of the consequences of setting DEBUG to False:

python manage.py runserver x.x.x.x:8000 --insecure

Start the Celery task queue¶

Note

The webserver and Celery both need to be able to read and write to the MEDIA_ROOT location. Therefore you might wish to consider starting Celery using the same user or group as the webserver, and setting the file permissions accordingly.

For testing, in a new shell: (assuming no virtualenv)

Linux:

cd /usr/local/lib/python2.7/dist-packages/openrem/
celery -A openremproject worker -l info

Windows:

cd C:\Python27\Lib\site-packages\openrem\
celery -A openremproject worker -l info

For production use, see http://celery.readthedocs.org/en/latest/tutorials/daemonizing.html

OpenREM Release Notes version 0.4.2¶

Headline changes¶

• This release fixes a major bug introduced in 0.4.0 regarding the import scripts.

Specific upgrade instructions¶

Upgrading from 0.3.9 or earlier¶

Follow the instructions in OpenREM Release Notes version 0.4.0

Upgrading from 0.4.0 or above¶

Move straight to version 0.4.3 and follow the instructions in OpenREM Release Notes version 0.4.3

OpenREM Release Notes version 0.4.1¶

Headline changes¶

• This release is exacly the same as 0.4.1 bar some documentation corrections

Specific upgrade instructions¶

Please use the 0.4.0 release notes for upgrades from 0.3.9

OpenREM Release Notes version 0.4.0

OpenREM Release Notes version 0.4.0¶

Headline changes¶

• User authentication has been added
• Studies can be deleted from the web interface
• Import scripts can now be passed a list of files, eg python openrem_rdsr.py *.dcm
• Date of birth no longer retained for mammography (bug fix - correct behaviour already existed for other imports)
• General bug fixes to enable import from wider range of sources
• Improved user documentation

Specific upgrade instructions¶

• pip install openrem==0.4.2 Go straight to 0.4.2

• Migrate the database

  Warning

  A database migration is required that will need a choice to be made

  • Linux: python /usr/lib/python2.7/dist-packages/openrem/manage.py schemamigration --auto remapp
  • Windows: C:\Python27\Lib\site-packages\openrem\manage.py schemamigration --auto remapp

  When South has considered the changes to the schema, you will see the following message:

  ? The field 'Observer_context.device_observer_name' does not have a default specified, yet is NOT NULL.
  ? Since you are making this field nullable, you MUST specify a default
  ? value to use for existing rows. Would you like to:
  ?  1. Quit now.
  ?  2. Specify a one-off value to use for existing columns now
  ?  3. Disable the backwards migration by raising an exception; you can edit the migration to fix it later
  ? Please select a choice: 3
  

  As per the final line above, the correct choice is 3. The fields that are now nullable previously weren’t. Existing data in those fields will have a value, or those tables don’t exist in the current database. The problem scenario is if after the migration these tables are used and one of the new nullable fields is left as null, you will not be able to migrate back to the old database schema without error. This is not something that you will want to do, so this is ok.

  Do the migration:

  • Linux: python /usr/lib/python2.7/dist-packages/openrem/manage.py migrate remapp
  • Windows: C:\Python27\Lib\site-packages\openrem\manage.py migrate remapp

• Update the settings files

  Warning

  The settings file has changed and will need to be manually edited.

  Changes need to be made to the settings.py file where the database details are stored. Normally upgrades don’t touch this file and the copy in the upgrade has a .example suffix. This upgrade and potentially future ones will need to change this file, so the format has been changed. The settings.py file will now be replaced each time the code is upgraded. In addition, there is a new local_settings.py file that contains things that are specific to your installation, such as the database settings.

  This upgrade will include a file called settings.py.new and the local_settings.py.example file. You will need to do the following:

  • Copy the database settings from your current settings.py file to the local_settings.py.example file and rename it to remove the .example. Both of these files are in the openrem/openrem directory, which will be somewhere like
    • Linux: /usr/lib/python2.7/dist-packages/openrem/openrem/
    • Windows: C:\Python27\Lib\site-packages\openrem\openrem\
  • Move the existing settings.py out of the python directories
  • Rename the settings.py.new to settings.py

• Create a new secret key

  All versions of openrem ship with the same secret key. This key is used for web security checks, and should be unique (and secret) for each installation.

  • Generate a new secret key - http://www.miniwebtool.com/django-secret-key-generator/ is a suitable method of creating a new key.
  • Copy the new key and use it to replace the default key in the local_settings.py file

• Restart your webserver

• Add some users

  • Go to the admin interface (eg http://localhost:8000/admin) and log in with the user created when you originally created the database (manage.py syncdb)

  • Create some users and add them to the appropriate groups (if there are no groups, go to the OpenREM homepage and they should be created).

    • viewgroup can browse the data only
    • exportgroup can do as view group plus export data to a spreadsheet, and will be able to import height and weight data in due course (See Issue #21)
    • admingroup can delete studies in addition to anything the export group can do

Radiation Dose Structured Reports¶

openrem_rdsr.py filename.dcm

You can use wildcards to process a number of files at once, ie:

openrem_rdsr.py *.dcm

For mammography DICOM images¶

openrem_mg.py filename.dcm

The facility for extracting dose information from mammography DICOM images has been designed and tested with images created with the GE Senographe DS. It has now been tested in a limited fashion with the images generated by the following systems:

• GE Senographe Essential
• Hologic Selenia
• Siemens Inspiration

See Mammography module for testing restrictions.

For radiographic DICOM images¶

openrem_dx.py filename.dcm

It is now possible with OpenREM version 0.5.0 to import dose information from DX and CR images from digital radiography units. As yet, it hasn’t been tested extensively.

For CT dose summary files from Philips CT scanners¶

openrem_ctphilips.py filename.dcm

Patient height and weight information¶

If height and weight data is not available in the DICOM data, but is available from another source, then it can be imported into the database using the openrem_ptsizecsv.py function. Normally the key to match the size information with the studies in the database will be the accession number; however in some situations this isn’t available and the Study Instance UID can be used instead.

usage:

openrem_ptsizecsv.py [-h] [-u] [-v] csvfile id height weight

-h, --help

Print the help text.

-u, --si-uid

Use Study Instance UID instead of Accession Number.

-v, --verbose

New in 0.3.7 Print to the standard output the success or otherwise of inserting each value.

csvfile

csv file containing the height and/or weight information and study identifier. Other columns will be ignored. Use quotes if the filepath has spaces.

id

Column title for the accession number or study instance UID. Use quotes if the title has spaces.

height

Column title for the patient height (DICOM size) - if this information is missing simply add a blank column with a suitable title. Use quotes if the title has spaces.

weight

Column title for the patient weight - if this information is missing simply add a blank column with a suitable title. Use quotes if the title has spaces.