Knowledge Center         Contents    Previous  Next    Index  
Platform Computing Corp.

Managing Users and User Groups

Contents

Viewing User and User Group Information

You can display information about LSF users and user groups using the busers and bugroup commands.

The busers command displays information about users and user groups. The default is to display information about the user who invokes the command. The busers command displays:

The bugroup command displays information about user groups and which users belong to each group.

The busers and bugroup commands have additional options. See the busers(1) and bugroup(1) man pages for more details.

restriction:  
The keyword all is reserved by LSF. Ensure that no actual users are assigned the user name "all."

View user information

  1. Run busers all.
  2. busers all
    USER/GROUP  JL/P  MAX  NJOBS  PEND  RUN   SSUSP  USUSP  RSV
    default       12    -      -     -    -       -      -    -
    user9          1   12     34    22   10       2      0    0
    groupA         -  100     20     7   11       1      1    0 
    

View user pending job threshold information

  1. Run busers -w, which displays the pending job threshold column at the end of the busers all output.
  2. busers -w
    USER/GROUP  JL/P  MAX  NJOBS  PEND  RUN   SSUSP  USUSP  RSV   MPEND
    default       12    -      -     -    -       -      -    -      10
    user9          1   12     34    22   10       2      0    0     500
    groupA         -  100     20     7   11       1      1    0  200000 
    

View user group information

  1. Run bugroup.
  2. bugroup
    GROUP_NAME           USERS
    testers              user1 user2 
    engineers            user3 user4 user10 user9
    develop              user4 user10 user11 user34 engineers/
    system               all users 
    

View user share information

  1. Run bugroup -l, which displays user share group membership information in long format.
  2. bugroup -l
    GROUP_NAME:  testers   
    USERS:       user1 user2 
    SHARES:      [user1, 4] [others, 10] 
    
    GROUP_NAME:  engineers   
    USERS:       user3 user4 user10 user9 
    SHARES:      [others, 10] [user9, 4] 
    
    GROUP_NAME:  system 
    USERS:       all users
    SHARES:      [user9, 10] [others, 15] 
    
    GROUP_NAME:  develop   
    USERS:       user4 user10 user11 engineers/ 
    SHARES:      [engineers, 40] [user4, 15] [user10, 34] [user11, 
    16] 
    

About User Groups

User groups act as aliases for lists of users. The administrator can also limit the total number of running jobs belonging to a user or a group of users.

You can define user groups in LSF in several ways:

If desired, you can use all three methods, provided the user and group names are different.

Existing User Groups as LSF User Groups

User groups already defined in your operating system often reflect existing organizational relationships among users. It is natural to control computer resource access using these existing groups.

You can specify existing UNIX user groups anywhere an LSF user group can be specified.

How LSF recognizes UNIX user groups

Only group members listed in the /etc/group file or the file group.byname NIS map are accepted. The user's primary group as defined in the /etc/passwd file is ignored.

The first time you specify a UNIX user group, LSF automatically creates an LSF user group with that name, and the group membership is retrieved by getgrnam(3) on the master host at the time mbatchd starts. The membership of the group might be different from the one on another host. Once the LSF user group is created, the corresponding UNIX user group might change, but the membership of the LSF user group is not updated until you reconfigure LSF (badmin). To specify a UNIX user group that has the same name as a user, use a slash (/) immediately after the group name: group_name/.

Requirements

UNIX group definitions referenced by LSF configuration files must be uniform across all hosts in the cluster. Unexpected results can occur if the UNIX group definitions are not homogeneous across machines.

How LSF resolves users and user groups with the same name

If an individual user and a user group have the same name, LSF assumes that the name refers to the individual user. To specify the group name, append a slash (/) to the group name.

For example, if you have both a user and a group named admin on your system, LSF interprets admin as the name of the user, and admin/ as the name of the group.

Where to use existing user groups

Existing user groups can be used in defining the following parameters in LSF configuration files:

LSF User Groups

You can define an LSF user group within LSF or use an external executable to retrieve user group members.

Use bugroup to view user groups and members, use busers to view all users in the cluster.

Where to use LSF user groups

LSF user groups can be used in defining the following parameters in LSF configuration files:

If you are using existing OS-level user groups instead of LSF-specific user groups, you can also specify the names of these groups in the files mentioned above.

Configure user groups

  1. Log in as the LSF administrator to any host in the cluster.
  2. Open lsb.users.
  3. If the UserGroup section does not exist, add it:
  4. Begin UserGroup
    GROUP_NAME      GROUP_MEMBER            USER_SHARES
    financial       (user1 user2 user3)     ([user1, 4] [others, 
    10])
    system          (all)                   ([user2, 10] [others, 
    15])
    regular_users   (user1 user2 user3 user4) -
    part_time_users (!)                       -
    End UserGroup 
    
  5. Specify the group name under the GROUP_NAME column.
  6. External user groups must also be defined in the egroup executable.

  7. Specify users in the GROUP_MEMBER column.
  8. For external user groups, put an exclamation mark (!) in the GROUP_MEMBER column to tell LSF that the group members should be retrieved using egroup.

  9. Optional: To enable hierarchical fairshare, specify share assignments in the USER_SHARES column.
  10. Save your changes.
  11. Run badmin ckconfig to check the new user group definition. If any errors are reported, fix the problem and check the configuration again.
  12. Run badmin reconfig to reconfigure the cluster.

Importing external user groups (egroup)

When the membership of a user group changes frequently, or when the group contains a large number of members, you can use an external executable called egroup to retrieve a list of members rather than having to configure the group membership manually. You can write a site-specific egroup executable that retrieves user group names and the users that belong to each group. For information about how to use the external host and user groups feature, see the Platform LSF Configuration Reference.


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next    Index