.nh
.TH pkidestroy 8 "December 13, 2012" PKI "PKI Instance Removal Utility"
.SH NAME
.PP
pkidestroy - Removes a subsystem from an instance of PKI server.

.SH SYNOPSIS
.PP
\fBpkidestroy\fP \fB-s\fP \fIsubsystem\fP \fB-i\fP \fIinstance\fP [\fB-u\fP \fIsecurity_domain_username\fP] [\fB-W\fP \fIsecurity_domain_password_file\fP] [\fB-h\fP] [\fB-v\fP]

.SH DESCRIPTION
.PP
Removes a subsystem from an instance of PKI server.
This utility removes any of the PKI subsystems (CA, KRA, OCSP, TKS, and TPS).

.PP
An instance can contain multiple subsystems, although it may contain at most one of each type of subsystem.
So, for example, an instance could contain CA and KRA subsystems,  but not two CA subsystems.
If \fBpkidestroy\fP is invoked on the last subsystem in the instance, then that instance is removed.
Typically, as subsystems need to contact the CA to update the security domain, the CA instance should be the last instance to be removed.

.SH OPTIONS
.PP
\fB-s\fP \fIsubsystem\fP
.br
    Specifies the subsystem to be removed, where \fIsubsystem\fP is CA, KRA, OCSP, TKS, or TPS.
    If this option is not specified, \fBpkidestroy\fP will prompt for its value.

.PP
\fB-i\fP \fIinstance\fP
.br
    Specifies the name of the instance from which the subsystem should be removed.
    The instance is located at /var/log/pki/\fIinstance\fP\&.
    If this option is not specified, \fBpkidestroy\fP will prompt for its value.

.PP
\fB-u\fP \fIsecurity_domain_username\fP
.br
    Specifies the username of the security domain of the subsystem.
    This is an \fBoptional\fP parameter.

.PP
\fB-W\fP \fIsecurity_domain_password_file\fP
.br
    Specifies the file containing the password of the security domain of the subsystem.
    This is an \fBoptional\fP parameter.

.PP
\fB-h\fP, \fB--help\fP
.br
    Prints additional help information.

.PP
\fB-v\fP
.br
    Displays verbose information about the installation.
    This flag can be provided multiple times to increase verbosity.
    See \fBpkidestroy -h\fP for details.

.SH AUTHORS
.PP
Ade Lee <alee@redhat.com>\&.

.SH SEE ALSO
.PP
\fBpkispawn(8)\fP

.SH COPYRIGHT
.PP
Copyright (c) 2012 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.