---
sourceDocument: Australia Platform security
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/platform-security

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia Platform security

ft:clusterId :

    - psec

bundleId :

    - psec

workflow :

    - Platform


---

# Upgrade to Contextual Security: Role Management V2

# Upgrade to Contextual Security: Role Management V2 {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Contextual Security: Role Management V2 is automatically installed on new instances.
You can upgrade from Contextual Security: Role Management to Contextual Security: Role
Management V2 to eliminate duplicate roles in the User Roles table and prevent future
duplicates.

## Vorbereitungen

Role required: admin, security_admin

You must have the admin role and [Elevate to a privileged role](https://servicenow-prod.fluidtopics.net/QSMW4UNBg6bevZDKAPGT2Q "The base system admin can elevate to a privileged role to have access to the features of High Security Settings.") to obtain the
effective security_admin role.  
Hinweis:  
Before upgrading to Contextual Security: Role: Management V2, you must enable the Audit Roles table to create audit records related to user roles. To learn more about setting the required system property, see [Enable role auditing with Contextual Security: Role Management V2](https://servicenow-prod.fluidtopics.net/0~ZuYw_kr516szz0tSJTLQ "Set a system property to enable the Audit Roles table to create audit records related to user roles.").

## Warum und wann dieser Vorgang ausgeführt wird

This procedure describes how to upgrade your Contextual Security role and how to activate the related plugins described in the following table.{#Role-Mgmt-V2-Upgrade__table_jpm_rh3_hy__entry__2}

| Plugin | Description |
|-|-|
| Contextual Security: Role Management V2 \[com.glide.role_management.inh_count\] | Prevents duplicate entries in the User Roles \[sys_user_has_role\] table. The security_admin role or a user with elevated privileges is required to activate the plugin, or contact Customer Service and Support. |
| Contextual Security: Role Management V2 REST API \[com.glide.role_management.inh_count.rest_api\] | Enables API functionality for role management. |
[Tabelle : 1. Plugins for Contextual Security: Role Management V2]

{#Role-Mgmt-V2-Upgrade__table_jpm_rh3_hy}

Before upgrading from Contextual Security: Role Management to Contextual Security:
Role Management V2, test the results of an upgrade by running the script. The script
returns a list of changes that an upgrade will perform. If the changes are
acceptable, install the Contextual Security: Role Management V2 plugin. If the
changes are not acceptable, do not install the Contextual Security: Role Management
V2 plugin. Alternatively, you can perform the upgrade and then manually make any
necessary changes.

## Prozedur

1. Test the impact of an upgrade prior to upgrading by running the following script.
   1. Navigate to System DefinitionScripts - Background.
   2. Run the following script in global scope.  

          new RoleManagementVerify().verifyInheritedRoles();

      For large sys_user_has_role tables, the execution may take up to several hours to complete. Do not edit or add user roles during this time.  
      Example result based on test data:

          *** Script: 2016-12-01 19:58:54 Starting checking of inherited roles for all users... 
          *** Script: User: itam, inherited roles to be ADDED: financial_mgmt_user 
          *** Script: User: bernard.laboy, inherited roles to be DELETED: api_analytics_read,pa_viewer,rest_api_explorer,a123 
          *** Script: User: bernard.laboy, inherited roles to be ADDED: dependency_views 
          *** Script: Number of inherited-role records in sys_user_has role, current: 260, after re-calculation: 258 
          *** Script: Number of users with discrepancies for inherited roles: 2 
          *** Script: 2016-12-01 19:58:55 Finished checking of inherited roles for all users!

   3. Evaluate the script results to determine whether the proposed changes are acceptable.
   {#Role-Mgmt-V2-Upgrade__substeps_kgk_j23_hy}
2. Activate the Contextual Security: Role Management V2 plugin.  
   Wichtig:  
   The security_admin role or a user with elevated privileges is required to activate the plugin, or contact Customer Service and Support.
   1. Navigate to System DefinitionPlugins.
   2. Find and click the plugin name.
   3. On the System Plugin form, review the plugin details and then click the Activate/Upgrade related link.
   4. Click Activate.
   {#Role-Mgmt-V2-Upgrade__substeps_fdv_mg3_hy}

## Ergebnisse

After activating Role Management V2, the changes outlined in the script result are enacted. The Inheritance Count (inh_count) column in the User Roles table is read-only and automatically reflects the number of times the user inherits a role.