User Tools

Site Tools


virtualbox

Running OpenEMM with VirtualBox

If you want to run OpenEMM on any other operating system than CentOS 7 you can use the virtualization software VirtualBox.
We are providing an almost ready to use appliance for easy installation.
To use this appliance you first have to install VirtualBox (supported) or any other virtualization software which supports the open virtualization format to import a virtual machine.

Installing VirtualBox

Windows and OS X

You can download the latest version here: https://www.virtualbox.org/wiki/Downloads

Linux

You can install VirtualBox from the repositories provides by your OS.
On Ubuntu you can install it with

sudo apt install virtualbox

If you need the latest version or your OS does not provide packages you can download it here: https://www.virtualbox.org/wiki/Linux_Downloads

Importing the OpenEMM appliance

Download the appliance from here: https://www.agnitas.de/en/download/openemm-2019-ova/
Now you can start VirtualBox.

After starting VirtualBox, click on File, Import Appliance and select the downloaded .ova file. Then click on Next.
In this menu you can edit the settings for this virtual machine, but the default settings are sufficient for the beginning.
If you change the network adapter settings, please make sure that after your changes it is still in bridged mode for best functionality.
When you are happy with the settings click on Import.

Now you can start the virtual machine by selecting it and clicking Start.
A terminal will open where you can login for the first time.

Use the user root and the password OpenEMM.

You will be asked to change this password immediately.

An IP address will be automatically assigned using DHCP. If you have to set up an IP address manually use the file /etc/sysconfig/network-scripts/ifcfg-enp0s3 for your changes.

BOOTPROTO=static
IPADDRESS=<your IP>
PREFIX=<your network prefix>
GATEWAY=<your network gateway>

You can see the current IP address with the command ip a.

Now switch to user openemm with
su - openemm

Configuring and running OpenEMM

Please mind the default credentials for the database:
User root password OpenEMM
User openemm password OpenEMM

Run the OpenEMMInstaller with bin/OpenEMMInstaller.sh.

You can now continue with the configuration at OpenEMM installer.

virtualbox.txt · Last modified: 2019/08/20 13:43 by general_user