streamtool getrestrictedconfig
The streamtool getrestrictedconfig command displays restricted or sensitive configuration settings for a domain or instance.
Usage
getrestrictedconfig >>-+-----------------------+------------------------------------> '-+- -d----------+--did-' '- --domain-id-' >--+------------------------------+--+---------------------+----> '-+- -i------------+--instance-' '-+- -U-----+--userid-' '- --instance-id-' '- --User-' >--+---------+--+-----------------+-----------------------------> +- -h-----+ '- --trace--level-' '- --help-' >--+-----------------------+------------------------------------> '-+- -v--------+--level-' '- --verbose-' >--| Non-interactive tool options |--+-------------------+----->< | .-,-------------. | | V | | '---property-name-+-' Non-interactive tool options (1) |--------+-----------------------------+------------------------| +- --embeddedzk---------------+ | .-,---------. | | V | | '- --zkconnect----host:port-+-'
- The non-interactive tool options are not supported in the interactive streamtool interface.
Authority
You must have read authority for the application configuration security element. By default, the DomainAdministrator role for domains and the InstanceAdministrator role for instances have this authority. For more information about access control lists, see streamtool getacl.
Description
Use this command to view restricted or sensitive information for a domain or instance, such as connection information for a password-protected database. This information can be accessed by an application, but only a domain administrator (for domain information) or instance administrator (for instance information) can access or modify these settings by using the streamtool command.
By default, the settings are displayed for all properties. To view the settings for one or more specific properties, specify the properties with the property-name option.
Options and arguments
- -d, --domain-id did
Specifies the domain identifier.
If you do not specify this option, IBM® Streams uses the domain name that is set in the STREAMS_DOMAIN_ID environment variable. By default, that domain name is StreamsDomain. If you are using the interactive streamtool interface, it uses the name of the active domain for the current streamtool session or else it prompts you for the domain name.
The active domain for the current streamtool session is set every time that you successfully run a streamtool command with a -d or --domain-id option. Alternatively, you can run the streamtool domain command in the interactive interface.
- -h, --help
Specifies to show the command syntax.
- -i, --instance
Specifies the instance identifier.
If you do not specify this option, IBM Streams runs the command by using the current domain settings.
- property-name
Specifies the name of a property.
- --trace level
Specifies the trace setting. The following valid levels are listed in order of increasing verbosity, which is to say that the first level in the list generates the least amount of information:
- off
- error
- warn
- info
- debug
- trace
- -U, --User userid
Specifies an IBM Streams user ID that has authority to run the command.
- -v,--verbose level
Specifies to provide more detailed command output. The verbosity level can be 0-3, where 0 disables detailed reporting and each increment provides more detailed output.