Installing optional tools and components
Installing optional tools and components
In addition to the Administration Service, Console and Web Interface, Active Roles allows you to install the following components:
-
Active Roles Management Shell: Provides commands based on the Windows PowerShell platform for managing users, group, computers and other objects in Active Directory via Active Roles; administering certain Active Roles objects; and configuring Active Roles Administration Service instances and Web Interface sites.
-
ADSI Provider: Enables custom applications and scripts to access directory data via Active Roles by using standard COM interfaces. Documentation for ADSI Provider can be found in the Active Roles SDK.
-
Active Roles SDK: Provides developers with documentation and samples to help them customize Active Roles by creating custom client applications and user interfaces, and implementing business rules and policies based on custom scripts.
-
Data Collector: Gathers data required for reporting. Retrieves data from specified data sources through the Administration Service, and stores the data on database server.
-
Report Pack: A comprehensive suite of report definitions that cover various administrative actions available in Active Roles.
Installing only the Management Shell, ADSI Provider and SDK
The Active Roles Management Shell, SDK and ADSI Provider tools are known as Management Tools. In the Active Roles installer, on the Component Selection page, the Active Roles Setup wizard automatically selects the Management Tools component if you have selected any core Active Roles components, such as the Administration Service, the Active Roles Console or the Web Interface.
This means that by default, the Active Roles Setup wizard installs the Management Tools together with any core component. However, you can also install them separately by selecting them individually.
To install the Active Roles Management Tools separately
-
Log in with a user account that has administrator rights on the computer.
-
Mount the Active Roles installation .iso file.
-
To start installation, double-click ActiveRoles.exe.
-
On the Component Selection page, clear all check boxes except Management Tools, then click Next.
-
On the Ready to Install page, review the summary and click Install.
-
To close the setup wizard, on the Completion page, click Finish.
After installing the Management Tools:
-
To open the Active Roles Management Shell, in the Windows Start menu or the Apps page of the operating system, select Active Roles 8.2.1 Management Shell. To view a reference list of all commands available in the Management Shell, run QuickRef.
-
To open the Active Roles SDK documentation, in the Windows Start menu or the Apps page of the operating system, select Active Roles 8.2.1 SDK.
Installing the Data Collector and Report Pack
Active Roles comes with a comprehensive suite of report definitions, contained in the Active Roles Report Pack. To work with reports, you must:
Installing the Data Collector
You can use the Active Roles Data Collector to prepare data for reporting, allowing you to configure, schedule, and run data collection jobs. Data Collector stores report data in a database on an on-premises SQL Server or Azure SQL database. For best results, use Microsoft SQL Server 2012 or a later version of SQL Server to host the Data Collector’s database.
NOTE: Collector can now store data in Azure database.
To install the Collector
-
Install Active Roles Management Tools. For more information, see Installing only the Management Shell, ADSI Provider and SDK.
-
In the Active Roles .iso, navigate to the Tools > Collector and Report Pack folder, and double-click the .msi file there.
-
Follow the instructions of the setup wizard.
-
Wait while the wizard completes the installation.
After you installed Collector, you can start the Data Collector wizard by selecting Active Roles 8.2.1 Collector and Report Pack on the Apps page or Start menu.