This guide covers installing SugarCRM on ClearOS 6.x. ClearOS 5.x can also run SugarCRM but will need modifications to the underlying PHP libraries. Consider using ClearOS 6.x instead.
You will need to have the following modules/apps installed and configured from the ClearOS Marketplace in order to deploy SugarCRM:
In your Web Server, you will need to decide which place you will host your files. You can either create a virtual server for just your CRM or you can also place SugarCRM in a subfolder of your default server or a subfolder in a virtual server. In this HowTo we will be placing our CRM in a subfolder of a virtual server in order to demonstrate that you can run multiple instances of SugarCRM all from the same server.
SugarCRM also requires some changes to your PHP environment which you will need to make via command line. You will also need the GD library.
yum -y install php-gd
Change this line:
upload_max_filesize = 2M
upload_max_filesize = 10M
After you make these changes, stop and start your web server.
service httpd restart
From SugarCRM's site you can navigate to the download at the bottom of their page where it says 'Download Community Edition'. From here you can download the 'no support' Community version or begin your trial of the paid version. <Shameless plug>As with other open source projects, using the paid version is a great way to further development of the project. If you are using SugarCRM for your business and it will become core to what you are doing, you will get a lot of benefit from using the paid version. This is especially true if you need it to do some custom things particular to your line of business or if you ever need support because you messed up your data.<\Shameless plug>
If you download the code to your computer, you will need to transfer it to your ClearOS server. You can do this using the flexshare method associated with the Web server option selected for uploads, WinSCP, or any other method. Additionally, you can use wget from command line. As of this writing the latest SugarCRM is 6.5.15.
yum -y install wget wget http://downloads.sourceforge.net/project/sugarcrm/1%20-%20SugarCRM%206.5.X/SugarCommunityEdition-6.5.X/SugarCE-6.5.15.zip
Once you have copied this file to your server, unzip the file:
yum -y install unzip unzip SugarCE-6.5.15.zip
This will create a directory with a name similar to SugarCE-Full-6.5.15.
You will need to move the contents of this directory to your Web Server that you have provisioned. At a minimum, you will need to do at least one of the following:
In my case, I've created a virtual server called crm.clearos.com. Because I want to have multiple instances of SugarCRM running I will use a sub directory instead of placing it in the root folder. I'm going to use the name 'corporate'. So I used the following commands to move the date from my /root/ directory and set up my directory under my virtual server(change the path to be your directory):
mv /root/SugarCE-Full-6.5.15 /var/www/virtual/crm.clearos.com/ mv /var/www/virtual/crm.clearos.com/SugarCE-Full-6.5.15 /var/www/virtual/crm.clearos.com/corporate chown -R --reference /var/www/virtual/crm.clearos.com /var/www/virtual/crm.clearos.com chmod -R --reference /var/www/virtual/crm.clearos.com /var/www/virtual/crm.clearos.com chown -R apache /var/www/virtual/crm.clearos.com chmod 766 /var/www/virtual/crm.clearos.com/corporate/config.php chmod 766 /var/www/virtual/crm.clearos.com/corporate/config_override.php chmod 766 /var/www/virtual/crm.clearos.com/corporate/custom chmod -R 766 /var/www/virtual/crm.clearos.com/corporate/cache/
With the server running and the default data where it should be, navigate to the root directory of the web server. In my case it is:
You will be presented with the start of the setup wizard.
Choose your language and click Next.
Read through the next page. You may also want to print this page as it has many useful facts about how SugarCRM will be installed. Click Next.
SugarCRM is licensed under GPLv3. Check the 'I Accept' box and click Next.
The next screen reviews all of the prerequisites to install SugarCRM. If you have been following this guide closely, you will have addressed these issues through the install process if not, by default, SugarCRM requires that you:
If you pass the test, the system will do a short count down and proceed with this screen:
This guide covers the typical install. Click Next.
On the next screen, you will have the mysqli driver listed, click Next.
In the database configuration page, fill in the appropriate fields:
In the next screen, you will need to specify the user with admin privileges. This can be a real user or you can use 'admin'.
You will be given a summary of the things you have configured. Review the summary and fix any problems that may exist. You will want to add the scheduler at this time as well.
Add this line (change the path to the appropriate place of the cron.php file):
Click the 'Install' button to finish. The wizard should report that the installation completed successfully. Click 'Next' to continue.
Finally, you can register with SugarCRM to receive emails and provide feedback. Once you are done, click 'Next' to continue.
Congratulations, you've installed SugarCRM and can now log in and get to work.