This repository contains the source code for CernVM Online. CernVM Online is based on the Python Django framework.
This section briefly describes what to do to get the software installed on a (virtual) machine running Apache and WSGI. Switching between different branches has been made easier through a setup/update script.
Instructions and deployment script have been tested on SLC 6 only, but can be easily adapted to any OS with little effort.
Clone the Git repository somewhere:
git clone https://github.com/cernvm/cernvm-online.git /root/cvmo.git
Choose the branch/tag you want:
cd /root/cvmo.git
git checkout <your_branch_name>
You must provide a config.py configuration file in the deployment
subdirectory of your Git clone:
cp /your/path/config.py /root/cvmo.git/deployment/config.py
You can get an example configuration file from the production host.
Beware! The file shall not be committed since it contains sensitive information (credentials, etc.)!
Additional configuration (like the installation path) can be performed by editing the setup file:
$YOUR_EDITOR /root/cvmo.git/deployment/setup.sh
but you mostly not need to touch it.
Run the automatic deployment script as root:
/root/cvmo.git/deployment/setup.sh
Installation of additional components and configuration of Apache and the WSGI interface will be performed automatically. The web server will be restarted at the end.
Updates on the Git repository are meant to be maintained manually. In general, synchronizing a branch means roughly:
cd /root/cvmo.git
git checkout <your_branch_name>
git pull
The repository does not contain the production files. Changed files must be deployed by running again the setup script:
/root/cvmo.git/deployment/setup.sh [-qq|-q]
The -q parameter runs a minimal number of operations to put in production the
new files and takes much less time than the full process. The -qq switch
makes the operation even faster.
Note: the "quick" switches should be used in development only. Use the full setup with no switches when promoting to production.
Enjoy!