Toggle navigation

SuiteCRM Image Guide

Version 7.8.2

Websoft9 SuiteCRM is a pre-configured, ready to run image for running SuiteCRM on Alibaba Cloud.

SuiteCRM is a fork of SugarCRM Community Edition. Massively extended, SuiteCRM delivers Workflow, Reporting, Portal, Quotes, Products, Invoices, Accounts, Contacts, Opportunities, Projects, Responsive mobile theme, Email marketing campaigns, Knowledge Base, Outlook and Thunderbird integration, Contracts, Leads, Activities and much more.

Software Version: SuiteCRM7.8.2
Software directory: /data/wwwroot/default/suitecrm

Basic software environment: LAMP
PHP Configuration File: /usr/local/php/etc/php.ini
Virtual host Configuration File directory: /usr/local/apache/conf/vhost
Virtual host Configuration Command: /root/oneinstack/

Database install directory: /usr/local/mysql
Database data directory: /data/mysql
Database Configuration File: /etc/my.cnf

After the installation of Image,please verify it

  • Login on Alibaba Cloud console,get you Internet IP Address
  • Open you Chrome or Firefox on your local PC,visit the http://Internet IP Address/
  • If verify successfully,you can enter the boot page of Websoft9 below
  • If no response from browser,please check the Security Group settings to ensure that port 80 is been allowed

This Image use MySQL for database

#default user/password:root/123456

MySQL User Guide: Click here

Step1. Create a database

1.login in MySQL:

Method 1:Use following URL to open phpMyAdmin page: http://< Public net IP >/phpMyAdmin

Method 2:Use SSH command to login in.

mysql -uroot –p                                #enter mysql console

 #default user/password:root/123456            More MySQL User Guide: Click here


2.create a database:

MySQL [(none)]> create database mydbname;

MySQL [(none)]> show databases;


3.Create a Database User and grants permissions to the User:

MySQL [(none)]> grant all privileges on mydbname.* to username@'localhost' identified by 'userpassword';

MySQL [(none)]> flush privileges;

MySQL [(none)]> exit;


Step2. Add a virtual host

Use SSH Command to Add a virtual host:

[root@iZbp1i4rjdsy216yq7lgucZ ~]# cd /root/oneinstack
[root@iZbp1i4rjdsy216yq7lgucZ oneinstack]# ./

Step3. Install SuiteCRM

Open your domain name via browser:
1. Agree the license, Click “Next”;

2. Click “Next”;

3. Fill in your database configration and set admin account, Click “Next”;

4. Installation was successful! You can now log in to SuiteCRM (using your admin account ).


  1. Log into your existing SuiteCRM application as the administrator and click admin on the right-hand corner of the page.
  2. System->Backups
  3. Input the backup directory adn Filename,then click the “Confirm Settings”
  4. Settings confirmed. Press “run backup” to perform the backup.
  5. Now,your backup file has been generated
  6. Then,you should go to phpMyAdmin and export the Database
  7. Visit http://< Internet IP Address >/phpMyAdmin,login in to the phpMyAdmin Panel
  8. Select you database,then Export
  9. Click “go” button,then download the SQL backup file

The Upgrade Wizard provides a quick way to upgrade to the latest version of the SuiteCRM application. It includes critical upgrade logic as well as the SQL commands needed to upgrade the application. Ensure that the config.php file for your installation, located in the SuiteCRM root directory, is writable, before using the Upgrade Wizard. Note: Manual upgrades by file replacements and running the upgrade SQL are not supported.

  1. Download the appropriate SuiteCRM Upgrade zip file from the SuiteCRM website or GitHub Repository to your local machine.
  2. Log into your existing SuiteCRM application as the administrator and click admin on the right-hand corner of the page.
  3. Click Upgrade Wizard in the Systems panel of the Administration Home page.
    • This displays the Upgrade Wizard page.
  4. Click Next.
    • This displays the System Checks page. and SuiteCRM begins the system check process. The Systems Check page indicates that there were no issues if the system check process completes successfully. Issues with file permissions, database, and server settings are listed on the page if the system check process encountered any problems.
  5. Click Next if the system check is successful.
    • This displays the Upload an Upgrade page.
  6. Click Browse, and navigate to the location of the upgrade zip file and select it.
    • The path to the file displays in the Upload an upgrade field.
  7. Click Upload Upgrade to upload the package to the SuiteCRM application.
    • The system uploads the package and displays it on the page. Use the Delete Package button to remove the package if necessary.
  8. Click Next.
    • This displays the Preflight Check page.
    • Click Show Schema Change Script toview differences in the SuiteCRM databases schema between your current and new SuiteCRM versions.
    • By default, the Upgrade Wizard Runs SQL option is selected as the database update method. Select Manual SQL Queries from the Database Update Method drop-down list and select the Check when SQL has been manually run box, if you ran the SQL queries manually.
  9. Click Recheck to rerun Preflight Check. Click Next to skip this step.
    • This displays the Commit Upgrade page.
    • You can also click Show to see a list of files that were copied and the rebuilt results. You can also view skipped queries.
  10. Click Next.
    • During the upgrade process, SuiteCRM performs a three-way merge between the customized instance on old version, default instance on old version, and default instance on new version. This three-way merge adds any fields that have been added to the default module layouts in the new version to the corresponding module layouts in the existing version, if the module layouts in the old version were not customized through Studio (or in the appropriate upgrade-safe way) prior to the upgrade. The three-way merge also changes the placement of fields in non-Studio-customized module layouts to match the placement in the default module layouts.
    • SuiteCRM displays the Confirm Layouts page as Step 5 of the upgrade process if the existing module layouts have been customized, and there are changes to the default fields and field placement in the new module layouts.
    • The Confirm Layouts page lists the module layouts that have changed in the new version. The administrator has the option of applying the changes to the existing module layouts. By default, all of the listed module layouts are selected to be merged during the upgrade.
    • For example, in 6.1.0, SuiteCRM added the Assigned To fields to the default Detail View and Edit View layouts for Notes and for Email Templates. If the instance being upgraded has a customized EditView layout for Notes, but no customized layouts for Email Templates, the following will occur during the upgrade:
    a. The Confirm Layouts page appears as Step 5 in the Upgrade Wizard
    b. The Confirm Layouts page displays the Notes module with the EditView and DetailView layouts. The Email Templates layouts do not display on the Confirm Layouts page because the existing layouts were not customized.
    c. The Administrator has the option of choosing to merge the changes in the Notes module with the existing customized EditView layout.
  11. Uncheck the module if you do not want to add the new fields to a module.
  12. Click Next.
    • This displays a message confirming that the layouts were successfully merged (if you chose to update your modules).
  13. Click Next.
  14. The Debrief page confirms the upgrade installation. Complete the steps for manual merging of files or running SQL queries now.
  15. Click Done.
    • This displays the Home page indicating that the upgrade is complete.
  16. Click Repair and select the Rebuild Relationships andRebuild Extensions options in the Systems panel of the Administration Home page.
    • For more information, see Repair.
  17. Manually merge the files by extracting the skipped file from the patch zip file if you unchecked any files to prevent the Upgrade Wizard from overwriting them. Merge the file installed in the SuiteCRM application directory.
    • Note:Check the upgradeWizard.log file in the SuiteCRM folder for information on unsuccessful SuiteCRM upgrades.

Websoft9 SuiteCRM Image have installed the phpMyadmin

phpMyAdmin install directory: /data/wwwroot/default/phpMyAdmin


Following is the step for access phpMyadmin

  1. Open Chrome or Firefox on your local PC
  2. visit the http://Internet IP Address/phpMyAdmin,you can enter the login page
  3. select you language,Username:root,Password:123456
  4. Click the button “Go”


Following is the step for access phpMyadmin

  1. User Remote Desktop Connection of Window to connect to you ECS
  2. Install a Chrome or Firefox browser on you ECS
  3. Open Chrome or Firefox on your ECS
  4. visit the http://localhost/phpMyAdmin,you can enter the login page
  5. select you language,Username:root,Password:123456
  6. Click the button “Go”

SuiteCRM support multi languages,

  1. Find and Download the language package
  2. Administrator->MODULE LOADER,upload the language package,then install it
  3. Afer the intallation,you can receive the message “The language package is ready to be installed.”
  4. go to Administrator->admin->system-Language,now you can see the new language item
  5. Log out,and log in again,you can see the language selections upper one the account


System Administrators can allow non-admin users to add groups to records. This can be done by doing the following steps:

  1. Navigate to Configure Tabs. Add Security Groups to the displayed tabs.
  2. Run Repair Roles, within Admin->Repair, to be able to assign rights to Security Groups.
  3. Edit role(s) to Enable Security Groups Management.
  4. Edit role(s) to set List to All or Group for Security Groups Management as desired.

When install new extension from back-end it will not successful,may be the permissions of file and folder is not appropriate,you should change it

Web site root permissions to follow:
file 644, folder 755 ,Permissions Users and groups www
If there is a file permissions problem, execute the following three commands:

chown -R www.www /data/wwwroot/default/suitecrm
find /data/wwwroot/default/suitecrm -type d -exec chmod 755 {} \;
find /data/wwwroot/default/suitercrm -type f -exec chmod 644 {} \;

Modify the  /usr/local/php/etc/php.ini file to increase the allowed size for uploads:

; Maximum size of POST data that PHP will accept.
post_max_size = 16M
; Maximum allowed size for uploaded files.
upload_max_filesize = 16M

then,restart the apache

# service httpd res

The PHP configuration file allows you to configure the modules enabled, the email settings or the size of the upload files. It is located at /usr/local/php/etc/php.ini.

There are some PHP settings that need to be sufficient to install.

The values for PHP.ini below are suggested values only.

  • memory_limit – Minimum: 64M Recommended: 128M or better
  • upload_max_filesize – Minimum: 20M
  • post_max_size – Minimum: 20M
  • max_execution_time: At Least 120 Recommended: 300

After modifying the PHP configuration file, restart both Apache and PHP-FPM for the changes to take effect:

# service httpd restart


If you receive the message “Maximum execution time of 30 seconds exceeded”.You may also like to extend the max_execution_time for PHP and you can modify it by two methods below

Method one: edit your  /usr/local/php/etc/php.ini

; Maximum execution time of each script, in seconds
; Note: This directive is hardcoded to 0 for the CLI SAPI
max_execution_time = 90
; Maximum amount of time each script may spend parsing request data. It's a good
; idea to limit this time on productions servers in order to eliminate unexpectedly
; long running scripts.

Method two: edit your .htaccess:

<IfModule mod_php5.c>
php_value max_execution_time 90