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