70 lines
2.0 KiB
ReStructuredText
70 lines
2.0 KiB
ReStructuredText
.. _upgrading-with-git:
|
|
|
|
Upgrading with Git
|
|
##################
|
|
|
|
Upgrading to new Bugzilla releases is very simple, and you can upgrade
|
|
from any version to any later version in one go - there is no need for
|
|
intermediate steps. There is a script named :file:`checksetup.pl` included
|
|
with Bugzilla that will automatically do all of the database migration
|
|
for you.
|
|
|
|
.. include:: upgrading-with-1.inc.rst
|
|
|
|
You can see if you have local code customizations using:
|
|
|
|
:command:`git diff`
|
|
|
|
If that comes up empty, then run:
|
|
|
|
:command:`git log | head`
|
|
|
|
and see if the last commit looks like one made by the Bugzilla team, or
|
|
by you. If it looks like it was made by us, then you have made no local
|
|
code customizations.
|
|
|
|
.. _start-upgrade-git:
|
|
|
|
Starting the Upgrade
|
|
====================
|
|
|
|
When you are ready to go:
|
|
|
|
#. Shut down your Bugzilla installation by putting some explanatory text
|
|
in the :param:`shutdownhtml` parameter.
|
|
|
|
#. Make all necessary :ref:`backups <backups>`.
|
|
*THIS IS VERY IMPORTANT*. If anything goes wrong during the upgrade,
|
|
having a backup allows you to roll back to a known good state.
|
|
|
|
.. _upgrade-files-git:
|
|
|
|
Getting The New Bugzilla
|
|
========================
|
|
|
|
In the commands below, ``$BUGZILLA_HOME`` represents the directory
|
|
in which Bugzilla is installed. Assuming you followed the installation
|
|
instructions and your Bugzilla is a checkout of a stable branch,
|
|
you can get the latest point release of your current version by simply doing:
|
|
|
|
:command:`cd $BUGZILLA_HOME`
|
|
|
|
:command:`git pull`
|
|
|
|
If you want to upgrade to a newer release of Bugzilla, then you will
|
|
additionally need to do:
|
|
|
|
:command:`git checkout bugzilla-X.X-stable`
|
|
|
|
where "X.X" is the 2-digit version number of the stable version you want to
|
|
upgrade to (e.g. "4.4").
|
|
|
|
.. note:: Do not attempt to downgrade Bugzilla this way - it won't work.
|
|
|
|
If you have local code customizations, git will attempt to merge them. If
|
|
it fails, then you should implement the plan you came up with when you
|
|
detected these customizations in the step above, before you started the
|
|
upgrade.
|
|
|
|
.. include:: upgrading-with-2.inc.rst
|