SGE_ST(8)

NAME
util/sgeST/sge_st - Grid Engine Service Tags Support control command

SYNOPSIS
sge_st enable | disable | register | unregister | check | enabled | supported | help

DESCRIPTION

sge_st controls the Grid Engine support for Service Tags. A Service Tag support improve the monitoring of usages of the Grid Engine.

OPTIONS

enable
    Enables the Service Tags support for Grid Engine. If the Service Tags packages are installed on the host, the presence of the product instance service tag is checked in every start of the qmaster daemon.

disable
    Disables the Service Tags support for Grid Engine.

register
    Create the product instance service tag.

unregister
    Remove the product instance service tag.

check
    Checks the status of the product instance service tag. If not registered, the option returns "unregistered". If registered, the option returns "registered:<product_instance_urn>"

enabled
    Check the status of the service tags support. If the service tags are enabled by Grid Engine administrator, the option returns "true", otherwise "false".

supported
    Checks if the Service Tags are supported on this host. This option validates the presence of the Service Tags packages on the host and checks if they are correctly installed. If Service Tags are supported on this host, the option return a word "true", otherwise "false".

The Service Tags Support
Service Tags enables automatic discovery of systems, software and services. A service tag uniquely identifies each tagged asset, and allows the asset information to be shared over a local network in a standard XML format.

The Grid Engine can create a service tag for one cluster installation. A service tag entry is stored in the Service Tag registry. Each service tag has an unique instance identifier which is generated when the record is added to the registry. This identifier is used as the key when accessing the record.

The discoverer and listener services installed together with Service Tags on a host. They provide a way to discover a service tags via the network. The discoverer is a UDP-based application which exists to provide information about the listener. The listener is a TCP-based application which provides a way to gather service tag and associated environmental information.

The discoverer service is used by operating system upgrade or register tools to send the service tags data to SUN. There is no other way, how to propagate the collected data to SUN than through the registration tool. The data to be send can be inspected and accepted. The Service Tags Data is going to be analyzed.

ENVIRONMENTAL VARIABLES

GE_ROOT
    Specifies the location of the Grid Engine standard configuration files.

GE_CELL
    If set, specifies the default Grid Engine cell. To address a Grid Engine cell

RESTRICTIONS
sge_st The command must be called with Grid Engine admin rights or root permissions.

FILES
sge_st creates a st.enabled file in GE_CELL\common directory. If available, the file contains the product related urn key. This key will be used for upgrading purposes.
<ge_root>/<cell>/common/st.enabled
	Grid Engine Service Tags Support enabling indicator

SEE ALSO

COPYRIGHT
See for a full statement of rights and permissions.