Installation Instructions

• Follow the instructions to install the Project Zero Command Line Interface.
• Make sure both the Java bin directory ( Java SDK 5.0 or later ) and the zero directory are on your PATH.
• Create a new Zero PHP project called SugarCRM by running:

zero create SugarCRM

• Get the full installation package of SugarCRM CommunityEdition 5 (The supported version is 5.0.0, of which the tested version is 5.0.0f - 5.1 will not yet work in this environment) and unzip it into the public directory of the new SugarCRM project.
  • In the public directory there should now be a directory SugarCE-Full-5.0.0f.
• Move all the files and directories in the SugarCE-Full-5.0.0f directory up a level so that they are in the public directory and the SugarCE-Full-5.0.0f. is empty.
• Download and unzip Mysql Community Edition 5.1. On a command line start the mysql server by changing to the bin directory and running;

mysqld --console

• Now we are going to add two dependencies to the project. The first pulls in the mysql database connector and the second adds the PHP interpreter to the project. Edit SugarCRM/config/ivy.xml to add the following two lines :

<dependency org="zero" name="zero.php" rev="[1.0.0.0, 2.0.0.0["/>
<dependency org="mysql" name="mysql-connector-java" rev="[5.1.0.0, 6.0.0.0["/>

• Resolve the project before proceeding – this will cause the PHP interpreter to be fetched and added to the project. From the SugarCRM directory type this before editing the php.ini file

zero resolve

• Now make a few changes to the PHP configuration file in SugarCRM/config/php.ini :
• Comment out this error_reporting setting in php.ini

; error_reporting = E_ALL|E_STRICT

• Uncomment this line in php.ini

error_reporting = E_COMPILE_ERROR|E_RECOVERABLE_ERROR|E_ERROR|E_CORE_ERROR

• Uncomment the include_path setting in php.ini so that it will include the current directory. Note that it must contain a dot for the current directory, and be a valid path for the operating system you are using.

include_path = "."

• Uncomment the session.save_path in php.ini and set it to a suitable directory ( e.g. for Windows ).

session.save_path = "C:\temp"

• If you are not using an IBM JDK, you may need to configure the JVM to increase the maximum heap size. For example, you can add the following to SugarCRM/config/zero.config to set it to 128M on Sun JDKs:

/config/zso/jvmargs/java.vendor/Sun += [
"-Xmx128M"
]

Note: The population of the SugarCRM database may exceed the time allowed by the sMash recycle timeout - to prevent this you must temporarily disable the timeout before installing SugarCRM. Locate the zero.config corresponding the the core - this will be in the 'expanded' directory - something like: %ZeroCLIHome%\zero-repository\stable\expanded\zero.core-1.0.0.2.xxxx\config Edit this file and set the recycle to disabled:

/config/zso/recycle/enable = false

• Start the project by typing this in the SugarCRM directory

zero start

• Browse to http://localhost:8080/ and follow the installation pages. Refer to the Sugar 5.0 Installation and Administration Guide for more information.

If you are using Windows and you do not already have it then you may need to install the 2005 version of the Microsoft C/C++ Runtime.

After installation of SugarCRM, remember to reset the recycle timeout to "true". Restart the server using "zero stop" followed by "zero start".

-- timpreece - 23 May 2008