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 Database. 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!