Virtual Machine Appliance Build

This directory contain all resources required to build CentOS virtual machine appliances.

Requirements

To build an virtual machine image the following tools are needed:

• Packer
• VirtualBox
• Make

To develop and debug ansible roles it recomended to also have vagrant installed

Build Steps

The build consists of the following steps:

1. CentOS base installation through the Kickstart file.
2. Shell provisoner to bootstrap Ansible
3. Ansible provisioner to provision the virtual machine
4. Shell provisoner to install VirtualBox guest additions
5. Compress post-processor to compress .ova file

Known Issues

• Don't run the build as root user. Ansible will fail with an "You need to be root to perform this command.". The root cause for this is unclear.

FAQ

How do I add a new PDF guide to the virtual machine?

To add new guides to the virtual machine simply extend specchio_client_guides in the following file. (Also ensure the the file with exact same name exists in the Guide repository.

How do I add a new dataset to the virtual machine?

Ensure that the dataset is present on the webserver (https://specchio.ch/datasets/). Then simple add a new entry to specchio_client_datasets in file.

How do I change the password of the specchio system user?

For this simply adjust the user statement in the kickstart file.

How do I change the password of the sdb_admin SPECCHIO/database user?

For this simply adjust the specchio_database_password statement in the playbook.yml.