Upgrading Exponent

From ExponentCMS Docs

Jump to: navigation, search

Edit Menu

  • Icon_Geting_Started_20px.png Getting Started
  • What is Exponent?
    An overview of Exponent including Features, Roadmap, License and a link to a test drive Demo.
  • Exponent Terminology
    An explanation of Exponent User and System Terminology to help you understand how Exponent works.
  • Installing Exponent
    A guide to Installing Exponent including System Requirements, Downloading, Uploading, Database, Install Wizard and Troubleshooting.
  • Installing Themes
    A guide to adding Themes to change the look of your Exponent website.
  • Installing Modules
    A guide to adding Modules to extend functionality of your Exponent website.
  • Configuring Exponent
    A guide to Configuring your Exponent site after installation.
  • Migrating Exponent
    A guide to Migrating an existing Exponent installation to a new server.
  • Upgrading Exponent
    A guide to Upgrading existing Exponent installations.
Edit Menu

Image:Icon_Geting_Started_40px.png Upgrading Exponent

This page contains a guide to Upgrading an existing Exponent website.

Alert_blue_40px.png ALERT! If you are upgrading an existing Exponent installation, it is HIGHLY RECOMMENDED that you export your database and backup your files.
Alert_blue_40px.png ALERT! If you are upgrading from any version prior to Exponent 0.96.3, it is recommended that you do a clean installation as the installer has changed substantially and may act quite strangely if you try to extract Exponent 0.96.x on top of anything other than a Exponent 0.96.x installation.


Contents

Upgrading Exponent Icon_Warning_20px.png

Use the following steps to upgrade an existing Exponent installation. For more detailed instructions see sections below.

  1. Backup the Exponent Database. See Backup the Exponent Database below.
  2. Backup your Configuration File which contains the settings for your Exponent installation: 
    /conf/config.php    (file)
  3. Backup your Files Folder which contains the Files and Resources you have uploaded to your Exponent website. See Backup your Files Folder below. 
    /files/             (folder, including sub-folders)
  4. Backup your Themes Folder which should contain any custom Themes which you've created for your website. 
    /themes/            (folder, including sub-folders)
  5. Upload and Extract a new version of the Exponent Software archive over your existing Exponent installation.
  6. In a web browser, visit your exponent website and load the Exponent Install Wizard.
  7. Step through the installer selecting Upgrade Installation to ensure the install process does NOT overwrite your Database with default data (erasing your old data).
  8. Restore your Configuration File by uploading the backup to your website and overwriting the new version.
  9. Restore your Files Folder by uploading the backup to your website.
  10. Restore your Themes Folder by uploading the backup to your website.
  11. Visit your upgraded Exponent website and all your data should be intact.

Backup the Exponent Database Icon_Warning_20px.png

Guides to backup up your database using the Exponent Data Exporters routine, cPanel Control Panel, MySQL Administrator, MySqlDump or PhpMyAdmin.

Backup the Database using Exponent Data Exporters Icon_Warning_20px.png

  1. Login to your Exponent website.
  2. Load the Administration Control Panel.
  3. Load the Database > Export Data page.
  4. Locate the EQL Database Exporter and click the Run Data Exporter link.
  5. Click on Select All to Export all installed tables.
  6. Name the Export file.
  7. Click on Export Data and when prompted Save the EQL file to your local computer.

Backup the Database using cPanel Control Panel Icon_Warning_20px.png

This guide is for the cPanel Control Panel but the steps should be similar for most web hosting Control Panels.

  1. Login to your Control Panel.
  2. Load the Backups page.
  3. Locate the Databases section and select your Exponent Database.
  4. When prompted Save the Backup to your file to your local computer.

For more info see the documentation for your Control Panel cPanel Documentation, DirectAdmin Site-Helper, Ensim Pro, H-Sphere Documentation, Plesk Documentation, or contact your Web Hosting provider.

Backup the Database using MySQL Administrator Icon_Warning_20px.png

  1. Launch MySQL Administrator and login.
  2. Browse to Backup.
  3. Select New Project at the bottom of the window.
  4. Select the New Project from the left-hand listing.
  5. Rename the New Project to something useful.
  6. Select the Exponent database and Add it to the project.
  7. Click on Backup.

For more info see MySQL Administrator.

Backup the Database using MySqlDump Icon_Warning_20px.png

Backup the Database using PhpMyAdmin, Icon_Warning_20px.png

Backup your Files Folder Icon_Warning_20px.png

Instructions for backing up your Files Folder with Exponent Data Exporters routine and platform specific guides.

Backup your Files using Exponent Data Exporters Icon_Warning_20px.png

  1. Login to your Exponent website.
  2. Load the Administration Control Panel.
  3. Load the Database > Export Data page.
  4. Locate the Uploaded Files Exporter and click the Run Data Exporter link.
  5. Click on Select All to Export resources from all modules.
  6. Name the Export file.
  7. Click on Export Data and when prompted Save the tar.gz file to your local computer.

Backup your Files using Linux Command Line Icon_Warning_20px.png

  1. cd into exponent directory.
  2. use the command: tar -czvf ../backup/files.tar.gz files.

Backup your Files using Windows File Explorer Icon_Warning_20px.png

  1. Select your /files/ directory using the File Explorer.
  2. Right-click the directory and use Send to > Compressed (zipped) folder.
  3. Move the archive created to your backup directory.

Backup your Files using Mac OSX Finder Icon_Warning_20px.png

  1. Select your /files/ folder using the Finder.
  2. Control-click the folder and use Create archive of "files".
  3. Move the archive created to your backup directory.

Upload and Extract Exponent Over an Existing Installation Icon_Warning_20px.png

Guides to Uploading and Extracting Exponent over an existing installation.

Upload and Extract Exponent for Linux Icon_Warning_20px.png

  1. Place the file exponent_new_version.tar.gz in the folder that contains exponent installation.
  2. Use the command: tar -xzvpf exponent_new_version.tar.gz.
  3. Use the command: mv exponent_new_version exponent_old_version.

Upload and Extract Exponent for Windows Icon_Warning_20px.png

  1. Double click on exponent_new_version.zip to extract the contents.
  2. Overwrite the the existing Exponent folders with the new version, replacing old files.

Upload and Extract Exponent for Mac OSX Icon_Warning_20px.png

  1. Double click on exponent_new_version.zip to extract the contents.
  2. Overwrite the the existing Exponent folders with the new version, replacing old files.

Using the OSX Terminal Application

  1. Launch the Terminal application and login.
  2. Change directory to your exponent installation, usually: 
cd /Library/WebServer/Documents/


Image:Icon_Resources_20px.png Getting Started Resources

Retrieved from "http://docs.exponentcms.org/Upgrading_Exponent"
Personal tools