MantisBT Upgrade Question

Get help from other users here.

Moderators: Developer, Contributor

Post Reply
gstoyanov
Posts: 4
Joined: 28 Feb 2019, 15:06

MantisBT Upgrade Question

Post by gstoyanov »

Hi All,

I am having a MantisBT version 2.19 and I would like to upgrade to the latest stable version 2.21.1. I have checked the manual and I think the upgrade chapter: https://www.mantisbt.org/docs/master/en ... grade.html is a bit confusing. First, it is asking to download and extract the latest version from within the webserver, then to put the website into maintenance mode and to run the /admin/install.php script from the already downloaded MantisBT which is only creating/updating the Database according to my opinion. It is missing to mention what to do with the extracted MantisBT directory after the upgrade is complete and also which URL for accessing it after the update. It fails to mention that you need to delete the
mantis_offline.php
in order to get your bug tracker out of maintenance mode and how you can confirm that the upgrade/update went smoothly.

I have moved the directory to a backup directory and I have enabled in the
/mantis/config/config_inc.php
the
$g_show_version = ON;
but it is still showing me 2.19. So I guess I need to merge the new_bt directory with the old one. Am I right?
cas
Posts: 1586
Joined: 11 Mar 2006, 16:08
Contact:

Re: MantisBT Upgrade Question

Post by cas »

If you follow the readme, instructions seem very clear to me :mrgreen:
UPGRADING
---------

* Backup your existing installation and database -- really!
* Extract the tarball into a clean directory; do not extract into an existing
installation, as some files have been moved or deleted between releases
* Copy your configuration from the old installation to the new directory,
including config_inc.php, custom_strings_inc.php, custom_relationships_inc.php,
custom_functions_inc.php and custom_constants_inc.php if they exist
* Point your browser to http://path/to/mantisbt/admin/check/index.php to ensure that
your webserver is compatible with MantisBT and configured correctly
* Point your browser to http://path/to/mantisbt/admin/install.php to upgrade
the database schema
* Click install/upgrade
* Remove the admin/ directory from within the MantisBT installation path. The
scripts within this directory should not be accessible on a live MantisBT
site or on any installation that is accessible via the Internet.
* Upgrading is complete
gstoyanov
Posts: 4
Joined: 28 Feb 2019, 15:06

Re: MantisBT Upgrade Question

Post by gstoyanov »

As a matter of fact, it is not really well explained how to perform the upgrade.

In the past, I was accessing my Bug Tracker at let's say https://example.com which is looking at

Code: Select all

/var/www/html/mantisbt
. According to the manual I need to extract the files to a different directory let's say

Code: Select all

/var/www/html/mantisbt/new
then in order to initiate the upgrade I need to point my browser to https://example.com/new/admin/install.php. This will update my database. After the update, do I need to access my bug tracker at https://example.com/new or do you suggest changing the NGINX configuration to point to the new path? This is the part I don't understand. According to me the update should not even require downloading/extracting and re-starting the same install.php script and the tracker should have a built-in upgrade menu, which should take care of everything giving you the choice to either do everything automatically or to upload manually the update package.

[EDIT] I also don't know where do you see this upgrade README file but this is the official documentation: https://www.mantisbt.org/docs/master/en ... grade.html and there is no mention about the https://example.com/admin/check.php script.
cas
Posts: 1586
Joined: 11 Mar 2006, 16:08
Contact:

Re: MantisBT Upgrade Question

Post by cas »

The readme is in the root of the installation package.
But let me tell you how I do it:
1. copy the old installation to somehwere else ( please note the current permission settings )
2. delete the old installation with the exception of the files directory
3. Extract the new version into the exiting folder
4. Copy your configuration from the backup location to the default mantis directory,
including config_inc.php, custom_strings_inc.php, custom_relationships_inc.php,
custom_functions_inc.php and custom_constants_inc.php if they exist
5. Copy all additional pluging from the backup directory
6. Point your browser to http://path/to/mantisbt/admin/check/index.php to ensure that
your webserver is compatible with MantisBT and configured correctly
7. Point your browser to http://path/to/mantisbt/admin/install.php to upgrade
the database schema
8. Click install/upgrade
9. Remove the admin/ directory from within the MantisBT installation path. The
scripts within this directory should not be accessible on a live MantisBT
site or on any installation that is accessible via the Internet.
10. Upgrading is complete :mrgreen:
gstoyanov
Posts: 4
Joined: 28 Feb 2019, 15:06

Re: MantisBT Upgrade Question

Post by gstoyanov »

Thanks for your help, cas, this makes more sense.
Post Reply