Linux Guide/Installing SugarCRM On Linux

Here is how I installed SugarCRM on a new PC:

• Download the four Fedora Core 4 image files and make install CD’s
• Install Fedora Core 4 using the standard “Workstation” settings ( don’t use the Server setup as it will put all the Apache, PHP, and MySQL files in the wrong place. Enable Firewall, Enable SELinux, Install Default Software Packages )
• Finish Installing, Reboot, Login as ‘root’
• After booting, click Desktop -> Security -> Security Level ( if using Gnome GUI ), check the box next to WWW (HTTP), click OK to close.
• Launch WEB browser
• From http://www.mysql.com/ download the v4.1.12 MySQL Linux x86 RPM Files, you will need the Server, Client Program, Libraries & Headers, and Dynamic Client Libraries.
• From http://www.php.net/ download PHP 4.3.11 (tar.gz)
• From http://www.apache.org/ download Apache 2.0.54 (tar.gz)
• Copy downloaded files to /usr/src directory
• Open a terminal window, Applications -> System Tools -> Terminal
• Type the following in the terminal to install MySQL

#cd /usr/src
#rpm -i MySQL*          ( don’t worry if MySQL fails to start )
#mysql_install_db
#mysqld_safe &
< hit enter again >

• Now set the root password for MySQL

#mysqladmin –u root password ‘enter-new-root-password-in-single-quotes’

• Now check to see if install was successful

#mysqlshow –p
Enter Password:

You should see something like:

Databases
---------
mysql
test

• Now we need to set the ‘root’ password to the old password format and delete the blank user that was created automatically when MySQL was installed.

#mysql –u root –p
Enter Password:
mysql>SET PASSWORD FOR ‘root’@’localhost’=OLD_PASSWORD(‘New-Password’);
mysql>use mysql
mysql>delete from user where User=’’;
mysql>quit

• Now MySQL is installed and we need to install Apache and PHP. Type:

#gzip –d httpd-2.0.54.tar.gz
#tar xvf httpd-2.0.54.tar
#gunzip php-4.3.11.tar.gz
#tar -xvf php-4.3.11.tar
#cd httpd-2.0.54
#./configure --enable-so
#make
#make install
#cd ../php-4.3.11
#./configure --with-apxs2=/usr/local/apache2/bin/apxs \        (hit enter key)
 --with-mysql-sock=/var/lib/mysql/mysql.sock
#make
#make install

• Now copy the php.ini file to the correct place

#cp php.ini-dist /usr/local/lib/php.ini

• Edit the php.ini file

Search for: memory_limit = 8M, change 8M to 16M Save & Close file

• Look for libphp4.so file in /usr/local/apache2/modules/ to make sure it’s there.
• Edit the Apache configuration file in /usr/local/apache2/conf/httpd.conf

Find loadmodule and make sure this line was added, ( or add )

LoadModule php4_module modules/libphp4.so

Find addtype and add

AddType application/x-tar.tgz
AddType application/x-httpd-php .php .phtml
AddType application/x-httpd-php-source .phps

Find directoryindex and add index.php to the line:

DirectoryIndex index.php index.html index.html.var

• launch apache by typing in the terminal

#/usr/local/apache2/bin/apachectl start

If you get the following error: “ Cannot load /usr/local/apache2/modules/libphp4.so into server: /usr/local/apache2/modules/libphp4.so : cannot restore segment prot after reloc: Permission Denied” Type:

#chcon –t shlib_t /usr/local/apache2/modules/libphp4.so

now try and start:

#/usr/local/apache2/bin/apachectl start

• Test Apache by opening a web browser and typing in http://localhost/ . You should see an apache success screen.
• Test PHP

Create a file in /usr/local/apache2/htdocs/ named test.php and enter the following line in the file:

<?php phpinfo(); ?>

Save and close. Set permissions on file to 755. Now in a browser type http://localhost/test.php You should see a PHP information screen with your current settings.

• Edit MySQL’s my.cnf file

Edit or create the /etc/my.cnf file, make it look like the following:

[mysqld]
#use old password encryption method ( needed for 4.0 and older clients ).
old-passwords
basedir=/var/lib/mysql

Save and close file.

• Edit the MySQL startup file /etc/init.d/mysql

Find: basedir=/ and change to:

basedir=/var/lib/mysql

• restart MySQL by going clicking Desktop -> System Settings -> Server Settings -> Services

select mysql, click restart

• create sugarsuite folder in /usr/local/apache2/htdocs
• copy the contents of the SugarCRM 3.0.1 folder ( or latest ) to the sugarsuite folder
• Set permissions on all files to 777 for installation. Type in a terminal :

#chmod -R 777 /usr/local/apache2/htdocs/sugarsuite

• • alternate instructions that worked great for me...

#cd ..  [now in htdocs folder]
#chown -R apache sugarsuite    [change file owner to the apache webserver]
#cd sugarsuite   [back to sugar webroot]
#chmod -R 775 cache custom data modules

• • alternately #chmod -R 775 ./cache/ ./custom/ ./data/ ./modules/

#chmod 664 config.php

• To install SugarCRM, open a browser and type http://localhost/sugarsuite/
• Follow install instruction: Create User, Create Datbase. Finish Installation.
• Set SugarCRM directory permissions in terminal window.

#chmod -R 755 /usr/local/apache2/htdocs/sugarsuite
#cd /usr/local/apache2/htdocs/sugarsuite
#chmod -R 777 ./cache/ < does not work!
#chmod -R 777 ./custom/
#chmod -R 777 ./data/
#chmod -R 777 ./modules/
#chmod -R 444 config.php

• Sugar install is finished!

• Now let’s add apache to the startup process. First. Let’s copy the apache startup file to the startup directory. Type in the terminal:

#cp /usr/local/apache2/bin/apachectl /etc/init.d/

• Edit the /etc/init.d/apachectl file: Add the lines in bold.

#1/bin/sh
#
#chkconfig: - 85 15
#description: Apache is a Web server to serve HTML files and CGI.
#
#copyright (c) 2000-2004 The Apache Software Foundation

• To enable httpd to start automatically. Type in a terminal:

#/sbin/chkconfig --add apachectl

• Reboot server to see if everything starts up and works!