The Password Manager Pro Agent
=============================

The agent could be used in target machines to which the PMP server can connect and effect password changes. All password related communication is over HTTPS and is secure. The agent is useful in cases when,

    	*	the required root passwords are not available in the PMP server to make the password changes from remote.


Downloading the PMP Agent
=========================

		The PMP Agent package is dynamically created by the PMP server to include the SSL certificate of the PMP server, that is used for the HTTPS communication between the server and the agent. So, the only place to download the agent is from the 'Admin' tab of the PMP web GUI. The agent package is a zip file containing the necessary executables, configuration files and the SSL certificate. Download the agent based on the OS of the target and just unzip the package.


Installing the PMP Agent
========================

		The package has all the necessary configuration already created by the server. Make sure the account in the system in which the agent is installed has sufficient privileges required to modify passwords.


	To install the agent as service,

		*	Execute the command "sh installAgent-service.sh install" to install the agent as service


	To start the agent,

		*	Execute the command "sh installAgent-service.sh start"


	To stop the agent,

		*	Execute the command "sh installAgent-service.sh stop"


	To uninstall the agent as service,

		*	Use the command "sh installAgent-service.sh remove", in case you wish to remove PMP Agent as service
		
		
	Configuring the time interval at which the agent should ping the PMP server
		
		By default, the agent pings the server once in 60 seconds. The interval is configurable. To change this,
 
        	1. Go to the PMP agent installation directory

        	2. Open the file Agent.conf

        	3. Modify the time interval value in seconds for the parameter ScheduleInterval to the value you require (in seconds)

        	4. Restart the agent service
        	
	
To remotely change the password
===============================

    *	Go to 'Resources' Tab

    *	Click the name of the resource whose password has to be changed remotely

    *	Click the "Change Password" icon
    

To find if any tasks are pending for execution by the agents
============================================================

The remote password reset and other tasks triggered by the user in PMP and awaiting execution by the agents, can be found from by clicking the icon on the top pane of the GUI. The status of the previously triggered tasks can also be known from here.

The notification icon will provide the following information:

	*	Number of password reset actions triggered

    *	Number of password verify actions triggered

    *	Status of password reset action triggered earlier

    *	Status of verify password action triggered earlier

This listing will be user-specific - that means, users get to know the status of only those tasks triggered by them. 


Troubleshooting
===============

	If the password changes do not take effect in the target systems, check

	*	by default, the agent tries to communicate with the PMP server through the port 7272. If you have configured the default PMP port, you need to make the agent communicate with the new address.
	
	*	if the account in which the agent is installed has sufficient privileges to make password changes

