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 |
-
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 |
Windows
About this task
To install Delegated Admin in a Windows environment:
Steps
-
In the Delegated Admin application directory, copy or rename the file
example.config.js
toconfig.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 asdadmin
. -
Open
config.js
in a text editor. -
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.
-
Save your changes to
config.js
. -
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
-
-
Open
delegated-admin.dsconfig
in a text editor and replace the variables,${variable}
, with actual values. -
Save your changes to
delegated-admin.dsconfig
.