PingDirectory

Installing the application

The steps for installing Delegated Admin depend on whether you are setting up the application in a Unix or Linux environment or in a Windows environment.

In all environments, if port 443 is used but not specified in the PingFederate Base URL, do not assign a value to window.PF_PORT.

  • Unix or Linux

  • Windows

Unix or Linux

About this task

To begin installing Delegated Admin in a Unix or Linux environment:

Steps

  • Run the following script in the /delegator directory that you obtained in Obtaining the installation files.

    $ ./set-up-delegator.sh

    Result:

    The system generates:

    • A configuration file, config.js, located in the /webapps/delegator/app directory.

    • A batch file, delegated-admin.dsconfig, in the /webapps/delegator directory.

    The setup tool also generates several command-line prompts for completing the Delegated Admin installation. After you provide the distinguished name (DN) of the root user for your PingDirectory instance, you’re prompted to enter information regarding your PingFederate server and the hosting location of the Delegated Admin web app. Enter your own values or press Enter to accept the default values.

If you answer y to the setup script question Is Delegated Admin being installed in a topology containing PingDirectoryProxy?, the system also generates a batch file, delegated-admin-for-proxy.dsconfig in the /webapps/delegator directory.

Windows

About this task

To install Delegated Admin in a Windows environment:

Steps

  1. In the Delegated Admin application directory, copy or rename the file example.config.js to config.js. config.js contains comments and placeholders for necessary information. For example, the Client ID that is required in this file must be one of the Client IDs that has been defined for the PingFederate configuration. This value represents the client intended for token issuance, such as dadmin.

  2. Open config.js in a text editor.

  3. Change the variable values to match your setup configuration.

    config.jsVariable Value

    window.PF_HOST

    Public address of the PingFederate server to which the application redirects the user’s browser when signing on.

    window.PF_PORT

    PingFederate port number.

    If port 443 is used but not specified in the PingFederate Base URL, do not assign a value to window.PF_PORT.

    window.DADMIN_CLIENT_ID

    PingFederate Client ID for the application.

  4. Save your changes to config.js.

  5. Concatenate the following files into a single file named delegated-admin.dsconfig:

    • delegated-admin-template-common.dsconfig

    • delegated-admin-template-ds.dsconfig

    • delegated-admin-template-ds-or-proxy.dsconfig

    • delegated-admin-template-webapp.dsconfig

  6. Open delegated-admin.dsconfig in a text editor and replace the variables, ${variable}, with actual values.

  7. Save your changes to delegated-admin.dsconfig.