jochenhager
03-24-2009, 05:55 PM
It took me a few attempts to successfully install SugarCRM on BlueHost. This short guide is the meant for SugarCRM CE 2.5.0c and gives a rough sequence of steps:
1) Download the SugarCRM CE 2.5.0c to your local computer. It will be a zip file.
2) Open cPanel / File Manager to create your base directory. This has to be underneath you public_html directory.
3) Use File Manager to upload the zip file into your base directory.
4) Use File Manager to decompress. This will create a new directory with all the files in it.
5) Change the Sugar Directory name to something shorter and simpler to type in a url if you like - optional
6) Place your php.ini file in the Sugar Directory - you need to adjust a number of parameters in the php.ini file (refer to the sugar installation release notes - the install script will check the parameters and let you know if some are off). Most important are memory_limit = 60M and upload_max_filesize = 8M.
7) Use File Manager to change permission of file config.php to 664 in your SugarCRM directory.
8) This step is tricky: you need to chmod the permissions on whole directory trees. The SugarCRM installation guide on the wiki advises to change permission on the following directory trees to 775 for all directories and 664 for all files in cache, custom, modules and data. You can do this through a SSH (requires setup and permission from BlueHost or you can use your FTP client, using their recursive chmod option. In essence a simple version of the command is: chmod -R 775 cache custom modules data
9) I was not able to create a database on the fly during installation. A way to make it work is to use the MySQL Database tool in the cPanel to create an empty database with a database admin user. Create the DB, create the admin user, assign the user to the database. The BlueHost database names will be created as <yourdomain>_<yourdbname>: example: dummydomain_sugarcrm. An administrator name could be dummydomain_admin.
10) Now you are ready to run the install script in your SugarCRM directory by entering the url: www.mydomain.com/.../<sugardirectory>/install.php
11) Follow the installscript entering the DB name and admin name you created above. The script will warn you that all data in your database will be dropped. That's OK, it is empty anyway.
12) Complete the installation. If you get an error, delete everything, and start with uncompressing the ZIP file and make sure your DB is empty again.
13) On successful completion - celebrate! you are almost there.
14) Weirdly some newly created files will have wrong file access permissions to perform SugarCRM customizations like changing the logo to a custom log and get all red status messages and some pop-ups with the correct text. To fix this, you need to run the above chmod commands again.
15) Done! :)
Helpful links:
http://www.sugarcrm.com/forums/
http://www.sugarcrm.com/wiki/index.php?title=Required_file_system_permissions_o n_Linux
1) Download the SugarCRM CE 2.5.0c to your local computer. It will be a zip file.
2) Open cPanel / File Manager to create your base directory. This has to be underneath you public_html directory.
3) Use File Manager to upload the zip file into your base directory.
4) Use File Manager to decompress. This will create a new directory with all the files in it.
5) Change the Sugar Directory name to something shorter and simpler to type in a url if you like - optional
6) Place your php.ini file in the Sugar Directory - you need to adjust a number of parameters in the php.ini file (refer to the sugar installation release notes - the install script will check the parameters and let you know if some are off). Most important are memory_limit = 60M and upload_max_filesize = 8M.
7) Use File Manager to change permission of file config.php to 664 in your SugarCRM directory.
8) This step is tricky: you need to chmod the permissions on whole directory trees. The SugarCRM installation guide on the wiki advises to change permission on the following directory trees to 775 for all directories and 664 for all files in cache, custom, modules and data. You can do this through a SSH (requires setup and permission from BlueHost or you can use your FTP client, using their recursive chmod option. In essence a simple version of the command is: chmod -R 775 cache custom modules data
9) I was not able to create a database on the fly during installation. A way to make it work is to use the MySQL Database tool in the cPanel to create an empty database with a database admin user. Create the DB, create the admin user, assign the user to the database. The BlueHost database names will be created as <yourdomain>_<yourdbname>: example: dummydomain_sugarcrm. An administrator name could be dummydomain_admin.
10) Now you are ready to run the install script in your SugarCRM directory by entering the url: www.mydomain.com/.../<sugardirectory>/install.php
11) Follow the installscript entering the DB name and admin name you created above. The script will warn you that all data in your database will be dropped. That's OK, it is empty anyway.
12) Complete the installation. If you get an error, delete everything, and start with uncompressing the ZIP file and make sure your DB is empty again.
13) On successful completion - celebrate! you are almost there.
14) Weirdly some newly created files will have wrong file access permissions to perform SugarCRM customizations like changing the logo to a custom log and get all red status messages and some pop-ups with the correct text. To fix this, you need to run the above chmod commands again.
15) Done! :)
Helpful links:
http://www.sugarcrm.com/forums/
http://www.sugarcrm.com/wiki/index.php?title=Required_file_system_permissions_o n_Linux