SGE_ST(8)

NAME
util/sgeST/sge_st - xxQS_NAMExx Service Tags Support control command

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

DESCRIPTION

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

OPTIONS

enable
    Enables the Service Tags support for xxQS_NAMExx. 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 xxQS_NAMExx.

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 xxQS_NAMExx 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 xxQS_NAMExx 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

xxQS_NAME_Sxx_ROOT
    Specifies the location of the xxQS_NAMExx standard configuration files.

xxQS_NAME_Sxx_CELL
    If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExx cell

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

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

SEE ALSO

COPYRIGHT
See for a full statement of rights and permissions.