Importing and exporting archives as zip files in UCM

Archive ZipOne of the features of Site Studio is the ability to backup and restore websites.  It takes all of the assets associated with the website and combines them into a backup directory that is stored on the server and can be downloaded as a zip if needed.  When it comes time to restore, you simply choose that backup from the server or upload the zip file saved earlier.  The mechanism that Site Studio is using in the background is simply a specialized Archiver process.  An archive is defined dynamically with the proper export criteria to grab the site assets and they are exported to that backup directory.  Then when you request a download of that backup, UCM zips that standard archive directory and delivers the zip file to the client browser.

Well, it turns out that this ability to download and upload zipped archives does not have to be for just Site Studio sites.  You can do this for regular content archives as well. 

First, when you go to the Archiver applet, you're taken to the default collection of archives.  In the menu, go to Options -> Open Archive Collection.  There you should see another one with the name "<instance name>_sitestudiobackupcollection".  Select that collection and click Open. 

Archive Collection

This collection got created when Site Studio was installed and is where site backups are archived. And even if you aren't using Site Studio at all, as long as you have it enabled, this feature will be available. If you've done backups or restores already, you'll see those listed. Now that you have the collection open, you can add your new archives here.  You can create those just as you normally would.  

archive list

Now perform the archive Export process.  The content/table data will then get exported to the collection location on the server.

To download the archive, go to Administration ->; Site Studio Administration -> Backup and Restore.   Click the Managed Archives button.  You should now see your archive in the list.  

Manage Backups

With the Actions icon, select 'Download backup archive as ZIP'.  This will zip up the archive and allow you to download it locally.  Note, large archives may take a while to zip up and may time out if too large.  For those types of archives, I'd recommend setting up the traditional ways of migrating the archive.

Now that you have your archive, you can just as easily import it into your target instance.  On that instance, go to  Administration -> Site Studio Administration -> Backup and Restore.  In the Upload Archive section, browse to your saved archive and click Upload Archive.  You'll then be taken to the archive information screen.   

Archive Information

On the Actions menu, select 'Restore backup archive contents'.  This will now import the archived documents.  If you wish to include some import mappings, you can simply go to the Archiver applet and set up the mappings there and do the import right from the applet.

Comments:

Hi Kyle, I have an archive which is larger then 2GB and I cannot upload it from the upload section. Is there any way to directly upload the zip file to the server and import it.

Thanks
-- Sid

Posted by Sid on April 16, 2013 at 01:11 PM CDT #

Hello Sid,

No afraid not. Like I mention in the article, archives that are too large may time out. In those cases, it's best to work with your admins on creating a Transfer between Archivers or manually move the archive folders between systems.

Thanks,
-Kyle

Posted by Kyle Hatlestad on April 17, 2013 at 10:33 AM CDT #

Hi Kyle,

That's what I ended up doing. I zipped up the archive on the source UCM server and manually copied over to the target UCM server in the Site Studio backuparchive directory[where the other archives get stored when you use the Web interface to upload an archive]. But after that it didn't show up in the on the Manage Archive web page. I'm not sure if it's suppose to show up there if I manually put the archive there.

So, then what I did was started the Archiver in standalone mode, open site studio backup collection and added a new archive. When I used Archiver in standalone mode it gave me an option to "copy from" while adding a new archive. So I pointed it to the archive which I had copied manually and now I could see it in Archiver Applet and the Manage Archive webpage. Then I just just picked restore option from there and I can now see all the content in the target instance.

Everything seems to be working fine, only thing I'm not sure about it the way I had to run the Archiver in stanalone mode in order to add the manually copied archive. Is this the correct way or is there any other better way to do this?

Thank you
-- Sid

Posted by Sid on April 17, 2013 at 10:50 AM CDT #

Hello Sid,

Yes, as long as you have access to run the Archiver in standalone mode, that's just the way to do it. Standalone mode in Archiver is required to have access to the server's file system which the applet version would not have.

Thanks,
-Kyle

Posted by Kyle Hatlestad on April 17, 2013 at 10:56 AM CDT #

Great, Thank you Kyle.

Just out of curiosity, is there any other way to do this, say in case I cannot run Archiver in standalone mode? Our UCM server run on Oracle Linux without any graphical interface. Only way to access the server is though SSH. But I happen to know about Xming so I was able to run the Archiver in standalone mode using putty and Xming with X Server running locally on my laptop.

Thank you
-- Sid

Posted by Sid on April 17, 2013 at 11:37 AM CDT #

Hello Sid,

Not in an easy or supported way. But archives can be manually placed by putting the archive's folder within the collection's folder. Standard archives are in the ../archives/ folder and the Site Studio ones are in the ../data/SiteStudio/backuparchives/ folder. You then manually modify the collections.hda file to add the 2 lines for your archive: Name and Description. The next time the Archiver applet is launched it will read the collectionds.hda file and recognize the new archive. Making these modifications are not really advised and should be done AT YOUR OWN RISK.

Thanks,
-Kyle

Posted by Kyle Hatlestad on April 17, 2013 at 11:50 AM CDT #

At one point I thought of doing that. But then realized that Archiver presents you with more options when run in standalone mode, so gave gave a shot first.

Thank you, this is good to know, just in case
-- Sid

Posted by Sid on April 17, 2013 at 11:57 AM CDT #

Post a Comment:
  • HTML Syntax: NOT allowed
About

Kyle Hatlestad is a Solution Architect in the WebCenter Architecture group (A-Team) who works with WebCenter Content and other products in the WebCenter & Fusion Middleware portfolios. The WebCenter A-Team blog can be found at: https://blogs.oracle.com/ ateam_webcenter/

Search

Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today