Upgrading places and PlaceTypesAdded by IBM on December 16, 2010 | Version 1 (Original)
|After you upgrade the design of databases on the server, you can use the qptool server task to upgrade places and PlaceTypes to enable the new features in them. You can upgrade them all at once or incrementally.
After you upgrade the design of databases on the server, you can use the qptool server task to upgrade places and PlaceTypes to enable the new features in them. You can upgrade them all at once or incrementally.
About this task
Keep the following points in mind about upgrading:
- Prior to upgrading places and PlaceTypes, you cannot use existing places or PlaceTypes to create new places or PlaceTypes.
- Any custom policies will be lost.
- Do not modify or refresh PlaceTypes until after they have been upgraded.
- When a place is upgraded, the user interface components "SiteMapLauncher" and "MyPlaces" are not added to custom themes. Place managers must add these components themselves.
- A place is locked while it is being upgraded. If you upgrade multiple places at the same time, only one place is locked at a time.
- The qptool upgrade -server command upgrades server-related databases and settings, and the other upgrade commands (qptool upgrade -p placename and qptool upgrade -a) upgrade places and custom placetypes.
- After upgrading the design of databases on the server, you can upgrade all places and PlaceTypes at once. If there is a large amount of data to upgrade, this can take a considerable amount of time, even multiple days, and once begun, the process should not be stopped. If there is a large amount of data to upgrade, consider upgrading places and PlaceTypes incrementally instead as decribed in the next section.
- Old PlaceTypes cannot be used to create new places, and old places cannot be used to create new PlaceTypes. Old places cannot be refreshed from their PlaceTypes, and old PlaceTypes cannot be refreshed from their places, until both are upgraded.
- To log server activities related to upgrading places and PlaceTypes, use the notes.ini setting QuickPlaceUpgradeLogging=value, where value is a number from 1 to 4. Enable upgrade logging only temporarily to aid in troubleshooting.
- To upgrade all places and PlaceTypes at the same time, open the Domino server console.
- Enter the following qptool command:
load qptool upgrade -f -a
The qptool upgrade command should be run only on the primary server in the cluster.
- When upgrading all places at once, you need to carefully review the output to ensure that the upgrade has completed successfully for every place. If the upgrade stops at a particular place or error messages are issued for a particular place you need to perform the following steps:
- Restore the place from a backup.
- Correct any problems reported.
- Run the upgrade for that one place. The reason for this is that during the first upgrade attempt some processing may have been done that can cause the remaining processing not to be attempted if another upgrade for that place is attempted.
- If you are upgrading Blog and Wiki placetypes and any child places created from these placetypes, you need to refresh the old placetypes and child places created based on these placetypes using the following command:
load qptool refresh -pt placetype
load qptool refresh -p place
When the upgrade is finished, the file qptool.upgrade.xml is created by default in the Domino program folder. This file indicates whether the upgrade was successful and contains the following xml:
<code>code number(0 if successful)/code>
<message>error message(if there's an error)/message>
Parent topic: Completing the upgrade
Upgrading places and placetypes incrementally
You can upgrade individual places and PlaceTypes incrementally, for example, if you have many of them to upgrade.
About this task
If the place used to create a PlaceType still exists, upgrade the place before upgrading the PlaceType.
- To determine which place was used to create a PlaceType, log in to the server as an administrator.
- Click Work with Templates -> Create PlaceType to display the field Select the place to base this PlaceType on.
Only places that have been enabled by their managers for use as PlaceTypes are shown.
- To upgrade places and PlaceTypes incrementally, enter one of the commands described in the following table:
Table 1. Upgrading places and PlaceTypes incrementally
|Upgrade one place||load qptool upgrade -f -p place|
|Upgrade multiple places||load qptool upgrade -f -p place place place|
|Upgrade one PlaceType||load qptool upgrade -f -pt PlaceType|
|Upgrade multiple PlaceTypes||load qptool upgrade -f -pt PlaceType PlaceType PlaceType|
When the upgrade is finished, the file qptool.upgrade.xml is created by default in the Domino program folder. This file indicates whether the upgrade was successful. It contains the following xml:
<code>code number(0 if successful)</code>
<message>error message(if there's an error)</message>