Changing the User ID and Passwords on Remote Hosts
The Change Remote Passwords command enables you to change the user ID and password on multiple remote hosts.
Changing the configuration of user IDs and passwords on multiple remote hosts is a two-step process:
- Prepare an input text file.
- Run the Change Remote Passwords menu command.
To Prepare an Input File
You must prepare an input file every time you wish to run the Change Remote Password command. The input file contains all the details necessary for switching user IDs and passwords. The information in this file is organized as a series of textual entries of two types: Host Details entry and Instance Details entry.
Each entry contains a series of values, separated by commas, as shown in the following table.
.
Remote Host Password Input File
Entry Type | Description | Field #1 | Other Fields |
|---|---|---|---|
Host details | Data necessary for connecting to remove hosts. One of more host detail entries may precede a group of Instance Detail entries. | 1 |
|
|
| Example: 1,Host,Port,PatrolUser,PatrolPassword | |
Instance details | Details regarding user IDs and passwords to be switched at remote host(s). Instance details are applied on all hosts specified in the host details entries (one or more) preceding the switch details entries. | 2 |
|
|
| Example: 2,CurrentUser,CurrentPassword,NewUser, NewPassword,ValidatePassword
| |
In the following example, a request is submitted for changing the password configuration.
To Change the User ID and Password Configuration on a Remote Host
- Right-click the BEATUX_SETUP icon.
- Choose KM Commands > Multi Instance Password Changes > Change Remote Passwords. The Change Password for Remote Hosts dialog box appears.
- Complete the Change Password for Remote Hosts dialog box as follows:
- In Local PatrolAgent User ID, enter the user name of the default PATROL account authorized to access the PATROL Agent on the local host.
- In Password, enter the password of the default PATROL account authorized to access the PATROL Agent on the local host.
- In Input File, enter the full name and pathway of the input file that you created; for more information, see To Prepare an Input File.
- In Log File, enter the full name and pathway for the log file that will be created. The log file is created automatically on your local computer when you submit your request for switching password configuration. For each password switch that was requested, it contains the following information:
- Host Name
- Port
- User
- Old User
- New User
- Error Message—for cases when the password switch operation could not be initiated (for example, failure to connect to the remote host)
- Click Accept.
Your requests for switching user IDs and passwords are sent to the appropriate target hosts, and a status message is displayed. The actual process of changing password configuration (in the pconfig) is executed asynchronously at each remote host. Details of this process are written in a special output file named LogChangePassword, which is automatically created within the $PATROL_HOME directory on each of the target remote hosts. To verify that password switching was successful, review the created output files on the remote hosts.
For each password switch that was requested, the output file contains the
following information:- Variable Name—the pconfig variable name that was affected
- Old User
- New User
- Error Message—for cases when the password switch operation failed
- To change the configuration of other remote host passwords using another input file, repeat 2 on page 78 through 4.
- After changing all desired passwords, click Cancel to exit the dialog box.