System information

Create and Remove Instance Tools

The Certificate System includes two tools to create and remove subsystem instances,

pkicreate and pkiremove.

NOTE

The pkicreate tool does not install the Certificate System system; this is done

through installing the packages or running the Red Hat Enterprise Linux up2date

command. This tool creates new instances after the default subsystems have

been installed.

Likewise, the pkiremove utility does not uninstall the Certificate System

subsystem; it removes a single instance.

1. pkicreate

The pkicreate tool creates instances of Certificate System subsystems and does a minimal

configuration of the new instance, such as setting the configuration directory and port numbers.

Further configuration is done through the HTML configuration page, as with configuring the

default instances.

The following sections explain the syntax and usage of the pkicreate tool.

1.1. Syntax

This tool has the following syntax:

pkicreate -pki_instance_root=/directory/path -subsystem_type=type

-pki_instance_name=instance_ID [-secure_port=SSLport]

[-unsecure_port=port] -tomcat_server_port=port

-user=user_name -group=group_name [-verbose] [-help]

NOTE

The pkicreate tool also accepts an environment variable,

DONT_RUN_PKICREATE; if this is set, the pkicreate utility is prevented from doing

anything. When the DONT_RUN_PKICREATE variable is set before installing the

default subsystem instance (before running the rhpki-install script), this

allows the default instance to be installed in a user-defined location instead of the

default location.

Chapter 1.