Home > Veritas Storage Foundation™ Volume Manager Manual Pages

VEAINFO (1M)

Maintenance Commands

Table of contents


NAME

veainfo - provides information about the relationships between various VxPAL agents, Authentication Brokers, and authentication domains.

SYNOPSIS

veainfo -h [reg_doms | joined_doms | reg_agents | joined_agents | agent_info | auth_brokers]

veainfo reg_doms -a agent_name [-u user@domain.domainType] [-p user_passwd] [-l agent_hostname] [-n|--noheader]

veainfo joined_doms -a agent_name [-u user@domain.domainType] [-p user_passwd] [-l agent_hostname] [-n]

veainfo joined_agents -d domain_name [-u user@domain.domainType] -p user_passwd] [-l agent_hostname] [-n]

veainfo reg_agents -d domain_name [-u user@domain.domainType] [-p user_passwd] [-l agent_hostname] [-n]

veainfo agent_info -a agent_name [-u user@domain.domainType] [-p user_passwd] [-l agent_hostname] [-n]

veainfo auth_brokers -d domain_controller


DESCRIPTION

veainfo enables you to obtain information about the relationships between various VxPAL agents, Authentication Brokers, and authentication domains.

When an agent joins a domain it becomes a secure member of the domain. It need not be up and communicating with the Domain Controller (vxsvc). Once an agent has joined a domain, it contacts its Domain Controller(s) (the domains that it has joined). At this point vxsvc registers the agent in the domain. The VxPAL agent is up and the Domain Controller(s) can communicate with it.

Should an agent go down the Domain Controller detects this state and unregisters the agent until such time that the agent comes back up and communication is established once more. In the time that the agent is unregistered it is still part of the list of agents that have joined the domain.


OPTIONS

-h, --help
Provides usage information for veainfo. For more details about the options of each veainfo command, type:
veainfo -h command

reg_doms
Provides the list of domains with which an agent is registered. If you do not specify the agent host, then local host is assumed.
joined_doms
Provides the list of domains an agent has joined. If you do not specify the agent host, then local host is assumed.
joined_agents
Provides the list of agents joined to a domain. If you do not specify a domain, then the default domain is assumed. If you do not specify an agent host, then all the agents joined to the domain are listed.
reg_agents
Provides the list of agents registered with a domain. If you do not specify a domain, then default domain is assumed. If you do not specify an agent host, then all the agents registered with the domain are listed.
agent_info
Provides information about an agent. If you do not specify the agent host, then local host is assumed.
auth_brokers
Provides the list of Authentication Brokers for a domain.
-a, --agent agent_name
agent_name can be one of the following: StorageAgent, StorageManager, DBEDAgent, actionagent, gridcentral, gridnode, VAILAgent, and so on. For the latest list of VxPAL agents, see the Veritas Storage Foundation Manager Release Notes.
-d, --domain domain_controller
Short name, IP address, or the fully-qualified domain name for the Domain Controller host.
-d, --domain domain_name
Short name, IP address, or the fully-qualified host name for the Domain Controller host.
-u, --user-id user@domain.domainType
The user ID. user is a valid account for the agent. domain is a valid authentication domain for the agent. domainType is the type of authentication domain for the agent, and can be the following: vx, nisplus, nis, nt, and unixpwd.
-p, --password user_passwd
Password for the specified account.
-l, --host agent_hostname
Short host name, IP address, or the fully-qualified host name for the agent.
-n, --noheader
Causes veainfo to print output without headers.

FILES

csf_resolve.conf is an optional file that contains the default security parameters for a VxPAL agent and the default domains for which an agent can be configured.

By default, csf_resolve.conf resides in: /etc/default/csf_resolv.conf (Solaris)

You can specify the location for csf_resolve.conf through the environment variable CSF_DOMAIN_RESOLVE_CONF

See csf_resolv.conf(4).


EXAMPLES

This section provides usage examples for veainfo.

EXAMPLE 1:

The following command, lists agents registered to the domain my_ab.example.com under the vea_agent account:

veainfo reg_agents -d my_ab.example.com -u
vea_agent@vea_domain.vx

EXAMPLE 2:

The following command, lists agents registered to the default domain. veainfo gets the necessary credentials from csf_resolv.conf:

veainfo reg_agents

EXAMPLE 3:

The following command, lists agent information for host my_host without headers in the output:

veainfo agent_info -a gridnode -l my_host -n


EXIT STATUS

The following exit values are returned:

0---Command executed successfully and the query produced output.

1---Command executed successfully but the query produced no output.

joined_agents: No agents have joined the domain.

reg_agents: Domain has no registered agents.

joined_doms: Agent is disjointed (has not joined any domain).

reg_doms: Agent is not registered to any domain.

auth_broker: No Authentication Broker is configured for the domain.

2---Error in command execution.


DIAGNOSTICS


SEE ALSO

csf_resolv.conf(4)

veaconfig(1m)

vxfinger(1m)


COPYRIGHTS

Copyright (c) 2007 Symantec Corporation. All rights reserved.

Last updated: 05/17/2007
Copyright ©2009 Symantec Corporation
All rights reserved.