forked-synapse/debian/synapse_port_db.1

68 lines
2.7 KiB
Groff
Raw Normal View History

.\" generated with Ronn-NG/v0.8.0
.\" http://github.com/apjanke/ronn-ng/tree/0.8.0
.TH "SYNAPSE_PORT_DB" "1" "July 2021" "" ""
2018-12-10 12:14:34 -05:00
.SH "NAME"
\fBsynapse_port_db\fR \- A script to port an existing synapse SQLite database to a new PostgreSQL database\.
.SH "SYNOPSIS"
\fBsynapse_port_db\fR [\-v] \-\-sqlite\-database=\fIdbfile\fR \-\-postgres\-config=\fIyamlconfig\fR [\-\-curses] [\-\-batch\-size=\fIbatch\-size\fR]
.SH "DESCRIPTION"
\fBsynapse_port_db\fR ports an existing synapse SQLite database to a new PostgreSQL database\.
.P
SQLite database is specified with \fB\-\-sqlite\-database\fR option and PostgreSQL configuration required to connect to PostgreSQL database is provided using \fB\-\-postgres\-config\fR configuration\. The configuration is specified in YAML format\.
.SH "OPTIONS"
.TP
\fB\-v\fR
Print log messages in \fBdebug\fR level instead of \fBinfo\fR level\.
.TP
\fB\-\-sqlite\-database\fR
The snapshot of the SQLite database file\. This must not be currently used by a running synapse server\.
.TP
\fB\-\-postgres\-config\fR
The database config file for the PostgreSQL database\.
.TP
\fB\-\-curses\fR
Display a curses based progress UI\.
.SH "CONFIG FILE"
The postgres configuration file must be a valid YAML file with the following options\.
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBdatabase\fR: Database configuration section\. This section header can be ignored and the options below may be specified as top level keys\.
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBname\fR: Connector to use when connecting to the database\. This value must be \fBpsycopg2\fR\.
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBargs\fR: DB API 2\.0 compatible arguments to send to the \fBpsycopg2\fR module\.
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBdbname\fR \- the database name
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBuser\fR \- user name used to authenticate
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBpassword\fR \- password used to authenticate
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBhost\fR \- database host address (defaults to UNIX socket if not provided)
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBport\fR \- connection port number (defaults to 5432 if not provided)
.IP "" 0
.IP "\[ci]" 4
2018-12-10 12:14:34 -05:00
\fBsynchronous_commit\fR: Optional\. Default is True\. If the value is \fBFalse\fR, enable asynchronous commit and don\'t wait for the server to call fsync before ending the transaction\. See: https://www\.postgresql\.org/docs/current/static/wal\-async\-commit\.html
.IP "" 0
.IP "" 0
.P
Following example illustrates the configuration file format\.
.IP "" 4
.nf
database:
name: psycopg2
args:
dbname: synapsedb
user: synapseuser
password: ORohmi9Eet=ohphi
host: localhost
synchronous_commit: false
.fi
.IP "" 0
.SH "COPYRIGHT"
This man page was written by Sunil Mohan Adapa <\fI\%mailto:sunil@medhas\.org\fR> for Debian GNU/Linux distribution\.
2018-12-10 12:14:34 -05:00
.SH "SEE ALSO"
synctl(1), hash_password(1), register_new_matrix_user(1), synapse_review_recent_signups(1)