Use this command to view information about one or more
registered nodes.
Privilege class
Any administrator can issue
this command.
Syntax
.-*---------.
>>-Query Node--+-----------+--+----------------------------+---->
'-node_name-' | .-,-----------. |
| V | |
'-DOmain--=----domain_name-+-'
.-Format--=--Standard-----.
>--+-------------------------+---------------------------------->
'-Format--=--+-Standard-+-'
'-Detailed-'
.-Type--=--Client-----.
>--+------------------------------+--+---------------------+---><
'-AUTHentication--=--+-LOcal-+-' '-Type--=--+-Client-+-'
'-LDap--' +-NAS----+
+-Server-+
'-Any----'
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.
Example: Display information about registered client
nodes
Display information about all registered client nodes.
query node
Node Name Platform Policy Domain Days Since Days Since Locked?
Name Last Password
Access Set
--------- -------- -------- --------- ---------- -------
CLIENT1 AIX STANDARD 6 6 No
GEORGE AIX STANDARD 1 1 No
JANET AIX STANDARD 1 1 No
JARED Linux86 STANDARD 1 1 No
JOE2 Mac STANDARD <1 <1 No
TOMC WinNT STANDARD 1 1 No
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 URL of the Tivoli Storage
Manager web client
that is configured on the client system. You
can use the URL in a web browser and in the Operations Center to remotely
manage the client node.
- 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.
- 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.
- 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.
Attention: If you specify ACTIVE_DATA
and one or more of the following conditions are true, inactive backup
data on the target replication server is deleted, and inactive backup
data on the source replication server is not replicated.
- When a Tivoli Storage
Manager version
earlier than Version 7.1.1 is installed on either the source or target
replication servers.
- When you are using the REPLICATE NODE command
with the FORCERECONCILE=YES parameter.
- When you are running the initial replication of a file space after
you configure replication, restore the database, or upgrade both the
source and target replication servers from a Tivoli Storage Manager
version earlier than V7.1.1.
If the previous conditions are not true, all new and changed
files since the last replication are replicated, including inactive
files, and files are deleted when they expire.
- ALL_DATA_HIGH_PRIORITY
- Replicates backup, archive, or space-managed data. The data is
replicated with high priority.
- ACTIVE_DATA_HIGH_PRIORITY
This rule is the same as the
ACTIVE_DATA replication rule except data is replicated with a 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.
- 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 V6.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 V6.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 V6.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.
- Utility URL
- Specifies the address of the Tivoli Storage Manager client management
services that are configured on the client
system. This URL is used by the Operations Center to access
client log files so that you can remotely
diagnose client issues from the Operations Center.
- Replication Recovery of Damaged Files
- Specifies whether damaged files can be recovered for this node
from a target replication server.
Example: Display information about node roles
The
example output is only a portion of the full display.
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.
Example: View all nodes that authenticate to the Tivoli Storage
Manager server
If
you want to view all nodes that authenticate locally, specify the
following command:
query node * authentication=local
Node Name Platform Policy Domain Days Since Days Since Locked?
Name Last Access Password Set
__________________________________________________________________________________
NODE1 WinNT STANDARD 3 3 No
LOCAL (?) STANDARD 7 7 No
Related commands
Table 1. Commands related to QUERY NODECommand |
Description |
LOCK NODE |
Prevents a client from accessing the server. |
QUERY ADMIN |
Displays information about one or more Tivoli Storage Manager administrators. |
QUERY REPLNODE |
Displays information about the replication
status of a client node. |
QUERY STATUS |
Displays the settings of server parameters,
such as those selected by the SET commands. |
REGISTER NODE |
Defines a client node to the server and sets
options for that user. |
REMOVE NODE |
Removes a client from the list of registered
nodes for a specific policy domain. |
REMOVE REPLNODE |
Removes a node from replication. |
RENAME NODE |
Changes the name for a client node. |
REPLICATE NODE |
Replicates data in file spaces that belong
to a client node. |
RESET PASSEXP |
Resets the password expiration for nodes or
administrators. |
SET INVALIDPWLIMIT |
Sets the number of invalid logon attempts
before a node is locked. |
SET MINPWLENGTH |
Sets the minimum length for client passwords. |
SET PASSEXP |
Specifies the number of days after which
a password is expired and must be changed. |
UNLOCK NODE |
Enables a locked user in a specific policy
domain to access the server. |
UPDATE NODE |
Changes the attributes associated with a client
node. |