Avoka Blog: Adobe LiveCycle

June 6, 2008

Hot Back-ups of LiveCycle

Filed under: LiveCycle, LiveCycle Administration, LiveCycle Architecture — htreisman @ 4:17 pm

Most of LiveCycle’s data is held in the LiveCycle database. Backing up the database is easy – just use the native backup facilities provided by your database vendor.

Usually you can do a “hot” backup, while the application (i.e. LiveCycle) is still running. What the backup utility does is to set a “marker” in the database transaction log – the backup is the state of the entire database at the point in time the marker was set. The database will continue to run, and execute transactions, but the data from these new transactions won’t appear in the backup – so no matter how big the database is, you always get a consistent set of data.

LiveCycle is a bit more complicated, because it has the Global Document Storage directory (GDS). The GDS is really an extension or overflow for the database. For any large documents, these are actually stored in the GDS, rather than in the database – this helps with performance, and also helps to ensure that your database doesn’t grow too rapidly.

You always need to ensure that when you do a backup of your database, you do a backup of your GDS. Similarly, if you do a restore, you should also restore both the GDS and the database at the same time.

The trick is: how do you ensure that the database and GDS are consistent with each other? Any missing files in the GDS will cause LiveCycle to start throwing exceptions.

One technique is to shut down LiveCycle while you’re doing the backup. If you need to do hot backups, then there are different approaches depending on your version of LiveCycle.

LiveCycle 8 Update 1

In LiveCycle 8 update 1 (at the time of writing, in beta), Adobe have added “backup mode” to enable backups to be made more reliably. The steps are:

  • Turn on “backup mode” in the adminui – this will temporarily prevent LiveCycle from deleting any files from the GDS.
  • Backup the database.
  • Backup the GDS.
  • Turn backup mode off.

LiveCycle 8

There is no backup mode in LiveCycle 8. The following procedure is the one that we recommend for hot backups.

  • Backup the GDS
  • Backup the database
  • Backup the GDS again, to the same backup location. Ensure that you use a backup mode that adds any new or modified files, but does NOT remove any files that have been removed since the first backup.

You should also try to ensure that the entire process above occurs as quickly as possible. This may mean that you initially copy the files to a temporary location, and then perform the real backup (to tape or whatever) from there.

There is apparently a small window of possibility that errors occurs – if a file in the GDS is created and removed between the time that the first backup starts and the second backup completes. This is generally a small window. Thank you to Rob Ryan of Adobe for pointing this out.



  1. Please allow a few questions:

    1) Can you provide a sample of putting the server in safe backup mode using the java api to do so? The adminUI method is manual and is not feasible for our company.

    2) If the server is in backup mode, users can still use livecycle, right? Is there any performance degradation in this scenario?

    3) What if up-to-the-hour recovery is a requirement? How are hot backups performed then? For example, the DB2 system tables take a crash at 3pm and we can only recover to 2pm? The DB2 administrators can use the transaction log to recover to that point in time, I suppose, but what about the GDS? How would we put it back to the state is was in at 2pm?

    Thanks very much!

    Comment by Elaine Schmitz — February 7, 2009 @ 5:24 am

    • Hi Elaine
      1) Please check out C:\Adobe\LiveCycle8.2\LiveCycle_ES_SDK\misc\Foundation\BackupRestoreCommandline
      2) Yes. I don’t believe so, although I haven’t tested.
      3) Like I said in the article, you need to back up (and restore) both the database and the GDS to the same point in time. i.e. the 2pm backup.

      I hope this helps…

      Comment by htreisman — February 9, 2009 @ 8:18 am

  2. Hey exceptional website! Does running a blog similar to this take a lot of
    work? I’ve no expertise in programming however I was hoping to start my own blog in the near future. Anyhow, if you have any recommendations or techniques for new blog owners please share. I understand this is off subject nevertheless I just had to ask. Thanks a lot!

    Comment by washington dc water damage — January 30, 2013 @ 2:35 am

RSS feed for comments on this post. TrackBack URI

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

Blog at WordPress.com.

%d bloggers like this: