1 kumpf 1.1 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1m.Z/cimreparchive.1m,v 1.2 2003/03/13 17:25:16 kumpf Exp $
 2           .TA c \" lowercase initial letter of .TH name
 3           .TH cimreparchive 1M
 4           .SH NAME
 5           cimreparchive \- create an archive copy of the CIM Server repository
 6           .SH SYNOPSIS
 7           
 8           \fBcimreparchive \fParchive_file
 9           
10           \fBcimreparchive --help
11           
12           \fBcimreparchive --version
13           .SH DESCRIPTION
14           The 
15           .B cimreparchive 
16           command creates an archive copy of the CIM Server
17           repository in the specified \fParchive_file. The archive copy is assured to
18           contain a consistent repository state even if it is created while the
19           CIM Server is running.
20           .PP
21           The \fParchive_file is created using the tar(1) command.  To restore the
22 kumpf 1.1 repository from the \fParchive_file, stop the cimserver, move the active
23           repository files to a different location, use tar(2) to extract the
24           archived repository files, and restart the cimserver.  (Note that the
25           repository location is printed when an archive file is created.)
26           .SS Options
27           .B cimreparchive 
28           recognizes the following options:
29           .RS
30           .TP 15
31           .B --help
32           Displays the command help message.  
33           .TP
34           .B --version
35           Displays the CIM Server version number.
36           .SH EXIT STATUS
37           When an error occurs, an error message is written to the standard error
38           stream and a non-zero exit status value is returned. The following exit
39           status values are defined:
40           .RS
41           .TP
42           .B 0
43 kumpf 1.1 Success
44           .PD
45           .TP
46           .B 1
47           General error
48           .PD
49           .TP
50           .B 2
51           Failed to initiate archive operation
52           .PD
53           .TP
54           .B 3
55           Archive operation failed
56           .PD
57           .RE
58           .SH SEE ALSO
59           .PP
60           cimserver(8), tar(1).