[Building Sakai] how to use Site Archive to import sites

[Sam Ottenhoff]

> I would like know use toll Site Archive to import site of one instance 
> of sakai to other instance of Sakai.

Unfortunately, transferring a site from one instance of Sakai to another 
instance is not the smoothest process.  To transfer a site:

  1) Go to Site Archive and enter the site id in the Export section
  2) Find the archive directory in the format "siteid-archive" 
(directory controlled by 
storagePath at org.sakaiproject.archive.api.ArchiveService setting)
  3) Transfer directory to other instance of Sakai
  4) Place archive in the relevant archive directory
  5) Import into other instance of Sakai using Site Archive tool ("file" 
would be "siteid-archive" and "to site" would be simply "siteid")

The most common problem with this transfer will be that the Resources 
files will not be imported.  This is caused by the bug reported here: 
http://jira.sakaiproject.org/browse/SAK-16086

Two possible solutions include:

   1) Fixing the code locally as described in the above JIRA; or

   2) doing a global rewrite in the XML files of the archive to modify 
the old user id with the new user id of the content owner (also do a 
global rewrite of the base64-encoded user id).

--Sam