myproxy-server(8)                   MyProxy                  myproxy-server(8)

NAME

       myproxy-server - store credentials in an online repository

SYNOPSIS

       myproxy-server [ options ]

DESCRIPTION

       The  myproxy-server is a server that runs on a trusted, secure host and
       manages a database of security credentials for use from  remote  sites.
       The myproxy-init(1) program stores credentials with associated policies
       that specify credential lifetimes and who  is  authorized  to  retrieve
       credentials.   The myproxy-server.config(5) file sets server-wide poli-
       cies that are used in conjunction with the  policies  set  by  myproxy-
       init(1) to control who is authorized to store and retrieve credentials.

OPTIONS

       -h, --help
              Displays command usage text and exits.

       -u, --usage
              Displays command usage text and exits.

       -v, --verbose
              Enables verbose debugging output to the terminal.

       -V, --version
              Displays version information and exits.

       -d, --debug
              Run the server in debug mode.  In this mode, the server will run
              in the foreground, will accept one connection,  write  log  mes-
              sages to the terminal while processing the incoming request, and
              exit after completing one request.

       -l hostname/ipaddr, --listen hostname/ipaddr
              Specifies the hostname or IP  address  that  the  myproxy-server
              should  listen (bind) to.  Default: all interfaces on the local-
              host

       -p port, --port port
              Specifies the TCP port number  that  the  myproxy-server  should
              listen on.  Default: 7512

       -c file, --config file
              Specifies the location of the myproxy-server configuration file.
              Default:     /etc/myproxy-server.config     or     $GLOBUS_LOCA-
              TION/etc/myproxy-server.config

       -s dir, --storage dir
              Specifies the location of the credential storage directory.  The
              directory must be  accessible  only  by  the  user  running  the
              myproxy-server   process   for   security   reasons.    Default:
              /var/myproxy or $GLOBUS_LOCATION/var/myproxy

FILES

       /etc/myproxy-server.config
              Default location of the server configuration file (see  myproxy-
              server.config(5)).   If not found, $GLOBUS_LOCATION/etc/myproxy-
              server.config will be used.  An alternate location can be speci-
              fied by using the -c option.

       /var/myproxy
              Default  location  of  the credential storage directory.  If not
              found, $GLOBUS_LOCATION/var/myproxy will be  used.   If  neither
              exist,   the   myproxy-server   will  first  attempt  to  create
              /var/myproxy  and  if  that  fails  will   attempt   to   create
              $GLOBUS_LOCATION/var/myproxy  and  use that.  The directory must
              be accessible  only  by  the  user  running  the  myproxy-server
              process  for  security  reasons.   An  alternate location can be
              specified by using the -s option.

ENVIRONMENT

       GLOBUS_LOCATION
              Specifies the root of the MyProxy installation, used to find the
              default  location of the myproxy-server.config file and the cre-
              dential storage directory.

       LD_LIBRARY_PATH
              The MyProxy server is typically linked dynamically  with  Globus
              security  libraries,  which  must  be  present  in  the  dynamic
              linker's search path.   This  typically  requires  $GLOBUS_LOCA-
              TION/lib to be included in the list in the LD_LIBRARY_PATH envi-
              ronment  variable,   which   is   set   by   the   $GLOBUS_LOCA-
              TION/libexec/globus-script-initializer  script,  which should be
              called from any myproxy-server startup  script.   Alternatively,
              to set LD_LIBRARY_PATH appropriately for the Globus libraries in
              an interactive shell,  source  $GLOBUS_LOCATION/etc/globus-user-
              env.sh   (for   sh   shells)   or   $GLOBUS_LOCATION/etc/globus-
              user.env.csh (for csh shells).

       MYPROXY_SERVER_PORT
              Specifies the port where the myproxy-server(8) is running.  This
              environment variable can be used in place of the -p option.

       X509_USER_CERT
              Specifies  an alternative location for the server's certificate.
              By default, the server uses /etc/grid-security/hostcert.pem when
              running  as  root or ~/.globus/usercert.pem when running as non-
              root.

       X509_USER_KEY
              Specifies an alternative location for the server's private  key.
              By  default, the server uses /etc/grid-security/hostkey.pem when
              running as root or ~/.globus/userkey.pem when  running  as  non-
              root.

       X509_USER_PROXY
              Specifies  an  alternative location for the server's certificate
              and private key (in the same file).  Use when running the server
              with  a  proxy  credential.  Note that the proxy will need to be
              periodically renewed before expiration  to  allow  the  myproxy-
              server to keep functioning.  When the myproxy-server runs with a
              non-host credential, clients  must  have  the  MYPROXY_SERVER_DN
              environment  variable  set to the distinguished name of the cer-
              tificate being used by the server.

       X509_CERT_DIR
              Specifies a non-standard location for the CA certificates direc-
              tory.

AUTHORS

       Bill  Baker,  Jim  Basney,  Shiva  Shankar  Chetan, Patrick Duda, Terry
       Fleury, Jarek Gawor, Monte Goode,  Daniel  Kouril,  Zhenmin  Li,  Neill
       Miller, Jason Novotny, Miroslav Ruda, Benjamin Temko, and Von Welch

SEE ALSO

       myproxy-change-pass-phrase(1),  myproxy-destroy(1),  myproxy-get-trust-
       roots(1), myproxy-info(1), myproxy-init(1), myproxy-logon(1),  myproxy-
       retrieve(1), myproxy-store(1), myproxy-server.config(5), myproxy-admin-
       adduser(8),  myproxy-admin-change-pass(8),   myproxy-admin-load-creden-
       tial(8), myproxy-admin-query(8)



Globus                            2008-12-12                 myproxy-server(8)