Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Installing the OSHIP framework on MS Windows XP & Vista (tested on both, with Grok 0.14)

The original install guide was contributed by Alessandro Torrisi.

Prerequisites

Python2.5 (tested with version 2.5.2)OSHIP requires at least Python 2.5; if it is not already installed on your system, you can download an installer fromhttp://www.python.org.

We assume it is installed for all users in the default directory C:\python25. You don't need to specify the full path of the Python binary every time you need it. Just add the directoriesC:\Python25andC:\Python25\Scriptsto your environment variable%PATH%. See the instructions to do so at:How do I set or change the PATH system

Download the executable setuptools from the Python Package Index  setuptools-0.6c9.win32-py2.5.exe

setuptools-0.6c9.win32-py2.5.exe

After installing, verify that C:\Python25\Scripts now contains the file easy_install.exe.

virtualenv -- In order to prevent your OSHIP project interfering with your other never-ending projects, we advice you to work in separate environments. Virtualenv can be used to create isolated environments.In a cmd window, type:

easy_install virtualenv

Verify that C:\Python25\Scripts now contains the filevirtualenv.exe

Install a bazaar client.

Installation steps (tested with Grok 1.0a1)

  1. First, open a cmd window, create the isolated OSHIP environment, and activate it. We assume that we start in the root folder C:\ virtualenv oshipenv
    cd oshipenv
    Scripts\activate.bat
    Check that your system prompt is now prefixed with (oshipenv)  e.g. (oshipenv) C:\oshipenv>
  2. Then, install the buildout-machinery. easy_install zc.buildout
  3. We provide you with a buildout recipe in the file buildout.cfg. We store this, and other files, on our subversion server. Use the svn checkout command to obtain your own working copy in the to be created subfolder oship. svn co http://www.openehr.org/svn/ref_impl_python/TRUNK/oship
  4. Now it's time for a chat at the coffee machine. Meanwhile, let buildout create your project: cd oship
    buildout
    All of the required Python eggs will be downloaded and installed.
    Alas, the process fails currently. We need to take refuge to this work-around: After the error occurs (I assume here it is tyring to install zope.app.testing with version 3.4.3), type the command easy_install zope.app.testing==3.4.3
    and wait. This will run until the following error occurs (when trying to install zope.app.container):
    error: Setup script exited with error: Python was built with Visual Studio version 7.1, and extensions need to be built with the same version of the compiler, but it isn't installed.

Duh. Let's continue with the buildout: buildout
Buildout will now halt at package zope.app.file, so jump again through the hoop: easy_install zope.app.file==3.4.4
where, again, the version number 3.4.4 is taken from the error message. Wait some more for the Visual Studio error to reoccur, and invoke buildout one more time: buildout
This time it will finish gracefully.

  1. Finally, you have a working OSHIP installation. You can start the server with bin/zopectl fg
    Verify it is up by visiting http://localhost:8080 in your browser. The login link is on the upper right side of the browser window. login=admin password=abc123

Once the server is running you will need to add the application 'oship' in the form provided. Then change your URL to http://localhost:8080/oship.

Now you should have a browser that looks pretty much like this.

  • No labels