Changes between Version 84 and Version 85 of TracPlugins

Timestamp:

Jul 18, 2015, 5:56:40 AM (9 years ago)

Author:

Ryan J Ollos

Comment:

Document upgrade of environment, raised in ​gmessage:trac-users:_Q17mg7zJF4/zrKnLx8HgHAJ.

TracPlugins

@@ -89 +89 @@
 
 After installing the plugin, you must restart your web server.
+
+==== Upgrading the environment
+
+Some plugins may require an environment upgrade. This will typically be necessary for plugins that implement `IEnvironmentSetupParticipant`. Common reasons for requiring an environment upgrade are to add tables to the database or add configuration parameters to trac.ini. A notification will be displayed when accessing Trac for the first time after installing a plugin and restarting the web server. To upgrade the environment, run the command:
+
+{{{#!sh
+$ trac-admin /path/to/env upgrade
+}}}
+
+A database backup will be made before upgrading the environment, unless the `--no-backup` option is specified. For more information, refer to the documentation output by `trac-admin /path/to/env help upgrade`.
 
 ==== Uninstalling