Configuring local user groups by using the command line

You can configure local user groups by using the command line interface.

About this task

To configure a local user group from the command line, you enter user group configuration mode, specifying the name of the user group that you want to configure, and enter the required user group configuration commands. You define the local users in a separate procedure, see Configuring local user groups by using the command line

Note: If you use messaging users and groups on the appliance for authentication records in an HA queue manager, you must set up the same messaging users and groups on all appliances in the HA group. The users and groups are not automatically replicated between the appliances.

Procedure

  1. Connect to the IBM® MQ Appliance as described in Command line access. Log in as an administrative user.
  2. Type config to enter global configuration mode.
  3. Type the following command to configure a local user group:
    usergroup name
    
    Where name identifies the user group that you want to configure. If you are creating a new user group, name can contain up to 128 characters. The following characters are valid:
    • a through z
    • A through Z
    • 0 through 9
    • Underscore (_)
    • Dash (-)
    • Period (.) (note that a name that comprises a single period, or including two periods together, is not permitted)
  4. Set the access policy for the user group:
    access-policy statement
    Where statement defines the access policy that applies to users who belong to this group. A policy statement takes the form:
    address/domain/resource?[Name=name]&Access=permission [&field=value]
    address

    An IP address or host alias for a local interface (Ethernet or VLAN) on the appliance. The special value * matches all appliance addresses.

    domain
    Enter * to match all domains.
    resource

    The resource type to which this policy applies. The special value * matches all resource types.

    Name=name
    Optionally Identifies by name an instance of the specified resource type. You can use a PCRE; for example, foo.* to specify all resources that start with foo.
    Access=permission
    The permission string assigns permissions. The string is cumulative and connected by plus (+) signs. For example, the string a+d+x+r+w represents add, delete, execute, read, and write permissions.
    field=value
    Optional: the field token must be one of the additional fields that can be added to the string. The corresponding value can be a PCRE.
  5. After you configure the user group, enter exit to save the configuration and exit, or type cancel to exit without saving.