Upgrading from Active Roles 6.9
Upgrade from Active Roles 6.9
Upgrading from Active Roles 6.9 to 7.x version is a side-by-side upgrade, which does not interrupt operations or affect the configuration of the currently installed Active Roles version. To ensure smooth upgrade to the new Active Roles version, upgrade the Administration Service first, and then upgrade the Web Interface.
Active Roles 6.9 components are not used in the upgrade and neither are any components from the earlier version uninstalled.
Before upgrading to the latest version of Active Roles, the add-ons of the earlier versions must be uninstalled.
Impact on Office 365 Add-On
- After an upgrade of Active Roles components to Active Roles 7.4.x, the Office 365 add-on which was supported in the earlier versions of Active Roles, ceases to work. Hence, it is recommended to uninstall the Office 365 add-on prior to the upgrade of Active Roles.
- Office 365 add-on is not supported on Active Roles 7.3 or later and must be uninstalled prior to the installation of Active Roles 7.1.
- Active Roles 7.4.x manages Office 365 and Azure AD natively.
For an upgrade demonstration, please refer to the following knowledge base article:
Prerequisites for upgrade from Active Roles 6.9
Before any upgrade is performed, first consider the following:
- There is no need to break replication when upgrading to Active Roles 7.4.x from 6.9 as Active Roles 7.3 or later does not support an in-place upgrade in this scenario. A side-by-side installation of Active Roles must be performed and replication must be configured post installation on the new instance of Active Roles.
NOTE: During and post-installation of Active Roles 7.4.x, the existing installation of Active Roles 6.9 will be available and fully functional. Hence, users will not be affected during the upgrade process with the exception of Dynamic Groups. For more details please review the knowledge base article, https://support.oneidentity.com/kb/211388.
To perform the Upgrade
- From the installation media, run ActiveRoles.exe.
- Accept the licensing agreement and click Next.
- Select the desired components and click Next.
- Review the summary and click Install.
- By default, the I want to perform configuration option is selected. Click Finish to launch the Configuration Center
- In the Configuration Center, under the Administration Service option click Configure.
- Select a service account that will run the Active Roles service and click Next.
- Choose the appropriate security group that will hold the role of the Active Roles Admin group and click Next.
- If this is the first installation of Active Roles, select New Active Roles database and click Next.
- Enter the appropriate SQL server, database name and credentials. Click Next.
- After completing, click Finish.
- In the Configuration Center, under Dashboard click Import Configuration, specify the Source SQL server, database and access credentials, and then click Next.
- Click Next.
- If the current version of Active Roles service is running, stop it and then click Next to continue.
- If you have the encryption key, provide it. If not, select Do not import encrypted data and click Next.
- If you do not have the encryption key, you must re-enter the credentials for any Managed Domains, which are not managed by the Active Roles Service account.
The Add-On Advisor checks if there are any incompatible Add-Ons installed the Wizard will not proceed. Before continuing, uninstall the Add-Ons from the Active Roles 6.9 server.
- Click Next.
- Once ready, click Import.
Importing change history
The Change History from Active Roles 6.9 database is not imported during the initial import, as the Change History may be extremely large and thus would take a long time for the initial Setup to complete. Active Roles provides a separate utility for importing Change History.
- In the Active Roles Configuration Center, click Import Management History under Administration Service.
- Enter the Active Roles 6.9 source database and appropriate credentials and click Next.
- Select the destination database and click Next.
- Choose the records to import and click Next.
- Confirm the settings and click Import.
The progress screen is displayed, and after completion, the summary is displayed.
In-place upgrade from Actve Roles 7.x
In-place upgrade from Actve Roles 7.x
Office 365 Add-On that was previously available for Active Roles is no longer compatible with Active Roles 7.4.x. Before proceeding with the upgrade starting from 7.0.x, the Office 365 Add-On must be uninstalled.
For an upgrade demonstration, please refer to the following knowledge base articles:
Backing up the Active Roles Database
Before upgrading, it is recommended to back up the Active Roles database. For general best practices, please refer to the following Microsoft article:
Prerequisites for in-place upgrade from Active Roles 7.x
It is recommended to back up the current Web Interfaces if any customizations have been implemented.
Any Web Interfaces that were created in Active Roles 7.2.x will continue to function in 7.4.x. However, it is recommended to thoroughly test before upgrading, as some customizations may not work as expected in newer versions of Active Roles.
To back up the Web Interface Configurations
- Launch the Active Roles Configuration Center.
- Click Web Interface.
- Select the desired site(s) and click Export Configuration.
To upgrade Active Roles
- Run ActiveRoles.exe from the installation media.
- Click Next to continue.
- Accept the license agreement and click Next.
- Review the summary and warning. If the Office 365 Add-On is installed in the 7.0.x instance, uninstall it before continuing.
- If the system does not restart, click Update Service Instance in the Configuration Center.
- If the system restarts and the Configuration Center does launch automatically, launch the Configuration Center and click Update Service Instance.
Due to the update of the database schema, the 7.0 versions of the Websites are no longer compatible.
- Click Manage Sites under Web Interface in the Configuration Center.
- Make note of the current websites and configurations used (For example, ARWebAdmin, using configuration “Site for Administrators”).
- Delete all the sites and click +Create.
- Enter the Alias of the site, for example ARWebAdmin and click Next.
- On the Configuration screen, ensure Create from a template is selected.
- Enter a Configuration name, select the original Template to import from (for example, “Site for Administrators 7.0”), and then click Create.