You are currently offline, waiting for your internet to reconnect

How to upgrade custom SharePoint Portal Server 2003 areas to Microsoft Office SharePoint Server 2007

Support for Office 2003 has ended

Microsoft ended support for Office 2003 on April 8, 2014. This change has affected your software updates and security options. Learn what this means for you and how to stay protected.

Author:
Cornelius van Dyk MVP
COMMUNITY SOLUTIONS CONTENT DISCLAIMER
MICROSOFT CORPORATION AND/OR ITS RESPECTIVE SUPPLIERS MAKE NO REPRESENTATIONS ABOUT THE SUITABILITY, RELIABILITY, OR ACCURACY OF THE INFORMATION AND RELATED GRAPHICS CONTAINED HEREIN. ALL SUCH INFORMATION AND RELATED GRAPHICS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT AND/OR ITS RESPECTIVE SUPPLIERS HEREBY DISCLAIM ALL WARRANTIES AND CONDITIONS WITH REGARD TO THIS INFORMATION AND RELATED GRAPHICS, INCLUDING ALL IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, WORKMANLIKE EFFORT, TITLE AND NON-INFRINGEMENT. YOU SPECIFICALLY AGREE THAT IN NO EVENT SHALL MICROSOFT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY DIRECT, INDIRECT, PUNITIVE, INCIDENTAL, SPECIAL, CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF USE, DATA OR PROFITS, ARISING OUT OF OR IN ANY WAY CONNECTED WITH THE USE OF OR INABILITY TO USE THE INFORMATION AND RELATED GRAPHICS CONTAINED HEREIN, WHETHER BASED ON CONTRACT, TORT, NEGLIGENCE, STRICT LIABILITY OR OTHERWISE, EVEN IF MICROSOFT OR ANY OF ITS SUPPLIERS HAS BEEN ADVISED OF THE POSSIBILITY OF DAMAGES.
SUMMARY
Customized area definitions, derived by cloning the SPS or other area folders as described in KB 898631, could fail to upgrade. Described here, is the work around to achieve a successful content upgrade.
SYMPTOMS
The upgrade process will fail and the upgrade logs will reflect "/Pages" cannot be found messages.  In some cases, the upgrade might appear to complete, but when attempting to access the upgraded portal site e.g. the system will redirect to resulting in a 404 File Not Found error instead of the proper page.
CAUSE
The cause of the upgrade failure is due to the cloning of the area template as described in KB 898631.  During the cloning process, a new area ID is given to the definition.  Naturally, the upgrade engine does not have awareness to or knowledge of any custom definitions.  As a result, it may attempt to upgrade the areas anyway based on the standard definitions, but customization may cause unexpected errors to occur during the upgrade.
RESOLUTION
Remember to always conduct full backups prior to attempting this procedure.  It is preferable to restore said backups to separate TEST servers for conducting the upgrade test.  NEVER use production servers as a proving ground.
 
To resolve the issue, the portal areas that have custom definitions, must be reverted back to base definitions by following these steps:
 
  1. Navigate to the home page.
  2. In the "Actions" section of the left hand vertical menu, click "Change Settings".
  3. On the "Change Settings" page, click the "Page" tab at the top.
  4. In the "Subarea Templates" section, ensure the "All subareas will use the following template" radio button option is selected.
  5. In the dropdown below, select the "SharePoint Portal Server Site" template.
  6. Click the "OK" button.
 
Your areas should now be based on the standard base template which should allow the upgrade process to complete successfully.  You can verify this by navigating to these areas.  You should notice a definite (depending on your level of customization) visual difference in the pages.
Customization will have to be reapplied once the upgrade was completed, so plan additional time for this as well.
Properties

Article ID: 555858 - Last Review: 03/21/2007 06:42:56 - Revision: 1.0

  • Microsoft Office SharePoint Portal Server 2003
  • kbpubmvp kbpubtypecca kbhowto KB555858
Feedback