print page  |  view normal version 

Appendix C: Upgrading Enano

Upgrading Enano was designed to be a very simple task. There are two main ways that you can upgrade.

Upgrading using a tarbomb/zipbomb

This method is extremely fast, and is available if:

  • You have SSH access to your server
  • Your server has a control panel such as cPanel™ 11 that supports extraction of .zip or .tar.gz files

To upgrade using this method:

  • Locate your Enano root directory (it has the files, index.php, ajax.php and cron.php, and the subfolders includes, images, themes, plugins, files, cache, language and install).
  • Back up the file config.php. If it exists, also back up .htaccess.
  • Go to the Enano download page
  • Select the version you are upgrading to
  • Select the ".tar.gz" file extension
  • Ensure that "Package as a tarbomb" is selected. This will build an archive file that has all of its files in the root directory, instead of in a subdirectory.
  • Click Start Download. The page will give you a direct link to the file.
  • If using SSH access:
    • Right click the direct download link and click "Copy Link Location" or "Copy Shortcut"
    • Open an SSH connection to your server and cd to your Enano root directory
    • Use wget or curl to download the direct link; most servers have one or the other:
      • wget -O enano-upgrade.tar.gz <paste direct link here>
      • curl -O enano-upgrade.tar.gz <paste direct link here>
    • Type: tar xzvf enano-upgrade.gz
  • If using a web-based control panel:
    • When the download window appears, save the file to your computer.
    • Upload the file to your Enano root directory using your control panel software
    • Use the control panel's "extract archive" option to unpack the archive file
  • Navigate to your Enano installation in your web browser. You should see an error that says, "Version mismatch."
  • Upgrade Enano using the link provided

Upgrade using FTP

If your hosting provider doesn't provide SSH access or a control panel supporting archive files, you can still use FTP to upload Enano files to your server.

  • Locate your Enano root directory (it has the files, index.php, ajax.php and cron.php, and the subfolders includes, images, themes, plugins, files, cache, language and install).
  • Back up the file config.php. If it exists, also back up .htaccess.
  • Go to the Enano download page and grab the latest version - it doesn't matter what options you select, so long as you are able to extract the archive.
  • Click Start Download
  • Save the file to your computer
  • Unzip the downloaded file. A new folder will appear with Enano's files in it.
  • Delete the following files from this folder: config.new.php, .htaccess.new
  • Use your FTP client to upload all the remaining files to your server, replacing any existing files.
  • Navigate to your Enano installation in your web browser. You should see an error that says, "Version mismatch."
  • Upgrade Enano using the link provided

If the upgrade fails...

There are several options you have if Enano fails to upgrade. The first thing you should always do is contact Enano support. Always paste the database error message. A dump of your database might be necessary if Enano support cannot determine the cause of the error by looking at the error message.

Typically, upgrades fail because of bugs in the database schema, minor incompatibilities between different database server versions, or tables or columns that already exist when the upgrade script tries to create them.

In Enano 1.2, upgrades are performed incrementally, so the number of SQL queries you have to invert in order to reverse a partially finished upgrade is kept to a minimum.

The Enano support team will often give you a list of SQL queries to run before attempting the upgrade again. Make sure you know how to execute SQL queries; often this is done using phpMyAdmin or a similar administration tool.

© 2007 Contributors. All content is under the GNU Free Documentation License.
Powered by Enano | Valid XHTML 1.1 | Valid CSS | Time: 0.03s