1myproxy-server(8)                   MyProxy                  myproxy-server(8)
2
3
4

NAME

6       myproxy-server - store credentials in an online repository
7

SYNOPSIS

9       myproxy-server [ options ]
10

DESCRIPTION

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

OPTIONS

21       -h, --help
22              Displays command usage text and exits.
23
24       -u, --usage
25              Displays command usage text and exits.
26
27       -v, --verbose
28              Enables verbose debugging output to the terminal.
29
30       -V, --version
31              Displays version information and exits.
32
33       -d, --debug
34              Run the server in debug mode.  In this mode, the server will run
35              in the foreground, will accept one connection,  write  log  mes‐
36              sages to the terminal while processing the incoming request, and
37              exit after completing one request.
38
39       -l hostname/ipaddr, --listen hostname/ipaddr
40              Specifies the hostname or IP  address  that  the  myproxy-server
41              should  listen (bind) to.  Default: all interfaces on the local‐
42              host
43
44       -p port, --port port
45              Specifies the TCP port number  that  the  myproxy-server  should
46              listen on.  Default: 7512
47
48       -c file, --config file
49              Specifies the location of the myproxy-server configuration file.
50              Default:     /etc/myproxy-server.config     or     $GLOBUS_LOCA‐
51              TION/etc/myproxy-server.config
52
53       -s dir, --storage dir
54              Specifies the location of the credential storage directory.  The
55              directory must be  accessible  only  by  the  user  running  the
56              myproxy-server   process   for   security   reasons.    Default:
57              /var/lib/myproxy or /var/myproxy or $GLOBUS_LOCATION/var/myproxy
58

FILES

60       /etc/myproxy-server.config
61              Default location of the server configuration file (see  myproxy-
62              server.config(5)).   If not found, $GLOBUS_LOCATION/etc/myproxy-
63              server.config will be used.  An alternate location can be speci‐
64              fied by using the -c option.
65
66       /var/lib/myproxy
67              Default  location  of  the credential storage directory.  If not
68              found,  /var/myproxy  or  $GLOBUS_LOCATION/var/myproxy  will  be
69              used.   If  none  of these directories exist, the myproxy-server
70              will first attempt to create /var/lib/myproxy and if that  fails
71              will  attempt  to  create  $GLOBUS_LOCATION/var/myproxy  and use
72              that.  The directory must be accessible only by the user running
73              the  myproxy-server  process for security reasons.  An alternate
74              location can be specified by using the -s option.
75

ENVIRONMENT

77       GLOBUS_LOCATION
78              Specifies the root of the MyProxy installation, used to find the
79              default  location of the myproxy-server.config file and the cre‐
80              dential storage directory.
81
82       LD_LIBRARY_PATH
83              The MyProxy server is typically linked dynamically  with  Globus
84              security  libraries,  which  must  be  present  in  the  dynamic
85              linker's search path.   This  typically  requires  $GLOBUS_LOCA‐
86              TION/lib to be included in the list in the LD_LIBRARY_PATH envi‐
87              ronment  variable,   which   is   set   by   the   $GLOBUS_LOCA‐
88              TION/libexec/globus-script-initializer  script,  which should be
89              called from any myproxy-server startup  script.   Alternatively,
90              to set LD_LIBRARY_PATH appropriately for the Globus libraries in
91              an interactive shell,  source  $GLOBUS_LOCATION/etc/globus-user-
92              env.sh   (for   sh   shells)   or   $GLOBUS_LOCATION/etc/globus-
93              user.env.csh (for csh shells).
94
95       MYPROXY_SERVER_PORT
96              Specifies the port where the myproxy-server(8) is running.  This
97              environment variable can be used in place of the -p option.
98
99       X509_USER_CERT
100              Specifies  an alternative location for the server's certificate.
101              By default, the server uses /etc/grid-security/hostcert.pem when
102              running  as  root or ~/.globus/usercert.pem when running as non-
103              root.
104
105       X509_USER_KEY
106              Specifies an alternative location for the server's private  key.
107              By  default, the server uses /etc/grid-security/hostkey.pem when
108              running as root or ~/.globus/userkey.pem when  running  as  non-
109              root.
110
111       X509_USER_PROXY
112              Specifies  an  alternative location for the server's certificate
113              and private key (in the same file).  Use when running the server
114              with  a  proxy  credential.  Note that the proxy will need to be
115              periodically renewed before expiration  to  allow  the  myproxy-
116              server to keep functioning.  When the myproxy-server runs with a
117              non-host credential, clients  must  have  the  MYPROXY_SERVER_DN
118              environment  variable  set to the distinguished name of the cer‐
119              tificate being used by the server.
120
121       X509_CERT_DIR
122              Specifies a non-standard location for the CA certificates direc‐
123              tory.
124
125       MYPROXY_KEYBITS
126              Specifies  the  size  for  RSA  keys  generated  by MyProxy.  By
127              default, MyProxy generates 2048 bit RSA keys.  Set this environ‐
128              ment variable to "1024" for 1024 bit RSA keys.
129

AUTHORS

131       See http://grid.ncsa.illinois.edu/myproxy/about for the list of MyProxy
132       authors.
133

SEE ALSO

135       myproxy-change-pass-phrase(1),  myproxy-destroy(1),  myproxy-get-trust‐
136       roots(1),  myproxy-info(1), myproxy-init(1), myproxy-logon(1), myproxy-
137       retrieve(1), myproxy-store(1), myproxy-server.config(5), myproxy-admin-
138       adduser(8),   myproxy-admin-change-pass(8),  myproxy-admin-load-creden‐
139       tial(8), myproxy-admin-query(8)
140
141
142
143MyProxy                           2014-07-12                 myproxy-server(8)
Impressum