Peter M. Groen / knowledgetree

Commit 78ab2c2e04a67a8d664e5a149fb68a33664b3713

Authored by nbm
1 parent 001072cc

Explain how to add a dmsadmin account for use with the automated 

upgrade.


git-svn-id: https://kt-dms.svn.sourceforge.net/svnroot/kt-dms/trunk@3376 c91229c3-7414-0410-bfa2-8a42b809f60b
Inline Side-by-side
Showing 1 changed file with 51 additions and 9 deletions
docs/UPGRADE.txt
  View file @78ab2c2
... ... @@ -23,6 +23,9 @@ forced to do so. Using the automated upgrade will create an upgrade
23 23 history that can be reviewed via the KnowledgeTree administrators
24 24 interface.
25 25  
  26 +If you are upgrading KnowledgeTree from versions prior to 2.0.6, see the
  27 +section at the bottom of this document to set up automated upgrades.
  28 +
26 29 Command line:
27 30  
28 31 - Run bin/automated-upgrade.php
... ... @@ -40,13 +43,25 @@ Web page:
40 43  
41 44 - Review the results of the upgrade.
42 45  
  46 +
  47 +
43 48 Manual upgrade
44 49 --------------
45 50  
46   -In order to upgrade your KnowledgeTree installation, perform the following tasks:
47   -- Run the appropriate database upgrade scripts against your database. If you are upgrading more than one version, multiple
48   - upgrade scripts will need to be executed.
49   - eg. if you're upgrading from version 1.2.2 to version 2.0.0, the following upgrade scripts need to be executed:
  51 +In order to upgrade your KnowledgeTree installation, perform the
  52 +following tasks:
  53 +
  54 +- Upgrade your application code, by unpacking the latest download into
  55 + your webroot directory.
  56 +
  57 +- Run the appropriate database upgrade scripts against your database.
  58 +
  59 + If you are upgrading more than one version, multiple upgrade scripts
  60 + will need to be executed.
  61 +
  62 + eg. if you're upgrading from version 1.2.2 to version 2.0.0, the
  63 + following upgrade scripts need to be executed:
  64 +
50 65 - sql/mysql/upgrade/1.2.2-to-1.2.3.sql
51 66 - sql/mysql/upgrade/1.2.3-to-1.2.4.sql
52 67 - sql/mysql/upgrade/1.2.4-to-2.0.0.sql
... ... @@ -63,8 +78,6 @@ In order to upgrade your KnowledgeTree installation, perform the following tasks
63 78 - sql/mysql/upgrade/2.0.6/create_upgrade_table.sql
64 79 - sql/mysql/upgrade/2.0.6/1-update_database_version.sql
65 80  
66   -- Upgrade your application code, by unpacking the latest download into your webroot directory.
67   -
68 81 - Run any applicable upgrade scripts in the bin/upgrade directory.
69 82 eg. If you are upgrading from version 2.0.5 to version 2.0.6, you
70 83 should run:
... ... @@ -72,20 +85,24 @@ In order to upgrade your KnowledgeTree installation, perform the following tasks
72 85 - bin/upgrade/upgrade-to-2.0.6.php
73 86  
74 87 Note: You will need to run each intermediate version's upgrade scripts
75   - manually. In other words, from 2.0.5 to 2.0.7, you will need to
  88 + manually. In other words, from 2.0.5 to 2.0.7, you may need to
76 89 run both upgrade-to-2.0.6.php and upgrade-to-2.0.7.php.
77 90  
78 91 - Copy over the changes you made to the configuration to the configuration
79 92 file.
80 93  
  94 +
  95 +==========================================================================
  96 +
  97 +
81 98 Additional steps
82 99 ----------------
83 100  
84 101 KnowledgeTree 2.0.0
85 102 -------------------
86 103  
87   -When upgrading to KnowledgeTree 2.0.0, run the following commands from the
88   -KnowledgeTree root directory (not the Root Folder):
  104 +When upgrading manually to KnowledgeTree 2.0.0, run the following
  105 +commands from the KnowledgeTree root directory (not the Root Folder):
89 106  
90 107 php bin/setPermissionFolder.php
91 108 php bin/rebuildSearchPermissions.php
... ... @@ -102,6 +119,31 @@ install is at http://example.org/kt/, then go to:
102 119 Only errors will be displayed.
103 120  
104 121  
  122 +---------------------------------------------------------------------------
  123 +
  124 +
  125 +KnowledgeTree 2.0.6
  126 +-------------------
  127 +
  128 +The automated upgrade requires that you set up a database administrator
  129 +user (name configurable in config/environment.php, defaults to
  130 +'dmsadmin') for the upgrade process to function. You need to run this
  131 +command on your database (say, 'dms') from the MySQL command prompt:
  132 +
  133 +mysql> use dms;
  134 +mysql> GRANT ALL PRIVILEGES ON * TO dmsadmin@localhost IDENTIFIED BY 'js9281djw';
  135 +
  136 +In config/environment.php, you should add:
  137 +
  138 +$default->dbAdminUser = "dmsadmin";
  139 +$default->dbAdminPass = "js9281djw";
  140 +
  141 +You should now be able to use the automated upgrade.
  142 +
  143 +
  144 +---------------------------------------------------------------------------
  145 +
  146 +
105 147 Jam Warehouse � Smart Business Innovation
106 148 Phone: +27 21 4477440
107 149 Fax: +27 21 4477449
... ...