From 9f1b50ad2cfc3058117aaa8a81f73c9b2297e33d Mon Sep 17 00:00:00 2001
From: adonohue <aran@fb.com>
Date: Sun, 6 Mar 2011 14:56:12 -0800
Subject: [PATCH] Update documentation to mention the need to apply sql
 patches.

Summary:
Update documentation to mention the need to apply sql patches.

Task ID: #

Test Plan:
No

Reviewed By: epriestley
Reviewers: epriestley
CC: epriestley
Revert Plan:
OK

- begin *PUBLIC* platform impact section -
Bugzilla: #
- end platform impact -

Differential Revision: 52
---
 src/docs/configuration_guide.diviner | 27 +++++++++++++++++----------
 1 file changed, 17 insertions(+), 10 deletions(-)
 mode change 100644 => 100755 src/docs/configuration_guide.diviner

diff --git a/src/docs/configuration_guide.diviner b/src/docs/configuration_guide.diviner
old mode 100644
new mode 100755
index c3a1316457..f00bc2db33
--- a/src/docs/configuration_guide.diviner
+++ b/src/docs/configuration_guide.diviner
@@ -11,11 +11,18 @@ If you haven't, see @{article:Installation Guide}.
 = Configuring MySQL =
 
 Get MySQL running and verify you can connect to it. Consult the MySQL
-documentation for help. When MySQL works, you just need to load the Phabricator
-schemata into it:
+documentation for help. When MySQL works, you need to load the Phabricator
+schemata into it. First, load the initial database schema.
 
   mysql -uroot < path/to/phabricator/resources/sql/init/initialize.sql
 
+Next, load each of the database patches in order. (One day this will be
+better.)
+
+  mysql -uroot < path/to/phabricator/resources/sql/patches/000.project.sql
+  mysql -uroot < path/to/phabricator/resources/sql/patches/001...
+  ...
+
 = Configuring Apache =
 
 Get Apache running and verify it's serving a test page. Consult the Apache
@@ -36,11 +43,11 @@ this:
   <VirtualHost *>
     # Change this to the domain which points to your host.
     ServerName phabricator.example.com
-    
+
     # Change this to the path where you put 'phabricator' when you checked it
     # out from github when following the Installation Guide.
     DocumentRoot /path/to/phabricator/webroot
-    
+
     RewriteEngine on
     RewriteRule ^/rsrc/(.*)     -                       [L,QSA]
     RewriteRule ^/favicon.ico   -                       [L,QSA]
@@ -52,7 +59,7 @@ this:
     # the next section for details.
     SetEnv PHABRICATOR_ENV setup
   </VirtualHost>
-  
+
 Now, restart apache and navigate to whichever subdomain you set up. You should
 either see the Phabricator login screen, which means you're all set, or some
 useful error message telling you what else you need to fix (for instance, you
@@ -65,7 +72,7 @@ Now that basic setup is complete, you should configure Phabricator. Phabricator
 configuration options which control how the applications behave are stored here:
 
   /path/to/phabricator/conf/
-  
+
 There are several configuration templates:
 
   - ##default.conf.php##: root configuration, lists every configuration option
@@ -82,18 +89,18 @@ There are several configuration templates:
   - ##setup.conf.php##: pulls in ##default.conf.php##, but sets some flags that
     make it easier to set up a Phabricator install. Switch away from this before
     deploying a production install.
-  
+
 While you can use these templates as-is, you'll probably want to set up custom
 configuration. To do this, create a new file:
 
   /path/to/phabricator/conf/custom/myconfig.conf.php
-  
+
 Put this in the file:
 
   <?php
 
   return array(
-  
+
     // This is just an example.
     'some.config' => 'some_value',
 
@@ -109,6 +116,6 @@ configuring Apache:
     SetEnv PHABRICATOR_ENV custom/myconfig
     # ...
   </VirtualHost>
-  
+
 Now, look through ##default.conf.php## and override any options you want to
 change by providing overrides in ##myconfig.conf.php##.