epadmin-services

epadmin services target — Displays, browses, and verifies the StreamBase Runtime service environment.

SYNOPSIS

epadmin [globalparameters] command services [commandparameters]

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 [sn|ad] in syntax examples is a reminder that this command requires either the global parameter ‑‑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 terminate 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 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 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.