[asterisk-commits] tzafrir: branch 11 r400279 - in /branches/11: ./ doc/

[SVN commits to the Asterisk project]

Author: tzafrir
Date: Wed Oct  2 12:36:28 2013
New Revision: 400279

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

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

Added:
    branches/11/doc/astdb2bdb.8   (with props)
    branches/11/doc/astdb2sqlite3.8   (with props)
Modified:
    branches/11/Makefile

Modified: branches/11/Makefile
URL: http://svnview.digium.com/svn/asterisk/branches/11/Makefile?view=diff&rev=400279&r1=400278&r2=400279
==============================================================================
--- branches/11/Makefile (original)
+++ branches/11/Makefile Wed Oct  2 12:36:28 2013
@@ -564,6 +564,7 @@
 	$(INSTALL) -m 644 doc/core-*.xml "$(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: branches/11/doc/astdb2bdb.8
URL: http://svnview.digium.com/svn/asterisk/branches/11/doc/astdb2bdb.8?view=auto&rev=400279
==============================================================================
--- branches/11/doc/astdb2bdb.8 (added)
+++ branches/11/doc/astdb2bdb.8 Wed Oct  2 12:36:28 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: branches/11/doc/astdb2bdb.8
------------------------------------------------------------------------------
    svn:eol-style = native

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

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

Added: branches/11/doc/astdb2sqlite3.8
URL: http://svnview.digium.com/svn/asterisk/branches/11/doc/astdb2sqlite3.8?view=auto&rev=400279
==============================================================================
--- branches/11/doc/astdb2sqlite3.8 (added)
+++ branches/11/doc/astdb2sqlite3.8 Wed Oct  2 12:36:28 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: branches/11/doc/astdb2sqlite3.8
------------------------------------------------------------------------------
    svn:eol-style = native

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

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