1999-07-22 17:09:15 +02:00
|
|
|
<!--
|
2001-01-20 23:09:24 +01:00
|
|
|
$Header: /cvsroot/pgsql/doc/src/sgml/ref/initdb.sgml,v 1.15 2001/01/20 22:09:24 tgl Exp $
|
1999-07-22 17:09:15 +02:00
|
|
|
Postgres documentation
|
|
|
|
-->
|
|
|
|
|
1999-07-06 19:16:42 +02:00
|
|
|
<refentry id="APP-INITDB">
|
2000-11-12 00:01:45 +01:00
|
|
|
<docinfo>
|
2000-12-26 00:15:27 +01:00
|
|
|
<date>2000-12-25</date>
|
2000-11-12 00:01:45 +01:00
|
|
|
</docinfo>
|
|
|
|
|
1999-07-06 19:16:42 +02:00
|
|
|
<refmeta>
|
2000-11-12 00:01:45 +01:00
|
|
|
<refentrytitle id="APP-INITDB-TITLE"><application>initdb</application></refentrytitle>
|
|
|
|
<manvolnum>1</manvolnum>
|
1999-07-06 19:16:42 +02:00
|
|
|
<refmiscinfo>Application</refmiscinfo>
|
|
|
|
</refmeta>
|
2000-11-12 00:01:45 +01:00
|
|
|
|
1999-07-06 19:16:42 +02:00
|
|
|
<refnamediv>
|
2000-11-12 00:01:45 +01:00
|
|
|
<refname>initdb</refname>
|
|
|
|
<refpurpose>Create a new <productname>Postgres</productname> database cluster</refpurpose>
|
1999-07-06 19:16:42 +02:00
|
|
|
</refnamediv>
|
2000-11-12 00:01:45 +01:00
|
|
|
|
1999-07-06 19:16:42 +02:00
|
|
|
<refsynopsisdiv>
|
2000-11-12 00:01:45 +01:00
|
|
|
<cmdsynopsis>
|
|
|
|
<command>initdb</command>
|
|
|
|
<group choice="plain">
|
|
|
|
<arg>--pgdata </arg>
|
|
|
|
<arg>-D </arg>
|
|
|
|
<replaceable>dbdir</replaceable>
|
|
|
|
</group>
|
|
|
|
<group>
|
|
|
|
<arg>--sysid </arg>
|
|
|
|
<arg>-i </arg>
|
|
|
|
<replaceable>sysid</replaceable>
|
|
|
|
</group>
|
|
|
|
<group><arg>--pwprompt</arg><arg>-W</arg></group>
|
|
|
|
<group>
|
|
|
|
<arg>--encoding </arg>
|
|
|
|
<arg>-E </arg>
|
|
|
|
<replaceable>encoding</replaceable>
|
|
|
|
</group>
|
|
|
|
<arg>-L <replaceable>directory</replaceable></arg>
|
|
|
|
<group><arg>--noclean</arg><arg>-n</arg></group>
|
|
|
|
<group><arg>--debug</arg><arg>-d</arg></group>
|
|
|
|
</cmdsynopsis>
|
|
|
|
</refsynopsisdiv>
|
|
|
|
|
|
|
|
<refsect1 id="R1-APP-INITDB-1">
|
|
|
|
<title>
|
|
|
|
Description
|
|
|
|
</title>
|
|
|
|
<para>
|
|
|
|
<application>initdb</application> creates a new
|
|
|
|
<productname>Postgres</productname> database cluster or system. A
|
|
|
|
database cluster is a collection of databases that are managed by a
|
|
|
|
single postmaster.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
Creating a database system consists of creating the directories in which
|
|
|
|
the database data will live, generating the shared catalog tables
|
2001-01-20 23:09:24 +01:00
|
|
|
(tables that belong to the whole cluster rather than to any particular
|
|
|
|
database), and creating the <literal>template1</literal>
|
2000-11-12 00:01:45 +01:00
|
|
|
database. When you create a new database, everything in the
|
|
|
|
<literal>template1</literal> database is copied.
|
|
|
|
It contains catalog tables filled in for things like the
|
|
|
|
built-in types.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2001-01-20 23:09:24 +01:00
|
|
|
You must not execute <application>initdb</application> as root; it must
|
|
|
|
be run by the Unix user account that will run the database server.
|
|
|
|
This is because you cannot run the database server as root either, but the
|
2000-11-12 00:01:45 +01:00
|
|
|
server needs to have access to the files <application>initdb</application>
|
|
|
|
creates. Furthermore, during the initialization phase, when there are no
|
|
|
|
users and no access controls installed, <productname>Postgres</productname>
|
|
|
|
will only connect with
|
|
|
|
the name of the current Unix user, so you must log in under the account
|
|
|
|
that will own the server process.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2001-01-20 23:09:24 +01:00
|
|
|
Although <application>initdb</application> will attempt to create the
|
|
|
|
specified data directory, often it won't have permission to do so,
|
|
|
|
since the parent of the desired data directory is often a root-owned
|
|
|
|
directory. To set up an arrangement like this, create an empty data
|
|
|
|
directory as root, then use <application>chown</application> to hand over
|
|
|
|
ownership of that directory to the database user account, then
|
|
|
|
<application>su</application> to become the database user, and
|
|
|
|
finally run <application>initdb</application> as the database user.
|
2000-11-12 00:01:45 +01:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<refsect2>
|
|
|
|
<title>Options</title>
|
1998-10-05 04:54:45 +02:00
|
|
|
|
2000-11-12 00:01:45 +01:00
|
|
|
<para>
|
1999-07-06 19:16:42 +02:00
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
1999-12-17 02:05:31 +01:00
|
|
|
<term>--pgdata=<replaceable class="parameter">dbdir</replaceable></term>
|
|
|
|
<term>-D <replaceable class="parameter">dbdir</replaceable></term>
|
1999-07-06 19:16:42 +02:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2000-12-26 00:15:27 +01:00
|
|
|
This option specifies where in the file system the database
|
|
|
|
should be stored. This is the only information required by
|
2001-01-20 23:09:24 +01:00
|
|
|
<application>initdb</application>, but you can avoid writing it by
|
2000-12-26 00:15:27 +01:00
|
|
|
setting the <envar>PGDATA</envar> environment variable, which
|
|
|
|
can be convenient since the database server
|
|
|
|
(<filename>postmaster</filename>) can find the database
|
|
|
|
directory later by the same variable.
|
1999-07-06 19:16:42 +02:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
1998-10-05 04:54:45 +02:00
|
|
|
|
1999-07-06 19:16:42 +02:00
|
|
|
<varlistentry>
|
1999-12-17 02:05:31 +01:00
|
|
|
<term>--sysid=<replaceable class="parameter">sysid</replaceable></term>
|
|
|
|
<term>-i <replaceable class="parameter">sysid</replaceable></term>
|
1999-07-06 19:16:42 +02:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2000-12-26 00:15:27 +01:00
|
|
|
Selects the system id of the database superuser. This defaults
|
|
|
|
to the effective user id of the user running
|
|
|
|
<application>initdb</application>. It is really not important
|
|
|
|
what the superuser's sysid is, but one might choose to start
|
|
|
|
the numbering at some number like 1.
|
1999-07-06 19:16:42 +02:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
1999-12-17 02:05:31 +01:00
|
|
|
|
1999-07-06 19:16:42 +02:00
|
|
|
<varlistentry>
|
2000-01-15 19:30:35 +01:00
|
|
|
<term>--pwprompt</term>
|
|
|
|
<term>-W</term>
|
1999-07-06 19:16:42 +02:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2000-12-26 00:15:27 +01:00
|
|
|
Makes <application>initdb</application> prompt for a password
|
2001-01-20 23:09:24 +01:00
|
|
|
to give the database superuser. If you don't plan on using password
|
2000-12-26 00:15:27 +01:00
|
|
|
authentication, this is not important. Otherwise you won't be
|
|
|
|
able to use password authentication until you have a password
|
|
|
|
set up.
|
1999-07-06 19:16:42 +02:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
1999-12-17 02:05:31 +01:00
|
|
|
|
|
|
|
<varlistentry>
|
2000-01-15 19:30:35 +01:00
|
|
|
<term>--encoding=<replaceable class="parameter">encoding</replaceable></term>
|
2000-01-18 01:03:37 +01:00
|
|
|
<term>-E <replaceable class="parameter">encoding</replaceable></term>
|
1999-12-17 02:05:31 +01:00
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Selects the multibyte encoding of the template database. This will also
|
|
|
|
be the default encoding of any database you create later, unless you
|
|
|
|
override it there. To use the multibyte encoding feature, you must
|
|
|
|
specify so at build time, at which time you also select the default
|
|
|
|
for this option.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
</variablelist>
|
1999-07-06 19:16:42 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Other, less commonly used, parameters are also available:
|
|
|
|
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
2000-11-12 00:01:45 +01:00
|
|
|
<term>-L <replaceable class="parameter">directory</replaceable></term>
|
1999-12-17 02:05:31 +01:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2000-12-26 00:15:27 +01:00
|
|
|
Specifies where <application>initdb</application> should find
|
|
|
|
its input files to initialize the database system. This is
|
|
|
|
normally not necessary. You will be told if you need to
|
|
|
|
specify their location explicitly.
|
1999-12-17 02:05:31 +01:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
1999-07-06 19:16:42 +02:00
|
|
|
<varlistentry>
|
|
|
|
<term>--noclean</term>
|
|
|
|
<term>-n</term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
By default, when <application>initdb</application>
|
2000-10-05 21:48:34 +02:00
|
|
|
determines that an error prevented it from completely creating the database
|
2001-01-20 23:09:24 +01:00
|
|
|
system, it removes any files it may have created before discovering
|
|
|
|
that it can't finish the job. This option inhibits tidying-up and is
|
1999-07-06 19:16:42 +02:00
|
|
|
thus useful for debugging.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>--debug</term>
|
|
|
|
<term>-d</term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
1999-12-17 02:05:31 +01:00
|
|
|
Print debugging output from the bootstrap backend and a few other
|
|
|
|
messages of lesser interest for the general public.
|
1999-07-06 19:16:42 +02:00
|
|
|
The bootstrap backend is the program <application>initdb</application>
|
|
|
|
uses to create the catalog tables. This option generates a tremendous
|
2001-01-20 23:09:24 +01:00
|
|
|
amount of extremely boring output.
|
1999-07-06 19:16:42 +02:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
</variablelist>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
</refsect2>
|
2000-11-12 00:01:45 +01:00
|
|
|
</refsect1>
|
1999-07-06 19:16:42 +02:00
|
|
|
|
2000-11-12 00:01:45 +01:00
|
|
|
<refsect1>
|
|
|
|
<title>See also</title>
|
1999-07-06 19:16:42 +02:00
|
|
|
|
2000-11-12 00:01:45 +01:00
|
|
|
<simpara>
|
|
|
|
<citetitle>PostgreSQL Administrator's Guide</citetitle>
|
|
|
|
</simpara>
|
1999-07-06 19:16:42 +02:00
|
|
|
</refsect1>
|
2000-11-12 00:01:45 +01:00
|
|
|
|
1999-07-06 19:16:42 +02:00
|
|
|
</refentry>
|
|
|
|
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
|
|
Local variables:
|
|
|
|
mode: sgml
|
|
|
|
sgml-omittag:nil
|
|
|
|
sgml-shorttag:t
|
|
|
|
sgml-minimize-attributes:nil
|
|
|
|
sgml-always-quote-attributes:t
|
|
|
|
sgml-indent-step:1
|
|
|
|
sgml-indent-data:t
|
|
|
|
sgml-parent-document:nil
|
|
|
|
sgml-default-dtd-file:"../reference.ced"
|
|
|
|
sgml-exposed-tags:nil
|
|
|
|
sgml-local-catalogs:"/usr/lib/sgml/catalog"
|
|
|
|
sgml-local-ecat-files:nil
|
|
|
|
End:
|
|
|
|
-->
|