Installing TKS with Existing DS Backend - dogtagpki/pki GitHub Wiki

Table of Contents

Overview

This page describes the process to install TKS with an existing DS backend (e.g. userRoot).

Preparing DS Instance

Add a PKI top-level entry in the default DS backend with the following command:

$ ldapadd -x -D "cn=Directory Manager" -w Secret.123 << EOF
dn: dc=pki,dc=example,dc=com
objectClass: domain
dc: pki
EOF

Installing TKS

Prepare a deployment configuration file (e.g. tks.cfg):

[TKS]
pki_admin_cert_file=/root/.dogtag/pki-tomcat/ca_admin.cert
[email protected]
pki_admin_name=tksadmin
pki_admin_nickname=tksadmin
pki_admin_password=Secret.123
pki_admin_uid=tksadmin

pki_client_database_password=Secret.123
pki_client_database_purge=False
pki_client_pkcs12_password=Secret.123

pki_ds_base_dn=dc=tks,dc=pki,dc=example,dc=com
pki_ds_database=userRoot
pki_ds_create_new_db=False
pki_ds_password=Secret.123

pki_security_domain_name=EXAMPLE
pki_security_domain_user=caadmin
pki_security_domain_password=Secret.123

pki_audit_signing_nickname=tks_audit_signing
pki_sslserver_nickname=sslserver
pki_subsystem_nickname=subsystem

To begin the installation, execute the following command:

$ pkispawn -v -f tks.cfg -s TKS

Verification

Verify that TKS is running with the following command:

$ pki -d ~/.dogtag/pki-tomcat/ca/alias -c Secret.123 -n caadmin tks-user-show tksuser
---------------
User "tksadmin"
---------------
  User ID: tksadmin
  Full name: tksadmin
  Email: [email protected]
  Type: adminType
  State: 1

See Also

⚠️ **GitHub.com Fallback** ⚠️