Password Manager Pro

https://www.manageengine.com/products/passwordmanagerpro/help/
Admin
Password Manager Pro is a comprehensive privileged account management solution that securely stores,...
Tokens:357,111
Snippets:3,014
Trust Score:9.9
Update:9 months ago
Show doc for...
Tokens:
Raw
### 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
<Password Manager Pro Installation Folder>/bin/importCert.bat <name of the server certificate>
```

--------------------------------

### 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" <iis installation directory path>\WindowsSecondaryNonMSP.iss" -f2" <iis installation directory path>\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://<Host-Name-of-Password-Manager-Pro-Server-OR-IP-Address>:<Port>/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 <Agent Key copied from the PMP UI>
bash installAgent-service.bash install <Agent Key copied from the PMP UI>
```

```bash
sh installAgent-service.sh start
bash installAgent-service.bash start
```

```bash
sh installAgent-service.sh update <Agent Key copied from the PMP UI>
bash installAgent-service.bash update <Agent Key copied from the PMP UI>
```

```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:<<Authtoken_generated_from_Password_Manager_Pro>>" -H "Content-Type: text/json" https://<Host-Name-of-Password-Manager-Pro-Server-OR-IP-Address>:<Port>/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 <full URL of the executable> -destination <full path to which you would like the executable to be downloaded>
Example:_start-bitstransfer -source https://www.manageengine.com/products/passwordmanagerpro/8621641/ManageEngine_PMP_64bit.exe -destination C:\Users\Administrator_
start-bitstransfer -source <full URL of the executable> -destination <full path to which you would like the executable to be downloaded>
Example:_start-bitstransfer -source https://www.manageengine.com/products/passwordmanagerpro/help/WindowsPrimaryNonMSP.zip -destination C:\Users\Administrator_
Expand-Archive -LiteralPath <full path of the executable file> -DestinationPath<full path to which you would like the file to be extracted>
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 <primary_FQDN> 8282 & Telnet <primary_FQDN> 2345

# From primary server:
Telnet <secondary_FQDN> 8282 & Telnet <secondary_FQDN> 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
```
Tokens:
Raw