Updated on 2024-09-23 GMT+08:00

Creating an MRS Cluster User

By default, only user admin has the highest operation permissions of Manager. Administrators need to create users on Manager and assign operation permissions to the users based on service requirements.

The FusionInsight Manager of an MRS 3.x or later cluster supports a maximum of 50000 users (including built-in users).

The MRS Manager of an MRS 2.x or earlier cluster supports a maximum of 1000 users.

Creating a User (MRS 3.x and Later)

  1. Log in to FusionInsight Manager.
  2. Choose System > Permission > User.
  3. On the User page, click Create.
  4. Set Username. The username can contain digits, letters, underscores (_), hyphens (-), and spaces. It is case-insensitive and cannot be the same as any existing username in the system or OS.
  5. Set User Type to Human-Machine or Machine-Machine.

    • Human-Machine user: used for FusionInsight Manager O&M and component client operations. If you select this option, you also need to select the password policy and set Password and Confirm Password.
    • Machine-Machine user: used for component application development. If you select this option, the password is randomly generated.

  6. In the User Group area, click Add to add one or more user groups to the list.

    • If the selected user group has been bound to a role or a permission policy has been configured in Ranger, the user can obtain the corresponding permissions.
    • After FusionInsight Manager is installed, some user groups generated by default have special permissions. Select desired user groups based on the descriptions on the UI.
    • If existing user groups cannot meet your requirements, click Create User Group to create a user group. For details, see Creating a User Group.

  7. Select a group from the Primary Group drop-down list to create directories and files.

    The drop-down list contains all groups selected in User Group.

    A user can belong to multiple groups (including the primary group and secondary groups). The primary group is set to facilitate maintenance and comply with the permission mechanism of the Hadoop community. The primary group has the same permission control functionality as other groups.

  8. In the Role area, click Add to bind roles to the user.

    • Adding a role when you create a user can specify the user permissions.
    • If the permissions granted to the user from the user group cannot meet service requirements, you can bind other created roles to the user. You can also click Create Role to create a role first. For details, see Creating a Role.

      It takes 3 minutes to make role permission assignment to the user take effect. If the permissions obtained from the user group are enough, you do not need to add a role.

    • After Ranger authentication is enabled for a component, you need to configure Ranger policies to assign permissions to the user except the permissions of default user group or role.
    • If a user is not added to a user group or assigned a role, the user cannot view information or perform operations after logging in to FusionInsight Manager.

  9. Enter information in Description.
  10. Click OK.

    After a human-machine user is created, you need to change the initial password as prompted after logging in to FusionInsight Manager.

Creating a User (MRS 2.x and Earlier)

  1. On MRS Manager, click System.
  2. In the Permission area, click Manage User.
  3. On the User page, click Create.
  4. Configure parameters as prompted and enter a username in Username.

    • A username that differs only in alphabetic case from an existing username is not allowed. For example, if User1 has been created, you cannot create user1.
    • When you use the user you created, enter the exactly correct username, which is case-sensitive.
    • Username is mandatory and contains 3 to 20 characters. Only digits, letters, and underscores (_) are allowed.
    • root, omm, and ommdba are reserved system user. Select another username.

  5. Set User Type to Human-Machine or Machine-Machine.

    • Human-machine user: used for MRS Manager O&M scenarios and component client operation scenarios. If you select this user type, you need to enter a password and confirm the password in Password and Confirm Password accordingly.
    • Machine-machine users: used for MRS application development scenarios. If you select this user type, you do not need to enter a password, because the password is randomly generated.

  6. In User Group, click Select and Join User Group to select user groups and add users to them.

    • If roles have been added to user groups, the users can be granted with permissions of the roles.
    • If you want to grant new users with Hive permissions, add the users to the Hive group.
    • If a user needs to manage tenant resources, the user group must be assigned the Manager_tenant role and the role corresponding to the tenant.

  7. In Primary Group, select a group as the primary group for users to create directories and files. The drop-down list contains all groups selected in User Group.
  8. In Assign Rights by Role, click Select and Add Role to add roles for users based on onsite service requirements.

    • If the permissions granted to the user from the user group cannot meet service requirements, you can bind other created roles to the user. It takes 3 minutes to make role permissions granted to the new user take effect.
    • Adding a role when you create a user can specify the user permissions.
    • A new user can access web UIs of HDFS, HBase, Yarn, Spark, and Hue even when roles are not assigned to the user.

  9. In Description, provide description based on onsite service requirements.

    Description is optional.

  10. Click OK.

    If a new user is used in the MRS cluster for the first time, for example, used for logging in to MRS Manager or using the cluster client, the password must be changed.