Skip to main content
Pentaho Documentation

How to Change the Administrator Role

The default administrator role in the Pentaho Server is Admin. If you need to give this privilege level to a different role name, follow these instructions:

Role names are case sensitive, so take special care when typing in the new role name.

  1. Open the /pentaho/server/pentaho-server/pentaho-solutions/system/pentaho.xml file with a text editor.
  2. Find the <acl-voter> element, and replace its <admin-role> property with the new administrator role. For example, as NewAdmin is used in this sample procedure:
    <admin-role>NewAdmin</admin-role>
  3. Find the <acl-publisher> element, and appropriately replace all instances of Admin in the properties inside of the <default-acls> and <overrides> elements as shown in the following example:
    <acl-entry role="NewAdmin" acl="ADMIN_ALL" />
  4. Save the file, then open applicationContext-spring-security.xml.

  5. Find the filterInvocationInterceptor bean, and modify its objectDefinitionSource property accordingly. You may need to consult the Spring Security documentation to complete this step:
    <property name="objectDefinitionSource">
        <value>
            <![CDATA[
            CONVERT_URL_TO_LOWERCASE_BEFORE_COMPARISON
            ...
            \A/admin.*\Z=NewAdmin
            ...
            ]]>
        </value>
    </property>
You have successfully changed the administrator role.