The Official PostNuke Installation & Getting Started Guide: Revision 9939 / Preview
Prev |  | Next

# Chapter 11. Upgrade Installation

If you have a previously installed version of PostNuke, or if you were running PHPNuke or MyPHPNuke, and wish to switch to PostNuke, you can use the Upgrade features of the installation to migrate your older system into the new PostNuke system.

Previous versions of PostNuke (versions 0.50, 0.60, 0.62, 0.63, 0.64, and 0.7x) can be automatically upgraded to the latest version of PostNuke using the upgrade function. Additionally, upgrades from MyPHPNuke (versions 1.87 and 1.88) and PHPNuke (versions 4.40, 5.20, 5.30, 5.31, and 5.40) to the latest version of PostNuke are supported by the upgrade process. Upgrades from PHPNuke 5.5 and later will be available in a future PostNuke release.

Through the upgrade process, user accounts are preserved, as are the settings for Articles, Blocks, Comments, Downloads, Headlines, and Reviews. Features that are specific to other CMS software (for example, article ratings in PHPNuke) are not converted and will be removed from the PostNuke database. Some modules and blocks may need to be upgraded to newer versions before they will function with PostNuke.

# Step-by-step: Upgrading PostNuke

- Print this document and keep it handy during the installation.

- Obtain the latest PostNuke release from http://www.postnuke.com in either ZIP or TAR.GZ format. Download the release to a temporary directory. Under *NIX, TAR.GZ is the preferred format since the files will possess the correct user privileges.

- Using your compression program, VIEW the distribution file to make sure it will expand the files into the correct subdirectory path.

- Completely back up your entire web directory (for example, /var/www/html).

- Do a dump of your web site's database using "`mysqldump`" (or equivalent utility). Try the following:"`mysqldump -u <db_administrator_name> -p --opt <old_db_name> > DBbackup_10Apr02.sql`".

  You will be prompted for your administrator password and the contents of the database called "old_db_name" will be saved as "DBbackup_10Apr02.sql" in the current directory.

- Move all previous-version PostNuke files & directories from your web directory and sub-directories into another location. Be especially careful to move everything from the /includes and /modules directories. It is not necessary to move NON-PostNuke files from the web directory or sub-directories (for example, under *NIX, type "`mv -R /var/www/html/* /var/nukebackup`").

  IMPORTANT NOTE: If you do not move ALL previous-version PostNuke files from these directories, it will prevent your web site from functioning properly.

- Extract the PostNuke archive into a temporary directory. Move the /html and /sql directories into your DocumentRoot (as specified by Apache) (for example, /var/www/html), preserving paths (for example, "`tar -xzvf <PostNuke-archive.tar.gz>`", "`mv -R html /var/www/`", "`mv -R sql /var/www/`").

-or-

- Upload the extracted PostNuke files into your web directory, preserving paths.

- If you wish for your site to offer multiple languages, download and install appropriate language packs. English is included in the distribution by default. Language packs and installation instructions can be found on SourceForge's PostNuke page: http://sourceforge.net/projects/post-nuke under "Files".

- From your previous-version backup, copy "config.php" and "config-old.php" to your web directory (for example, under *NIX, type "`cp /var/nukebackup/config.php /var/www/html/`", "`cp /var/nukebackup/config-old.php /var/www/html`").

- Additionally, copy "config.php" into the web directory with the name "pn7config.php" (for example, under *NIX, type "`cp /var/nukebackup/config.php /var/www/html/pn7config.php`").

- Set the permissions on these files located in your web directory:

  - "`chmod 666 config.php`" (Windows: Remove the read-only file attribute with "`attrib -r config.php`". If using NTFS, be certain that the proper NTFS permissions are set.)

  - "`chmod 666 config-old.php`" (Windows: Remove the read-only file attribute with "`attrib -r config-old.php`". If using NTFS, be certain that the proper NTFS permissions are set.)

  - "`chmod 666 pn7config.php`" (Windows: Remove the read-only file attribute with "`attrib -r pn7config.php`". If using NTFS, be certain that the proper NTFS permissions are set.)

- Point your browser to the installation file (for example, http://www.yoursite.com/install.php).

- Follow the prompts to modify databases, tables, and configuration options.

  - Select your language from the drop-down list. Click "Set Language" to continue.

  - Read the license. Click "Next" to agree with the license terms and continue installation. If you do not agree with the license terms, abort the installation.

  - CHMOD Check: PostNuke checks to make sure that critical files are appropriately writable in the web directory. If no errors are reported, click "Continue". If there are errors reported, correct them and click "Re-check" to perform the CHMOD check again.

  - Database configuration

    - Database Host: Enter the name of the host system where the database files are stored. If your database is on your local machine, this entry will be "`localhost`".

    - Database Username: Enter the database username that will be used to add, edit, and delete files from the database.

    - Database Password: Enter the database password for the user defined above.

    - Database Name: Enter the name of the database to be upgraded. Entry example: "`postnuke`".

    - Table Prefix (for Table Sharing): If you wish to prefix the table names, enter the prefix here. For most users that are not sharing tables, the recommended entry is "`nuke`".

    - Database Type: Select the database type from this drop-down list. Entry example: "`MySQL`"

    - Site is for intranet or other local (non-internet) use: Check this box if this site is intended for intranet or other local (non-internet) use.

Click "Continue" to move to the next step.

You are presented a review of the database configuration selections that you just made. If they are incorrect, click "Change Info" to modify the selections. If the settings are correct, select "Upgrade" to upgrade from a previous version of PostNuke, or if you are migrating from PHPNuke or MyPHPNuke.

The next screen is where you select the CMS from which you are upgrading.

- Click "PHP-Nuke" to upgrade an existing PHP-Nuke install.

  - To continue, click the version of PHP-Nuke you wish to upgrade. Follow the prompts.

- Click "PostNuke" to upgrade an existing PostNuke install.

  - To continue, click the version of PostNuke you wish to upgrade. Follow the prompts.

- Click "MyPHPNuke" to upgrade an existing MyPHPNuke install.

  - To continue, click the version of MyPHPNuke you wish to upgrade. Follow the prompts.

- If you have a logo graphic for your site, upload it to the images directory (for example, /var/www/html/images). You may name the file anything you want. If you do not yet have a logo, you may skip this step and the default PostNuke logo will be displayed. Generally, the dimensions of this file should be 220 pixels wide by 80 pixels tall to fit into most pre-made themes. However, if you are satisfied with how a larger graphic looks, you may use a logo graphic that ignores these size recommendations. This graphic file is displayed at the top of the page within some themes, and at the top of every page that is printed from your site.

  The graphic file must be located in the /images/ directory of your web site or within the theme's /images/ directory. The graphic file can be in PNG, GIF, or JPG format. The canonical location will be determined in a future release.

Click "Go to your PostNuke site" to enter your PostNuke site for the first time. Skip down to "Testing The Installation/Upgrade", below.

Once the upgrade has been tested to work, you may begin to migrate your NON-PostNuke files from the backup directory back into the web directory. You may now delete your previous-version backup files (for example, from /var/nukebackup)

Prev | Home | Next
New Installation |  | Testing The Installation/Upgrade