[asterisk-commits] tzafrir: trunk r400282 - in /trunk: ./ doc/

Wed Oct 2 13:28:05 CDT 2013

Author: tzafrir
Date: Wed Oct  2 13:28:03 2013
New Revision: 400282

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=400282
Log:
man pages for astdb2bdb and astdb2sqlite3

Review: https://reviewboard.asterisk.org/r/2898/
........

Merged revisions 400279 from http://svn.asterisk.org/svn/asterisk/branches/11
........

Merged revisions 400281 from http://svn.asterisk.org/svn/asterisk/branches/12

Added:
    trunk/doc/astdb2bdb.8   (with props)
    trunk/doc/astdb2sqlite3.8   (with props)
Modified:
    trunk/   (props changed)
    trunk/Makefile

Propchange: trunk/
------------------------------------------------------------------------------

--- branch-12-merged (original)
+++ branch-12-merged Wed Oct  2 13:28:03 2013
@@ -1,1 +1,1 @@
-/branches/12:1-398558,398560-398577,398579-399305,399307-400181,400194,400196,400205,400217,400227,400236,400245,400254,400256,400265,400268,400270
+/branches/12:1-398558,398560-398577,398579-399305,399307-400181,400194,400196,400205,400217,400227,400236,400245,400254,400256,400265,400268,400270,400281

Modified: trunk/Makefile
URL: http://svnview.digium.com/svn/asterisk/trunk/Makefile?view=diff&rev=400282&r1=400281&r2=400282
==============================================================================
--- trunk/Makefile (original)
+++ trunk/Makefile Wed Oct  2 13:28:03 2013
@@ -578,6 +578,7 @@
 	$(INSTALL) -m 644 doc/snapshots.xslt "$(DESTDIR)$(ASTDATADIR)/documentation"
 	$(INSTALL) -m 644 doc/appdocsxml.dtd "$(DESTDIR)$(ASTDATADIR)/documentation"
 	$(INSTALL) -m 644 doc/asterisk.8 "$(DESTDIR)$(ASTMANDIR)/man8"
+	$(INSTALL) -m 644 doc/astdb*.8 "$(DESTDIR)$(ASTMANDIR)/man8"
 	$(INSTALL) -m 644 contrib/scripts/astgenkey.8 "$(DESTDIR)$(ASTMANDIR)/man8"
 	$(INSTALL) -m 644 contrib/scripts/autosupport.8 "$(DESTDIR)$(ASTMANDIR)/man8"
 	$(INSTALL) -m 644 contrib/scripts/safe_asterisk.8 "$(DESTDIR)$(ASTMANDIR)/man8"

Added: trunk/doc/astdb2bdb.8
URL: http://svnview.digium.com/svn/asterisk/trunk/doc/astdb2bdb.8?view=auto&rev=400282
==============================================================================
--- trunk/doc/astdb2bdb.8 (added)
+++ trunk/doc/astdb2bdb.8 Wed Oct  2 13:28:03 2013
@@ -1,0 +1,46 @@
+.TH "ASTDB2BDB" "8" "30 SEPTEMBER 2013" "Asterisk 11" ""
+
+.SH NAME
+astdb2bdb \- convert astdb back to Berkeley DB 1.86
+.SH SYNOPSIS
+
+.B cd \fIastvarlibdir\fB && astdb2bdb path/to/astdb.sqlite3
+
+.SH "DESCRIPTION"
+Up until version version 11, Asterisk used an old version of the
+Berkeley DB 1.86 (bdb) to store its internal persistent database. In
+version 11 it switched to using a SQLIte 3 database. This program is
+used to convert the newly-formatted SQLite 3 astdb back to bdb.
+
+You may need it in case of reverting an upgrade or other similar
+scenarios.
+
+.SH OPTIONS
+There is a single (and required) parameter: the path the the sqlite file.
+The output file will be a file called
+.B astdb
+in the current working directory.
+
+.SH EXAMPLES
+In case you want to revert an upgrade to Asterisk 11, you can do the
+following (while Asterisk is not running):
+
+  cd /var/lib/asterisk && astdb2bdb astdb.sqlite3 && rm astdb.sqlite3
+
+This will convert the newly-formatted astdb back to the old format, and
+delete it (to avoid obsolete data copies).
+
+.SH NOTES
+Berkeley DB 1.86 is obsolete. It is incompatible with newer versions
+(4.x and newer) that you may see around. Chances are you don't have the
+tools to use it independently of Asterisk.
+
+.SH SEE ALSO
+.B astdb2sqlite3(8),
+.B asterisk(8)
+
+.SH AUTHOR
+astdb2bdb was written by Terry Wilson <twilson at digium.com>.
+
+This manual page was written by Tzafrir Cohen <tzafrir.cohen at xorcom.com>.
+

Propchange: trunk/doc/astdb2bdb.8
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: trunk/doc/astdb2bdb.8
------------------------------------------------------------------------------
    svn:keywords = Author Date Id Revision

Propchange: trunk/doc/astdb2bdb.8
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: trunk/doc/astdb2sqlite3.8
URL: http://svnview.digium.com/svn/asterisk/trunk/doc/astdb2sqlite3.8?view=auto&rev=400282
==============================================================================
--- trunk/doc/astdb2sqlite3.8 (added)
+++ trunk/doc/astdb2sqlite3.8 Wed Oct  2 13:28:03 2013
@@ -1,0 +1,39 @@
+.TH "ASTDB2SQLITE3" "8" "30 SEPTEMBER 2013" "Asterisk 11" ""
+
+.SH NAME
+astdb2sqlite3 \- convert astdb to SQLite 3
+.SH SYNOPSIS
+
+.B astdb2sqlite3 path/to/astdb
+
+.SH "DESCRIPTION"
+Up until version version 11, Asterisk used an old version of the
+Berkeley DB 1.86 (bdb) to store its internal persistent database. In
+version 11 it switched to using a SQLite 3 database. This program is
+used to convert an existing bdb astdb file to astdb.sqlite3.
+
+Normally the conversion is done by Asterisk itself which will run this
+program. But you may need to run it on your own.
+
+.SH OPTIONS
+There is a single (and required) parameter: the path the the bdb file.
+The output file name will be the same as the input, with
+.B .sqlite3
+appended.
+
+.SH EXAMPLES
+Asterisk will typically run the following to upgrade the database:
+
+  astdb2sqlite3 /var/lib/asterisk/astdb
+
+which will create \fB/var/lib/asterisk/astdb.sqlite3\fR.
+
+.SH SEE ALSO
+.B astdb2bdb(8),
+.B asterisk(8)
+
+.SH AUTHOR
+astdb2sqlite3 was written by Terry Wilson <twilson at digium.com>.
+
+This manual page was written by Tzafrir Cohen <tzafrir.cohen at xorcom.com>.
+

Propchange: trunk/doc/astdb2sqlite3.8
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: trunk/doc/astdb2sqlite3.8
------------------------------------------------------------------------------
    svn:keywords = Author Date Id Revision

Propchange: trunk/doc/astdb2sqlite3.8
------------------------------------------------------------------------------
    svn:mime-type = text/plain


