man pages for astdb2bdb and astdb2sqlite3
[asterisk/asterisk.git] / doc / astdb2bdb.8
1 .TH "ASTDB2BDB" "8" "30 SEPTEMBER 2013" "Asterisk 11" ""
2
3 .SH NAME
4 astdb2bdb \- convert astdb back to Berkeley DB 1.86
5 .SH SYNOPSIS
6
7 .B cd \fIastvarlibdir\fB && astdb2bdb path/to/astdb.sqlite3
8
9 .SH "DESCRIPTION"
10 Up until version version 11, Asterisk used an old version of the
11 Berkeley DB 1.86 (bdb) to store its internal persistent database. In
12 version 11 it switched to using a SQLIte 3 database. This program is
13 used to convert the newly-formatted SQLite 3 astdb back to bdb.
14
15 You may need it in case of reverting an upgrade or other similar
16 scenarios.
17
18 .SH OPTIONS
19 There is a single (and required) parameter: the path the the sqlite file.
20 The output file will be a file called
21 .B astdb
22 in the current working directory.
23
24 .SH EXAMPLES
25 In case you want to revert an upgrade to Asterisk 11, you can do the
26 following (while Asterisk is not running):
27
28   cd /var/lib/asterisk && astdb2bdb astdb.sqlite3 && rm astdb.sqlite3
29
30 This will convert the newly-formatted astdb back to the old format, and
31 delete it (to avoid obsolete data copies).
32
33 .SH NOTES
34 Berkeley DB 1.86 is obsolete. It is incompatible with newer versions
35 (4.x and newer) that you may see around. Chances are you don't have the
36 tools to use it independently of Asterisk.
37
38 .SH SEE ALSO
39 .B astdb2sqlite3(8),
40 .B asterisk(8)
41
42 .SH AUTHOR
43 astdb2bdb was written by Terry Wilson <twilson@digium.com>.
44
45 This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com>.
46