Configure a Custom TSM Administration Group
This topic describes how to configure a custom TSM administration group.
By default, the Tableau Server installation process creates a group called
tsmadmin. Users in this group are authorized as administrators of TSM. You can change this default group during installation. See Help Output for initialize-tsm Script.
If you have already installed Tableau Server and wish to change the group used for TSM administration, follow the procedure in this topic.
You can configure Tableau Server to use an arbitrary group as a custom TSM administration group. Once configured, any user that is a member of the custom group will be able to administer TSM.
Step 1: Create the new group
Create a new group on your computer. Do not change the permissions on the default group as created by Linux.
Step 2: Configure Tableau Server
The custom TSM administration group name is stored in the
tsm.authorized.groups configuration key. If you want to specify a group name (other than
tsmadmin) then you will need to update the
tsm.authorized.groups configuration key and then restart Tableau Server.
Use the tsm configuration set command to set the group name value. For example, to change the TSM administrative group name to
myadmingroup, run the following commands:
tsm configuration set -k tsm.authorized.groups -v myadmingroup
tsm pending-changes apply
- Setting the
tsm.authorized.groupsconfiguration key overwrites any existing value stored on that key.
- If you have users in the existing
tsmadmingroup, and you overwrite the
tsm.authorized.groupsconfiguration key with a new value, then the users in the existing
tsmadmingroup will no longer be authorized for TSM.
- You can specify multiple groups by entering a comma-separated list of group names as the value.
Step 3: Add users to the new group
After you finished setting
tsm.authorized.groups, any user in the new group(s) that you have specified will have full TSM administrative rights on Tableau Server.