Page History

...

managegroups.py is a script for remotely managing VCL user groups. It uses VCL's XML RPC API to provide an easy command line driven way of doing group management.

Download information

managegroups.py is not included in any official releases. You can download it from our subversion repository.

Download managegroups.py

Available Commands

Running managegroups.py with no arguments provides help on how to use it. It is used by specifying one of the following commands along with parameters specific to each command.

• addUserGroup #addUserGroup - creates a new user group
• getUserGroupAttributes #getUserGroupAttributes - gets information about a user group
• deleteUserGroup #deleteUserGroup - deletes a user group
• editUserGroup #editUserGroup - modifies attributes of a user group
• getUserGroupMembers #getUserGroupMembers - gets members of a user group
• addUsersToGroup #addUsersToGroup - adds users to a group
• removeUsersFromGroup #removeUsersFromGroup - removes users from a group
• emptyGroupMembership #emptyGroupMembership - removes all users currently in a group

...

• -u username - log in to VCL site with this user, must be in username@affiliation form
• -p "vclpass" - password used when logging in to VCL site, use quotes if it contains spaces
• -r vclurl - XMLRPC URL of VCL site (it will end with index.php?mode=xmlrpccall - i.e. https://vcl.ncsu.edu/scheduling/index.php?mode=xmlrpccall^{Image Removed})

Anchor
addUserGroup addUserGroup

addUserGroup

Use this command to create a new user group.

...

on success, returns:
SUCCESS: User group sucessfully created

Anchor
getUserGroupAttributes getUserGroupAttributes

getUserGroupAttributes

Use this command to get existing information about a user group's attributes (it does not include the current membership of the group).
parameters:

...

on success, returns:
SUCCESS: Attributes retreived
followed by:
owner: <user group owner>
managingGroup: <name of managing user group>
initialMaxTime: <max allowed initial reservation time>
totalMaxTime: <total allowed reservation time>
maxExtendTime: <make time allowed per extension>

Anchor
deleteUserGroup deleteUserGroup

deleteUserGroup

Use this command to delete an existing user group.
parameters:

...

on success, returns:
SUCCESS: User group sucessfully deleted

Anchor
editUserGroup editUserGroup

editUserGroup

Use this command to modify attributes of an existing user group (it is not used for editing the membership of the group). You can specify any combination of the parameters labeled as optional.
parameters:

...

on success, returns:
SUCCESS: User group sucessfully updated

Anchor
getUserGroupMembers getUserGroupMembers

getUserGroupMembers

Use this command to get the current members of a group. Note that it is possible for a group to have no members.
parameters:

...

on success, returns:
SUCCESS: Membership retrieved
followed by one user per line in username@affiliation form

Anchor
addUsersToGroup addUsersToGroup

addUsersToGroup

Use this command to add users to an existing user group. Note: The users will either need to already exist in VCL or be part of an affiliation that is backed by LDAP so that the users can be verified.
parameters:

...

on success, returns:
SUCCESS: Users sucessfully added to group

Anchor
removeUsersFromGroup removeUsersFromGroup

removeUsersFromGroup

Use this command to remove users from an existing user group.
parameters:

...

on success, returns:
SUCCESS: Users sucessfully removed from group

Anchor
emptyGroupMembership emptyGroupMembership

emptyGroupMembership

Use this command to empty the membership of an existing user group.
parameters:

...

on success, returns:
SUCCESS: Users sucessfully removed from group

Examples

The last example includes the authentication information on the command line. For the other examples, the authentication would have been specified inline in the script. Authentication information was only included in one example to make the others more readable.

Create a new user group with name FallUsers, affiliation Local, admin as the owner, and adminUsers@Local as the managing group:

managegroups.py -u admin@Local -p passwordhere -r 'https://your.vcl.site/index.php?mode=xmlrpccall' addUserGroup -n FallUsers -a Local -o admin@Local -m adminUsers@Local -i 240 -t 360 -x 30

...

managegroups.py -u admin@Local -p passwordhere -r 'https://your.vcl.site/index.php?mode=xmlrpccall' editUserGroup -n FallUsers -a Local -N SpringUsers

...

managegroups.py -u admin@Local -p passwordhere -r 'https://your.vcl.site/index.php?mode=xmlrpccall' addUsersToGroup -n FallUsers -a Local -l student1<at:var at:name="Local,student2" />Local

...

managegroups.py -u admin@Local -p passwordhere -r 'https://your.vcl.site/index.php?mode=xmlrpccall' addUsersToGroup -n FallUsers -a Local -f newusers.txt

...

managegroups.py -u admin@Local -p passwordhere -r 'https://your.vcl.site/index.php?mode=xmlrpccall' emptyGroupMembership -n CS101 -a Local

...