4.3 Install the DRA REST Extensions

The DRA REST Extensions package has four features:

  • NetIQ DRA Host Service: Gateway used to communicate with the DRA Administration Service. This service must run on a computer with the DRA Administration Service installed.

  • DRA REST Service and Endpoints: Provides the RESTful interfaces that enable the DRA Web Console and non-DRA clients to request DRA operations. This service must run on a computer with either a DRA console or the DRA Administration Service installed.

  • PowerShell Extensions: Provides a PowerShell module that allows non-DRA clients to request DRA operations using PowerShell cmdlets.

  • DRA Web Console: The web client interface that is primarily used by assistant administrators, but also includes customization options.

Step

Details

Log on to the target server

Log on to the target Microsoft Windows server for the install with an account that has local administrative privileges.

Install the SSL Certificate

If not already installed on the Windows server, you will need to have an SSL certificate installed before you run the installation.

Copy and run the NetIQ Admin Installation Kit

Copy the DRA installation kit NetIQAdminINstallationKit.msi to the target server and execute it by double-clicking the file or calling it from the command line. The installation kit will extract the DRA installation media to the local file system to a customizable location.

Execute the DRA REST Extensions Installer

After the DRA installation kit finishes extracting the installation media, it will prompt you to launch the DRA install. Navigate to the location were the installation media was extracted, right-click the DRARESTExtensionsInstaller.exe file, and select Run as administrator.

Accept the EULA license agreement

Accept the terms of the End User License Agreement.

Select Components and Specify the target location for the installation

From the Installation Select Components dialog, install all options: DRA Host Service, DRA REST Endpoints and service, PowerShell Extensions, and DRA Web Console.

Either accept the default installation location C:\Program Files (x86)\NetIQ\DRA Extensions or specify an alternate location for the install.

Verify prerequisites

The Prerequisites dialog will display the list of required software based on the components selected for the installation. The installer will guide you though installing any missing prerequisites that are required for the install to complete successfully.

Specify the Service Account to Run As

By default the existing service account from DRA server is displayed. Specify the service account password. For more information on setting up a service account for the DRA Administration Server, see DRA Administration Server Requirements.

Specify REST Service SSL Certificate

Select the SSL certificate you will use for the REST service, and specify the REST and Host service ports.

Specify Web Console SSL Certificate

Specify the SSL certificate you will use for the HTTPS binding.

Verify install configuration

You can verify the configuration on the installation summary page before clicking Install to proceed with the installation.