sctelemetry

- initialize system resource monitoring

Synopsis

sctelemetry -d

sctelemetry -e

sctelemetry -i -o hasp_rg=rg,hasp_rs=rs [,hasp_mnt_pt=mnt_pt] [,db_rg=rg] [,db_rs=rs] 

[,telemetry_rg=rg] [,telemetry_rs=rs]

sctelemetry -i -o hasp_mnt_pt=mnt_pt,hasp_nodelist=node[:…] [,hasp_rs=rs] [,db_rg=rg] 

[,db_rs=rs] [,telemetry_rg=rg,telemetry_rs=rs]

sctelemetry -u

Description

The sctelemetry command initializes system resource monitoring, brings monitoring online, and takes it offline. When initializing, use the -o option with the hasp_rg=rg,hasp_rs=rs parameters to rely on an existing resource of type SUNW.HAStoragePlus. Use the -o option with the hasp_mnt_pt=mnt_pt,hasp_nodelist=node[:,...]parameters to have the sctelemetry command create a resource of type SUNW.HAStoragePlus. For more information about the resource types, see the SUNW.derby(5), SUNW.HAStoragePlus(5), and SUNW.SCTelemetry(5) man pages.

SUNW.SCTelemetry is instantiated in a multi-master resource group, that is the resource group is configured on all cluster nodes and does not use network load balancing.

You can use this command only in the global zone.

Options

The options for sctelemetry are as follows:

-d

Disables the collection of system resource usage data and the database in which telemetry data is stored.

You can use this option only in the global zone.

Users other than superuser require solaris.cluster.system.modify RBAC authorization to use the -d option of sctelemetry. For more information, see the rbac(5) man page.

-e

Brings collection of system resource usage data online. By default, system resource monitoring is online when you use the -i option of the sctelemetry command.

You can use this option only in the global zone.

Users other than superuser require solaris.cluster.system.modify RBAC authorization to use the -e option of sctelemetry. For more information, see the rbac(5) man page.

-i

Creates resource groups containing resources of type SUNW.SCTelemetry and SUNW.derby. By default, when you create these resources and resource groups by using the -i option, system resource monitoring is online.

You can use this option only in the global zone.

Users other than superuser require solaris.cluster.system.modify RBAC authorization to use the -i option of sctelemetry. For more information, see the rbac(5) man page.

-o hasp_rg=rg,hasp_rs=rs[,hasp_mnt_pt=mnt_pt][,db_rg=rg][,db_rs=rs][,telemetry_rg=rg][ ,telemetry_rs=rs]

When used with the -i option, identifies the resource of type SUNW.HAStoragePlus to be used by the database and the resource group that contains this resource. The data collection facility must have access to a file system for SUNW.HAStoragePlus.

The parameters are as follows:

hasp_rg=rg

The resource group that contains the resource of type SUNW.HAStoragePlus that is used for system resource monitoring. You must specify rg, the name of this resource group.

hasp_rs=rs

The resource of type SUNW.HAStoragePlus that is used for system resource monitoring. You must specify rs, the name of this resource.

hasp_mnt_pt=mnt_pt

The mount point on which sctelemetry stores database files for system resource monitoring. This mount point must be a property of the resource, hasp_rs. Specifying this mount point is obligatory if there is more than one mount point in hasp_rs.

db_rg=rg

The resource group in which sctelemetry configures the resource of type SUNW.derby. You can specify rg, the name of this resource group.

db_rs=rs

The resource of type SUNW.derby that sctelemetry configures. You can specify rs, the name of this resource.

telemetry_rg=rg

The resource group in which sctelemetry configures a resource of type SUNW.SCTelemetry. You can specify rg, the name of this resource group.

telemetry_rs=rs

The resource of type SUNW.SCTelemetry that sctelemetry configures. You can specify rs, the name of this resource.

-o hasp_mnt_pt=mnt_pt,hasp_nodelist=node[:...][,hasp_rs=rs][,db_rg=rg][,db_rs=rs]\[,telemetry_rg=rg][,telemetry_rs=rs]

When used with the -i option, specifies the nodes on which the SUNW.HAStoragePlus file system for data collection is accessible and specifies the mount point for the file system in which Oracle Solaris Cluster stores system resource data.

The parameters are as follows:

hasp_mnt_pt=mnt_pt

The mount point that sctelemetry uses to configure a resource of type SUNW.HAStoragePlus. You must specify mnt_pt, the name of the mount point. The shared storage must be configured before the HAStoragePlus resource to be created. This mount point refers to the shared storage and must appear in /etc/vfstab as follows:

/dev/md/ddg/dsk/d20 /dev/md/ddg/rdsk/d20    \

/mntpt ufs     2       no logging

hasp_nodelist=node[:...]

The nodes with which sctelemetry configures a resource of type SUNW.HAStoragePlus. You must specify node:[...], the name of the nodes.

hasp_rs=rs

The resource of type SUNW.HAStoragePlus that sctelemetry configures. You can specify rs, the name of this resource.

db_rg=rg

The resource group in which sctelemetry configures a resource of type SUNW.derby. You can specify rg, the name of this resource group.

db_rs=rs

The resource of type SUNW.derby that sctelemetry configures. You can specify rs, the name of this resource.

telemetry_rg=rg

The resource group in which sctelemetry configures a resource of type SUNW.SCTelemetry. You can specify rg, the name of this resource group.

telemetry_rs=rs

The resource of type SUNW.SCTelemetry that sctelemetry configures. You can specify rs, the name of this resource.

-u

Removes the resources and resource groups that were previously created by using the -i option.

You can use this option only in the global zone.

Users other than superuser require solaris.cluster.system.modify RBAC authorization to use the -u option of the sctelemetry command. For more information, see the rbac(5) man page.

Examples

Initializing System-Resource Monitoring, When a HAStoragePlus Resource Exists

This example initializes system-resource monitoring and verifies that monitoring has been initialized. This example assumes that you have a SUNW.HAStoragePlus resource available for system-resource monitoring.

This example does not specify the names of the resources db_rs and telemetry_rs or the resource groups db_rg and telemetry_rg. The sctelemetry command gives these resources and resource groups default names.

The output of the scstat -g command shows the relationship between resources and resource groups involved in system resource monitoring. The output also shows that the db_rs and hasp_rs resources and the db_rg resource group are each online on one node, the telemetry_rg and telemetry_rs are online on all cluster nodes.

# sctelemetry -i \

-o hasp_mnt_pt=DBDATA,hasp_nodelist=l6-lx-1:l6-lx-4,hasp_rs=anto

# scstat -g

Disabling System-Resource Monitoring

This example disables system-resource monitoring then verifies that the monitoring has been disabled. When monitoring is disabled, the output of the scstat -g command shows that the db_rs, hasp_rs, and telemetry_rs resources and the db_rg and telemetry_rg resource groups are offline.

# sctelemetry -d

# scstat -g

Exit Status

The following exit values are returned:

0

The command completed successfully.

nonzero

An error has occurred.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

Intro(1CL), cltelemetryattribute(1CL), cluster(1CL), scstat(1M), sctelemetry(1M), SUNW.derby(5), SUNW.HAStoragePlus(5), SUNW.SCTelemetry(5)