home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / postgres / postgre2.z / postgre2 / ref / unix / postmaster < prev    next >
Encoding:
Text File  |  1992-08-27  |  4.0 KB  |  107 lines
  1. .\" XXX standard disclaimer belongs here....
  2. .\" $Header: /private/postgres/ref/unix/RCS/postmaster,v 1.12 1992/08/18 18:14:12 mao Exp $
  3. .SP POSTMASTER UNIX 6/14/90
  4. .XA 1 "The \*(PP Postmaster"
  5. .uh "NAME"
  6. .lp
  7. postmaster \*- run the \*(PP postmaster
  8. .uh "SYNOPSIS"
  9. .lp
  10. .(l
  11. \fBpostmaster\fR [ -p port ] [ -b backend_pathname ] [ -d debug_level ] [ -s ] [ -n ] &
  12. .)l
  13. .uh "DESCRIPTION"
  14. .lp
  15. The postmaster manages the communication between frontends and backends,
  16. as well as allocating the shared buffer pool and semaphores (on machines
  17. without TAS).  The postmaster
  18. does not itself interact with the user so it should be started as a background
  19. process.  \fBOnly one postmaster should be run on a machine!\fR
  20. .sp
  21. .uh "COMMAND OPTIONS"
  22. .lp
  23. \fIport\fR is the well known TCP/IP port used for network 
  24. communication between a libpq application and the backend.  If you specify
  25. a port other than the default port then you must specify the same port when 
  26. starting any libpq application including the terminal monitor.  Alternatively
  27. you may set the environment variable PGPORT to the specified port and all
  28. libpq applications will use it instead of the default.
  29. .lp
  30. \fIbackend_pathname\fR is the full pathname of the \*(PP backend you
  31. wish to use.
  32. .lp
  33. \fIdeug_level\fR determines the amount of debugging output the backend will
  34. produce.  Specifying any level will cause the postmaster to print out
  35. a few terse debugging output messages to the tty on which it was started.
  36. .lp
  37. The
  38. \fI\-s\fP and \fI\-n\fP options control the behavior of the postmaster
  39. when a backend dies abnormally.
  40. The ordinary strategy for this situation is to notify all other backends
  41. that they must terminate,
  42. and to reinitialize shared memory and semaphores.
  43. This is because an errant backend,
  44. before dumping core,
  45. could have contaminated some shared state.
  46. .lp
  47. If the \fI\-s\fP option is supplied, then the postmaster will stop all
  48. other backends,
  49. but will not cause them to terminate.
  50. This permits system programmers to collect core dumps from all concurrent
  51. backends by hand.
  52. .lp
  53. If the \fI\-n\fP command-line option is supplied,
  54. then the postmaster does not reinitialize shared data structures.
  55. A knowledgable system programmer can use the
  56. .i shmemdoc
  57. program to examine shared memory and semaphore state,
  58. in order to debug the problem.
  59. .lp
  60. Neither \fI\-s\fP nor \fI\-n\fP is intended for use in ordinary operation.
  61. .sp
  62. .uh "EXAMPLES"
  63. .lp
  64. .ft C
  65. postmaster &
  66. .ft
  67. .lp
  68. This command will start up a postmaster on the default port (4321) and 
  69. will expect to use the default path to the 
  70. \*(PP backend ($POSTGRESHOME/bin/postgres) or /usr/postgres/bin/postgres.
  71. This is the simplest and most common way to start the postmaster.
  72. .sp
  73. .lp
  74. .ft C
  75. postmaster -p 1234 -b /a/postgres/bin/postgres &
  76. .ft
  77. .lp
  78. This command will start up a postmaster communicating through the port
  79. 1234, and will expect to use the backend located at
  80. /a/postgres/bin/postgres.  Note: to connect to this postmaster using
  81. the terminal monitor, you would need to specify \fB-p 1234\fR on
  82. the command line invoking the terminal monitor.
  83. .sp
  84. .uh "DIAGNOSTICS"
  85. .lp
  86. \fBsemget: No space left on device\fR
  87. .lp
  88. If you see this message, you should run the \fIipcclean\fR command.
  89. After doing this, try starting the postmaster again.  If this still doesn't
  90. work, you will need to configure your kernel for shared memory and
  91. semaphores as described in the installation notes.
  92. .lp
  93. \fBStreamServerPort: cannot bind to port\fR
  94. .lp
  95. If you see this message, you should be certain that there is no other 
  96. postmaster program already running.  The easiest way to determine this is
  97. by the command "ps -ax | grep postmaster".  If you are sure there is no
  98. other postmaster running and you still get this error try specifying a
  99. different port using the -p option.  You may also get this error if you
  100. terminate the postmaster and immediately restart it using the same port;
  101. in this case, you should simply wait until the operating system closes
  102. the port.
  103. .lp
  104. .uh "SEE ALSO"
  105. .lp
  106. postgres(unix), monitor(unix), ipcclean(unix), shmemdoc(unix).
  107.