Upgrading PHPDevShell

From PHPDevShell

Jump to: navigation, search

Contents

SPECIAL INSTRUCTIONS FOR Upgrading from PHPDevShell older then V 2.8.0 to V2.8.x

Always do a backup when upgrading. With PHPDevShell V 2.8.0 to much changed making a reliable automatic upgrade very complicated, keeping this in mind here are a few facts;

@NOTE: PHPDevShell V 2.8.0 is NOT upgradable the standard way but uses Upgrade System Download Here.

@NOTE: Previous plugins for earlier versions ARE compatible with V 2.8.0.

@NOTE: Please follow instructions below to upgrade;

@NOTE: Always backup first!

  1. Download the V 2.8.x package and the upgrade.php package.
  2. Copy upgrade.php inside the downloaded 2.8.1 package root.
  3. Copy the complete package to a new location on your server.
  4. Copy all plugins from old install to new locations plugins folder.
  5. Edit new config file like you would with a fresh install and use old database settings.
  6. Now browse to new package /upgrade.php and follow the instructions.

Cleaning up:

  1. Login to your newly upgraded system and change the default template in System Management -> System Admin -> System Settings and change it to Chrome.
  2. Now clean up your menu items by going into the plugin manager and hit "reinstall menus" next to each plugin.
  3. If you are still useing old templates rename template_main.php to main.php and template_modules.php to modules.php within your template folder.

We are very sorry for the breaking in the elegant upgrade system. This is a once off thing and will most probably not happen in the future.

UPGRADING PHPDevShell from V 2.8.0 Onwards

Always do a backup when upgrading.

Manual Method

  1. It is best to be logged in while upgrading, else if you are logged out set $configuration['system_down_bypass'] = true;
  2. Copy new PHPDevShell files overwriting out-dated PHPDevShell files.
  3. Browse to your install location of PHPDevShell, hard refresh to load template changes, by pressing Ctrl + F5 and browse to your System Control -> System Admin -> Plugin Manager and click on "Upgrade Database" within PHPDevShell (You should see an upgrade ok notification).
  4. Check if you have an out-dated version of .htaccess or default.config.php.

PS: If you have PHP notices turned on, you might see a notice until you ran upgrade, ignore these notices.

Automatic Method

PHPDevShell support an automatic upgrading system. To use this:

  1. Make sure your ftp details are completed in System Management->System Admin->System Settings->FTP Settings.
  2. Goto System Management->System Admin->Plugins Admin
  3. Next to PHPDevShell hit Latest Version Check->Auto Upgrade
  4. If there are database upgrades hit Database Upgrade after the Auto Upgrade is complete.
Personal tools