Logging on to VCS
Prev	Administering the cluster from the command line	Next

---

Logging on to VCS

VCS prompts user name and password information when non-root users run haxxx commands. You can use the halogin command to save the authentication information so that you do not have to enter your credentials every time you run a VCS command. Note that you might need specific privileges to run VCS commands.

When you run the halogin command, VCS stores encrypted authentication information in the user's home directory. For clusters running in secure mode, the command also sets up a trust relationship and retrieves a certificate from an authentication broker.

If you run the command for different hosts, VCS stores authentication information for each host. After you run the command, VCS stores the information until you end the session.

For clusters that run in secure mode, you can also generate credentials for VCS to store the information for eight years and thus configure VCS to not prompt for passwords when you run VCS commands as non-root users.

See Running HA commands as non-root users on clusters in secure mode

Root users need not run halogin when running VCS commands from the local host.

To log on to a cluster running in secure mode

1. Set the following environment variables:
   • VCS_DOMAIN—Name of the Security domain to which the user belongs.
   • VCS_DOMAINTYPE—Type of VxSS domain: unixpwd, nt, nis, nisplus, or vx.
2. Define the node on which the VCS commands will be run. Set the VCS_HOST environment variable to the name of the node. To run commands in a remote cluster, you set the variable to the virtual IP address configured in the ClusterService group.
3. Log on to VCS:

   halogin vcsusername password

To log on to a cluster not running in secure mode

1. Define the node on which the VCS commands will be run. Set the VCS_HOST environment variable to the name of the on which to run commands. You can set the variable to the virtual IP address configured in the ClusterService group.
2. Log on to VCS:

   halogin vcsusername password

To end a session for a host

• Run the following command:

  halogin -endsession hostname

To end all sessions

• Run the following command:

  halogin -endallsessions

VCS prompts you for credentials every time you run a VCS command.