Exactly how to upgrade (update) MLF to new version? (Technics)

by AlmostAnonymous, Thursday, May 07, 2020, 04:51 (174 days ago)

Hi,

I attempted an upgrade to the latest code a few months ago and it was a real mess. I had to restore my board from backups.

All I see for instructions is from the Github page "Run the installation script by accessing yourdomain.tld/forum/install/ in your web browser and follow the instructions."

Skeptical that this is all there is to it for an upgrade (upgrading an existing site with DB settings and many messages plus data such as avatars I don't want to wipe out.)

So I would like to understand the exact procedure to follow all in one place.

Facts:

- Got a live MLF site as the top URL under a domain.
- Version of current site: 2.4.13
- I just grabbed 2.4.21.

Questions:

- Is a direct upgrade between the two versions possible or do I need an intermediate upgrade?

- Does your upgrade also upgrade the MySQL DB in-place without any backup/restore needed?

- Do I just copy the new MLF files on top of the web directory of the existing site and overwrite my old files with your new ones. And then run the /install noted above? I note that db_settings.php in the install is a dummy but a diff shows that the DB settings themselves (host et) are all that are different in my version. What else can be trashed on the current site by writing over?

I had a lot of trouble with this process before and I thought I followed the instructions but apparently I didn't do everything needed. The site stopped working (forget the issue) and I restored everything from a backup.

Sorry for the somewhat irritating newbie time waster style step by step request but I much of the support forum is in German and nothing that I found like a FAQ pulls these issues together.

Thanks.

Avatar

Exactly how to upgrade (update) MLF to new version?

by Auge ⌂ @, Thursday, May 07, 2020, 14:54 (174 days ago) @ AlmostAnonymous

Hello

I attempted an upgrade to the latest code a few months ago and it was a real mess. I had to restore my board from backups.

All I see for instructions is from the Github page "Run the installation script by accessing yourdomain.tld/forum/install/ in your web browser and follow the instructions."

This is the installation instruction, not the one for the update.

I would like to understand the exact procedure to follow all in one place.

Facts:

- Got a live MLF site as the top URL under a domain.
- Version of current site: 2.4.13
- I just grabbed 2.4.21.

So far, so good.

Questions:

- Is a direct upgrade between the two versions possible or do I need an intermediate upgrade?

A direct upgrade from 2.4.13 to 2.4.21 is possible. There is no intermediate step to take.

- Does your upgrade also upgrade the MySQL DB in-place without any backup/restore needed?

Yes, ist does.

- Do I just copy the new MLF files on top of the web directory of the existing site and overwrite my old files with your new ones. And then run the /install noted above?

No, don't do this.

I note that db_settings.php in the install is a dummy but a diff shows that the DB settings themselves (host et) are all that are different in my version. What else can be trashed on the current site by writing over?

Where ot start with …

Do not overwrite a single file before you read the update instructions below.

I had a lot of trouble with this process before and I thought I followed the instructions but apparently I didn't do everything needed. The site stopped working (forget the issue) and I restored everything from a backup.

It seems, that you took a wrong way. Let's clarify, what to do.

Sorry for the somewhat irritating newbie time waster style step by step request but I much of the support forum is in German and nothing that I found like a FAQ pulls these issues together.

Ok, obviously we have to improve the update instructions. Let's start with a step by step instruction here.

1. Download of the new package. (done as stated by you)
2. Unzip the package locally on your computer.
3. Upload of the following files (in their directories) from the local copy of the new version to your webspace: update/update_2.3.5-2.4.php and config/VERSION. The upload of both files from the new version is mandatory before you are able to start an update.
4. Disable the forum in the forum settings (accessible via the admin area).
5. Go back to the admin areas dashboard and follow the link to the update function (as seen in the following screenshot, next-to-last menu point).

[image]

6. Read the instructions, (you disabled the forum before and downloaded the new package, so you can skip the first steps) and follow the link to update/update_2.3.5-2.4.php. (see the following screenshot)

Attention: If you ran an older version of the forum as 2.3.7 before, it is possible that you see a further update script, named   update_2.x-2.3.php. Please use only the script update/update_2.3.5-2.4.php.

[image]

7. Insert the password of your administrator account to confirm the run of the update script.

[image]

8. On the following page you'll get the success message for step one of the update (database operations) or an error message. In case of success you'll see a list of all script files that changed between your and the new version. You have to load up all the listed files and directories to your webspace (this is because not every file got altered with every version). After loading all changed files and directories of the new version to your webspace, you are done.

If you encountered errors, please report it instantaneously here in this forum thread.

Attention: Your forum was automatically reenabled by the script after the database operations. We might change this behaviour in the future. Please check that in the forum settings panel. This is recommended because you, logged in as the administrator, will see your forum in the enabled state, even it is disabled for everyone else.

I hope, my instructions will help you. Please give a report, if questions remain unanswered and also when your operation was successful.

Tschö, Auge

--
Trenne niemals Müll, denn er hat nur eine Silbe!

THANK YOU just what I was looking for

by AlmostAnonymous, Thursday, May 07, 2020, 17:37 (174 days ago) @ Auge

One/"mythic someone" could easily copy your instructions to a stand alone page with a very prominent title. That would avoid this kind of question in the future. I see things I had no idea about in your instructions.

Much appreciated.

I'll check back in with a success/failure report.

Results...

by AlmostAnonymous, Friday, May 08, 2020, 05:10 (173 days ago) @ Auge

Everything worked in the upgrade process.

I forgot the step to empty the directory templates_c so I received a Smarty template error. Everything seemed to work after that with no error messages.

My goodness, though. Instructions for upgrading are unwritten, and the "upgrade" function of the software itself that displays the cheat sheet for initiating the upgrade only gives one part of the process (doesn't cover at all the config files that must be uploaded prior to the upgrade PHP script.) I don't expect to bother with this for another couple of years with this kind of procedure.

I recommend (1) asking the user to upload the entire unzipped upgrade file to a new specified subdirectory under the public directory. and (2) generate a shell or bash script that performs the copy of the 30 or so scattered files that must be done manually now. (3) instruct the user to go to the command line and execute that script.

Then you'd need less documentation. Or at least eliminate some error prone manual steps.

RSS Feed of thread

powered by my little forum