A live demo of CAIRIS is available to use on demo.cairis.org. The username and password you need are test and test. The live demo is rebuilt every night based on the latest updates to CAIRIS.
If you have Docker installed on your laptop or an available machine, the easiest way of getting up and running with the web application is to download the CAIRIS container from Docker hub. This is built from the latest changes in github, and uses mod_wsgi-express to deliver the CAIRIS web services.
From the web browser of your choice, connect to the CAIRIS URL, e.g. http://localhost When asked for credentials, provide test/test
If you want to interact with a pre-existing CAIRIS model, you can find some examples on the CAIRIS github, repository, e.g. NeuroGrid. You can import this from the System/Import menu, selecting type ‘Model’, and the model file to import. Allow a minute or two for this import to complete.
You can accept many of these defaults, except for the database root password. When you select
Ok, the script will create a new CAIRIS database, and accompanying CAIRIS configuration file; this file will ensure that CAIRIS knows what database it needs to refer to when you start up the tool and setup the necessary environment variables. The form below will then be displayed.
You will need to supply a username and password here. When you select
Ok, the script will add a user to the CAIRIS database.
If you want to run the Flask development server, run
./cairisd.py runserver (the script can be found in cairis/cairis/bin).
If you want to run CAIRIS in a production environment then it may be sensible to use mod_wsgi-express rather than the Flask development server. To do this, you will need to install the requisite Apache2 packages.
You will then need to use pip to install the requisite dependencies.
To start mod_wsgi-express, you should run
mod_wsgi-express start-server cairis.wsgi; cairis.wsgi can also be found in cairis/cairis/bin.
You can now point your browser to http://SERVERNAME:PORT_NUMBER, depending on where
cairisd is installed, and what port cairisd or mod_wsgi-express is listening to, e.g. http://myserver.org:7071.
If you plan to develop for CAIRIS, you should install the requisite packages for running the tests in cairis/cairis/test.
You should also set the
CAIRIS_CFG_DIR environment variables in your .bashrc file.