1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138
|
'\" t
.\" Title: grid-ca-package
.\" Author: University of Chicago
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 07/22/2011
.\" Manual: Globus Commands
.\" Source: Globus Toolkit 5.2.0
.\" Language: English
.\"
.TH "GRID\-CA\-PACKAGE" "1" "07/22/2011" "Globus Toolkit 5.2.0" "Globus Commands"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
grid-ca-package \- Prepare a CA certificate, configuration, and policy for distribution
.SH "SYNOPSIS"
.HP \w'\fBgrid\-ca\-package\fR\ 'u
\fBgrid\-ca\-package\fR [\-help] [\-h] [\-usage] [\-version] [\-versions]
.HP \w'\fBgrid\-ca\-package\fR\ 'u
\fBgrid\-ca\-package\fR [\-ca\ \fIHASH\fR] [\-g] [\-b] [\-r] [\-d]
.SH "DESCRIPTION"
.PP
The
\fBgrid\-ca\-package\fR
utility creates a tarball containing an RPM spec file and the files needed to use a CA with grid tools\&. It optionally will also create a GPT package for distributing a CA\&.
.PP
By default, the
\fBgrid\-ca\-package\fR
utility displays a list of installed grid CA and prompts for which CA to package\&. It then creates a tarball containing the CA certificate, signing policy, CA configuration files, and an spec script to generate a binary RPM package containing the CA\&. If the CA hash is known prior to running
\fBgrid\-ca\-package\fR, it may provided as an argument to the
\fB\-ca\fR
parameter to avoid prompting\&.
.PP
In addition to generating a spec script and tarball,
\fBgrid\-ca\-package\fR
creates a GPT package if either the
\fB\-g\fR
or
\fB\-b\fR
options are used on the command\-line\&. These packages may be used to distribute a CA and configuration to systems which do not support RPM packages\&.
.PP
The
\fBgrid\-ca\-package\fR
utility writes the package tarballs to the current working directory\&.
.PP
The full set of command\-line options to
\fBgrid\-ca\-package\fR
follows\&.
.PP
\fB\-help\fR, \fB\-h\fR, \fB\-usage\fR
.RS 4
Display the command\-line options to
\fBgrid\-ca\-package\fR
and exit\&.
.RE
.PP
\fB\-version\fR, \fB\-versions\fR
.RS 4
Display the version number of the
\fBgrid\-ca\-package\fR
command\&. The second form includes more details\&.
.RE
.PP
\fB\-ca \fR\fB\fICA\fR\fR
.RS 4
Use the CA whose name matches the hash string
\fICA\fR\&. When invoked with this option,
\fBgrid\-ca\-package\fR
runs non\-interactively\&.
.RE
.PP
\fB\-g\fR
.RS 4
Create a GPT binary package in addition to the RPM script tarball\&. This package may be installed on other systems using the
\fBgpt\-install\fR
program\&.
.RE
.PP
\fB\-b\fR
.RS 4
Create a GPT binary package with GPT metadata located in the path expected by GPT 3\&.2 (used in Globus 2\&.0\&.0\-5\&.0\&.x) instead of
\fB${datadir}\fR/globus/packages
as used in Globus 5\&.2\&.x\&. This option overrides the
\fB\-g\fR
command\-line option\&.
.RE
.PP
\fB\-r\fR
.RS 4
Create a binary RPM package for the CA\&. This option currently only works on RPM\-based distributions\&.
.RE
.PP
\fB\-d\fR
.RS 4
Create a binary Debian package for the CA\&. This option currently only works on Debian\-based distributions\&.
.RE
.SH "EXAMPLES"
.PP
Package a Simple CA with hash
0146c503
.sp
.if n \{\
.RS 4
.\}
.nf
% \fBgrid\-ca\-package\fR \fB\-ca \fR\fB0146c503\fR
Creating RPM source tarball\&.\&.\&. done
globus_simple_ca_0146c503\&.tar\&.gz
.fi
.if n \{\
.RE
.\}
.sp
.SH "ENVIRONMENT VARIABLES"
.PP
The following environment variables affect the execution of
\fBgrid\-ca\-package\fR:
.PP
\fBGLOBUS_LOCATION\fR
.RS 4
Non\-standard installation path of the Globus toolkit\&.
.RE
.SH "SEE ALSO"
.PP
\fBgrid-cert-request\fR(1),
\fBgrid-ca-sign\fR(1),
\fBgrid-default-ca\fR(1),
\fBgrid-ca-create\fR(1)
.SH "AUTHOR"
.PP
\fBUniversity of Chicago\fR
|