Chat now with support
Chat with Support

Active Roles 8.2 - Installation Guide

Introduction System requirements Prerequisites of installing Active Roles Installing Active Roles Deploying the Administration Service Deploying user interfaces Installing optional tools and components Uninstalling Active Roles Using Active Roles to manage Azure AD objects Active Roles availability on Azure and AWS Marketplace Configuring Active Roles for AWS Managed Microsoft AD

Silent installation of Active Roles components

Active Roles supports command line options for various installation procedures. The following is a list of command line options available with Active Roles 8.2.

Category

Command

Description

Installation type

ActiveRoles.exe

Launches the setup wizard in normal mode.

ActiveRoles.exe /quiet [parameters]

Launches the setup wizard in quiet mode (also known as silent mode or unattended installation) with no user interaction.

Examples:

  • ActiveRoles.exe /quiet /install ADDLOCAL=Service,Console /IAcceptActiveRolesLicenseTerms

  • ActiveRoles.exe /quiet /install ADDLOCAL=Console TARGETDIR=D:\Active Roles\ /IAcceptActiveRolesLicenseTerms

Parameter syntax

/parameter [properties]

Specifies additional installation parameters. Separate parameter properties with spaces.

Properties

ADDLOCAL=

The comma-separated list of the Active Roles components to install.

Example:

ADDLOCAL=Service,Console

REMOVE=

The comma-separated list of the Active Roles components to remove.

Example:

REMOVE=Web,Console

TARGETDIR=

The path of the Active Roles installation folder.

Example:

TARGETDIR=D:\Active Roles\

Component names

ALL

Specifies all Active Roles components.

Service

Specifies the Active Roles Administration Service.

Web

Specifies the Active Roles Web Interface.

Console

Specifies the Active Roles Console (MMC Interface).

Tools

Specifies the Active Roles Management Tools.

SyncService

Specifies the Active Roles Synchronization Service.

Parameters

/IAcceptActiveRolesLicenseTerms

Acknowledges that you have read and understood the terms of the Active Roles license agreement.

This parameter is required if both the /quiet and /install parameters are specified.

Example:

ActiveRoles.exe /quiet /install /IAcceptActiveRolesLicenseTerms

/install [properties]

Installs the Active Roles components specified by the ADDLOCAL property to the TARGETDIR folder.

  • If ADDLOCAL is omitted, it installs all Active Roles components, except Synchronization Service.

  • If TARGETDIR is omitted, it installs Active Roles to %programfiles%\One Identity\Active Roles\.

TIP: To install Active Roles Synchronization Service use the ADDLOCAL=SyncService parameter.

Takes effect only if any Active Roles components are installed, otherwise disregarded.

Example:

ActiveRoles.exe /install ADDLOCAL=Web TARGETDIR=D:\Active Roles\

/repair

Repairs all installed components.

Takes effect only if any Active Roles components are installed, otherwise disregarded.

Example:

ActiveRoles.exe /quiet /repair

/modify

Installs the Active Roles components specified by ADDLOCAL property and removes the components specified by the REMOVE property.

Takes effect only if any Active Roles components are installed, otherwise disregarded.

Example:

ActiveRoles.exe /modify ADDLOCAL=Service,Console | REMOVE=Web

/uninstall

Uninstalls all components. Error conditions may terminate uninstall.

Takes effect only if any Active Roles components are installed, otherwise disregarded.

Example:

ActiveRoles.exe /quiet /uninstall

/forceuninstall

Use this parameter to uninstall all components if errors prevent normal uninstall.

Takes effect only if any Active Roles components are installed, otherwise disregarded.

Example:

ActiveRoles.exe /quiet /forceuninstall

/forcerestart

Auto-restarts the computer when a restart is required to complete the requested setup actions.

Use this parameter to avoid having to restart the computer manually after running the Active Roles setup wizard (for example, if setup needs to update any files that are currently in use).

Examples:

  • ActiveRoles.exe /quiet /uninstall /forcerestart

  • ActiveRoles.exe /quiet /repair /forcerestart

Uninstalling Active Roles

If Active Roles or any of its components are no longer used in the machine, you can remove it with Active Roles setup wizard.

To uninstall Active Roles and its components

  1. On the system where Active Roles is installed, open Control Panel, and navigate to Programs > Programs and Features.

  2. In the list of installed programs, right-click on One Identity Active Roles, and click Uninstall/Change.

  3. In the Active Roles setup wizard, click Remove.

  4. To uninstall Active Roles, in the Ready to Remove dialog, click Remove.

TIP: If you want to fix a corrupted Active Roles installation, use the Repair option of the setup wizard to reinstall any corrupted Active Roles files.

Using Active Roles to manage Azure AD objects

You can use the Active Roles Configuration Center to perform Azure AD configuration tasks, such as adding, removing or modifying Azure tenants for managing their contents in Active Roles. Active Roles also supports the multi-tenant model.

NOTE: Administrative users or users with sufficient privileges only can view Azure configuration.

Configuring Active Roles to manage Azure AD using the Active Roles Configuration Center

You can add Azure tenants to manage their Azure AD resources in Active Roles with the Active Roles Configuration Center.

You can add an Azure tenant by two means:

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating