Book Image

Implementing SugarCRM

By : Michael Whitehead
Book Image

Implementing SugarCRM

By: Michael Whitehead

Overview of this book

<p>SugarCRM is a popular customer relationship management system. It is available in both free open source and commercial versions, making it an ideal way for small-medium business to try out a CRM system without committing large sums of money. Although SugarCRM is carefully designed for ease of use, attaining measurable business gains requires careful planning and research. This book distils hard won SugarCRM experienced into an easy to follow guide to implementing the full power of SugarCRM. SugarCRM is an extensive PHP/MySQL based application but with its rich administration interfaces no programming is required to get the most of it.</p> <p>This book will give you all the information you need to start using this powerful, free CRM system. Written by veteran SugarCRM expert and experienced documentation author, Michael J. Whitehead, this book is the definitive guide to implementing SugarCRM. Whether you are wondering exactly what benefits CRM can bring, or you have already learned about CRM systems but have yet to implement one, or you're working with SugarCRM already; this book will show you how to get maximum benefit of this exciting product.</p>
Table of Contents (18 chapters)
Implementing SugarCRM
Credits
About the Author
About the Reviewer
Preface
Index

Configure Apache for Multiple Virtual Server Installations


If you intend to run more than one instance of SugarCRM on a server, perhaps providing service to a number of organizations, you will need to create multiple virtual server entries on your server. If you are performing a conventional installation of SugarCRM for a single organization, you will not need to follow the instructions in this section.

  1. Click on SUSE | System | File Manager | File ManagerSuper User Mode, and enter the root password when prompted. From file:/root, navigate upwards one click to file:/. Click on the etc folder, and then on apache2

  2. Scroll down to find the listen.conf file, and right-click on it. Select Open With | KWrite.

  3. Uncomment the name-based virtual hosting entry—NameVirtualHost *:80.

  4. Perform a File | Save, and exit KWrite.

  5. Open the folder vhosts.d in etc/apache2.

  6. In that folder, there are two template files—vhost-ssl.template, and vhost.template.

  7. Copy the vhost.template file by right-clicking on it and selecting Copy. Then right-click in an open area within the current folder, and select Paste. Enter _primary.conf as the new file name when prompted. This will be the new configuration file for your primary server entry (if your URL is example.com, then http://www.example.com will use this configuration file). Note the underscore at the start of the name—it is very important.

  8. Edit your _primary.conf file, by right-clicking on it and selecting Open With | KWrite.

  9. Replace all instances of dummy-host.example.com with the fully qualified domain you intend to serve—for instance example.com.

  10. Within the same file, uncomment the line Include /etc/apache2/conf.d/*.conf.

  11. Now find the entry beginning with DocumentRoot and edit it to read DocumentRoot /srv/www/htdocs.

  12. Now look for the entry beginning with <Directory, and edit it to read <Directory “/srv/www/htdocs”>.

  13. Save the file _primary.conf, and exit KWrite.

  14. Much the same way as in Step 7 above, copy vhost.template to your first virtual server entry, for example new.conf.

  15. Edit your new.conf file, by right-clicking on it and selecting Open With | KWrite. Replace all instances of dummy-host.example.com with the fully qualified sub‑domain you intend to create—for instance new.example.com—where example.com is the URL you have defined in steps 7-13 above.

  16. Within the same file, uncomment the line Include /etc/apache2/conf.d/*.conf.

  17. Save the file new.conf, and exit KWrite.

  18. Go to the directory /srv/www/vhosts and within that directory create the folder that will hold the content for your new sub-domain address—for instance new.example.com. When you are installing multiple instances of SugarCRM, this is the sort of folder into which it should be installed for each virtual host. As covered in step 5 of the Install SugarCRM section, ensure that permissions on this folder are set appropriately. Also—remember that each installation will require a new database to be defined within MySQL, and potentially a new MySQL user as well—or you will mix the data from one site with that of another.

  19. For each additional virtual host you wish to create, repeat steps 14-18 above.

  20. Restart the Apache web server, so that these changes come into effect.