Follow the procedure below to migrate the content of a place
from an existing Quickr Portal Services installation to a different Quickr
Portal Services installation.
| The target Quickr Portal Services
installation must have APAR LO28503 and LO29301 and their pre-requisite
APAR-s applied for a successful restore on the target installation. |
| The two instances of Quickr
Portal Services must use an LDAP directory with the same user information
in it. That is because the identities (such as document authors) are also
published with the places and the place content. The two instances must
also be of the same platform (e.g. Windows). |
From the home screen, select the manage places button.
This will take you to the page for managing places on your server. From
here, identify the place to be migrated. Select either the
backup
or
archiveaction by clicking the appropriate button (circled in
red in the image below)
[IMAGE]
In the image below, the
backup button was selected.
This screen shows the current list of backups for the place and provides
buttons to refresh the list and to start a new backup. Select
Create
backup to create the saved image of the place on the file system of
the server.
The following image shows the message displayed on the
page after the backup is started. Hitting the refresh button will cause
the new backup to appear in the list when backup operation has completed.
The following image shows the page after the backup has
completed successfully. A message indicating success appears and the new
backup is added to the list.
When the backup completes a directory structure with the
saved contents of the place is created on the file system of the server
in the directory identified for backups and archives. In the default installation
this is under directory with the portal server files in a subdirectory
named
backup.
[IMAGE]
The second level directory under the backup directory
contains the backup information for a single place. in this case the folders
name is
11_8000CB1A087D40231NUTCI1GA4. Within that folder there
is one folder for each backup, with each backup sequentially numbered starting
from a string of all 0s (zeros). Within these folder are the saved contents
of the place. Each of these folders that represents a single backup instance
contain at the very least an
application-instance.xml and
restore-point.xml
file.
Select select the desired folder from this group of folders
(generally the most recent one) and copy it to the target server and place
it in a similar folder structure under the backup directory of the target
server. Note that this can be most efficiently done by zipping up the contents
of this folder, ftp'ing the resulting zip file, and then unzipping the
contents into the folder on the target Quickr server.
Return to the
Manage Places page on the target
server and select
Archived Applications from the
Show: selection
and click the
GO button to get the list of archived applications.
at this point you should see a screen like the next figure. The backup
that was copied over should appear in this list.
Select the button for restoring the backup (the circular
arrow graphic)
Make sure the correct backup version is selected as in
the screen below and click the
Restore Application button.
Click
OK on the confirmation dialog to start the
restore.
The following message will be displayed on the current
dialog. Click the
Done button which will return you to the main
list of applications.
Select
All Applications from the
Show: selection
list and click the
GO button. This will display all current applications.
Keep refreshing the list periodically. Once the restore completes the moved
place will appear in the list of places as shown below.
The Place is now available and ready for use.
Restrictions
- The security environment must be the same
- The procedure has only be tested on migration between
similar server operating systems.