Import Virtual Appliance¶
ESX & ESXi version 5 and up
Import virtual appliance¶
Download the VMware virtual appliance from https://www.ciphermail.com/downloads-virtual-appliance.html.
Unzip the downloaded zip file.
Import the virtual appliance using the tool that comes with your VMware product. For example with the vSphere client, select the menu option “Deploy OVF Template…” and select the ovf file to import.
To prevent swapping because of memory overcommitment, reserve all memory for the virtual machine.
VMWare memory reservation can be set using the following procedure:
Select settings of the virtual appliance
Select resources tab and finally
Select memory and set reservation to the limit based on parent resource pool or current host. For more information on running a JVM on ESX see http://www.vmware.com/resources/techresources/1087
Download the Hyper-V virtual hard disk from https://www.ciphermail.com/downloads-virtual-appliance.html.
Unzip the virtual hard disk file to the location where all the virtual hard disks are stored.
Create a new virtual machine.
Set memory to 2 GB (≥ 4 GB recommended)
Connect the network.
Select “Use an existing virtual hard disk” and select the gateway virtual disk.
Optionally, select more than one “Virtual Processor” (≥ 2 vCPUs recommended)
Finish the “New Virtual Machine Wizard”.
Virtual Appliance configuration¶
After the Virtual Appliance has been imported, the virtual machine can be “Powered on”. The first time the Virtual Appliance starts, new SSH and SSL/TLS keys will be generated. After starting for the first time, the Virtual Appliance should be configured.
For security reasons, the gateway is not yet configured with an IP address. The IP address can be configured using the console application.
Login to CipherMail from the VM console using the default console login credentials:
After logging into the Virtual Appliance console, the system console tool will be started. The system console tool can be used to configure certain aspects of the gateway which cannot be configured from the WEB GUI.
Only basic settings, like IP address, Timezone etc., should be configured using the console tool. All other settings should be configured from the Admin Web GUI.
After configuring the IP address, you can login via ssh.
The Virtual Appliance system configuration tool contains the following main menu items: “File”, “Config”, “Backup” and “Other”.