How to install Zurmo Virtual Machine

The main aim of the Zurmo VM is to help people interested in Zurmo, to get access to Zurmo CRM software on their own computer using virtual machine fast and easy, without installing all required software on their computers. Zurmo VM is based on Ubuntu Server 12.04(no graphic interface).
All you have to do is to follow these simple steps.

Instaling Zurmo on Virtualbox

1. Download and install recent version of Virtualbox

2. Download Zurmo VMDK image, and extract it. There should be two files: Zurmo.vmdk and Zurmo.ovf(Open Virtualization Format)

3. Click File->Import Appliance, select path to Zurmo.ovf, follow few obvious steps, and once the installation finishes you will have Zurmo in your list of virtual machines.

4. Click on Zurmo to start VM

5. Open virtualbox and click start and should see the login after several seconds.  Login as here as: Username: root Password: zurmo

(Note: If you happen to receive an error such as: “Failed to open a session for the virtual machine… Nonexistent host networking interface, name ‘eth0′ (VERR_INTERNAL_ERROR)”, you can close the error message, click the “Network” heading to open up the network settings, uncheck the box ‘Enable Network Adapter’, and click OK to close the network settings.  Then open the network settings again and enable the network adapter and click OK, then try to start the virtual machine again.)

6. You need to be sure that ip address is set correctly on your VM.  You can check this by typing:

  • ifconfig | grep "inet addr"

In my local network, I have an ip of 192.168.1.105 (Mask: 255.255.255.0), your ip address should be similar. You will need to remember this ip address.

7. Now, open the hosts configuration file (on your local machine) in your favourite text editor.

  • On mac/linux : /etc/hosts
  • On windows : C:\WINDOWS\system32\drivers\etc\hosts

8. Add the following line at the end of your hosts file and replace the ip address with one you already found on your VM (for example: 192.168.1.105).

  • 192.168.1.105 zurmo.vbox

9. Once you save this file you can now open your browser and enter the url: http://zurmo.vbox , if you have perfromed all of the steps correctly the Zurmo CRM login screen should appear.

10. To login to Zurmo CRM as super admin use the following credentials: Username: super Password: super

Tips and tricks

Users
The following users are already created on the server :
root (with all privileges)
zurmo (simple user)
mysql (with all privileges to administrate mysql)
Password : zurmo

Changing keyboard layout
vim /etc/default/keyboard
dpkg-reconfigure console-setup
more info

Changing PHP Date time zone
vim /etc/php5/apache2/php.ini
/etc/init.d/apache2 restart

Start and stop services

Memcached
/etc/init.d/memcached start
/etc/init.d/memcached stop
/etc/init.d/memcached restart

Apache (and PHP)
/etc/init.d/apache2 start
/etc/init.d/apache2 stop
/etc/init.d/apache2 restart

Mysql
/etc/init.d/mysql start
/etc/init.d/mysql stop
/etc/init.d/mysql restart

Logs
If something goes wrong, the errors are logged.
/var/log/apache2/zurmo-error_log
/var/log/apache2/zurmo-access_log

Leave a Comment

  • Vladimir Vucinic

    After some time playing with vbox I got the error: “An error has occurred. Please click here to continue to the home page. If the error persists please contact your administrator.” If I clear the browser cache I got the login page, but after entering user/pass I got the same error again. Any hints how to fix it?

    • Ivica Nedeljkovic

      You can try to enable error reporting in app/protected/config/debug.php, clear system cache(http://zurmo.org/wiki/zurmo-cache-system-explained), and you should be able to see more details about error.
      If you want to reset your instance, I can give you instructions for that too.
      Please post further questions/comments in our forum.

  • Dave

    All I get when I point my browser at the Zurmo VM is a phpinfo() page.

    • Dave

      Figure it out – it seems you MUST access the box via the hostname zurmo.vbox. I edited my /etc/hosts file and now I get an app. But why force the host name?

      • Ivica Nedeljkovic

        Great that you was able to figure out. We decided to force host name because ip address may be different when you install virtual box. However, if you want you can easy change host name o something else, you only need to edit Apache virtual host file(/etc/apache2/sites-available/zurmo.vbox), restart Apache and modify /etc/hosts file.

  • Peter Gordon

    Here is another gotcha: inside settings > system > processor, check ON Enable PAE/NX . This stuff you can read about here: http://en.wikipedia.org/wiki/Physical_Address_Extension but basically it is to make use of a certain chipset harware feature. Other vanilla flavored linux servers dont seem to require it in my VirtualBox; However working through the install in win7 xampp revealed that zurmo works best with a few tweaks to php/mysql settings. The other thing I had to deal with was turning off and re-enabling the network adapter as suggested.

  • James Revillini

    Trying to install on VirtualBox 4.2 for Mac OSX 10.8.4 and getting the following errors. Little help?

    Failed to import appliance /Users/jrevillini/Downloads/bitnami-zurmo-2.0.13-0-ubuntu-12.04/bitnami-zurmo-2.0.13-0-ubuntu-12.04-VBOX3.ovf.

    Could not open the medium storage unit ‘/Users/jrevillini/Downloads/bitnami-zurmo-2.0.13-0-ubuntu-12.04/bitnami-zurmo-2.0.13-0-ubuntu-12.04.vmdk’.

    VMDK: inconsistent references to grain directory in ‘/Users/jrevillini/Downloads/bitnami-zurmo-2.0.13-0-ubuntu-12.04/bitnami-zurmo-2.0.13-0-ubuntu-12.04-s001.vmdk’ (VERR_VD_VMDK_INVALID_HEADER).

    VD: error VERR_VD_VMDK_INVALID_HEADER opening image file ‘/Users/jrevillini/Downloads/bitnami-zurmo-2.0.13-0-ubuntu-12.04/bitnami-zurmo-2.0.13-0-ubuntu-12.04.vmdk’ (VERR_VD_VMDK_INVALID_HEADER).Result Code: VBOX_E_FILE_ERROR (0x80BB0004)Component: ApplianceInterface: IAppliance {3059cf9e-25c7-4f0b-9fa5-3c42e441670b}

  • William Green

    I know this is an older post, but do you have an updated virtual machine image that can be used? Zurmo is up to stable version 2.5.6, but this image is pre- 2.0.12. Any assistance with this would be greatly appreciated. Thank you.

    • William Green

      If someone is able to help me access the folders (using filezilla), I can manually do the upgrade process myself. Unfortunately, I don’t know how to even do that on a virtual machine yet.

  • http://www.storageguardian.com/ www.storageguardian.com

    Now, open the hosts configuration file (on your local machine) in your favourite text editor.

  • Gray Hattus

    WARNING: The included VM is OUT OF DATE!!

    Please update your Zurmo vbox files. The version included is, 0.6.80 (from 2012)!!