Skip to main content
Planview Customer Success Center

What should I be aware of when upgrading to 23.4?

Last Updated:   |  Applicable Hub Versions: 23.4 and later

Answer

When upgrading to 23.4.0 or later from an earlier version, you should create two new user roles, NonRepositoryWriteAccess and RepositoryWriteAccess, at the Tasktop realm through the Hub User Administration Console (Keycloak), if you'd like to provide certain users with specific repository permissions. 

  • NonRepositoryWriteAccess disables a user from creating and editing repositories.
  • RepositoryWriteAccess allows a user to create and edit repositories. 

NoteAll users installing Hub after 23.4 will have the new role by default and will not need to follow any additional steps.

To add the NonRepositoryWriteAccess role, please see the instructions below:

  1. Login to the Admin Console and click Roles on the left sidebar. 
    1. Click 'Roles'
  2. Next, click Add Role to add the new user role. 
    1. 71584188.png
  3. Name the new role NonRepositoryWriteAccess and enter the following description, Does not allow user to create and edit repositories.
    1. image (9).png
  4. After saving the new role, navigate to Groups and click New to create a new group.
    1. image (10).png
  5. Name the new group NonRepositoryUsers. Go back to the group list, select the newly created group and click Edit.
    1. image (11).png
  6. Then, go to the Role Mappings tab, and add the NonRepositoryWriteAccess role to this group.
    1. image (12).png
  7. Next, assign your desired users to the group. To do this, click Users on the left sidebar and select the user you'd like to add.
    1. NoteWhen creating a user with one of the new groups, be sure to remove them from any other groups they were added to by default such as TasktopUsers. Groups generally add permissions and do not take them away, so if a user is a member of TasktopUsers, adding them to NonRepositoryUsers will have no effect.
    2. 79987997.png
  8. Then, click the Groups tab, select the group you'd like to join, and click Join.

To add the RepositoryWriteAccess role, please see the instructions below:

  1. Login to the Hub Admin Console and click Roles on the left sidebar. 
    1. Click 'Roles'
  2. Next, click Add Role to add the new user role. 
    1. 71584188.png
  3. Name the new role RepositoryWriteAccess and enter the following description, Allows user to create and edit repositories.
  4. After saving the new role, navigate to Groups and click New to create a new group.
    1. 71584190.png
  5. Name the new group RepositoryOnlyUsersGo back to the group list, select the newly created group and click Edit.
    1. image (14).png
  6. Go to the Role Mappings tab, and add the RepositoryWriteAccess role to this group.
    1. image (16).png
  7. Next, assign your desired users to the group. To do this, click Users on the left sidebar and select the user you'd like to add.
    1. 79987997.png
  8. Then, click the Groups tab, select the group you'd like to join, and click Join.
    1. image (18).png