First, install Vagrant and one of the supported providers: VirtualBox (should work fine), LXC (tested), libvirt (try it and tell us!). Then run the following commands:
git clone https://gitlab.com/dissemin/disseminwill clone the repository, i.e., download the source code of Dissemin. You should not reuse an existing copy of the repository, otherwise it may cause errors with Vagrant later.
cd disseminto go in the repository
- If using the VirtualBox provider, run vagrant plugin install vagrant-vbguest to install the VirtualBox guest additions plugin for Vagrant
vagrant up --provider=your_providerwill create the VM / container and provision the machine once
vagrant sshwill let you poke into the machine and access its services (PostgreSQL, Redis, ElasticSearch)
- A tmux session is running so that you can check out the Celery and Django development server, attach it using:
tmux attach. It contains a
bashpanel, two panels to check on Celery and Django development server and a panel to create a superuser (admin account) for Dissemin, which you can then use from localhost:8080/admin.
Dissemin will be available on your host machine at localhost:8080.
Note that, when rebooting the Vagrant VM / container, the Dissemin server will not be started automatically.
To do it, once you have booted the machine, run
vagrant ssh and then
cd /dissemin and
./launch.sh and wait for some time until it says that Dissemin has started.
The same holds for other backend services, you can check the
provisioning/provision.sh to find out how to start them.