Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
installer(8)		  Archiveopteryx Documentation		    installer(8)

NAME
     installer - Archiveopteryx installer.

SYNOPSIS
     /usr/local/libexec/aox/installer [ -n ] [ -q ] [ -v ] ...

DESCRIPTION
     This program does the following:

     1. Creates a Unix group named aox.

     2. Creates a Unix user named aox.

     3. Creates a Postgres user named aox.

     4. Creates a Postgres user named aoxsuper.

     5. Creates a Postgres database named archiveopteryx owned by aoxsuper.

     6. Loads the database schema and grants limited privileges to user aox.

     7. Generates an initial configuration file.

     8. Adjusts ownership and permissions if necessary.

     installer should be run after jam install when installing from source.

     By  default,  the address of the PostgreSQL server is derived from the com-
     pile-time DBADDRESS setting in the Jamsettings file (which is 127.0.0.1  by
     default).	If  the  db-address variable is set in an existing configuration
     file, that value takes precedence. If the -a  command-line  flag  is  used,
     then the address specified has precedence over either of the former values.

     If  the  server  address  (as determined above) is 127.0.0.1, the installer
     will try to use a Unix domain socket to connect to the server. The location
     of this socket is determined by the -s socket command-line argument. If  no
     socket    is    specified,    the	 default   named   socket   location   (
     /tmp/.s.PGSQL.5432) is used instead.  For any other server address, the in-
     staller will try to use a Unix domain socket  only  if  one  is  explicitly
     specified	with  -s.  In any case, if password authentication is to be used
     when talking to the server, the -P  option  will  cause  the  installer  to
     prompt for the password.

OPTIONS
     -q     Suppresses all normal output.

     -v     Makes the output more verbose (may be repeated).

     -n     Causes  the  program to report what it would do, but not actually do
	    anything.

     -g group
	    Allows you to specify a Unix group other than the default of aox.

     -u userAllows you to specify a Unix username other than the default of aox.

     -p postgres
	    Allows you to specify the name of the PostgreSQL superuser. The  de-
	    fault is to try $PGUSER (if set), postgres and pgsql in turn.

     -P     Instructs  the installer to prompt for and read the PostgreSQL supe-
	    ruser's password, and be prepared to use that for authentication (if
	    necessary).

     -a address
	    Allows you to specify a different address for the  Postgres  server.
	    The default is 127.0.0.1.

     -s /path/to/socket
	    Allows  you  to specify a location for the PostgreSQL server's Unix-
	    domain listening socket. The specified value is  used  as  described
	    above.

     -t portAllows  you to specify a different port for the Postgres server. The
	    default is 5432. (This value is used only if the server address does
	    not refer to a Unix socket.)

     -d dbname
	    Allows  you  to  specify  a  database  to  use.   The   default   is
	    archiveopteryx.

     -S schema
	    Allows you to specify a schema where the Archiveopteryx database ob-
	    jects  will  be installed. If this is not specified, objects are in-
	    stalled into the public schema.

	    Please do not use -S unless you are sure you understand all its  im-
	    plications. It is safe to ignore it entirely if you don't.

     The defaults come from Jamsettings.

DIAGNOSTICS
     The return code is zero if all goes well, and a non-zero in case of errors.
     Disasters are logged via stderr.

AUTHOR
     The Archiveopteryx Developers, info@aox.org.

VERSION
     This  man	page  covers  Archiveopteryx version 3.2.0, released 2014-03-10,
     http://archiveopteryx.org/3.2.0

SEE ALSO
     archiveopteryx(8), 	    archiveopteryx.conf(5),		logd(8),
     http://archiveopteryx.org

aox.org 			   2014-03-10			    installer(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=installer&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help