Appendix A. Utilities
A.1. Domain Management Tool
internalthat is only used to store the
adminuser. To add and remove other users from the system, you must first add the directory services in which they are found.
rhsc-manage-domains, to add and remove domains provided by this service. In this way, you can grant access to the Red Hat Gluster Storage environment to users stored across multiple domains.
rhsc-manage-domainscommand on the machine on which Red Hat Gluster Storage Console was installed. The
rhsc-manage-domainscommand must be run as the root user.
# rhsc-manage-domains action [options]
- Add a domain to the console directory services configuration.
- Edit a domain in the console directory services configuration.
- Delete a domain from the console directory services configuration.
- Validate the console directory services configuration. The command attempts to authenticate to each domain in the configuration using the configured user name and password.
- List the current directory services configuration of the console.
- Specifies the domain on which the action must be performed. The
--domainparameter is mandatory for
- Specifies the domain user to use. The
--userparameter is mandatory for
add, and optional for
- A file containing the password. If this is not set, the password is read interactively.
- Specifies an alternative configuration file that the command must load. The
--config-fileparameter is always optional.
- Specifies that all validation errors encountered while performing the validate action will be reported in full.
rhsc-manage-domainscommand help output:
# rhsc-manage-domains --help
A.1.2. Listing Domains in Configuration
Example A.1. rhsc-manage-domains List Action
# rhsc-manage-domains list Domain: directory.demo.redhat.com User name: admin@DIRECTORY.DEMO.REDHAT.COM This domain is a remote domain.
A.1.3. Adding Domains to Configuration
Example A.2. rhsc-manage-domains Add Action
# rhsc-manage-domains add --domain=directory.demo.redhat.com --provider=IPA --user=admin loaded template kr5.conf file setting default_tkt_enctypes setting realms setting domain realm success User guid is: 80b71bae-98a1-11e0-8f20-525400866c73 Successfully added domain directory.demo.redhat.com. oVirt Engine restart is required in order for the changes to take place (service ovirt-engine restart).
A.1.4. Editing a Domain in the Configuration
Example A.3. rhsc-manage-domains Edit Action
# rhsc-manage-domains edit --domain=directory.demo.redhat.com --user=admin loaded template kr5.conf file setting default_tkt_enctypes setting realms setting domain realmo success User guide is: 80b71bae-98a1-11e0-8f20-525400866c73 Successfully edited domain directory.demo.redhat.com. oVirt Engine restart is required in order for the changes to take place (service ovirt-engine restart).
A.1.5. Validating Domain Configuration
Example A.4. rhsc-manage-domains Validate Action
# rhsc-manage-domains validate User guide is: 80b71bae-98a1-11e0-8f20-525400866c73 Domain directory.demo.redhat.com is valid.
A.1.6. Deleting a Domain from the Configuration
Example A.5. rhsc-manage-domains Delete Action
# rhsc-manage-domains delete --domain=directory.demo.redhat.com WARNING: Domain directory.demo.redhat.com is the last domain in the configuration. After deleting it you will have to either add another domain, or to use the internal admin user in order to login. Successfully deleted domain directory.demo.redhat.com. Please remove all users and groups of this domain using the Administration portal or the API.