'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH "SLONIK CLUSTER NAME" 7 "24 July 2014" "" "Slony-I 2.2.3 Documentation"
.SH NAME
CLUSTER NAME \- preamble - identifying Slony-I cluster 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBCLUSTER NAME = \fR\kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fIclustername;\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
Must be the very first statement in every
slonik script. It defines the
namespace in which all Slony-I
specific functions, procedures, tables and sequences are
defined. The namespace name is built by prefixing the given
string literal with an underscore. This namespace will be
identical in all databases that participate in the same
replication group.
.PP
No user objects are supposed to live in this namespace, and the
namespace is not allowed to exist prior to adding a database to
the replication system. Thus, if you add a new node using
\fBpg_dump -s \fRon a database that is already in
the cluster of replicated databases, you will need to drop the
namespace via the SQL command \fBDROP SCHEMA _testcluster
CASCADE; \fR.
.SH EXAMPLE
.nf
\*(T<     CLUSTER NAME = testcluster;
    \*(T>
.fi
.SH "VERSION INFORMATION "
This command was introduced in Slony-I 1.0