Index for Section 8

Alphabetical listing for C

Bottom of page

caa_register(8)
NAME
  caa_register - Registers a resource with Cluster Application Availability
  (CAA)

SYNOPSIS
  /usr/sbin/caa_register resource_name [...] [-u] [-q]

PARAMETER
  resource_name [...]
      Name(s) (as specified in a resource profile) of one or more resources
      to be registered.	 A profile must exist for the resource you are
      registering.

OPTIONS
  [-u]
      Update existing binary CAA database registry entries with the latest
      resource profile information for resource names listed as parameters.
      Use caa_register -u immediately after a caa_profile -update or a manual
      edit of a resource profile to ensure that the changes take place
      immediately.

  [-q]
      Runs the caa_register command in quiet mode; no messages are displayed
      on the console.

DESCRIPTION
  The caa_register command registers the resource(s) specified with the
  resource_name parameter(s).  A resource must be registered in order for the
  caad daemon to monitor the resource or to start, restart, or relocate a
  highly available application associated with an application resource. A
  resource registration must be updated for any changes to a resource profile
  to take effect.

  A resource can be registered with CAA if it is not currently registered, or
  updated if it currently is registered. A resource can be registered or
  updated with CAA only if the CAA daemon is active, and a CAA resource
  profile exists in the /var/cluster/caa/profile directory for this resource.
  A resource profile assigns values to attributes that define how a resource
  should be managed or monitored in a cluster.

  If a profile has an invalid attribute value, the caa_register command
  displays an error and the profile is not registered or updated.

  If fields are missing from a resource profile, the profile is merged with
  the default profile for the resource type and the values in the default
  profile are used in the CAA registry database.

  You must have root privileges to use this command.

EXAMPLE
  The following example registers with CAA a resource named xclock for which
  a resource profile exists in the /var/cluster/caa/profile directory:

       /usr/sbin/caa_register xclock

EXIT VALUES
  The following exit values are returned:

  0   Successful completion.

  non-zero
      A failure has occurred.

      A corresponding text message will be given for the following error
      conditions:

      No root privilege.

      CAA daemon is not running.

      Resource specified on the command line does not match resource
      specified in the profile file.

      Resource is already registered with the CAA daemon.

      Resource type cannot be updated.

SEE ALSO
  Commands:  caa_stat(1), caa_profile(8), caa_relocate(8), caa_start(8),
  caa_stop(8), caa_unregister(8)

  Daemon:  caad(8)

  TruCluster Server Cluster Administration

Index for Section 8

Alphabetical listing for C

Top of page