/eramba-build

Installs the Eramba Community Edition.

Primary LanguageShell

Eramba Community Edition Installation script

Bash script automating the installation of Eramba Community Edition on Debian 11

Vagrantfile and bootstrap.sh for use with Vagrant and Virtualbox

Design principles:

  • Dedicated to Eramba, nothing else
  • Use the defaults where possible
  • Least access

Known issues:

  • Currently using self signed cert, but the CSR is there so send that to Issuing CA instead
  • Daily Cron job cannot run before first login with admin/admin and password changed.
  • Not tested with anything else than Debian 11 (Bullseye)

Latest changes

2021-11-04 - Initial version

Version 1.00

2021-11-07 - Create certificates for Apache

Version 1.50 - Now with cert and cron adjusted

2021-11-12 - iptables firewall only allowing 22, 80 and 443

Version 2.00 - Firewall

Important: Do NOT use the process below for production, as Vagrant leaves some unfortunate security artifacts behind. The install-eramba.sh alone can be used on a known secure installation of Debian 11, or you could remove Vagrant artifacts (the former is preferred)

Quick installation - If you just want to get on with it

Packages required

All that is needed to spin up test systems is:

Installation

VirtualBox

  • Install VirtualBox on your preferred system (MacOS or Linux is preferred) as described on the VirtualBox website
  • Install the VirtualBox Extensions

Both software titles can be downloaded from https://www.virtualbox.org/ They can also be added to your package manager, which help with keeping them up-to-date. This can also easily be changed to run with VMWare.

Vagrant

  • Install Vagrant on your system as described on the Vagrant website

Vagrant is available at https://www.vagrantup.com/downloads

Testlab

Prerequisite: A DHCP server on the network, alternatively change the NIC to use a static or NAT within Vagrantfile.

  • Create a directory with ample space for Virtual Machines, e.g. /mnt/data/VMs
  • Configure VirtualBox to use that directory for Virtual Machines by default.
  • Change directory into /mnt/data/Environments/
  • Run git clone https://github.com/martinboller/eramba-build.git
  • Change directory into /mnt/data/Environments/eramba-build/
  • Execute vagrant up eramba and wait for the OS to install

You may have to select which NIC to use for this e.g. wl08p01 Logon to the website on the server https://eramba

The first install will take longer, as it needs to download the Vagrant box for Debian 11 (which this build is based on) first, however that’ll be reused in subsequent (re)installations.