Zarafa VMware virtual appliance

From Zarafa wiki

Jump to: navigation, search

Zarafa offers a VMware appliance on http://www.zarafa.com/content/vmware

The Zarafa VMware appliance includes a minimal Ubuntu 10.04 LTS installation.

The current Zarafa version of the VMware appliance is 6.40.4. This is scheduled to be upgraded to the new 7 series soon. For now, please keep in mind you're not using the latest-and-greatest version of Zarafa with this appliance.

To run the Zarafa VMware demo you need the VMware player or the VMware server. You can downloaded the latest VMware server at following url:

http://www.vmware.com/download/server/

After downloading the VMware image, you need to extract it to a directory on your local harddrive, for example C:\Virtual Machines if you are using Windows.

After you extract the VMware image, you can open the image in VMware via File -> Open and select the file Ubuntu.vmx.

You can now start the VMware image.

The VMware image has one network interface which is configured in bridge mode, so it will get an ip-address from the DHCP-server in your network.

How to evaluate

When the VMware is started, you can log on to the console with the following username and password: 

Username: root
Password: root

The keyboard layout of the VMware image is set to US International. To change the keyboard layout, you can use the following command:

dpkg-reconfigure console-setup

Via the command `ip addr`, you can check the ip-address of the virtual machine. The vmware network adapter is configured in bridge mode. If you run a DHCP server in your network, the vmware image will get an ip-address from this server.

Manual Zarafa Ubuntu Vmware

After you logged in, you need to configure the default email domain.

  • Open /etc/postfix/main.cf with an text editor (nano or vi)
  • Change the attribute zarafadomain to your email domain
  • Reload Postfix to activate the changes via /etc/init.d/postfix reload

After the email domain is configured, you can add users to Zarafa via the zarafa-admin console tool.

zarafa-admin -c username -P -f “Firstname Lastname” -e “email address”

Make sure the email address contains the domain name you specified in the /etc/postfix/main.cf file.

By default the mailbox will be created in english. To create a mailbox in another language you will need to add the option --lang to the script: 

 /etc/zarafa/userscripts/createuser.d/00createstore
 zarafa-admin --lang de_DE --create-store "${ZARAFA_USER}"

To add email aliases to an user please follow these steps.

  • Open /etc/postfix/virtual with an editor
  • Add the line with the alias to the file e.g. 
 info@example.com        z.user@example.com, sales@example.com
  • Recreate the virtual alias database with: postmap /etc/postfix/virtual

After the user is created, you can login via the Zarafa webaccess which can be accessed via http://your-ip-address/webaccess.

To connect Outlook to the Zarafa server, please see the Zarafa client install manual on http://www.zarafa.com/doc

Users who want to read their email via other mail clients than Outlook or the Zarafa webaccess, can use the Zarafa-gateway. Via the Zarafa-gateway you can retrieve your email via any POP3 or IMAP client, like Thunderbird or Outlook Express.

If you have any (technical) questions about Zarafa virtual appliance please create a forum post on http://forums.zarafa.com or send an email to support@zarafa.com. Alternatively you may also choose to chat with our community at the Zarafa IRC/Webchat

Retrieved from "http://www.zarafa.com/wiki/index.php/Zarafa_VMware_virtual_appliance"
Personal tools