1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
<?xml version="1.0" encoding="UTF-8"?>
<refentry>
<refmeta>
<refentrytitle>bbstored-certs</refentrytitle>
<manvolnum>8</manvolnum>
</refmeta>
<refnamediv>
<refname>bbstored-certs</refname>
<refpurpose>Manage certificates for the Box Backup system</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>bbstored-certs <certs-dir> <command>
[<arguments>]</command>
</cmdsynopsis>
</refsynopsisdiv>
<refsection>
<title>Description</title>
<para><literal>bbstored-certs</literal> creates and signs certificates for
use in Box Backup. It allows the user to create and sign the server keys,
as well as signing client keys.</para>
<para>All commands must be followed by the <literal>certs-dir</literal>,
which is the directory in which the certificates are stored.</para>
<refsection>
<title>Commands</title>
<para>There are 3 commands:</para>
<itemizedlist>
<listitem>
<para><literal>init</literal>: Create the
<literal>certs-dir</literal>, and generate the server keys for
bbstored. <literal>certs-dir</literal> cannot exist before running
the command.</para>
</listitem>
<listitem>
<para><literal>sign-server <servercsrfile></literal>: Sign the
server certificate. The <literal>servercsrfile</literal> is the file
generated by the <literal>init</literal> command.</para>
</listitem>
<listitem>
<para><literal>sign <clientcsrfile></literal>: Sign a client
certificate. The <literal>clientcsrfile</literal> is generated
during client setup. See <literal>bbackupd-config(8)</literal>. Send
the signed certificate back to the client, and install according to
the instructions given by <literal>bbackupd-config</literal>.</para>
</listitem>
</itemizedlist>
</refsection>
</refsection>
<refsection>
<title>Author</title>
<para>Ben Summers and contributors. For help, please go to the <ulink
url="http://www.boxbackup.org/trac/">Wiki</ulink>, or subscribe to the Box
Backup <ulink
url="http://lists.warhead.org.uk/mailman/listinfo/boxbackup">mailing
list.</ulink></para>
</refsection>
<refsection>
<title>See Also</title>
<para><literal>bbstored-config(8)</literal></para>
<para><literal>bbstored.conf(5)</literal></para>
<para><literal>bbstoreaccounts(8)</literal></para>
</refsection>
<refsection>
<title>Files</title>
<para><literal>raidfile-config</literal> generates the raidfile.conf(5)
file.</para>
</refsection>
<refsection>
<title>Bugs</title>
<para>If you find a bug in Box Backup, and you want to let us know about
it, join the <ulink
url="http://lists.warhead.org.uk/mailman/listinfo/boxbackup">mailing
list</ulink>, and send a description of the problem there.</para>
<para>To report a bug, give us at least the following information:</para>
<itemizedlist>
<listitem>
<para>The version of Box Backup you are running</para>
</listitem>
<listitem>
<para>The platform you are running on (hardware and OS), for both
client and server.</para>
</listitem>
<listitem>
<para>If possible attach your config files (bbstored.conf,
bbackupd.conf) to the bug report.</para>
</listitem>
<listitem>
<para>Also attach any log file output that helps shed light on the
problem you are seeing.</para>
</listitem>
<listitem>
<para>And last but certainly not least, a description of what you are
seeing, in as much detail as possible.</para>
</listitem>
</itemizedlist>
</refsection>
</refentry>
|