Promote a user to administrator (Local only)

If your IBM® Planning Analytics Workspace administrator is no longer available, you can promote a non-admin user to the administrator role by using the command line. If you are upgrading to Planning Analytics Workspace 2.0.92 or a higher version, you can also use the same command line tools to assign Environments administration privileges to a user.

Important: This command-line approach is the only way to do the following administrative tasks:
  • Promote a user to the Administrator role without logging in as an existing administrator.
  • Assign Environments administration privileges when no administrator currently has that privilege.
  1. Run the following command to see a list of users in this environment, including their login ID, display name, user ID, and role.
    • On Windows:
      docker exec -it wa-proxy powershell -command "C:\wa-proxy\tools\runTool.ps1" changeUserRoleToAdmin
    • On Red Hat Enterprise Linux® 8 and 9:
      sudo podman exec -it wa-proxy bash -C /wa-proxy/tools/runTool.sh changeUserRoleToAdmin
    • On OpenShift:
      oc rsh <wa-proxy-pod-id> bash -C /wa-proxy/tools/runTool.sh changeUserRoleToAdmin
  2. Identify the user ID for the user that you want to promote, then run the following command with the appropriate userID. This command sets the user to the Administrator role and also grants Environments administration privileges.
    • On Windows:
      docker exec -it wa-proxy powershell -command  "C:\wa-proxy\tools\runTool.ps1" changeUserRoleToAdmin <userId>
    • On Red Hat Enterprise Linux® 8 and 9:
      sudo podman exec -it wa-proxy bash -C  /wa-proxy/tools/runTool.sh changeUserRoleToAdmin
      <userId>
    • On OpenShift:
      oc rsh <wa-proxy-pod-id> bash -C /wa-proxy/tools/runTool.sh changeUserRoleToAdmin <userId>

Assigning Environments privileges to a user (Local only)

If you are upgrading to Planning Analytics Workspace 2.0.92 and intend create and manage multiple environments in Planning Analytics Administration Local, you must grant Environments administration privileges to at least one administrator.

Note:
  • For new installations of Planning Analytics Workspace, the first user that is assigned with the Administrator role automatically receives Environments administration privileges.
  • When you upgrade an existing environment, you must explicitly assign the Environments administration privileges.

You can promote an existing user and assign Environments administration privileges from the command line or remove Environments administration privileges by setting the user's environments_admin_privileges property value to false.

An existing Environments administrator can also assign and remove these privileges from Planning Analytics Administration Local by clicking the Users and Groups tile and selecting Users.