environ.sgml
上传用户:blenddy
上传日期:2007-01-07
资源大小:6495k
文件大小:3k
源码类别:

数据库系统

开发平台:

Unix_Linux

  1. <Chapter Id="environ">
  2. <Title>Setting Up Your Environment</Title>
  3. <Para>
  4.      This section discusses how to set up
  5.      your own environment  so  that  you  can  use  frontend
  6.      applications.  We assume <ProductName>Postgres</ProductName> has already been 
  7.      successfully installed and started; refer to the Administrator's Guide
  8. and the installation  notes
  9.      for how to install Postgres.
  10. </Para>
  11. <Para>
  12. <ProductName>Postgres</ProductName> is a client/server application. As a user,
  13. you only need access to the client portions of the installation (an example
  14. of a client application is the interactive monitor <Application>psql</Application>).
  15.      For simplicity,
  16.      we will assume that <ProductName>Postgres</ProductName> has been installed in  the
  17.      directory  <FileName>/usr/local/pgsql</FileName>.   Therefore, wherever
  18.      you see the directory <FileName>/usr/local/pgsql</FileName> you  should
  19.      substitute  the name of the directory where <ProductName>Postgres</ProductName> is
  20.      actually installed.
  21.      All <ProductName>Postgres</ProductName> commands are installed  in  the  directory
  22.      <FileName>/usr/local/pgsql/bin</FileName>.   Therefore,  you should add
  23.      this directory to your shell command path.  If you  use
  24.      a variant of the Berkeley C shell, such as <Application>csh</Application> or <Application>tcsh</Application>,
  25.      you would add
  26. <ProgramListing>
  27. set path = ( /usr/local/pgsql/bin path )
  28. </ProgramListing>
  29.      in the <FileName>.login</FileName> file in your home directory.  If you  use
  30.      a  variant  of  the  Bourne  shell, such as <Application>sh</Application>, <Application>ksh</Application>, or
  31.      <Application>bash</Application>, then you would add
  32. <ProgramListing>
  33. $ PATH=/usr/local/pgsql/bin:$PATH
  34. $ export PATH
  35. </ProgramListing>
  36.      to the <FileName>.profile</FileName> file in your home directory.
  37.      From now on, we will assume that  you  have  added  the
  38.      <ProductName>Postgres</ProductName>  bin  directory to your path.  In addition, we
  39.      will make frequent reference to <Quote>setting a shell  
  40.      variable</Quote>  or  <Quote>setting an environment variable</Quote> throughout
  41.      this document.  If you did  not  fully  understand  the
  42.      last  paragraph  on  modifying  your  search  path, you
  43.      should consult the UNIX manual pages that describe your
  44.      shell before going any further.
  45. </Para>
  46. <Para>
  47. If your site administrator has not set things up in the
  48. default  way,  you may have some more work to do.  For example, if the database
  49.  server machine is a remote machine, you
  50. will need to set the <Acronym>PGHOST</Acronym> environment variable to the name
  51. of the database server machine.   The  environment  variable
  52. <Acronym>PGPORT</Acronym> may also have to be set.  The bottom line is this: if
  53. you try to start an application  program  and  it  complains
  54. that it cannot connect to the <Application>postmaster</Application>,
  55.  you should immediately consult your site administrator to make sure that your
  56. environment is properly set up.
  57. </Para>
  58. </Chapter>