### Download and Execute Installer (Windows) Source: https://www.manageengine.com/products/passwordmanagerpro/help/installation This snippet describes the initial step of downloading and executing the Password Manager Pro installer on a Windows system. It initiates the installation wizard. ```text 1. Download and execute the file ManageEngine_PMP.exe. The Password Manager Pro installation wizard shows up. ``` -------------------------------- ### Install Password Manager Pro as a Service (Windows) Source: https://www.manageengine.com/products/passwordmanagerpro/help/installation This command installs Password Manager Pro as a startup service on a Windows machine using a batch file. Navigate to the PMP installation's bin directory and execute the command. ```batch pmp.bat install ``` -------------------------------- ### Install Password Manager Pro as a Service (Linux) Source: https://www.manageengine.com/products/passwordmanagerpro/help/installation This command installs Password Manager Pro as a startup service on a Linux machine. Log in as root, navigate to the /bin directory, and execute the shell script. For Ubuntu, use bash. ```shell sh pmp.sh install ``` ```shell bash pmp.sh install ``` -------------------------------- ### Install KMP Agent for Windows Server Source: https://www.manageengine.com/products/passwordmanagerpro/help/buypassgo-integration Installs the KMP agent on a Windows server for Buypass Go SSL challenge verification. This agent facilitates automatic domain validation. ```bash AgentInstaller.exe start. ``` -------------------------------- ### Install Server Certificate in Password Manager Pro Source: https://www.manageengine.com/products/passwordmanagerpro/help/pmp-using-mssql-cluster-as-backend This process describes how to install the server certificate within the Password Manager Pro installation directory. It involves copying the certificate and executing a batch script. ```batch /bin/importCert.bat ``` -------------------------------- ### Silent Install Password Manager Pro - Windows Secondary Server Source: https://www.manageengine.com/products/passwordmanagerpro/help/silent-install This command performs a silent installation of Password Manager Pro on a Windows secondary server. Similar to the primary server installation, it utilizes an .iss file for configuration and generates a log file. Ensure the .iss file is correctly configured for a secondary server setup. ```batch ManageEngine_PMP_64bit.exe -a -s -f1" \WindowsSecondaryNonMSP.iss" -f2" \WindowsSecondaryNonMSP.log" ``` -------------------------------- ### PostgreSQL pg_hba.conf Configuration Example Source: https://www.manageengine.com/products/passwordmanagerpro/help/ro-server-pgsql Example configuration snippet for the PostgreSQL pg_hba.conf file, showing how to define replication access for a Read-Only server. This is crucial for troubleshooting replication issues. ```ini # TYPE DATABASE USER ADDRESS METHOD host replication pmpuser 10.214.147.123/32 md5 ``` -------------------------------- ### Get Audit Details Source: https://www.manageengine.com/products/passwordmanagerpro/help/restapi Retrieves audit details for resources or users. Requires specifying the audit type (Resource/User), start index, limit, and duration (TODAY, YESTERDAY, LAST_7_DAYS). ```URL https://:/restapi/json/v1/audit?AUDITTYPE=Resource&STARTINDEX=1&LIMIT=2&DURATION=YESTERDAY ``` -------------------------------- ### Filter User Accounts in Linux (Go Agent) - UserQuery Source: https://www.manageengine.com/products/passwordmanagerpro/help/installing-the-pmp-agent Use the UserQuery parameter to filter user accounts during discovery in Linux environments with the Go Agent. This example discovers accounts that start with 'admin'. This feature is available from build 11301 and later. ```bash UserQuery = awk -F: '$1 ~ /^ *admin/ {print$1}' /etc/passwd ``` -------------------------------- ### Import Certificates on Linux for Password Manager Pro HA Source: https://www.manageengine.com/products/passwordmanagerpro/help/ha-pgsql-model-1 This snippet demonstrates how to import SSL certificates into the Password Manager Pro installation on a Linux read-only server. It assumes the necessary certificate files (ServerCer.cer and CAcert.pem) are present in the specified directories. This is crucial for secure communication in the HA setup. ```shell sh importCert.sh ../conf/ServerCer.cer sh importCert.sh ../conf/CAcert.pem sh importCert.sh ../agent/ServerCer.cer ``` -------------------------------- ### Manage Password Manager Pro Linux Agent Source: https://www.manageengine.com/products/passwordmanagerpro/help/installing-the-pmp-agent Commands to install, start, update, stop, and remove the Password Manager Pro Linux agent. Requires root privileges. The bash commands are applicable for Go Agent only. Note that the update command does not re-transfer ownership of previously discovered accounts. ```bash sh installAgent-service.sh install bash installAgent-service.bash install ``` ```bash sh installAgent-service.sh start bash installAgent-service.bash start ``` ```bash sh installAgent-service.sh update bash installAgent-service.bash update ``` ```bash sh installAgent-service.sh stop bash installAgent-service.bash stop ``` ```bash sh installAgent-service.sh remove bash installAgent-service.bash remove ``` -------------------------------- ### Initialize PostgreSQL Database (Windows) Source: https://www.manageengine.com/products/passwordmanagerpro/help/faq This command navigates to the Password Manager Pro's bin directory and executes the initPgsql.bat script to initialize the PostgreSQL database. This is a common step during upgrade or installation procedures. ```batch < Password-Manager-Pro-Installation-Directory>\bin\initPgsql.bat ``` -------------------------------- ### Create Resource Group (cURL Example) Source: https://www.manageengine.com/products/passwordmanagerpro/help/restapi Example using cURL to create a resource group, demonstrating how to pass data via POST request with authentication token and JSON payload. ```Shell curl -X POST -k -H "AUTHTOKEN:<>" -H "Content-Type: text/json" https://:/restapi/json/v1/resourcegroup --data-urlencode "INPUT_DATA={\"operation\": {\"Details\": {\"critgroup\": \"CG1\",\"critdesc\": \"description about CG1\",\"RuleCriteria\": \"Low\",\"NoHelpDeskRetrieval\": \"false\",\"andor\": \"and\",\"NoOfCriteria\": 2,\"condition_1\": \"RESOURCENAME\",\"operator_1\": \"CONTAINS\",\"valuefield_1\": \"win\",\"condition_2\": \"LOGINNAME\",\"operator_2\":\"CONTAINS\",\"valuefield_2\": \"PMP\"} } }" ``` -------------------------------- ### Install Password Manager Pro via PowerShell (Windows Core Server) Source: https://www.manageengine.com/products/passwordmanagerpro/help/installation This snippet details the process of installing Password Manager Pro on Windows Core Server 2019 using PowerShell. It includes commands for downloading the installer and silent installation files, extracting them, installing necessary tools like Nano text editor, and executing the silent installation. ```powershell powershell start-bitstransfer -source -destination Example:_start-bitstransfer -source https://www.manageengine.com/products/passwordmanagerpro/8621641/ManageEngine_PMP_64bit.exe -destination C:\Users\Administrator_ start-bitstransfer -source -destination Example:_start-bitstransfer -source https://www.manageengine.com/products/passwordmanagerpro/help/WindowsPrimaryNonMSP.zip -destination C:\Users\Administrator_ Expand-Archive -LiteralPath -DestinationPath Example:_Expand-Archive -LiteralPath C:\Users\Administrator\WindowsPrimaryNonMSP.zip -DestinationPathC:\Users\Administrator\WindowsPrimaryNonMSP Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1')) choco install nano nano WindowsPrimaryNonMSP.iss ManageEngine_PMP_64bit.exe -a -s -f1"C:\Windows\WindowsPrimaryNonMSP.iss" -f2"C:\Windows\WindowsPrimaryNonMSP.log" ``` -------------------------------- ### Implementation Tips Source: https://www.manageengine.com/products/passwordmanagerpro/help/password-reset-plugin Guidance on how to access and utilize resource properties within your implementation class. ```APIDOC ## Implementation Tips ### Description When implementing the `RemotePasswordReset` interface, you can access various properties of the resources and accounts. The `resetProps` and `verifyProps` (both of type `Properties`) objects passed to the methods contain these details. ### Accessing Resource Properties | Method Call | Description | |------------------------------|----------------------------------------------------------------| | `resetProps.get("RESOURCEID")` | Returns a `Long` object of the resource ID. | | `resetProps.get("ACCOUNTID")` | Returns a `Long` object of the account ID. | | `resetProps.get("OLDPASSWORD")` | Returns a `String` object of the account's old password. | | `resetProps.get("NEWPASSWORD")` | Returns a `String` object of the account's new password. | | `resetProps.get("RESOURCENAME")` | Returns a `String` object of the resource name. | | `resetProps.get("DNSNAME")` | Returns a `String` object of the resource's DNS name. | | `resetProps.get("ACCOUNTNAME")` | Returns a `String` object of the account name. | | `resetProps.get("OSTYPE")` | Returns a `String` object of the resource's OS type. | | `resetProps.get("NOTES")` | Returns a `String` object of the notes present under the account. | | `resetProps.get("LOGINNAME")` | Returns a `String` object of the user who initiated the reset. | | `resetProps.get("IPADDRESS")` | Returns a `String` object of the resource's IP address. | | `resetProps.get("RESOURCEDETAILS")`| Returns a `ResourceDetails` object with all other resource details. | **Note**: The property keys are case-sensitive. ``` -------------------------------- ### Verify Port Connectivity using Telnet Source: https://www.manageengine.com/products/passwordmanagerpro/help/faq This example demonstrates how to use the 'telnet' command to verify if necessary ports (2345 and 8282/443) are open between primary and secondary Password Manager Pro servers for replication. This helps diagnose 'Connection refused' errors. ```bash # From secondary server: Telnet 8282 & Telnet 2345 # From primary server: Telnet 8282 & Telnet 2345 ``` -------------------------------- ### Making Installer Executable in Linux Source: https://www.manageengine.com/products/passwordmanagerpro/help/silent-install This command is used to grant execute permissions to the Password Manager Pro installer binary on a Linux system, which is a prerequisite for running the installation. ```bash chmod a+x ManageEngine_PMP_64bit.bin ``` -------------------------------- ### Filter User Accounts in Windows/Windows Domain (C# Agent) - accountFilter Source: https://www.manageengine.com/products/passwordmanagerpro/help/installing-the-pmp-agent Use the accountFilter parameter to filter user accounts during discovery in Windows or Windows Domain environments with the C# Agent. This example discovers accounts that start with 'admin'. Note that Windows Domain agents require this filter to automatically add user accounts. This feature is available from build 11301 and later. ```text accountFilter = ^*admin ```