Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

6.7. Setting Gear Quotas and Sizes for Specific Users

Use the oo-admin-ctl-user command to set individual user gear parameters to limit the number of gears a user is allowed, and change user access to gear sizes.
On the broker host, display gear information for a user with the following command. Replace username with the relevant user name: 
# oo-admin-ctl-user -l username
Copy to clipboard

Example 6.9. 

# oo-admin-ctl-user -l user

User user:
   consumed gears: 3
   max gears: 100
   gear sizes: small
Copy to clipboard
On the broker host, limit the number of gears a user is allowed with the following command. Replace username with the relevant user name and 101 with the desired number of gears: 
# oo-admin-ctl-user -l username --setmaxgears 101
Copy to clipboard

Example 6.10. Limiting a User's Number of Gears

# oo-admin-ctl-user -l user --setmaxgears 101
Setting max_gears to 101... Done.

User user:
   consumed gears: 3
   max gears: 101
   gear sizes: small
Copy to clipboard
On the broker host, add a gear size for a user with the following command. Replace username with the relevant user name and medium with the desired gear size: 
# oo-admin-ctl-user -l username --addgearsize medium
Copy to clipboard

Example 6.11. Enabling a Gear Size For a User

# oo-admin-ctl-user -l user --addgearsize medium
Adding gear size medium for user user... Done.

User user:
   consumed gears: 3
   max gears: 101
   gear sizes: small, medium
Copy to clipboard
On the broker host, remove a gear size from a user with the following command. Replace username with the relevant user name and medium with the desired gear size: 
# oo-admin-ctl-user -l username --removegearsize medium
Copy to clipboard

Example 6.12. Removing a Gear Size For a User

# oo-admin-ctl-user -l user --removegearsize medium
Removing gear size medium for user user... Done.

User user:
   consumed gears: 3
   max gears: 101
   gear sizes: small
Copy to clipboard
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.