mirror of
https://github.com/postgres/postgres.git
synced 2025-07-30 11:03:19 +03:00
initlocation is history. (It's still mentioned in manage-ag.sgml,
but I'll leave that file alone so as not to mess up the doc patch I trust Gavin is working on.)
This commit is contained in:
Tom Lane
@ -1,5 +1,5 @@
|
|||||||
<!--
|
<!--
|
||||||
$PostgreSQL: pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.57 2004/06/18 06:13:05 tgl Exp $
|
$PostgreSQL: pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.58 2004/06/18 21:24:01 tgl Exp $
|
||||||
PostgreSQL documentation
|
PostgreSQL documentation
|
||||||
Complete list of usable sgml source files in this directory.
|
Complete list of usable sgml source files in this directory.
|
||||||
-->
|
-->
|
||||||
@ -111,7 +111,6 @@ Complete list of usable sgml source files in this directory.
|
|||||||
<!entity dropuser system "dropuser.sgml">
|
<!entity dropuser system "dropuser.sgml">
|
||||||
<!entity ecpgRef system "ecpg-ref.sgml">
|
<!entity ecpgRef system "ecpg-ref.sgml">
|
||||||
<!entity initdb system "initdb.sgml">
|
<!entity initdb system "initdb.sgml">
|
||||||
<!entity initlocation system "initlocation.sgml">
|
|
||||||
<!entity ipcclean system "ipcclean.sgml">
|
<!entity ipcclean system "ipcclean.sgml">
|
||||||
<!entity pgConfig system "pg_config-ref.sgml">
|
<!entity pgConfig system "pg_config-ref.sgml">
|
||||||
<!entity pgControldata system "pg_controldata.sgml">
|
<!entity pgControldata system "pg_controldata.sgml">
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
<!--
|
<!--
|
||||||
$PostgreSQL: pgsql/doc/src/sgml/ref/createdb.sgml,v 1.38 2004/03/23 02:47:35 neilc Exp $
|
$PostgreSQL: pgsql/doc/src/sgml/ref/createdb.sgml,v 1.39 2004/06/18 21:24:02 tgl Exp $
|
||||||
PostgreSQL documentation
|
PostgreSQL documentation
|
||||||
-->
|
-->
|
||||||
|
|
||||||
@ -90,8 +90,7 @@ PostgreSQL documentation
|
|||||||
<term><option>--location <replaceable class="parameter">location</replaceable></></term>
|
<term><option>--location <replaceable class="parameter">location</replaceable></></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Specifies the alternative location for the database. See also <xref
|
Specifies the alternative location for the database.
|
||||||
linkend="app-initlocation">.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|||||||
@ -1,89 +0,0 @@
|
|||||||
<!--
|
|
||||||
$PostgreSQL: pgsql/doc/src/sgml/ref/initlocation.sgml,v 1.22 2003/11/29 19:51:39 pgsql Exp $
|
|
||||||
PostgreSQL documentation
|
|
||||||
-->
|
|
||||||
|
|
||||||
<refentry id="APP-INITLOCATION">
|
|
||||||
<refmeta>
|
|
||||||
<refentrytitle id="APP-INITLOCATION-TITLE"><application>initlocation</application></refentrytitle>
|
|
||||||
<manvolnum>1</manvolnum>
|
|
||||||
<refmiscinfo>Application</refmiscinfo>
|
|
||||||
</refmeta>
|
|
||||||
|
|
||||||
<refnamediv>
|
|
||||||
<refname>initlocation</refname>
|
|
||||||
<refpurpose>create a secondary <productname>PostgreSQL</productname> database storage area</refpurpose>
|
|
||||||
</refnamediv>
|
|
||||||
|
|
||||||
<indexterm zone="app-initlocation">
|
|
||||||
<primary>initlocation</primary>
|
|
||||||
</indexterm>
|
|
||||||
|
|
||||||
<refsynopsisdiv>
|
|
||||||
<cmdsynopsis>
|
|
||||||
<command>initlocation</command>
|
|
||||||
<arg choice="plain"><replaceable>directory</replaceable></arg>
|
|
||||||
</cmdsynopsis>
|
|
||||||
</refsynopsisdiv>
|
|
||||||
|
|
||||||
<refsect1 id="R1-APP-INITLOCATION-1">
|
|
||||||
<title>Description</title>
|
|
||||||
<para>
|
|
||||||
<application>initlocation</application>
|
|
||||||
creates a new <productname>PostgreSQL</productname> secondary database storage area.
|
|
||||||
See the discussion under <xref linkend="SQL-CREATEDATABASE" endterm="SQL-CREATEDATABASE-title">
|
|
||||||
about how to manage and use secondary storage areas. If the argument does not contain
|
|
||||||
a slash and is not valid as a path, it is assumed to be an environment variable,
|
|
||||||
which is referenced. See the examples at the end.
|
|
||||||
</para>
|
|
||||||
<para>
|
|
||||||
In order to use this command you must be logged in (using <command>su</command>, for example)
|
|
||||||
as the database superuser.
|
|
||||||
</para>
|
|
||||||
</refsect1>
|
|
||||||
|
|
||||||
<refsect1 id="R1-APP-INITLOCATION-2">
|
|
||||||
<title>Examples</title>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
To create a database in an alternate location, using an
|
|
||||||
environment variable:
|
|
||||||
<screen>
|
|
||||||
<prompt>$ </prompt><userinput>export PGDATA2=/opt/postgres/data</userinput>
|
|
||||||
</screen>
|
|
||||||
Stop and start <command>postmaster</> so it sees the <envar>PGDATA2</envar>
|
|
||||||
environment variable. The system must be configured so the
|
|
||||||
<command>postmaster</> sees <envar>PGDATA2</envar> every time it starts. Finally:
|
|
||||||
<screen>
|
|
||||||
<prompt>$</prompt> <userinput>initlocation PGDATA2</userinput>
|
|
||||||
<prompt>$</prompt> <userinput>createdb -D PGDATA2 testdb</userinput>
|
|
||||||
</screen>
|
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
Alternatively, if you allow absolute paths you could write:
|
|
||||||
<screen>
|
|
||||||
<prompt>$</prompt> <userinput>initlocation /opt/postgres/data</userinput>
|
|
||||||
<prompt>$</prompt> <userinput>createdb -D /opt/postgres/data/testdb testdb</userinput>
|
|
||||||
</screen>
|
|
||||||
</para>
|
|
||||||
</refsect1>
|
|
||||||
|
|
||||||
</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:
|
|
||||||
-->
|
|
||||||
@ -1,5 +1,5 @@
|
|||||||
<!-- reference.sgml
|
<!-- reference.sgml
|
||||||
$PostgreSQL: pgsql/doc/src/sgml/reference.sgml,v 1.48 2004/06/18 06:13:02 tgl Exp $
|
$PostgreSQL: pgsql/doc/src/sgml/reference.sgml,v 1.49 2004/06/18 21:24:04 tgl Exp $
|
||||||
|
|
||||||
PostgreSQL Reference Manual
|
PostgreSQL Reference Manual
|
||||||
-->
|
-->
|
||||||
@ -180,7 +180,6 @@ PostgreSQL Reference Manual
|
|||||||
</partintro>
|
</partintro>
|
||||||
|
|
||||||
&initdb;
|
&initdb;
|
||||||
&initlocation;
|
|
||||||
&ipcclean;
|
&ipcclean;
|
||||||
&pgControldata;
|
&pgControldata;
|
||||||
&pgCtl;
|
&pgCtl;
|
||||||
|
|||||||
@ -5,7 +5,7 @@
|
|||||||
# Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
|
# Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
|
||||||
# Portions Copyright (c) 1994, Regents of the University of California
|
# Portions Copyright (c) 1994, Regents of the University of California
|
||||||
#
|
#
|
||||||
# $PostgreSQL: pgsql/src/bin/Makefile,v 1.43 2004/04/20 00:40:06 momjian Exp $
|
# $PostgreSQL: pgsql/src/bin/Makefile,v 1.44 2004/06/18 21:24:05 tgl Exp $
|
||||||
#
|
#
|
||||||
#-------------------------------------------------------------------------
|
#-------------------------------------------------------------------------
|
||||||
|
|
||||||
@ -13,7 +13,7 @@ subdir = src/bin
|
|||||||
top_builddir = ../..
|
top_builddir = ../..
|
||||||
include $(top_builddir)/src/Makefile.global
|
include $(top_builddir)/src/Makefile.global
|
||||||
|
|
||||||
DIRS := initdb initlocation ipcclean pg_ctl pg_dump \
|
DIRS := initdb ipcclean pg_ctl pg_dump \
|
||||||
psql scripts pg_config pg_controldata pg_resetxlog
|
psql scripts pg_config pg_controldata pg_resetxlog
|
||||||
|
|
||||||
all install installdirs uninstall depend distprep:
|
all install installdirs uninstall depend distprep:
|
||||||
|
|||||||
@ -1,32 +0,0 @@
|
|||||||
#-------------------------------------------------------------------------
|
|
||||||
#
|
|
||||||
# Makefile for src/bin/initlocation
|
|
||||||
#
|
|
||||||
# Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
|
|
||||||
# Portions Copyright (c) 1994, Regents of the University of California
|
|
||||||
#
|
|
||||||
# $PostgreSQL: pgsql/src/bin/initlocation/Makefile,v 1.15 2003/11/29 19:52:04 pgsql Exp $
|
|
||||||
#
|
|
||||||
#-------------------------------------------------------------------------
|
|
||||||
|
|
||||||
subdir = src/bin/initlocation
|
|
||||||
top_builddir = ../../..
|
|
||||||
include $(top_builddir)/src/Makefile.global
|
|
||||||
|
|
||||||
all: initlocation
|
|
||||||
|
|
||||||
initlocation: initlocation.sh
|
|
||||||
cp $< $@
|
|
||||||
chmod a+x $@
|
|
||||||
|
|
||||||
install: all installdirs
|
|
||||||
$(INSTALL_SCRIPT) initlocation $(DESTDIR)$(bindir)/initlocation
|
|
||||||
|
|
||||||
installdirs:
|
|
||||||
$(mkinstalldirs) $(DESTDIR)$(bindir)
|
|
||||||
|
|
||||||
uninstall:
|
|
||||||
rm -f $(DESTDIR)$(bindir)/initlocation
|
|
||||||
|
|
||||||
clean distclean maintainer-clean:
|
|
||||||
rm -f initlocation
|
|
||||||
@ -1,171 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
#-------------------------------------------------------------------------
|
|
||||||
#
|
|
||||||
# initlocation.sh--
|
|
||||||
# Create a secondary PostgreSQL database storage area.
|
|
||||||
#
|
|
||||||
# Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
|
|
||||||
# Portions Copyright (c) 1994, Regents of the University of California
|
|
||||||
#
|
|
||||||
#
|
|
||||||
# IDENTIFICATION
|
|
||||||
# $PostgreSQL: pgsql/src/bin/initlocation/initlocation.sh,v 1.17 2003/11/29 19:52:04 pgsql Exp $
|
|
||||||
#
|
|
||||||
#-------------------------------------------------------------------------
|
|
||||||
|
|
||||||
exit_nicely(){
|
|
||||||
echo "$CMDNAME: failed" 1>&2
|
|
||||||
rm -rf "$PGALTDATA"
|
|
||||||
exit 1
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
CMDNAME=`basename $0`
|
|
||||||
EffectiveUser=`id -n -u 2>/dev/null || whoami 2>/dev/null`
|
|
||||||
|
|
||||||
if [ "$USER" = 'root' -o "$LOGNAME" = 'root' ]
|
|
||||||
then
|
|
||||||
echo "$CMDNAME: cannot be run as root" 1>&2
|
|
||||||
echo "Please log in (using, e.g., \"su\") as the (unprivileged) user that will" 1>&2
|
|
||||||
echo "own the server process." 1>&2
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
Location=
|
|
||||||
|
|
||||||
while [ "$#" -gt 0 ]
|
|
||||||
do
|
|
||||||
case "$1" in
|
|
||||||
# These options are not really necessary, but what the heck.
|
|
||||||
--location=*)
|
|
||||||
Location=`echo $1 | sed 's/^--pgdata=//'`
|
|
||||||
;;
|
|
||||||
--location)
|
|
||||||
Location="$2"
|
|
||||||
shift;;
|
|
||||||
-D)
|
|
||||||
Location="$2"
|
|
||||||
shift;;
|
|
||||||
|
|
||||||
--help|-\?)
|
|
||||||
usage=t
|
|
||||||
break;;
|
|
||||||
|
|
||||||
-*)
|
|
||||||
echo "$CMDNAME: invalid option: $1" 1>&2
|
|
||||||
echo "Try \"$CMDNAME --help\" for more information." 1>&2
|
|
||||||
exit 1
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
Location="$1"
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
shift
|
|
||||||
done
|
|
||||||
|
|
||||||
|
|
||||||
if [ "$usage" ]; then
|
|
||||||
echo "$CMDNAME initializes an alternative filesystem location for database"
|
|
||||||
echo "creation."
|
|
||||||
echo ""
|
|
||||||
echo "Usage:"
|
|
||||||
echo " $CMDNAME LOCATION"
|
|
||||||
echo
|
|
||||||
echo "Please read the description of the CREATE DATABASE command for details."
|
|
||||||
echo
|
|
||||||
echo "Report bugs to <pgsql-bugs@postgresql.org>."
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
|
|
||||||
if [ -z "$Location" ]; then
|
|
||||||
echo "$CMDNAME: missing required argument LOCATION" 1>&2
|
|
||||||
echo "Try \"$CMDNAME --help\" for more information." 1>&2
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
|
|
||||||
#
|
|
||||||
# Here's what's going on:
|
|
||||||
#
|
|
||||||
# You can call initlocation ENVAR (no dollar sign), then ENVAR will
|
|
||||||
# (a) be tested whether it is valid as a path, or
|
|
||||||
# (b) be resolved as an environment variable.
|
|
||||||
# The latter has been the traditional behaviour.
|
|
||||||
#
|
|
||||||
# You can call initlocation $ENVAR, which will of course be resolved
|
|
||||||
# by the shell, or initlocation some/path (containing at least one slash).
|
|
||||||
# Then you just take that path.
|
|
||||||
# This should appease users who are confused by the above behavour.
|
|
||||||
#
|
|
||||||
|
|
||||||
echo "$Location" | grep '/' >/dev/null 2>&1
|
|
||||||
|
|
||||||
if [ "$?" -ne 0 -a ! -d "$Location" ]; then
|
|
||||||
PGALTDATA=`printenv $Location 2> /dev/null`
|
|
||||||
if [ -z "$PGALTDATA" ]; then
|
|
||||||
echo "$CMDNAME: environment variable $Location not set" 1>&2
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
haveenv=t
|
|
||||||
else
|
|
||||||
PGALTDATA="$Location"
|
|
||||||
haveenv=f
|
|
||||||
fi
|
|
||||||
|
|
||||||
echo "The files belonging to this location will be owned by user \"$EffectiveUser\"."
|
|
||||||
echo "This user must also own the server process."
|
|
||||||
echo
|
|
||||||
|
|
||||||
# -----------------------------------------------------------------------
|
|
||||||
# Create the data directory if necessary
|
|
||||||
# -----------------------------------------------------------------------
|
|
||||||
|
|
||||||
# don't want to leave anything lying around
|
|
||||||
trap 'echo "Caught signal." ; exit_nicely' 1 2 3 15
|
|
||||||
|
|
||||||
# umask must disallow access to group, other for files and dirs
|
|
||||||
umask 077
|
|
||||||
|
|
||||||
if [ ! -d "$PGALTDATA" ]; then
|
|
||||||
echo "creating directory $PGALTDATA"
|
|
||||||
mkdir "$PGALTDATA"
|
|
||||||
if [ "$?" -ne 0 ]; then
|
|
||||||
echo "$CMDNAME: could not create directory \"$PGALTDATA\"" 1>&2
|
|
||||||
echo "Make sure \"$PGALTDATA\" is a valid path and that you have permission to access it." 1>&2
|
|
||||||
exit_nicely
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
echo "fixing permissions on pre-existing directory $PGALTDATA"
|
|
||||||
chmod go-rwx "$PGALTDATA" || exit_nicely
|
|
||||||
fi
|
|
||||||
|
|
||||||
|
|
||||||
if [ ! -d "$PGALTDATA"/base ]; then
|
|
||||||
echo "creating directory $PGALTDATA/base"
|
|
||||||
mkdir "$PGALTDATA/base"
|
|
||||||
if [ "$?" -ne 0 ]; then
|
|
||||||
echo "$CMDNAME: could not create $PGALTDATA/base" 1>&2
|
|
||||||
echo "Make sure \"$PGALTDATA/base\" is a valid path and that you have permission to access it." 1>&2
|
|
||||||
exit_nicely
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
echo "fixing permissions on pre-existing directory $PGALTDATA/base"
|
|
||||||
chmod go-rwx "$PGALTDATA/base" || exit_nicely
|
|
||||||
fi
|
|
||||||
|
|
||||||
echo
|
|
||||||
echo "$CMDNAME is complete."
|
|
||||||
# We can only suggest them these commands if they used the environment
|
|
||||||
# variable notation. Otherwise they would be induced to use an absolute
|
|
||||||
# path, which the backend won't allow by default.
|
|
||||||
if [ "$haveenv" = "t" ]; then
|
|
||||||
echo "You can now create a database using"
|
|
||||||
echo " CREATE DATABASE <name> WITH LOCATION = '$Location'"
|
|
||||||
echo "in SQL, or"
|
|
||||||
echo " createdb -D '$Location' <name>"
|
|
||||||
echo "from the shell."
|
|
||||||
fi
|
|
||||||
echo
|
|
||||||
|
|
||||||
exit 0
|
|
||||||
Reference in New Issue
Block a user