Installing dependencies on Linux

Purpose:
This wiki provides you step by step instructions on setting up dependencies on a Linux machine.

Audience:
Individuals trying to install Zurmo on a Linux machine.

Production

Installing a LAMP stack

  • Choose a linux distribution you like.
  • Use distribution’s recommended way of installing packages to install the following:
    • apache2
    • mysql-server-5.1
    • php5
    • php5-mysql
    • php5-pdo
    • php5-pdo_mysql
    • php5-memcache
    • php5-curl
    • php5-mbstring
    • php-apc
    • php-soap
    • php-imap
    • memcached
    • php-gd
    • php-pear

    Some of the php extensions names might be different depending on your distribution’s package maintainer’s choice. Also for PHP extensions you have to enable them manually by editing php.ini file or create a file under php’s config directory. Please consult your distribution’s PHP Extension package for details.

Apache Configuration

  • Enable mod_deflate in apache2. For details instruction please consult your distribution’s apache manual.

PHP Configuration

  • Edit php.ini(location depends on your distribution) and change the following lines to specified settings:
    • date.timezone = America/Chicago
    • memory_limit = 256M
    • file_uploads = On
    • upload_max_filesize = 20M
    • post_max_size = 20M
    • max_execution_time = 300
  • Restart apache2 for changes to take effect

MySQL

Configuration

Database and User

Development

Instructions in this section are inclusive of Production. To setup a development machine you would have to follow the instructions above and then make any amendment/additions as described below.

Installing a LAMP stack

  • You may want to install php-xdebug along with other extensions for easy debugging of Zurmo code. Configuration of xdebug to have it integrated with your IDE is beyond the scope of this wiki.

MySQL

Database and User

You would need to create 2 more pairs of user and database for development setup.

PhpUnit

Selenium Server

Mercurial

  • Use your distributions preferred method to install latest version of Mercurial
  • Create ~/.hgrc as below:
    [ui]
    username = you_bitbucket_username_here <your_bitbucket_account_email_here@example.com>

Setting up Keys

  • Run the following command in terminal:
    ssh-keygen -t rsa -C "your_bitbucket_account_email_here@example.com"

    It will ask couple of questions, you can just press enter to make it use defaults.

  • Login to bitbucket, go to Account, copy and paste the id_rsa.pub key(found in ~/.ssh/) into list of your keys

Leave a Comment

  • k l

    php-mbstring is missing from the packages list above.

    • http://twitter.com/err404notfound Muhammad Shoaib

      Nice spot. Fixed it. Thanks.

    • http://www.wovenlore.com Martin LaBelle

      mbstring is now included in the php5 language on most distributions

  • vaijanath

    Hello, I’m very new to yii framework as well as zurmo crm. I have installed zurmo crm on my local machine lamp in ubantu 12.04. I got the yii framework along with zurmo installation. But I’m not able to access the yii framework on localhost. In fact i dint get “demos” and “requirement” folders within “yii” folder in “zurmo” folder path. Could somebody help me to access it on localhost?
    I have tried to open by:
    http://localhost/zurmo/yii/requirements/index.php
    It is showing the error:
    The requested URL /zurmo/yii/requirements/index.php was not found on this server.

    this is correct because there is no “requirements” in yii folder which is in “zurmo” folder. What should i do now?

  • http://betterpchealth.com Spencer

    should be php5-gd and php5-imap (debian wheezy)

  • Adam Jakab

    php5-ldap is also missing from requirements