UNIS and the MS (also included in this codebase) are a part of the Periscope measurement framework which also includes BLiPP. You can find more information about all these components here.

First, you’ll need a few basic things

$ sudo apt-get install python-setuptools python-dev

UNIS and the MS use MongoDB as their backend data store. Install it and start it in whatever way you like.

$ sudo apt-get install mongodb

You might also need swig

$ sudo apt-get install swig

Now run the setup script in top level of the repository. You can use --prefix or --install-dir to install it somewhere other than the default location. The default usually requires using sudo.

$ python setup.py install

You can attempt to run it

$ periscoped

or to run it straight from the repository

$ python periscope/app.py

Either of which will start it running on port 8888.

You may encounter problems related to AUTH or GEMINI specific files, I’ll try to cover these.

If you see something like

ImportError: /usr/local/lib/python2.7/dist-packages/M2Crypto-0.21.1-py2.7-linux-x86_64.egg/M2Crypto/__m2crypto.so: undefined symbol: SSLv2_method

You’re probably running Ubuntu - try installing python-m2crypto from apt-get.

$ sudo apt-get install python-m2crypto

Now remove the version of M2Crypto that Periscope was complaining about. In the example above, that would mean doing.

$ rm -r /usr/local/lib/python2.7/dist-packages/M2Crypto-0.21.1-py2.7-linux-x86_64.egg/

Now if you try python periscope/app.py again, you should be in business. Or at least you should get some errors that have to do with your config. Running with SSL or ABAC turned on may require some additional packages. See the configuration section.

Mostly done by editing periscope/settings.py

Inside you can enable or disable the MS, enable or disable SSL, and ABAC.

For quick testing, find the corresponding variables in settings.py and make them look like so:

ENABLE_SSL = False
MS_ENABLE = True
ENABLE_AUTH = False