(Answer) (Category) Faq-O-Matic Faq-O-Matic : (Category) Administrators' Guide : (Category) Maintain :
Backing up Faq-O-Matic
What files should be copied to backup Faq-O-Matic?
How can Faq-O-Matic be restored or reinstalled on another server from the backup?
To backup a FAQ-O-Matic, back up the following:
  - the CGI stub, such as cgi-bin/fom.cgi. This captures any
    local configuration you had to do to get it working.
- the fom-serve/ directory. You don't actually need the cache/ subdirectory, but item/ and bags/ contain your original data.
- the fom-meta/ directory. This directory has all of the configuration of your FAQ, user accounts, and that sort of metadata.
Be sure to use an archiving tool that captures file ownership and permissions correctly. GNU tar is a good choice.
To restore a FAQ-O-Matic, reinstall FAQ::OMatic on the machine, then restore the CGI stub and directories you backed up (above).

Here are the things to watch out for:

  - You may need to manually modify the CGI stub so it can find Perl,
  the FAQ::Omatic libraries, and the meta directory, if any of those
  moved on the new machine.
- Be careful about the file ownership and permissions on what you reinstall. If you use tar, be sure to use the --preserve-permissions (-p) flag.
fom-meta/ and fom-serve/ should both be owned by the user that runs CGI scripts on the new machine, in case that changed from the old one (e.g. 'nobody' to 'apache'.) If you don't run the server you're restoring to, you'll either need the superuser's help to fix the ownership, or you'll need to write a little stub CGI to unpack the backup archive so that it writes the files out with the right ownership.
- After you've restored, go back to the install page and through each of the steps again (even though they're already checked off). In particular, you want to ensure that Define Configuration Parameters is right for the new machine. And you'll want to rebuild the cache, since the embedded links in cached files may be different in the new environment.

See also (Xref) Moving the CGI or data files on the server.

When copying the meta directory, make sure that you copy or make your tarfile as the user who owns the meta/idfile (it's rw-------).

If you move to another system, you may have problems with the RCS directories. I just deleted the RCS files, but I didn't need to preserve the history of the entries either.

[Append to This Answer]
Previous: (Answer) How to rearrange the order of categories listed ?
Next: (Answer) Manually setting a username/password
This document is: http://www.jonh.net/cgi-bin/faqomatic/fom?file=1481
[Search] [Appearance]
This is a Faq-O-Matic 2.718d.
Hosted by SourceForge Logo and jonh.net.