Issue#705. Update cron documentation

Steve Johnson · Steve Johnson · commit 348c5452ff61 · 2016-07-02T18:16:15.000Z
diff --git a/_includes/config/setup-cron.md b/_includes/config/setup-cron.md
@@ -1,15 +1,22 @@
 <div markdown="1">
 
 ### Prerequisites
-Magento uses cron for two sets of tasks, and for each, cron can be run with a different configuration:
+Magento uses cron for two sets of tasks, and for each, cron can run with a different configuration:
 
-*	The general cron job that reindexes indexers, generates e-mails, generates the sitemap, and so on, typically runs as the PHP command-line user's `php.ini`
-*	Two other cron jobs are used by the <a href="{{page.baseurl}}comp-mgr/bk-compman-upgrade-guide.html">Component Manager and System Upgrade utilities</a>. Those commands must use the web server's `php.ini`.
+*	PHP command-line configuration: The general cron job that reindexes indexers, generates e-mails, generates the sitemap, and so on.
+
+	You can find the command-line configuration using the command `php --ini`. 
+*	Web server PHP plug-in configuration: Two other cron jobs are used by the <a href="{{page.baseurl}}comp-mgr/bk-compman-upgrade-guide.html">Component Manager and System Upgrade utilities</a>. 
+
+	You can find the web server plug-in configuration using <a href="{{ page.baseurl }}install-gde/prereq/optional.html#install-optional-phpinfo"><code>phpinfo.php</code>.
+
+<div class="bs-callout bs-callout-warning">
+    <p>To avoid issues during installation and upgrade, we strongly recommend you apply the same PHP settings to both the PHP command-line configuration and to the PHP web server plug-in's configuration. For more information, see the instructions in either the <a href="{{ page.baseurl }}install-gde/prereq/php-ubuntu.html#instgde-prereq-timezone">Ubuntu</a> or <a href="{{ page.baseurl }}install-gde/prereq/php-ubuntu.html#instgde-prereq-timezone">CentOS</a> PHP topics.</p>
+</div>
 
 If you're not experienced with running cron, you can run all commands with the web server's configuration; however, we leave the decision up to you.
 
 #### Find the web server configuration
-
 To find the web server configuration, run a <a href="{{page.baseurl}}install-gde/prereq/optional.html#install-optional-phpinfo">`phpinfo.php` file</a> in your web browser and look for the Loaded Configuration File as follows:
 
 <img src="{{ site.baseurl }}common/images/config_phpini-webserver.png" width="700px">
@@ -25,7 +32,7 @@ A sample result follows:
 
 #### Create the cron job
 
-To create a cron job as the Magento file system owner, enter the following command as a user with `root` privileges:
+To create a cron job for the Magento file system owner, enter the following command as a user with `root` privileges:
 
 	crontab -u <Magento file system owner user name> -e
 
@@ -35,24 +42,24 @@ For example,
 
 A text editor displays. (You might need to choose a text editor first.)
 
-	* * * * * <path_to_binary> -c <ini_file_path> <magento_dir>/bin/magento cron:run | grep -v "Ran jobs by schedule" >> <magento_dir>/var/log/magento.cron.log
-	* * * * * <path_to_binary> -c <ini_file_path> <magento_dir>/update/cron.php >> <magento_dir>/var/log/update.cron.log
-	* * * * * <path_to_binary> -c <ini_file_path> <magento_dir>/bin/magento setup:cron:run >> <magento_dir>/var/log/setup.cron.log
+	* * * * * <path to php binary> <magento install dir>/bin/magento cron:run | grep -v "Ran jobs by schedule" >> <magento install dir>/var/log/magento.cron.log
+	* * * * * <path to php binary> <magento install dir>/update/cron.php >> <magento install dir>/var/log/update.cron.log
+	* * * * * <path to php binary> <magento install dir>/bin/magento setup:cron:run >> <magento_dir>/var/log/setup.cron.log
 
 where 
 
-*	`<path_to_binary>` is the absolute file system path to your PHP binary
-*	`<ini_file_path>` is the path to a `php.ini` file to use for the cron job
+*	`<path to php binary>` is the absolute file system path to your PHP binary
+*	`<magento install dir>` is the directory in which you installed the Magento software; for example, `/var/www`
 *	`| grep -v "Ran jobs by schedule"` filters this message from the log, making any errors easier to spot
 
 The first command (`magento cron:run`) reindexes indexers, send automated e-mails, generates the sitemap, and so on. Usually it's associated with the PHP command line `.ini` file. The other two commands are used by the Component Manager and System Upgrade.
 
-For example, if the PHP binary is located in `/usr/bin`, you installed Magento in `/var/www/html/magento2`, and all commands use the web server's `/etc/php5/apache2/php.ini`, enter
+For example, if the PHP binary is located in `/usr/bin`, you installed Magento in `/var/www/html/magento2`, enter
 
 Example:
 
-	* * * * * /usr/bin/php -c /etc/php5/apache2/php.ini /var/www/magento2/bin/magento cron:run | grep -v "Ran jobs by schedule" >> /var/www/magento2/var/log/magento.cron.log
-	* * * * * /usr/bin/php -c /etc/php5/apache2/php.ini /var/www/magento2/update/cron.php >> /var/www/magento2/var/log/update.cron.log
-	* * * * * /usr/bin/php -c /etc/php5/apache2/php.ini /var/www/magento2/bin/magento setup:cron:run >> /var/www/magento2/var/log/setup.cron.log
+	* * * * * /usr/bin/php /var/www/magento2/bin/magento cron:run | grep -v "Ran jobs by schedule" >> /var/www/magento2/var/log/magento.cron.log
+	* * * * * /usr/bin/php /var/www/magento2/update/cron.php >> /var/www/magento2/var/log/update.cron.log
+	* * * * * /usr/bin/php /var/www/magento2/bin/magento setup:cron:run >> /var/www/magento2/var/log/setup.cron.log
 
 Save your changes to the crontab and exit the editor.
diff --git a/_includes/install/php-config.html b/_includes/install/php-config.html
@@ -23,19 +23,30 @@
 
 	`asp_tags` will be removed in PHP 7.
 
-To set PHP options:
+<div class="bs-callout bs-callout-warning">
+    <p>To avoid issues during installation and upgrade, we strongly recommend you apply the same PHP settings to both the PHP command-line configuration and to the PHP web server plug-in's configuration. For more information, see the next section.</p>
+</div>
+
+### Find PHP configuration files
+To find the web server configuration, run a <a href="{{page.baseurl}}install-gde/prereq/optional.html#install-optional-phpinfo">`phpinfo.php` file</a> in your web browser and look for the Loaded Configuration File as follows:
+
+<img src="{{ site.baseurl }}common/images/config_phpini-webserver.png" width="700px">
+
+To locate the PHP command-line configuration, enter
 
-1.	Locate `php.ini` by entering the following command:
+	php --ini
+
+Use the value of Loaded Configuration file.
+
+### Set PHP options
+
+To set PHP options:
 
-		php --ini
+1.	Locate `php.ini` for both the web server and the PHP command line as discussed in the preceding section.
 
-	Use the value of `Loaded Configuration File`.
-	
-	Typical locations follow:
+	Make the following changes to _both_ configurations.
 
-	*	Ubuntu: `/etc/php5/cli/php.ini`
-	*	CentOS: `/etc/php.ini`
-2.	Open `php.ini` in a text editor.
+2.	Open a `php.ini` in a text editor.
 3.	Locate your server's time zone in the available [time zone settings](http://php.net/manual/en/timezones.php){:target="_blank"}
 4.	Locate the following setting and uncomment it if necessary:
 
@@ -54,9 +65,10 @@
 		asp_tags =
 9.	Make sure its value is set to `Off`.
 10.	Save your changes and exit the text editor.
+11.	Open the other `php.ini` and make the same changes in it.
 11.	Restart your web server:
 
-	*	Ubuntu: `service apache2 restart`
-	*	CentOS: `service httpd restart`
-	*	Ubuntu and CentOS: `service nginx restart`
+	*	Apache, Ubuntu: `service apache2 restart`
+	*	Apache, CentOS: `service httpd restart`
+	*	nginx, Ubuntu and CentOS: `service nginx restart`
 
