Microsoft KB Archive/296610

= You Lose Portal Customizations and Custom Web Parts After You Upgrade from Evaluation Version of Portal Server =

Article ID: 296610

Article Last Modified on 9/12/2007

-

APPLIES TO


 * Microsoft SharePoint Portal Server 2001

-



This article was previously published under Q296610



SYMPTOMS
When you upgrade the 120-day evaluation edition of Microsoft SharePoint Portal Server 2001 to the full released version, you may lose your portal customizations and custom Web parts.



CAUSE
This behavior can occur because the SharePoint Portal Server upgrade process always installs the latest version of the portal files and overwrites your customizations.

This article discusses how to restore your portal customizations if you did not run this preparation script before the upgrade.



RESOLUTION
To resolve this problem, obtain the latest service pack for SharePoint Portal Server 2001. For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

312963 How to Obtain the Latest SharePoint Portal Server 2001 Service Pack

At the root of your workspace, there is a hidden folder named &quot;Portal,&quot; which contains all the dashboard site files. Before you install new portal files, the upgrade process renames your original folder to match the format &quot;Portal_(date and time of upgrade).&quot; For example, if you upgraded on August 3rd, 2001 at 11:35:32 A.M., the Portal folder would have been renamed &quot;Portal_2001_8_3_11_35_32.&quot; Open your workspace root (as a Web folder) to determine the actual folder name.

You can export the customized contents of this saved folder to your current Portal folder to restore your original Portal settings. Do not copy all of the folder contents directly from the saved folder to the Portal folder, because doing so may overwrite newer Portal files. Copy the customized files only as needed, following the steps in the &quot;Workaround&quot; section of this article.



WORKAROUND
To recover your original portal settings, follow these steps while you are logged on as a workspace coordinator:  Restore custom Web parts.

If the custom Web parts are available from another source, such as backed up to a .dwp file, you can re-acquire each Web part and import them into the upgraded Portal. If the Web parts are not available, you can open the old Portal and export them to a file. To do this, follow these steps:  To open the old Portal, type the workspace URL appended by the renamed Portal folder on the Address bar of your browser. In the preceding example, this would be as follows:

http:// / /Portal_2001_8_3_11_35_32

 When the Web page has loaded, click the Content link. Click the name of a custom Web part to see its settings. At the bottom of the page, click the Export button. Save the Web part to disk.

This file can be safely deleted when you are finished importing it into the Portal.</li> Open the new, upgraded portal (http:// / ), and then click the Content link.</li> Select Import a Web Part File, and then follow the instructions to import the Web part that you just saved.</li> Repeat steps c through g for each custom Web part.</li></ol> </li> Restore Portal page layout and settings customizations. Re-apply the settings on the new portal page.</li> Restore dashboard files that you have modified or created. Copy the files manually by using Web folders.</li></ol>

STATUS
This problem was first corrected in SharePoint Portal Server 2001 Service Pack 1.

<div class="moreinformation_section">

MORE INFORMATION
WARNING: Consult the SharePoint Portal Server software development kit (SDK) for information about which files may be safely modified. Service packs and hotfixes may overwrite changed files unless they are mentioned as safe for modification in the SDK.

Also, do not copy the entire old folder structure directly; doing so causes the same loss of customization the next time that SharePoint Portal Server services are restarted. Copy files individually, and only those files that you need.

Additional query words: sps

Keywords: kbqfe kbhotfixserver kbfix kbprb kbshareptportalsvr2001sp1fix KB296610

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.