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

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

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

OPTIONS
     enable
          Enables the Service Tags support for Sun  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 Sun 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 Sun Grid Engine administra-
          tor, 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 Sun 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  iden-
     tifier  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 environ-
     mental 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
     SGE_ROOT       Specifies the location of the Sun Grid Engine
                    standard configuration files.

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

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

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

SEE ALSO
     sge_qmaster(8).

COPYRIGHT
     See sge_intro(1)