Next / Previous / Contents / TCC Help System / NM Tech homepage

11.5.   The account manager, acctmngr

The acctmngr command provides a single interface for manipulating user accounts.

Note

You must connect to the userhost server via ssh to use this command. You must also run it inside ucsh.

Important

User Consultants should only create accounts for students (undergrad (U), grad (G), or special (Sp)). Direct anybody else to the TCC office upstairs in Speare 117.

If you are using acctmngr to make changes requested by a person be sure to see a photo ID to verify the account owner's identity. As some people insist on looking at your screen you want to do this even before running the -s option as the resulting display will reveal some personal information.

Where an ID number is to be entered be sure to use the person's Banner ID.

Options to this command are shown below. Each option has two forms, a short form starting with a single hyphen, and a long form starting with two hyphens. You may use either form. For example, you could close an account named manson with either “acctmngr -c manson” or “acctmngr --close manson”.

-a --add student_id

Create an account.

-ag --add-group username group

Add a user to a group.

-ah --add-host username hostname

Add host access to an account.

-an --add-note username Note

Add a note to an account.

-ar --ar-number student_id

Modify an account number.

-c --close username

Close an account. A closed account may still be reopened.

-cs --change-shell username shell

Change a user's default shell. When specifying the shell use it's fully qualified path (i.e. /bin/csh).

-cu --change-username username new_username

Change the name of an account.

-d --delete username

Delete an account. Be very careful using this command; it is not reversible.

-dg --delete-group username group

Delete a user from a group.

-dh --delete-host username hostname

Delete host access from an account.

-dn --delete-note username note_number

Delete a note to an account.

-dm --disable_modem username [comment]

Disable modem access for an account. Use the optional comment to record notes about why, if any.

-dv --disable-vpn username [Note]

Disable VPN access for an account.

-e --enable username [comment]

Enable an existing account (e.g., after it has been closed).

Note

This command is usually only used to change a user's shell from a non-functional one (such as the initial shell of the new accounts program or the shell given to revoked accounts) to a functional one. If a user simply wishes to change their shell, they may issue the chsh command themselves.

-em --enable_modem username [comment]

Enable modem access for an account.

-ev --enable-vpn username

Enable VPN access for an account.

-f --file filename

Create accounts using a specially formatted flat file as input.

-p --password username

Set a user's password.

-q --quota username size

Set a users' quota information (size is in megabytes).

-r --revoke username [comment]

Revoke an account.

Important

See the section on revoking an account in the Restricted Handbook for details of account revocation before using this command.

-s --status username

Display the status of an account. Will show email quota and other useful things.

-t --type username

Modify the account type.