Knowledge Center Contents Previous Next Index |
Managing Users and User Groups
Contents
- Viewing User and User Group Information
- About User Groups
- Existing User Groups as LSF User Groups
- LSF User Groups
Viewing User and User Group Information
You can display information about LSF users and user groups using the
busers
andbugroup
commands.The
busers
command displays information about users and user groups. The default is to display information about the user who invokes the command. Thebusers
command displays:
- Maximum number of jobs a user or group may execute on a single processor
- Maximum number of job slots a user or group may use in the cluster
- Maximum number of pending jobs a user or group may have in the system.
- Total number of job slots required by all submitted jobs of the user
- Number of job slots in the
PEND
,RUN
,SSUSP
, andUSUSP
statesThe
bugroup
command displays information about user groups and which users belong to each group.The
busers
andbugroup
commands have additional options. See thebusers(1)
andbugroup(1)
man pages for more details.
restriction:
The keywordall
is reserved by LSF. Ensure that no actual users are assigned the user name "all."View user information
- Run
busers all
.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 0View user pending job threshold information
- Run
busers -w
, which displays the pending job threshold column at the end of thebusers all
output.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 200000View user group information
- Run
bugroup
.bugroup
GROUP_NAME USERS testers user1 user2 engineers user3 user4 user10 user9 develop user4 user10 user11 user34 engineers/ system all usersView user share information
- Run
bugroup -l
, which displays user share group membership information in long format.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:
- Use existing user groups in the configuration files
- Create LSF-specific user groups
- Use an external executable to retrieve user group members
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 filegroup.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 timembatchd
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 interpretsadmin
as the name of the user, andadmin/
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:
USERS
inlsb.queues
for authorized queue usersUSER_NAME
inlsb.users
for user job slot limitsUSER_SHARES
(optional) inlsb.hosts
for host partitions or inlsb.queues
orlsb.users
for queue fairshare policiesLSF 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, usebusers
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:
USERS
inlsb.queues
for authorized queue usersUSER_NAME
inlsb.users
for user job slot limitsUSER_SHARES
(optional) inlsb.hosts
for host partitions or inlsb.queues
for queue fairshare policiesIf 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
- Log in as the LSF administrator to any host in the cluster.
- Open
lsb.users
.- If the
UserGroup
section does not exist, add it: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- Specify the group name under the
GROUP_NAME
column.External user groups must also be defined in the
egroup
executable.- Specify users in the
GROUP_MEMBER
column.For external user groups, put an exclamation mark (
!
) in theGROUP_MEMBER
column to tell LSF that the group members should be retrieved usingegroup
.- Optional: To enable hierarchical fairshare, specify share assignments in the
USER_SHARES
column.- Save your changes.
- Run
badmin ckconfig
to check the new user group definition. If any errors are reported, fix the problem and check the configuration again.- 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-specificegroup
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 thePlatform LSF Configuration Reference
.
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next Index |