← Back to branch summary

~ubuntu-branches/ubuntu/karmic/postgresql-8.4/karmic-security

« back to all changes in this revision

Viewing changes to doc/src/sgml/start.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2009-05-05 00:58:06 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20090505005806-c19tt7oyqb7kuw49
Tags: 8.4~beta1+cvs20090503-1
New upstream snapshot.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/start.sgml
74
74
      <para>
75
75
       A server process, which manages the database files, accepts
76
76
       connections to the database from client applications, and
77
 
       performs actions on the database on behalf of the clients.  The
 
77
       performs database actions on the behalf of the clients.  The
78
78
       database server program is called
79
79
       <filename>postgres</filename>.
80
80
       <indexterm><primary>postgres</primary></indexterm>
108
108
 
109
109
   <para>
110
110
    The <productname>PostgreSQL</productname> server can handle
111
 
    multiple concurrent connections from clients.  For that purpose it
 
111
    multiple concurrent connections from clients.  To achieve this it
112
112
    starts (<quote>forks</quote>) a new process for each connection.
113
113
    From that point on, the client and the new server process
114
114
    communicate without intervention by the original
159
159
   </para>
160
160
 
161
161
   <para>
162
 
    If you see a message similar to
 
162
    If you see a message similar to:
163
163
<screen>
164
164
createdb: command not found
165
165
</screen>
166
166
    then <productname>PostgreSQL</> was not installed properly.  Either it was not
167
 
    installed at all or the search path was not set correctly.  Try
 
167
    installed at all or your shell's search path was not set correctly.  Try
168
168
    calling the command with an absolute path instead:
169
169
<screen>
170
170
<prompt>$</prompt> <userinput>/usr/local/pgsql/bin/createdb mydb</userinput>
171
171
</screen>
172
172
    The path at your site might be different.  Contact your site
173
 
    administrator or check back in the installation instructions to
 
173
    administrator or check the installation instructions to
174
174
    correct the situation.
175
175
   </para>
176
176
 
177
177
   <para>
178
178
    Another response could be this:
179
179
<screen>
180
 
createdb: could not connect to database postgres: could not connect to server: No such file or directory
 
180
createdb: could not connect to database postgres: could not connect
 
181
to server: No such file or directory
181
182
        Is the server running locally and accepting
182
183
        connections on Unix domain socket "/tmp/.s.PGSQL.5432"?
183
184
</screen>
246
247
    length.  A convenient choice is to create a database with the same
247
248
    name as your current user name.  Many tools assume that database
248
249
    name as the default, so it can save you some typing.  To create
249
 
    that database, simply type
 
250
    that database, simply type:
250
251
<screen>
251
252
<prompt>$</prompt> <userinput>createdb</userinput>
252
253
</screen>
299
300
      <para>
300
301
       Using an existing graphical frontend tool like
301
302
       <application>pgAdmin</application> or an office suite with
302
 
       <acronym>ODBC</acronym> support to create and manipulate a
 
303
       <acronym>ODBC</> or <acronym>JDBC</> support to create and manipulate a
303
304
       database.  These possibilities are not covered in this
304
305
       tutorial.
305
306
      </para>
314
315
     </listitem>
315
316
    </itemizedlist>
316
317
 
317
 
    You probably want to start up <command>psql</command>, to try out
 
318
    You probably want to start up <command>psql</command> to try
318
319
    the examples in this tutorial.  It can be activated for the
319
320
    <literal>mydb</literal> database by typing the command:
320
321
<screen>
321
322
<prompt>$</prompt> <userinput>psql mydb</userinput>
322
323
</screen>
323
 
    If you leave off the database name then it will default to your
 
324
    If you do not supply the database name then it will default to your
324
325
    user account name.  You already discovered this scheme in the
325
 
    previous section.
 
326
    previous section using <command>createdb</command>.
326
327
   </para>
327
328
 
328
329
   <para>
335
336
mydb=&gt;
336
337
</screen>
337
338
    <indexterm><primary>superuser</primary></indexterm>
338
 
    The last line could also be
 
339
    The last line could also be:
339
340
<screen>
340
341
mydb=#
341
342
</screen>
342
343
    That would mean you are a database superuser, which is most likely
343
344
    the case if you installed <productname>PostgreSQL</productname>
344
345
    yourself.  Being a superuser means that you are not subject to
345
 
    access controls.  For the purposes of this tutorial that is not of
346
 
    importance.
 
346
    access controls.  For the purposes of this tutorial that is not
 
347
    important.
347
348
   </para>
348
349
 
349
350
   <para>
395
396
   </para>
396
397
 
397
398
   <para>
398
 
    To get out of <command>psql</command>, type
 
399
    To get out of <command>psql</command>, type:
399
400
<screen>
400
401
<prompt>mydb=&gt;</prompt> <userinput>\q</userinput>
401
402
</screen>
407
408
    installed correctly you can also type <literal>man psql</literal>
408
409
    at the operating system shell prompt to see the documentation.  In
409
410
    this tutorial we will not use these features explicitly, but you
410
 
    can use them yourself when you see fit.
 
411
    can use them yourself when it is helpful.
411
412
   </para>
412
413
 
413
414
  </sect1>