Provided by: pki-server_10.2.6+git20160317-1_amd64 bug

NAME

       pkidaemon - provides status management of PKI instances

SYNOPSIS

       pkidaemon {start|status} instance-type [instance-name]

       Note:  Although  this  tool  currently resides in the /usr/bin directory, proper use of it
       requires it to be run with super user privileges.

DESCRIPTION

       The pkidaemon command with the 'status' argument provides a way to display the  status  of
       all  existing  PKI  instances on a machine.  Optionally, an individual PKI instance may be
       specified by using an optional [instance-name].

       The pkidaemon 'start' argument is currently only used internally by the systemctl scripts.

       Currently, although the pkidaemon 'instance-type' argument states that it  can  be  either
       apache or tomcat, only the tomcat argument will yield useful details.

OPTIONS

       As  stated  above, the only optional argument to pkidaemon is [instance-name].  If a valid
       instance name is specified, only the status of that instance will be displayed.

EXAMPLES

       For the following examples, two instances were installed.  The first contained a CA,  KRA,
       OCSP,  TKS  and  TPS  in a shared PKI instance named 'pki-tomcat', while the second simply
       contained a CA running on different ports and named 'pki-tomcat-2'.

       For the OCSP 'Unsecure URL' and the OCSP 'Secure EE  URL'  which  both  specify  a  static
       string  of  '<ocsp  request  blob>',  the intention is for the user to replace this static
       string with an actual OCSP request blob relevant to their particular deployment.

   Listing the status of all local PKI instances on this machine:

       # pkidaemon status tomcat

       REPORT STATUS OF 'tomcat' INSTANCE(S):

       Status for pki-tomcat: pki-tomcat is running ..

           [CA Status Definitions]
           Unsecure URL        = http://pki.example.com:8080/ca/ee/ca
           Secure Agent URL    = https://pki.example.com:8443/ca/agent/ca
           Secure EE URL       = https://pki.example.com:8443/ca/ee/ca
           Secure Admin URL    = https://pki.example.com:8443/ca/services
           PKI Console Command = pkiconsole https://pki.example.com:8443/ca
           Tomcat Port         = 8005 (for shutdown)

           [DRM Status Definitions]
           Secure Agent URL    = https://pki.example.com:8443/kra/agent/kra
           Secure Admin URL    = https://pki.example.com:8443/kra/services
           PKI Console Command = pkiconsole https://pki.example.com:8443/kra
           Tomcat Port         = 8005 (for shutdown)

           [OCSP Status Definitions]
           Unsecure URL        = http://pki.example.com:8080/ocsp/ee/ocsp/<ocsp request blob>
           Secure Agent URL    = https://pki.example.com:8443/ocsp/agent/ocsp
           Secure EE URL       = https://pki.example.com:8443/ocsp/ee/ocsp/<ocsp request blob>
           Secure Admin URL    = https://pki.example.com:8443/ocsp/services
           PKI Console Command = pkiconsole https://pki.example.com:8443/ocsp
           Tomcat Port         = 8005 (for shutdown)

           [TKS Status Definitions]
           Secure Agent URL    = https://pki.example.com:8443/tks/agent/tks
           Secure Admin URL    = https://pki.example.com:8443/tks/services
           PKI Console Command = pkiconsole https://pki.example.com:8443/tks
           Tomcat Port         = 8005 (for shutdown)

           [TPS Status Definitions]
           Unsecure URL        = http://pki.example.com:8080/tps
           Secure URL          = https://pki.example.com:8443/tps
           Tomcat Port         = 8005 (for shutdown)
           Unsecure PHONE HOME = http://pki.example.com:8080/tps/phoneHome
           Secure PHONE HOME   = https://pki.example.com:8443/tps/phoneHome

           [CA Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  Root CA (Security Domain)

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

           [DRM Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  DRM

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

           [OCSP Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  OCSP

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

           [TKS Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  TKS

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

           [TPS Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  TPS

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

       Status for pki-tomcat-2: pki-tomcat-2 is running ..

           [CA Status Definitions]
           Unsecure URL        = http://pki.example.com:18080/ca/ee/ca
           Secure Agent URL    = https://pki.example.com:18443/ca/agent/ca
           Secure EE URL       = https://pki.example.com:18443/ca/ee/ca
           Secure Admin URL    = https://pki.example.com:18443/ca/services
           PKI Console Command = pkiconsole https://pki.example.com:18443/ca
           Tomcat Port         = 18005 (for shutdown)

           [CA Configuration Definitions]
           PKI Instance Name:   pki-tomcat-2

           PKI Subsystem Type:  Root CA (Security Domain)

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:18443
           ====================================================================

       FINISHED REPORTING STATUS OF 'tomcat' INSTANCE(S).

   Listing the status of the PKI instance named 'pki-tomcat':

       # pkidaemon status tomcat pki-tomcat

       Status for pki-tomcat: pki-tomcat is running ..

           [CA Status Definitions]
           Unsecure URL        = http://pki.example.com:8080/ca/ee/ca
           Secure Agent URL    = https://pki.example.com:8443/ca/agent/ca
           Secure EE URL       = https://pki.example.com:8443/ca/ee/ca
           Secure Admin URL    = https://pki.example.com:8443/ca/services
           PKI Console Command = pkiconsole https://pki.example.com:8443/ca
           Tomcat Port         = 8005 (for shutdown)

           [DRM Status Definitions]
           Secure Agent URL    = https://pki.example.com:8443/kra/agent/kra
           Secure Admin URL    = https://pki.example.com:8443/kra/services
           PKI Console Command = pkiconsole https://pki.example.com:8443/kra
           Tomcat Port         = 8005 (for shutdown)

           [OCSP Status Definitions]
           Unsecure URL        = http://pki.example.com:8080/ocsp/ee/ocsp/<ocsp request blob>
           Secure Agent URL    = https://pki.example.com:8443/ocsp/agent/ocsp
           Secure EE URL       = https://pki.example.com:8443/ocsp/ee/ocsp/<ocsp request blob>
           Secure Admin URL    = https://pki.example.com:8443/ocsp/services
           PKI Console Command = pkiconsole https://pki.example.com:8443/ocsp
           Tomcat Port         = 8005 (for shutdown)

           [TKS Status Definitions]
           Secure Agent URL    = https://pki.example.com:8443/tks/agent/tks
           Secure Admin URL    = https://pki.example.com:8443/tks/services
           PKI Console Command = pkiconsole https://pki.example.com:8443/tks
           Tomcat Port         = 8005 (for shutdown)

           [TPS Status Definitions]
           Unsecure URL        = http://pki.example.com:8080/tps
           Secure URL          = https://pki.example.com:8443/tps
           Tomcat Port         = 8005 (for shutdown)
           Unsecure PHONE HOME = http://pki.example.com:8080/tps/phoneHome
           Secure PHONE HOME   = https://pki.example.com:8443/tps/phoneHome

           [CA Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  Root CA (Security Domain)

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

           [DRM Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  DRM

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

           [OCSP Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  OCSP

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

           [TKS Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  TKS

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

           [TPS Configuration Definitions]
           PKI Instance Name:   pki-tomcat

           PKI Subsystem Type:  TPS

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:8443
           ====================================================================

   Listing the status of the PKI instance named 'pki-tomcat-2':

       # pkidaemon status tomcat pki-tomcat-2

       Status for pki-tomcat-2: pki-tomcat-2 is running ..

           [CA Status Definitions]
           Unsecure URL        = http://pki.example.com:18080/ca/ee/ca
           Secure Agent URL    = https://pki.example.com:18443/ca/agent/ca
           Secure EE URL       = https://pki.example.com:18443/ca/ee/ca
           Secure Admin URL    = https://pki.example.com:18443/ca/services
           PKI Console Command = pkiconsole https://pki.example.com:18443/ca
           Tomcat Port         = 18005 (for shutdown)

           [CA Configuration Definitions]
           PKI Instance Name:   pki-tomcat-2

           PKI Subsystem Type:  Root CA (Security Domain)

           Registered PKI Security Domain Information:
           ====================================================================
           Name:  example.com Security Domain
           URL:   https://pki.example.com:18443
           ====================================================================

BUGS

       Report bugs to http://bugzilla.redhat.com.

AUTHORS

       Matthew Harmsen <mharmsen@redhat.com>.  pkidaemon was written by  the  Certificate  Server
       project.

COPYRIGHT

       Copyright  (c)  2015  Red Hat, Inc. This is licensed under the GNU General Public License,
       version 2 (GPLv2). A copy of this license is available at http://www.gnu.org/licenses/old-
       licenses/gpl-2.0.txt.

SEE ALSO

       pkispawn(8), pkidestroy(8), pki_default.cfg(5), pki(1)