Chapter 8. Installing an IdM server or replica with custom Directory Server and certificate authority settings from LDIF and INI files


You can use a configuration file to install an Identity Management (IdM) server or replicas with custom settings for:

  • The IdM Directory Server.
  • The IdM Certificate Authority.

8.1. Installing an IdM server or replica with custom Directory Server settings from an LDIF file

You can install an Identity Management (IdM) server and replicas with custom settings for the Directory Server (DS). The following procedure shows you how to create an LDAP Data Interchange Format (LDIF) file with the IdM DS settings, and how to pass those settings to the IdM server and replica installation commands.

Prerequisites

Procedure

  1. Create a text file in LDIF format with your custom DS settings. Separate LDAP attribute modifications with a dash (-). This example sets non-default values for the idle timeout and maximum file descriptors.

    changetype: modify
    replace: nsslapd-idletimeout
    nsslapd-idletimeout: 1800
    -
    replace: nsslapd-maxdescriptors
    nsslapd-maxdescriptors: 8192
    Copy to Clipboard
  2. Use the --dirsrv-config-file parameter to pass the LDIF file to the installation script.

    1. To install an IdM server:

      # ipa-server-install --dirsrv-config-file <filename.ldif>
      Copy to Clipboard
    2. To install an IdM replica:

      # ipa-replica-install --dirsrv-config-file <filename.ldif>
      Copy to Clipboard

8.2. Installing an IdM server or replica with custom certificate authority settings from an INI file

You can install an Identity Management (IdM) server and IdM replicas with custom settings for the IdM Certificate Authority (CA) and Key Recovery Authority (KRA).

The following procedure describes how to create an INI file containing an override for the CA, and how to pass it to the IdM server and replica installation commands.

Prerequisites

  • You have root privileges.

Procedure

  1. Create a text file in INI format with your custom CA settings. Write each parameter on a new line. This example sets the CA signing key size to 4096 bits.

    [CA]
    pki_ca_signing_key_size=4096
    Copy to Clipboard
  2. Use the --pki-config-override parameter to pass the INI file to the installation script.

    1. To install an IdM server:

      # ipa-server-install --pki-config-override <pkiconfig.ini>
      Copy to Clipboard
    2. To install an IdM replica:

      # ipa-replica-install --pki-config-override <pkiconfig.ini>
      Copy to Clipboard
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat