QUERY NODE (Query nodes)

Privilege class

Any administrator can issue this command.

Parameters

node_name

Specifies the name of the client node to be queried. You can use wildcard characters to specify this name. All matching client nodes are queried. If you do not specify a value for this parameter, all client nodes are queried. The parameter is optional.

DOmain

Specifies a list of policy domains that limit the client node query. Only nodes that are assigned to one of the specified policy domains are displayed. This parameter is optional. Separate the items in the list by commas, with no intervening spaces. You can use wildcard characters to specify a domain. All clients that are assigned to a matching domain are displayed. If you do not specify a value for this parameter, all policy domains are included in the query.

Format

Specifies how the information is displayed. This parameter is optional. The default value is STANDARD. You can specify one of the following values:

Standard

Specifies that partial information is displayed for the specified client nodes.

Detailed

Specifies that complete information is displayed for the specified client nodes.

Type

Specifies the type of node to include in the query results. The parameter is optional. The default value is CLIENT. You can specify one of the following values:

Any

Specifies any type of node.

Client

Specifies client nodes that are backup-archive clients, Tivoli® Storage Manager for Space Management clients, or application clients.

NAS

Specifies NAS nodes.

Server

Specifies client nodes that are other servers.

Authentication

Specifies the password authentication method for the node.

LOcal

Display those nodes that authenticate to the Tivoli Storage Manager server.

LDap

Display those nodes that authenticate to an LDAP directory server. The node password is case-sensitive.

Field descriptions

Node Name

The name of the client node.

Platform

The operating system of the client node, as of the last time that the client node contacted the server. A question mark (?) is displayed until the client node first accesses the server and reports its operating system type.

Client OS Level

The level of the operating system for the client as of the last time that the client node contacted the server.

Client Version

The version of the client that is installed on the client node.

This field does not apply to NAS nodes.

Application Version

The version of the Tivoli Data Protection for VMware client.

Policy Domain Name

The assigned policy domain of the client node.

Last Access Date/Time

The last date and time that the client node accessed the server.

Days Since Last Access

The number of days that elapsed since the last time that the client node accessed the server.

Password Set Date/Time

The date and time that the password was set for the client node.

Days Since Password Set

The number of days that elapsed since the password was set for the client node.

Invalid Sign-on Count

The number of invalid sign-on attempts that were made since the last successful sign-on. This count can be non-zero only when the invalid password limit (SET INVALIDPWLIMIT) is greater than zero. When the number of invalid attempts equals the limit that is set by the SET INVALIDPWLIMIT command, the node is locked out of the system.

Locked?

Whether the client node is locked out of Tivoli Storage Manager.

Contact

Any contact information for the client node.

Compression

Whether compression is enabled on the client node.

This field does not apply to NAS nodes.

Archive Delete Allowed?

Whether the client node can delete its own archive files.

Backup Delete Allowed?

Whether the client node can delete its own backup files.

Registration Date/Time

The date and time that the client node was registered.

Registering Administrator

The name of the administrator that registered the client node.

Last Communication Method Used

The communication method that was last used by the client node to contact the server.

Bytes Received Last Session

The number of bytes received by the server during the last client node session.

This field does not apply to NAS nodes.

Bytes Sent Last Session

The number of bytes sent to the client node.

This field does not apply to NAS nodes.

Duration of Last Session (sec)

How long the most recent client node session lasted.

This field does not apply to NAS nodes.

Pct. Idle Wait Last Session

The percentage of the total session time that the client was not running any functions.

This field does not apply to NAS nodes.

Pct. Comm. Wait Last Session

The percentage of the total session time that the client waited for a communication response from the server.

This field does not apply to NAS nodes.

Pct. Media Wait Last Session

The percentage of the total session time that the client waited for a removable volume to be mounted.

This field does not apply to NAS nodes.

Optionset

The name of the client option set.

URL

The web address of the client. The administrator can use this address to contact the client from the Operations Center.

Node Type

The type of client node. One of the following values is possible:

• Client: a backup-archive client, a Tivoli Storage Manager for Space Management client, or an application client
• Server: a Tivoli Storage Manager server
• NAS: a NAS file server

Password Expiration Period

The password expiration period of the client node.

Keep Mount Point?

Whether the client node retains a mount point during a session.

Maximum Mount Points Allowed

The number of mount points that a client node can use on the server for Tivoli Storage Manager for Space Management migration and for backup and archive operations. This parameter does not apply to nodes with a type of NAS or SERVER. If a client node was registered to a server at Version 3.7 or later, the value is 0-999, depending on the value that is set with the MAXNUMMP parameter of the REGISTER NODE command. If the client node was registered under previous versions of the server and the MAXNUMMP parameter was not explicitly set by using the UPDATE NODE command, the value is set to NOLIMIT. The MAXNUMMP value is not evaluated or enforced during client data read operations such as restore, retrieve, and Tivoli Storage Manager for Space Management recall. However, mount points in use for data read operations are evaluated against attempted concurrent data store operations for the same client node. This evaluation might prevent the data store operations from acquiring mount points.

Auto Filespace Rename

Whether Tivoli Storage Manager prompts the client to rename file spaces when the client system upgrades to a client that supports Unicode. This field is valid only for client systems that use Windows, Macintosh OS X, or NetWare operating systems.

Validate Protocol

Whether the client has data validation that is enabled. If the client has data validation that is enabled, this field specifies whether Tivoli Storage Manager validates only the file data or all data, which includes file metadata. You can enable data validation by using the REGISTER NODE or UPDATE NODE commands.

TCP/IP Name

The host name of the client node as of the last time that the client node contacted the server. The field is blank if the client software does not support reporting this information to the server.

TCP/IP Address

The TCP/IP address of the client node as of the last time that the client node contacted the server. The field is blank if the client software does not support reporting this information to the server.

Globally Unique ID

The globally unique identifier (GUID) as of the last time that the client node contacted the server. This GUID identifies the host computer on which the node is located.

Transaction Group Max

Specifies the number of files per transaction committed that are transferred between a client and a server. Client performance might be improved by using a larger value for this option.

Data Write Path

Specifies the transfer path that is used when the client sends data to the server, storage agent, or both, during storage operations. If a path is unavailable, the node cannot send any data.

Data transfer path options are ANY, LAN, or LAN-free.

Data Read Path

Specifies the transfer path that is used when the server, storage agent, or both, read data for a client, during operations such as restore or retrieve. If a path is unavailable, data cannot be read.

Data transfer path options are ANY, LAN, or LAN-free.

Session Initiation

Controls whether the server or client initiates sessions. The following two options are available:

• ClientOrServer
• Serveronly

High-level Address

Specifies the client IP address that the server contacts to initiate scheduled events when SESSIONINITIATION is set to SERVERONLY.

Low-level Address

Specifies the client port number on which the client listens for sessions from the server when SESSIONINITIATION is set to SERVERONLY.

Collocation Group Name

Specifies the name of the collocation group to which a node belongs. If a node does not belong to a collocation group, this field is blank.

Tip: If the node contains file spaces that are members of a file space collocation group, this field is left blank. You can find file space names by issuing the QUERY FILESPACE command.

Proxynode Target

Specifies which nodes are proxy nodes (agents) for other nodes, in a space-separated list. If there are no nodes in that type of association, this field is blank.

Proxynode Agent

Specifies the originating (target) node name for a proxy node session, in a space separated list. If there are no nodes in that type of association, this field is blank.

Node Groups

Specifies the name of the node group to which a node belongs. If a node does not belong to a node group, this field is blank.

Email Address

Specifies the email address of the client node.

Deduplication

The location where data is deduplicated. The value ServerOnly specifies that data stored by this node can be deduplicated on the server only. The Clientorserver value specifies that data stored by this node can be deduplicated on either the client or the server.

Replication State

Indicates whether the node is enabled for replication. The following values are possible:

Enabled

The node is configured for replication and ready to replicate.

Disabled

The node is configured for replication but is not ready to replicate.

None

The node is not configured for replication.

Replication Mode

Indicates whether the node is configured as the source of or target for replicated data. If this field is blank, the node is not configured for replication. The following values are possible:

Send

The node is configured as the source of data for replication.

Receive

The node is configured as the target of data for replication.

SyncSend

The data that belongs to the node is to be synchronized with the node data that is on the target replication server. Synchronization applies only to nodes whose data was imported from a source replication server and imported to the target replication server. Synchronization occurs during replication.

SyncReceive

The data that belongs to the node is to be synchronized with the node data that is on the source replication server. Synchronization applies only to nodes whose data was imported from a source replication server and imported to the target replication server. Synchronization occurs during replication.

None

The node is not configured for replication.

Replication Source Server

Specifies the source replication server for the client node.

Backup Default Replication Rule

Archive Default Replication Rule

Space Managed Default Replication Rule

The replication rule that applies to back up, archive, and space-managed data that belongs to the node. The following values are possible:

ALL_DATA

Replicates backup, archive, or space-managed data. The data is replicated with normal priority.

ACTIVE_DATA

Replicates active backup data. The data is replicated with normal priority.

ALL_DATA_HIGH_PRIORITY

Replicates backup, archive, or space-managed data. The data is replicated with high priority.

ACTIVE_DATA_HIGH_PRIORITY

Replicates active backup data. The data is replicated with high priority.

DEFAULT

Replicates backup, archive, or space-managed data according to the domain rule for the data type.

NONE

No data is replicated. For example, if the replication rule for archive data is NONE, archive data that belongs to the node is not replicated.

Last Replication Server

Specifies the name of the server that the node was last replicated to and the name of the server that the client fails over to during restore operations.

Users allowed to back up

Specifies whether a non-root user ID or only a root user ID can back up files to the server. ALL indicates all users, while ROOT indicates that just the root user ID can back up files to the server. This output is not available if the client node operating system is considered a single-user operating system.

Client OS Name

The operating system of the client. The client deployment wizard uses this information to deploy a package to the client. This field is reported only for Tivoli Storage Manager clients at version 6.2.0.0 and later.

Client Processor Architecture

The client architecture. The client deployment wizard uses this value to determine which package to deploy when the client is being updated. This field is reported only for Tivoli Storage Manager clients at version 6.2.0.0 and later.

Client Products Installed

The products that are on the node. The following products might be listed:

• BA (Backup-Archive Client)
• VE (Virtual Environments)
• FCM (FlashCopy® Manager)

Client Target Version

The version of the client that is installed at a time that is scheduled through the DEFINE SCHEDULE or UPDATE SCHEDULE command. This field is reported only for Tivoli Storage Manager clients at version 6.2.0.0 and later.

Authentication

Specifies the password authentication method: LOCAL, LDAP, or LDAP (pending).

Authentication Target	Authentication Method
Tivoli Storage Manager server	LOCAL
LDAP directory server	LDAP
This node is configured to authenticate with an LDAP directory server, but the node did not yet authenticate.	LDAP (pending)

SSL Required

Specifies whether the security setting for the node requires Secure Sockets Layer (SSL). Values can be YES, NO, or Default. You must have system level authority to update the node SSLREQUIRED setting.

Split Large Objects

Specifies whether large objects that are stored by this node are automatically split into smaller pieces, by the server, to optimize server processing. Yes indicates that the server splits large objects (over 10 GB) into smaller pieces when stored by a client node. No indicates that this process is bypassed. The default value is Yes.

At-risk type

Specifies the at-risk evaluation type. Values can be Default, Bypassed, or Custom. Default indicates that the node is evaluated with the same interval that was specified for the nodes classification by the SET STATUSATRISKINTERVAL command. Bypassed indicates that the node is not evaluated for at-risk status by the status monitor. Custom indicates that the node is evaluated with the interval that was specified by the SET NODEATRISKINTERVAL command, rather than the interval that was specified by the SET STATUSATRISKINTERVAL command.

At-risk interval

Specifies the amount of time, in hours, between client backup activity before the status monitor considers the client at-risk. This field applies only when the at-risk type is Custom.

Example: Display information about node roles

query node alvin f=d

                  Proxynode Agent:
                      Node Groups:
                    Email Address:
                    Deduplication: ServerOnly
         Users allowed to back up: All
                             Role: Server
                    Role Override: UseReported
                 Processor Vendor: ORACLE
                  Processor Brand: UltraSPARC-T2
                   Processor Type: 4
                  Processor Model:
                  Processor Count: 1
                       Hypervisor:
                  API Application: NO
                       Scan Error: NO
                      MAC Address:

Field Descriptions

Role

The processor role as reported by the client.

Role Override

The override value for role, which is specified with the UPDATE NODE command.

Processor Vendor

The processor vendor as reported by the client.

Processor Brand

The processor brand as reported by the client.

Processor Type

The processor type as reported by the client. This value specifies the number of processor cores that are used for PVU calculation.

Processor Model

The processor model as reported by the client.

Processor Count

The processor count as reported by the client.

Hypervisor

The hypervisor as reported by the client.

API Application

The client indicator that the client is an API application.

Scan Error

The indicator of whether the latest scan for processor information might be failing and needs investigation.

MAC Address

MAC Address as reported by the client.

Related commands