====== Upgrading Pergamon MU ======

Regardless of the way in which you upgrade your software, make sure that you do one thing first.

MAKE A BACKUP OF YOUR CURRENT INSTALLATION - **AT THE VERY LEAST, YOUR DATABASE**.

===== Automated Upgrades =====

If an upgrade release of Pergamon is marked as an automated upgrade, it is possible to run the installer as if performing your installation for the first time (see [[pergamonmu:quickstart:install122|Installing Pergamon]]).

All necessary file copying and file updating will take place automatically.

===== Full Upgrade =====

On occasion, it may be necessary to perform a full upgrade. These are normally required for major upgrade releases, as well as releases that have seen an upgrade to included third-party software or the directory structure.

In this case:

  * Ensure that you make a backup copy of your entire installation - you can do this by selecting the installation folder and then copy-and-paste to another directory, or by performing a more formal backup (see your IT staff for assistance).

  * To ensure that older files or files that are no longer required are removed, navigate to the installation folder (e.g. **c:/program files/pergamon**) and double-click the uninstall.exe file to uninstall the software. Note that files that have dynamically changed (such as the database) will not be removed by this process.

  * If you have not already done so, download a new version of Pergamon (if an upgrade is required, you will normally be informed of this and provided with a download link, but you can also download the most recent software from the Esferico ltd. website).

  * Unzip the downloaded **xxx_setup.zip** file to get access to the **xxx_setup.exe file** (xxx will be replaced with the software name and version number).

  * Double-click the **xxx_setup.exe** file to start the installer. Please note that often the installation directory in organisations is protected - you may need suitably authorised member of your IT staff present to complete this part of the upgrade.

  * Follow the on-screen instructions and select any on-screen options (if there are any) to perform the installation.

  * You may now delete the **xxx_setup.zip** and **xxx_setup.exe** files, as they are no longer required.

  * If you selected to install in the same directory as before, your database file and any other local configuration files will remain. If not, copy these back in from your backup.

  * Start Pergamon - This will identify any database changes that are required by the new software and perform the necessary upgrade.

  * Once you have successfully logged in without further messages, the upgrade is complete.

----


{{:logo.png?nolink |}}\\
[[:start|Pergamon Wiki Home]]