DiVA Administrator's Guide
This guide is a how-to deploy DiVA on your resources.
Deployment
Dependencies
First of all, you must have a dotCloud compatible environment (take a look at http://bitbucket.org/dotcloud/dotcloud/wiki/Home for more details):
- Have a dotCloud-compatible kernel. You can make your own one or download it from http://diva-cloud.org/downloads/kernels
wget http://diva-cloud.org/downloads/kernels/linux-image-2.6.27-dotcloud.deb dpkg -i linux-image-2.6.27-dotcloud.deb
- Install dotCloud dependencies. For an installation on an Ubuntu: http://bitbucket.org/dotcloud/dotcloud/wiki/InstallOnUbuntu
apt-get update && apt-get install bindfs=1.8-1 \ couchdb=0.8.0-1 \ build-essential=11.4 \ iptables=1.4.0-4ubuntu2 \ pkg-config=0.22-1 \ libnspr4-dev=4.7.5-0ubuntu0.8.10.1 \ python-dev=2.5.2-1ubuntu1 \ python-setuptools=0.6c9-0ubuntu1 \ rsync=3.0.3-2ubuntu1 \ vzctl=3.0.22-11ubuntu1 \ vzquota=3.0.11-1 \ openntpd=3.9p1-7
DiVA-Manager
In order to install the last stable release of DiVA in '/usr/share/diva' run the following commands:
apt-get update && apt-get install libdb4.4-dev libsasl2-dev libssl-dev libldap2-dev
easy_install pip virtualenv pip -E /usr/share/diva install -r http://diva-cloud.org/repo/devel/DiVA-Manager/raw-file/tip/requirements.txt pip -E /usr/share/diva install http://diva-cloud.org/repo/devel/DiVA-Manager/archive/tip.tar.gz ln -sf /usr/share/diva/bin/diva /usr/local/bin/diva reboot
Once the installation is done, you can deploy DiVA on your system (see the DiVA User's Guide, for the complete list of commands):
diva --deploy
Configuration
etc/description.json
You can find the last version of this file, on our mercurial repository:
http://diva-cloud.org/repo/devel/DiVA-Manager/raw-file/tip/etc/description.json
This file describe the 'DiVA pool', a set of components.
For example, if you just want mantis, with mysql, nginx and the WebManager, the file will looks like this:
{ "resources": { "variables": { "projectname" : "DiVA", "mail" : "admin@mydomain.org", "domain" : "mydomain.org" }, "volumes": { "db-mantis": { "path": "mantis_DB", "url" : "http://diva-cloud.org/repo/devel/volume-DB_mantis" }, "log-DiVA-WebManager": { "path": "log/DiVA-WebManager", "sub-directory": [ {"path": "/apt"}, {"path": "/apache2", "mode": 0750, "uid" : 33, "gid" : 4} ] }, "log-DiVA-mantis": { "path": "log/DiVA-mantis", "sub-directory": [ {"path": "/apt"}, {"path": "/apache2", "mode": 0750, "uid" : 33, "gid" : 4} ] }, "log-DiVA-phpmyadmin": { "path": "log/DiVA-phpmyadmin", "sub-directory": [ {"path": "/apt"}, {"path": "/apache2", "mode": 0750, "uid" : 33, "gid" : 4} ] }, "log-DiVA-mysql": { "path": "log/DiVA-mysql", "sub-directory": [ {"path": "/apt"} ] }, "log-DiVA-nginx": { "path": "log/DiVA-nginx", "sub-directory": [ {"path": "/apt"}, {"path": "/nginx", "mode": 0755, "uid" : 0, "gid" : 0} ] } } }, "appliances": { "DiVA-WebManager": { "ip_dotcloud": network.localhost.ip, "log" : resources.volumes.log-DiVA-WebManager, "with_sso" : False, "url" : "http://diva-cloud.org/repo/devel/DiVA-WebManager" }, "DiVA-mantis": { "host_mysql" : network.DiVA-mysql.ip, "admin_mail" : resources.variables.mail, "domain_name": resources.variables.domain, "log" : resources.volumes.log-DiVA-mantis, "ip_dotcloud": network.localhost.ip, "with_sso" : False, "type" : "service", "url" : "http://diva-cloud.org/repo/devel/DiVA-mantis" }, "DiVA-mysql": { "db" : { "mantis" : resources.volumes.db-mantis }, "log" : resources.volumes.log-DiVA-mysql, "type": "service", "url" : "http://diva-cloud.org/repo/devel/DiVA-mysql" }, "DiVA-phpmyadmin": { "host_mysql" : network.DiVA-mysql.ip, "log" : resources.volumes.log-DiVA-phpmyadmin, "ip_dotcloud": network.localhost.ip, "with_sso" : False, "url" : "http://diva-cloud.org/repo/devel/DiVA-phpmyadmin" }, "DiVA-nginx": { "log" : resources.volumes.log-DiVA-nginx, "url" : "http://diva-cloud.org/repo/devel/DiVA-nginx", "alias": { "mantis" : network.DiVA-mantis.ip, "phpmyadmin" : network.DiVA-phpmyadmin.ip } } } }
Back up to: Documentation