Content-type: text/html
Manpage of cmarchive
cmarchive
Section: User Commands (1)
Updated: SnapshotCM
Index
Return to Main Contents
NAME
cmarchive - export projects from and import archives into a SnapshotCM database
SYNOPSIS
cmarchive
[-E] [-C #]
[-V]
[-d archiveDir]
/ProjectPath
cmarchive
[-I] [-C #]
[-V]
archiveDir
DESCRIPTION
cmarchive exports a SnapshotCM project into an archive which can be
imported back into the same or different SnapshotCM database.
cmarchive operates directly upon the database files so the server(s)
must not be running.
A cmarchive archive consists of a directory with a archive.xml file
containing all project information except the file revision contents,
and a revisions subdirectory containing the revision files.
The primary intent of cmarchive is to move a project to another
SnapshotCM server. Archived projects can also be reimported into the same
server.
IMPORTANT NOTES
At present, the archive format is not stable, so use of cmarchive
for long-term archiving of old projects is not recommended.
cmarchive is only available by request.
We recommend backing up your database before importing into it, and
running dbck after the import to validate the database before use.
We also recommend that you validate the import into the new database before
removing the project from your existing database.
The only permission needed to run cmarchive is operating system access
to the database and archive files themselves.
Options
- -E
-
Export a project from the database.
The parameter is the full path name of the project to export.
The database to export from must be in the current directory.
- -I
-
Import an archive into the database.
The parameter is the name of the directory containing the archive.xml file.
The database to import into must be in the current directory.
- -CMegabytes
-
Set the size of the database memory cache.
A larger cache generally results in better performance.
Normally, the default need not be changed as
memory for the cache is allocated only as needed.
- -darchivePath
-
Specify the directory in which to create the archive
(the default is ProjectArchive).
Each exported project is stored in a project-named subdirectory of the
location specified.
An example may clarify this: If exporting the project /PROJ to ProjectArchive,
the archive will be created in ProjectArchive/PROJ.
- -V
-
Print the internal version and exit.
RETURN VALUE
Exit status is 0 if the operation succeeded, 1 if there was an error
performing the operation, and 2 if there was a bad option.
EXAMPLES
Export /PROJ into the C:\ARCHIVE directory:
-
cmarchive -E -d C:\ARCHIVE /PROJ
Import the archive from C:\ARCHIVE\PROJ into the database in the current
directory:
-
cmarchive -I C:\ARCHIVE\PROJ
SEE ALSO
cmconfig(1), dbck(1).
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- IMPORTANT NOTES
-
- Options
-
- RETURN VALUE
-
- EXAMPLES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 14:55:05 GMT, July 27, 2010