CiviCRM Image Guide
Version 4.7.23
Websoft9 CiviCRM is a pre-configured, ready to run image for running CiviCRM on Alibaba Cloud.
CiviCRM is a constituent relationship management system designed to meet the needs of advocacy, non-profit and non-governmental groups. It is an open source project, licensed under GNU AGPL 3.CiviCRM is released as a module that runs within the Drupal, Joomla, and WordPress content management systems.
CiviCRM Stack Components
Application Software(CiviCRM4.7.23,WordPress4.8) Software directory: /data/wwwroot/civicrm You should know that CiviCRM is a module running within the WordPress
Application Server(PHP7.0,APACHE2.4) PHP Configuration File: /etc/php/7.0/apache2/php.ini Apache Vhost Configuration File: /etc/apache2/sites-available Apache Log Files:/var/log/apache2
Database(MYSQL5.7) Database install directory: /usr/share/mysql Database data directory: /data/mysql Database Configuration File: /etc/mysql/mysql.conf.d/mysqld.cnf PhpMyAdmin install directory: /usr/share/phpmyadmin Kown more from MySQL User Guide (http://en.websoft9.com/xdocs/manage-mysql%ef%bc%88lnmplamp- image-%ef%bc%89)
Verify the Image
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 Start Installation page of this Image If no response from browser,please check the Security Group settings (https://www.alibabacloud.com/help/doc-detail/25471.htm) to ensure that port 80 is been allowed
Start to install CiviCRM
Using Chrome or Firefox to visit: http://Internet IP Addres/ to start the tapplication installation process.It is recommended to complete two steps before the installation:
Domain resolution if you want to use (Add an A record to the Internet IP Address of Server from your Domain Control Panel) Modify the MySQL password of Root through PhpMyAdmin
Then access the installation page by domain directly and complete the installation wizard for the following steps: 1. Open your domain name via browser,Visit URL: http://Internet IP Addres/;
2. Select the language,Click “Continue”;
(http://libs.websoft9.com/Websoft9/DocsPicture/en/wordpress/wp01.png) 3.Click “Les’s go!”;
(http://libs.websoft9.com/Websoft9/DocsPicture/en/wordpress/wp02.png)
4.Fill in your database user, password, and database name;Click “Submit”;
5.Click “Run the install”;
(http://libs.websoft9.com/Websoft9/DocsPicture/en/wordpress/wp05.png) 6.Set administrator user, password and mail;Click “Install WordPress”;
(http://libs.websoft9.com/Websoft9/DocsPicture/en/wordpress/wp06.png)
7.Wordpress has been installed successfully and we log in the backend to active the CiviCRM plugin. Use http://
8.Then you can find the “CiviCRM Installer” item on the left menu of WordPress
9.Once you see the green “You’re ready to install!” message,Click the “Check Requirements and Install CiviCRM” Note:CiviCRM may be configured to use your existing WordPress database, or a separate (new) database.If you still see a red bar with the message “These database details don’t appear to be correct.” – check the Database Details section below your settings for specific errors and problems. Once you correct these problems, click “Recheck requirements” to verify your settings before continuing.
10.After installation, There should now be a CiviCRM link in your WordPress menu. Click that link and the CiviCRM Menu, Shortcuts, Search and New Individual Blocks should appear.
Frequently used Usernames and Passwords
Three usernames and passwords are required for application installation, application using, andapplication maintenance:
1、CiviCRM:Username and password is set by youself when installation, Backend URL:http://youdomain.com/wp-admin 2、MySQL Database:Default username and password is root/123456, Control Panel URL:http://Internet ip Address/phpmyadmin 3、Linux Server:Username is root,Password is set by youself when buying.You can reset the password through console and restart the Server if you have forgotten it Please Using the putty for Remote and WinSCP for SFTP
Using Extensions
CiviCRM extensions allow you to install additional features for your site. Go to the Administer->System Settings->Extensions,the page will automatically list the available “native” extensions from the CiviCRM.org extensions directory (https://civicrm.org/extensions) which are compatible with this version of CiviCRM. If you install Custom Searches, Reports or Payment Processor extensions – these will automatically be available on the corresponding menus and screens.
Below are the steps of Extensions installations:
1. Go to the Administer->System Settings->Extensions page,then Cick “Add new”
2. Click the “Download” button,and then click the “Download and Install”
3. The extension’s installation is OK
Backup
Routine backup (archives) of the database and application setup is essential to ensure failover is smooth.you can use Manual Backup as following steps:
1. Download the entire civicrm directory(/data/wwwroot/civicrm) by SFTP or other tools 2. Visit http://< Internet IP Address >/phpMyAdmin,login in to the phpMyAdmin Panel 3. Select your database,then Export it
4. Click “go” button for backup process,and then download the SQL backup file
Upgrade
Before upgrade you should put the site down for maintenance and always Backup your code, data and config files.
More detais read the https://wiki.civicrm.org/confluence/display/CRMDOC/Upgrading+CiviCRM+for+WordPres (https://wiki.civicrm.org/confluence/display/CRMDOC/Upgrading+CiviCRM+for+WordPress)
How to access phpMyAdmin?
Websoft9 Mantis Image have installed the 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” How to start or stop the services?
Ubuntu Linux
Apache http service
~# service apache2 start ~# service apache2 stop ~# service apache2 restart ~# service apache2 reload #Configuration file
MySQL service
~# service mysqld start ~# service mysqld stop ~# service mysqld restart
Else
~# a2dismod ModuleName #disable Apache2 module ~# a2enmod ModuleName #enable Apache2 module ~# a2ensite Configuration #enable vhost configuration ~# a2dissiteConfiguration #disable vhost configuration
How to Create CiviCRM Contacts for Existing WordPress Users?
Once installed, CiviCRM keeps your WordPress Users synchronized with corresponding CiviCRM contact records. The ‘rule’ is that there will be a matched contact record for each WordPress user record. Conversely, only contacts who are authenticated users of your site will have corresponding WordPress user records.
When CiviCRM is installed on top of an existing WordPress site, a special CiviCRM Administrative feature allows you to automatically create CiviCRM contacts for all existing WordPress users:
Login to your WordPress site with an administrator-level login Click the CiviCRM link in the main navigation block (If your WordPress site makes use of the db_prefix setting (in settings.php – cf. Step 2, above), in de top bar click Administer » System Settings » CMS Database Integration, and update the box for the WordPress Users Table Name so that it includes the prefix.) Click Administer in the menu bar Click Users and Permissions from the drop-down menu, then select Synchronize Users to Contacts
How to change the permissions of filesytem?
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-data If there is a file permissions problem, execute the following three commands:
chown -R www-data.www-data /data/wwwroot/civicrm find /data/wwwroot/default/civicrm -type d -exec chmod 755 {} \; find /data/wwwroot/default/civicrm -type f -exec chmod 644 {} \;
How to modify the allowed limit for upload?
Modify the /etc/php/7.0/apache2/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 # systemctl restart httpd
How to modify PHP settings?
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 /etc/php/7.0/apache2/php.ini.
There are some PHP settings that need to be sufficient to install.
e.g The values for PHP.ini below are suggested values only.
memory_limit – Minimum: 256M Recommended: 1G 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:
# systemctl restart httpd
How to change the max_execution_time?
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 /etc/php/7.0/apache2/php.ini ; Maximum execution time of each script, in seconds ; http://php.net/max-execution-time ; 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 ; idea to limit this time on productions servers in order to eliminate ; long running scripts.
Method two: edit your .htaccess:
CiviCRM Help Links
Detailed installation instructions are on the wiki (https://wiki.civicrm.org/confluence/display/CRMDOC/Installation+and+Upgrades). Documentation can be found at https://civicrm.org/documentation (https://civicrm.org/documentation) Answers for users, administrators & integrators: http://civicrm.stackexchange.com (http://civicrm.stackexchange.com/) Report all issues to CiviCRM via JIRA: https://issues.civicrm.org (https://issues.civicrm.org/)
Websoft9