mirror of https://github.com/postgres/postgres
but I'll leave that file alone so as not to mess up the doc patch I trust Gavin is working on.)REL8_0_STABLE
Tom Lane
22 years ago
parent
b33c7231e5
commit
984c8a48f4
@ -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,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 |
||||
Loading…
Reference in new issue