Installing Zurmo

Purpose:
To guide individuals through the Zurmo installation.

Audience:
Anyone who wants to equip his machine with Zurmo.

Requirements

Please go through Zurmo Installation Requirements page to setup prerequisites for your machine.

Production

  • Download the latest stable version of Zurmo here
  • Unzip downloaded file into document root of your webserver(actual location may vary depending on your platform)
  • Check with the Installation Requirements page to setup proper write permissions on specific files and directories. This is mandatory
  • In a browser to go http://localhost/zurmo/app/index.php to run the installation
  • Click continue to run a system check
  • Check and fix any issues found by the system check, if necessary rerun tests
  • On next screen you would be prompted to provide Zurmo Install Wizard with your preferred settings
  • You may see memcache configuration on setup form. This is purely optional, though highly recommended for good traffic sites
  • Fill the setup form with database credentials and password for superadmin for Zurmo(you can change this later).
  • Click on install to install the application
  • Once installation is complete you are given the option of installing demo data. For Production it is advised to not install demo data.
  • At the end of the installation you will have a log in link to be able to go to the log in screen

Development

  • Clone the zurmo source code in the document root of your webserver(actual location depends on your platform).
  • Follow the install guide for Production setup above

Leave a Comment

  • PatrizioRullo

    I’m trying to install Zurmo on my Ubuntu 12.04, and it tells me it’s missing the IMAP module (on Ubuntu it’s a package named php5-imap). Can you add this info? Thanks!

    • Ivica Nedeljkovic

      IMAP is optional service, that is why it is not listed under required items.

      • Andrew

        Yeah, but I think that this information should be present at chapters 1,2.

        • Ivica Nedeljkovic

          php-imap is added as optional requirement. Thanks!

  • PatrizioRullo

    I think it’s better to add information about installing php5-curl, needed to call curl.
    I installed curl and the Zurmo installation was saying that it was missing, without help of people from forum, it would take me quite a long time to figure it out.

    • Ivica Nedeljkovic

      I edited article, and added php5-curl as required php library.

  • Cool Lkdop

    once installed on Ubuntu 12.04, I am prompted the login/password. what are they ? I am testing super/super & jim/jim & zurmo/zurmo… not working :(

    Also, when I check Database in phpmmyadmin, there are only table under the ‘zurmo’ database, nothing under ”zurmo_wacky’, is this normal ?

    Thank you for your help

    • Cool Lkdop

      It’s ok, it’s the one set during installation process…

    • Ivica Nedeljkovic

      Login username is ‘super’ and password ins one that you entered during installation(field: “Super User Password “).
      “‘zurmo_wacky” database is used just for unit tests, so after installation this database will be empty. But there will be some tables in this database during unit tests.

  • David Saldana

    I downloaded the 1.5 version, unzip the folder and then try to run as it said above but it does not work, it tells me document not found. what I am doing wrong?

    • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

      Do you have the proper server environment? You can post any error messages and screenshots here: http://zurmo.org/forums/index.php?/forum/8-installation-and-setup/

      • David Saldana

        The server was running version 1.31 so I guess it does had the right server environment. I don’t have any critical data so I wanted to do a fresh install instead of an upgrade

        • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

          We have Developer Sessions every Tuesday at 10:00AM Chicago Time: http://zurmo.org/forums/index.php?/calendar/event/2-developer-learning-session
          You can always join an upcoming session and ask any questions to our technical team.

          • David Saldana

            thanks, I got it working. I change permissions to the folder and it is now installed

          • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

            Fantastic! Glad to hear everything is working now.

  • Kevin

    Getting the following error:

    Warning: include(SecurableModule.php) [function.include]: failed to open stream: No such file or directory in /home/*****/public_html/crm/zurmo/yii/framework/YiiBase.php on line 421

    Warning: include() [function.include]: Failed opening ‘SecurableModule.php’ for inclusion (include_path=’.:/home/*****/public_html/crm/zurmo/app/protected/modules/api/tests/unit/forms:/home/*****/public_html/crm/zurmo/app/protected/modules/api/tests/unit/models:/usr/lib/php:/usr/local/lib/php’) in /home/*****/public_html/crm/zurmo/yii/framework/YiiBase.php on line 421

    Fatal error: Class ‘SecurableModule’ not found in /home/*****/public_html/crm/zurmo/app/protected/modules/zurmo/ZurmoModule.php on line 38

    • Jason Green

      What OS/php/apache versions are you running? did you try restarting memcache and apache? are you running APC, turn off APC and see if it is ok.

      • Kevin

        Hello Jason, I have the following CentOs 5.9 i686 – Apache/2.2.24 (Unix) mod_ssl/2.2.24 OpenSSL/0.9.8e-fips-rhel5 mod_bwlimited/1.4 PHP/5.3.24 mod_perl/2.0.6 Perl/v5.8.8 I tried restarting the memcache and Apache with no success.

        • Jason Green

          Kevin,
          A few other people have had this problem recently, but we can’t seem to replicate it and are not having any problems with our build environments for our servers. it would be great if you could install xdebug on php, and then get us a stack trace of what is going on. this would help immensely.

          • Kevin

            Thank you, I will do so this weekend. Looking forward to using Zurmo…

          • Jason Green

            ok looking forward to seeing the stack trace

          • Kevin

            1.

          • Guest

            2.

          • Kevin

            3.

          • Kevin

            2.

          • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

            Kevin, we have Developer Sessions every Tuesday at 10:00AM Chicago Time (http://zurmo.org/forums/index.php?/calendar/event/2-developer-learning-session/). You can always join an upcoming session so we can go over the issues and help you get them resolved.

          • Kevin H.

            Hello, Sorry I missed the developper session… Was this issue discussed by any chance?

          • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

            No worries. We didn’t discuss any install issues. Maybe you can make next week’s session.

          • http://twitter.com/MarkPDaoust Mark P Daoust

            I’m having the same issues – exact same stack trace. Any ideas?

            I’m installing on Mac OS 10.8 running PHP 5.3

          • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht
          • http://codesleepshred.com/ r109

            Any Luck Kev? I am trying to do this on a similar setup on CentOS

          • Ray Stoeckicht

            Come join the Developer Session and we will help. We have sessions every Tuesday at 10:00AM Chicago Time: http://zurmo.org/forums/index.php?/calendar/event/2-developer-learning-session

          • Kevin

            This is the php info of my server, memcache section… People say it’s the memcache but I got the error messages with memcache/memcached installed and not installed.

          • Brisvegan
          • Brisvegan

            Fixed … was permissions issue.

          • http://codesleepshred.com/ r109

            Where you using CentOS? What did you do to fix this?

    • Tareq

      Hi,

      I don’t know if this problem still happen, but in case, if any one face this problem, it seems to be permission problem.

      Try to give permissions (for example 777 for all directories as testing only) and see if this will help or not. That I did when I face this problem ;)

      Brisvegan said it is permission problem too.

      • Ray Stoeckicht

        This looks like the same issue and lists the fix: http://zurmo.org/forums/index.php?/topic/454-fatal-error-securablemodule/

        • Arfur Folkesayke

          dunno, I had this issue and the I RTFM and found that it’s human stupidity issue. If you read manual, you’ll find that:

          The following paths should be writable by the webserver process:
          app/protected/config/
          app/
          app/protected/config/
          app/assets/
          app/protected/data/
          app/protected/runtime/

          Voila, problem solved.

  • Damien Wilson

    Hi,

    Did we find a solution for:

    PHP Fatal error: Class ‘SecurableModule’ not found in /var/www/zurmo/app/protected/modules/zurmo/ZurmoModule.php on line 38?

    • Jason Green

      It is a permissions issue with apache. You need to change permissions and then restart apache.

      • Damien Wilson

        Hi Jason, Thanks.

        I’ve changed permissions to 0777 on all directories and files and still have the issue.

        A restart shouldn’t be needed for permission changes. I wonder if the developers of this product have a list of probable causes? Now that would be helpful ;)

        • Ray Stoeckicht
          • Damien Wilson

            I’ve fixed it Jason…. I’m running Ubuntu 12.04.

            My issue was that I ran ‘wget’ on the zip file instead of the tar ball. The difference between them being that .zip doesn’t retain permissions and .tar.gz does.

            My advice: if installing on a Linux box download and unpack the *.tar.gz to the required destination and run:

            chown -R www-data zurmo/*
            chgrp -R www-data zurmo/*

            … and all should be ok… once your server meets requirements ;)

          • Imran Yousuf

            I ran into this problem when installing for the first time also, and based on the fix by Damien, I also found that I had a similar root cause. I had downloaded the tarball using wget, and then used tar -gzxf to extract and unzip it. That resulted in permission problems, producing the SecurableModule error message. I decided to start fresh, copied the tar.gz file to /var/www/html and used gunzip and tar -xvf as separate commands, and that was all that was needed. It launched properly after that!

          • roderickm

            This should be added to the installation instructions. It was necessary for my installation as well.

  • Amarnath Gupta

    Hi, i have given all required permissions to all the folders.

    When I am opening zurmo/app/index.php, it redirects to zurmo/app/index.php/install/default, but after that I get error “No input file specified.”

    Any help please….

    • gisse

      Did you ever get a reply? I have the same issue.

  • maddtechwf

    Awesome app!

  • vaijanath

    I’m trying to install zurmo on ubantu 12.04. I have already LAMP installed. And i downloaded the latest released zurmo and gone through all the installation process but when try “http://localhost/zurmo/app/index.php” in a browser it shows error: “server error”. Please help me. Installing zurmo is very hard, please make it easy..

  • Shah Khalid

    I am getting this error, [an error occurred while processing this directive] on bluehost

  • http://www.esrati.com David Esrati

    Did an install from softaculous. Seem to have a problem with setting up cron jobs:

    Warning: require_once(//protected/config/debugDIST.php): failed to open stream: No such file or directory in /home2/USERNAME/public_html/crm/app/protected/commands/bootstrap.php on line 58
    Anyone else having these problems?

  • Divya Mishra

    Hi, zurmo is not getting installed on my system, its throwing unknown error. how can we get zurmo database manually and run it without installation

  • Vijay

    Hi,

    I have zurmo source from zurmo-stable-2.6.5.c5257ee612c5.zip. Now i am using linux 12.10 version i did’t have phpmyadmin password. But in basic installation of zurmo need db password .Please give me some suggestion for without password to install this into localhost.

  • Gustavormello

    Is it possible to install an older version of zurmo? I want to move a copy of zurmo I have hosted on the web to a local installation but it is version 1.5.12 . I guess just backing up the database and importing it in a fresh newer version wouldn’t work, right?