Open Bacchus Project is a backup solution for oVirt/RHEV environment. It is being developed based on Python 2.7, Django 1.10 and oVirt Python SDK 4.1. Please be aware that it is still under development. Thank you for checking it out.

Dear Open Bacchus User,

Bacchus is an opensource backup solution for oVirt/RHEV. The backup mechanism behind the Bacchus relies on oVirt Python SDK. It basically creates a snapshot of a VM, clones a new VM from the snapshot with the prefix bacchus_ and exports this cloned VM to default Export Domain of oVirt/RHEV. Snapshot and cloned VM is deleted after the backup is completed. Configuration of Export Domain is user's responsibility. If the domain is configured properly, Bacchus will detect it. No additional work required.

The code may be lacking error handling in many cases for now. We are aware of it and will be covering the cases very soon. We need voluntary testers. Please drop an e-mail if you are interested.

We use MariaDB as backend database, you may choose your own flavor but it is your responsibility to take care of it. Celery and RabbitMQ are being used as scheduling backend.

Please install the following packages on to your favorite Linux distro.

• Python 2.7.x
• pip
• MariaDB
• RabbitMQ

For CentOS 7:

yum groupinstall 'Development Tools'
yum install libxml2-devel python-devel python-pip mariadb-devel mariadb-server rabbitmq-server

1. Install django framework 1.10.x
   django-fernet-fields provides encryption in database.
   For security, we strongly recommend you change the SECRET_KEY value in settings.py

pip install django==1.10.6
pip install django-fernet-fields

2. Install oVirt Python SDK

pip install ovirt-engine-sdk-python==4.1.2

3. Install Python MySQL support

pip install MySQL-python

4. Install Celery

pip install celery==4.0.2
pip install django-celery-beat
pip install django-celery-results
pip install flower

5. Create bacchus database and user on MariaDB

create database bacchus;
grant all on bacchus.* to bacchus@localhost identified by 'bacchus';

6. Create bacchus user on RabbitMQ (run the following commands with root user)

rabbitmqctl add_user bacchus bacchus
rabbitmqctl add_vhost bacchus
rabbitmqctl set_user_tags bacchus Administrator
rabbitmqctl set_permissions -p bacchus bacchus ".*" ".*" ".*"

6. Create bacchus user and group on Linux

useradd bacchus

7. Login with bacchus user and get the Bacchus code from git repository

git clone https://github.com/openbacchus/bacchus.git

8. Create the Bacchus Database layout

cd bacchus
python manage.py check
python manage.py migrate

9. Add your host into Django settings.py

• in bacchus/settings.py change the line ALLOWED_HOSTS = ["bacchus"] to ALLOWED_HOSTS = ["your_hostname"]

10. Change the timezone

• in bacchus/settings.py change the TIME_ZONE parameter to your timezone.

11. Create Bacchus admin account

python manage.py createsuperuser

12. Start Bacchus

bacchus/scripts/start_bacchus.sh

13. Access your Bacchus at http://your_hostname:8080/
    Login with the user credentials set in step 10.

14. We strongly recommend you to configure a reverse proxy with SSL support enabled (e.g. apache/nginx) as a front end to Bacchus.

As you log in to Bacchus using the default URL, you need to navigate to RHEV/Ovirt -> Managers to introduce your oVirt to Bacchus. After successful addition, you may list your VMs under 'VM Protection' pane. You can either use "On Demand Backup" page for spontaneous backups or go to "Automation" pane and define a schedule.

As a safety measure, the session will be terminated after 5 minutes of inactivity. This behavior can be modified in bacchus/settings.py, replacing 5 in SESSION_COOKIE_AGE = 5 * 60 with a value of your choice.

Session will also be terminated when browser is closed at some point. If you don't want to, change to False SESSION_EXPIRE_AT_BROWSER_CLOSE in bacchus/settings.py.

In both cases, a restart of services is required.

Bacchus "restore" functionality has not been implemented yet. VM backups will appear in Export Domain's "Import VM" pane. You may use oVirt/RHEV to restore your VM.

Please feel free to contact to openbacchus@gmail.com for any issues.

Subscribe to our user mailing list to stay tuned http://bacchus.co/mailman/listinfo/users_bacchus.co

You can also open an issue on GitHub project page.

Hope you enjoy Open Bacchus !