| |
Upgrading PowerPhlogger
If you're upgrading from a previous version please check the following instructions:
| 2.2.4
- 2.2.5
|
|
There is no upgrade-script for 2.2.4-2.2.5
as there haven't been any changes in the DB-structure. Just replace
your old pphlogger directory with the new one including the whole
filetree. (Don't forget to
use the new config.inc.php and edit the settings!).
It is strongly recommended to get 2.2.5 as this version fixes some
minor security exploits! |
|
| 2.2.3
- 2.2.4
|
|
There is no upgrade-script for 2.2.3-2.2.4
as there haven't been any changes in the DB-structure. Just replace
your old pphlogger directory with the new one including the whole
filetree. (Don't forget to
edit the settings in config.inc.php of your new directory! - As nothing
has changed in this file, you might as well use your existing config.inc.php
from 2.2.3).
It is strongly recommended to get 2.2.4 as this version fixes a major
security exploit in PPhlogger! |
|
| 2.2.2a/b - 2.2.3
|
|
| Please exactly follow those instructions:
- Untar or unzip the distribution (e.g. tar -xzf pphlogger-2.2.3.tar.gz)
- Open the file config.inc.php in your favourite
editor and modify the values for host, user, password, and database
to fit your environment.
WARNING: Do not use your old config file as it
has been changed in 2.2.3
- Upload all files into a new directory on your server (do not
replace the old one yet !!), e.g. /pphlogger_NEW
- (optional but recommended:)
To lock access to your database during the upgrade process
copy the following two files from /pphlogger_NEW to your old pphlogger
directory:
main_location.inc (overwrite the old one), main-dummy.php
Then, edit main_location.inc and set PPHL_DB_LOCK to TRUE (see
the instructions inside the file). Access to your database is
now locked and your users won't get any errors because of this.
- Run the upgrade-script from your new directory: <www.your-host.com>/pphlogger_NEW/upgrade/upd_2.2.2b-2.2.3.php
- Done!
You can now delete your old directory and rename /pphlogger_NEW
to /pphlogger.
|
|
| 2.2.2a - 2.2.2b
|
|
There is no upgrade-script for 2.2.2a-2.2.2b
as there haven't been any changes in the DB-structure. Just replace
your old pphlogger directory with the new one.
Warning:
In 2.2.2b, $rel_path has changed to the constant PPHL_SCRIPT_PATH.
If you're calling pphlogger.php directly in PHP, please use define('PPHL_SCRIPT_PATH','pphlogger/');
instead of $rel_path = 'pphlogger/';
The documentation has been updated. |
|
| 2.2.2 - 2.2.2a
|
|
As 2.2.2a is just a maintenance release,
there haven't been a lot of changes in the DB-structure. The upgrade-script
shouldn't take too long to execute.
Upgrade-instructions:
- Untar or unzip the distribution (e.g. tar -xzf pphlogger-2.2.2a.tar.gz)
- Open the file config.inc.php in your favourite editor
and modify the values for host, user, password, and database to
fit your environment.
- Upload all files into a new directory on your server (do not
replace the old one yet !!), e.g. /pphlogger_NEW
- Run the upgrade-script from your new directory: <www.your-host.com>/pphlogger_NEW/upgrade/upd_2.2.2-2.2.2a.php
- If everything works fine, delete your old pphlogger directory
and move pphlogger_NEW to its place (rename pphlogger_NEW to pphlogger).
Done!
|
|
| 2.2.1 - 2.2.2
|
|
In 2.2.2 there have been a lot of
changes in the PowerPhlogger DB-structure. Due to an enormeous risk
of messing up your data, please make sure you strictly follow those
instructions (this time, update instructions are a bit more complicated!):
- Untar or unzip the distribution (e.g. tar -xzf pphlogger-2.2.2.tar.gz)
- Open the file config.inc.php in your favourite editor
and modify the values for host, user, password, and database to
fit your environment.
WARNING: As default there is a new table prefix 'pphl_' for your
mySQL tables. We do strongly recommend to use this new prefix!
If you already had a prefix in your 2.2.1 distribution, make sure
you enter it in $tbl_prefix_old. The update script will do the
whole conversion process for you.
- Upload all files into a NEW PPHLOGGER DIRECTORY on your
server (do not replace the old one yet !!), e.g. /pphlogger_NEW
- - rename /pphlogger_NEW/upgrade/main.php.dummy to main.php
and replace the main.php in your OLD PPHLOGGER DIRECTORY
with this file
- copy /pphlogger_NEW/showhits.php and replace showhits.php
in your OLD PPHLOGGER DIRECTORY with this file
- Run the upgrade-script from your NEW PPHLOGGER DIRECTORY:
<www.your-host.com>/pphlogger_NEW/upgrade/upd_2.2.1-2.2.2.php
You'll find further instructions during the upgrade process.
If the script breaks due to PHP's max_execution_time, just run
it again till it's done. If you got a huge amount of users/logs,
this may take a while! Just make sure you don't press the reload-button
while it's running!
- If you're done you can now run /pphlogger_NEW/admin/setup.php
and check your settings.
- If everything works fine, delete your old pphlogger directory
and move pphlogger_NEW to its place (rename pphlogger_NEW to pphlogger).
Done!
|
|
| upgrade from previous
versions... |
|
|
Upgrading from previous versions might be tricky so we recommend
to always upgrade to the most recent version as soon as it's out.
Basically you can follow those rules:
- Follow step 1-4 described above in the "2.2.1-2.2.2"
box
- Run <www.your-host.com>/pphlogger_NEW/upgrade/prefix_change.php
- Run each upgrade-script (in /upgrade) in the correct order.
e.g.: upd_2.1.4d-2.2.0.php --> upd_2.2.0-2.2.1.php --> upd_2.2.1-2.2.2.php
If you get redirected to /admin/setup.php, go through the whole
setup-process and enter the
correct settings. Then, go back to the upgrade script you came
from and run it again.
If any script breaks, run it again till it has successfully completed
before running the next one!
|
|
All previous upgrade-instructions have been removed from this page due to outdated
information.
If you still would like to have a look at them, check the upgrade
instructions archive.
We do not recommend to follow those instructions as the whole upgrade process
is always based on the most recent version.
|
|
|