[Phpwiki-talk] upgrade from 1.3.10 to 1.3.11p1

[Ben H. <ph...@gr...>]

Hi all,

I am upgrading a phpwiki installation from 1.3.10 to 1.3.11p1.  I am
reading the upgrade instructions, and I am missing something.

Here is the begining of the upgrade file:

> To migrate to a new phpwiki installation you have to backup your old page=
s=20
> (best via a zip dump), configure your new installation, and restore the o=
ld=20
> pages in PhpWikiAdministration. Or just upgrade your configuration as=20
> described below.
>=20
> UPGRADING since 1.3.10
>=20
> To upgrade default pages, the database and some config settings=20
> add "?action=3Dupgrade" to your HomePage url and press "Enter", which will
> do most of the upgrades automatically.
> You might need to enter the DBADMIN_USER and DBADMIN_PASSWD in=20
> config/config.ini for SQL databases and default permissions.

As I understand it, you can rephrase the first paragraph as follows:

> There are two ways to upgrade an existing PhpWiki installation. =20
>=20
> 1) Backup your pages (via a zip dimp), configure your new installation,
> and restore the old pages in PhpWikiAdministration.
>=20
> 2) Upgrade your installation as described below.

Is this a correct restatement of the first paragraph, or am I
misinterpreting what is written there?

I am choosing to follow the second path rather than the first, but I
think it might be helpful to include a reference to a page describing
how to backup pages and how to restore pages from a backup, for those
interested in pursuing the first option.

Getting on to the second option, we come to the second paragraph quoted
above:

> UPGRADING since 1.3.10
>
> To upgrade default pages, the database and some config settings add
> "?action=3Dupgrade" to your HomePage url and press "Enter", which will
> do most of the upgrades automatically.  You might need to enter the
> DBADMIN_USER and DBADMIN_PASSWD in config/config.ini for SQL databases
> and default permissions.

There's a step missing - what is the best way to get the new files into
place?  I have my wiki installation sitting in /a/b/c/phpwiki-1.3.10/.
The new one, presumably, will sit at /a/b/c/phpwiki-1.3.11/. =20

Should I:

* rename phpwiki-1.3.10 to phpwiki-1.3.11 then untar the tgz file over
the existing directory, thereby replacing the files that have changed?
If so, what files should I remove (configurator?) so as to avoid the
possibility of someone reinitializing my installation?

* untar phpwiki-1.3.11 to a new place, and selectively copy over files
(such as config.ini)?  Which files should I copy over?  I think I'm
going to try this approach, and hope that config.ini is the only file I
need to copy over, but I still wonder if there are any files that the
configurator removes so as to protect itself.

At some point after the new files are in the right place, I should do as
it says (add ?action=3Dupgrade) to my URL, but I wonder when...


I appreciate having the docs to help the upgrade, but I think answers to
the questions above might help improve the document.  :)

Thanks!

-ben



--=20
Ben Hartshorne
email: be...@ha...
http://ben.hartshorne.net