Logging on to VCS


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

VCS prompts for user name and password information when non-root users run haxxx commands. 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 may 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 that run 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 also can generate credentials for VCS to store the information for 24 hours or for eight years and thus configure VCS to not prompt for passwords when you run VCS commands as non-root users.

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

To log on to a cluster running in secure mode

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, ldap, nis, nisplus, or vx.
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 that was configured in the ClusterService group.
Log on to VCS:
```
# halogin vcsusername password
```

To log on to a cluster not running in secure mode

Define the node on which the VCS commands will be run. Set the VCS_HOST environment variable to the name of the node on which to run commands. To run commands in a remote cluster, you can set the variable to the virtual IP address that was configured in the ClusterService group.
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
```
After you end a session, VCS prompts you for credentials every time you run a VCS command.

Prev	Up	Next
Additional considerations for stopping VCS	Home	Running high availability commands (HA) commands as non-root users on clusters in secure mode