epadmin-services
epadmin services target — Displays, browses, and verifies the StreamBase Runtime service environment.
DESCRIPTION
Use the services target to see the overall view of nodes, clusters, and services running on the current subnet.
The services target has three commands:
The designation [ in syntax examples is a reminder that this
command requires either the global parameter sn|ad]‑‑servicename or the ‑‑adminport and
‑‑hostname combination to identify the node or cluster
of interest.
epadmin browse services
Browses for services. The browse command does not exit. It continues to look for new services on the network until you explicitly stop it with an interrupt. New services are displayed when discovered.
epadmin browse services --servicetype=node epadmin browse services --servicename=X epadmin browse services --interval=1 --iterations=10 epadmin browse services --showproperty=NodeState epadmin browse services --detailed epadmin browse services --properties="property1=value1,property2=value2"
| Command Parameter | Description | Required |
|---|---|---|
servicetype
|
Browse for this service type. | No. The default is to show all service types. |
servicename
|
Browse for this service name. | No. The default is to show all discovered services. |
interval
|
The number of seconds to wait between service discovery broadcasts while browsing. | No. The default is ten seconds. |
iterations
|
The number of browse operations to perform before exiting. | No. The default is to browse until interrupted. |
detailed
|
A boolean value controlling detailed output. Cannot be used with the
showproperty parameter.
|
No. The default is false.
|
showproperty
|
Displays a specific property for a service if that property is set.
Property names are shown in the detailed
output. Cannot be used at the same time as the detailed parameter.*
|
No. No default value. |
properties
|
Comma-separated list of name-value pairs used to filter returned
services.*
|
No. The default value is an empty list. |
| *Service properties are described in Service Types in the Architecture Guide. | ||
epadmin display services
Displays properties of StreamBase Runtime services on the current subnet.
epadmin display services epadmin display services --servicename=X epadmin display services --detailed epadmin display services --showproperty=NodeState epadmin display services --properties="NodeState=running,property2=value2"
| Command Parameter | Description | Required |
|---|---|---|
servicetype
|
Service type to discover. | No. The default is to show all service types. |
servicename
|
Service name to discover. | No. The default is to show all discovered services. |
detailed
|
A boolean value controlling detailed output. Cannot be used with the
showproperty parameter.
|
No. The default is false.
|
showproperty
|
Displays a specific property for a service if property set. Cannot be used
with the detailed parameter.
|
No. No default value. |
properties
|
Comma-separated list of name-value pairs used to filter returned
services.
|
No. The default value is an empty list. |
| *Service properties are described in Service Types in the Architecture Guide. | ||
epadmin verify services
Verifies that the StreamBase Runtime discovery service is working correctly.
epadmin verify services
epadmin verify services --mode=verification-mode
| Command Parameter | Description | Required |
|---|---|---|
mode
|
Discovery verification mode. May be one of server (starts a discovery server), client (sends a discovery request), or clientserver (performs both functions).
|
No. The default value is clientserver.
|
Note
Use the --debug global parameter to add discovery service debug tracing to the output of this command.