Installation & Getting Started

Overview

Welcome to ManageEngine Password Manager Pro!

This section provides information on how to install Password Manager Pro (PMP) in your system. This section also deals with the system requirements for PMP, how to install the solution, how to start and shutdown and how to connect web interface after successfully starting the server.

Prerequisite Software

There is no prerequisite software installation required to use PMP. The standard system (hardware and software) requirements as mentioned below plus an external mail server (SMTP server) are essential for the functioning of PMP server and to send various notifications to users.

System Requirements

Following table provides the minimum hardware and software configuration required by PMP:

Components of PMP

PMP consists of the following components:

• The PMP server
• PMP agent that helps in connecting to remote resources

• MySQL 5.0.79 bundled with PMP. MySQL runs as a separate process (mysqld-nt.exe in Windows/ mysqld in Linux). It accepts connections only from the host in which it is running and is not visible externally

Installing PMP

In Windows

• Download and execute ManageEngine_PMP.exe

• The installation wizard will guide you through the installation process

• Choose an installation directory - by default, it will be installed in C:/Program Files/PMP; Henceforth, this installation directory path shall be referred as "PMP_Home"

• In the final step, you will see two check-boxes - one for viewing ReadMe file and the other one for starting the server immediately after installation; if you choose to start the server immediately, it will get started in the background.

• If you choose to start the server later, after installation, you can start it from the Start >> Programs >> ManageEngine Password Manager Pro menu
• From the Start Menu, you can perform other actions such as stopping the server and uninstalling the product

In Linux

• Download ManageEngine_PMP.bin for linux

• Assign executable permission using command  chmod a+x  <file-name>

• Execute the following command: ./<file_name>

• Follow the instructions as they appear on the screen

• PMP is installed in your machine in the desired location. Henceforth, this installation directory path shall be referred as "PMP_Home".

Starting & Shutting Down PMP

In Windows

In Linux

Connecting Web Interface

Automatic Browser Launch

Once the server is started successfully, a browser is automatically launched with the PMP login screen. As the connection is through HTTPS, you will be prompted to accept security certificate. Hit 'Yes' and then type the user name and password in the login screen and press Enter. For an unconfigured setup, the default user name and password will be admin and admin respectively. Every time you start the server, the browser will be automatically launched.

Launching the Web Client Manually

In the case of windows, you can also launch the web client manually from the Windows Tray. Right-click the PMP tray icon and click "PMP Web Console". A browser would be launched with the PMP login screen. As the connection is through HTTPS, you will be prompted to accept security certificate. Hit 'Yes' and then type the user name and password in the login screen and press Enter. For an unconfigured setup, the default user name and password will be admin and admin respectively. Every time you start the server, the browser will be automatically launched.

In the case of Linux, open a browser and connect to the URL

Connecting the Web Client in Remote Hosts

If you want to connect web clients in a different machine than the one in which PMP is running, open a browser and connect to the URL

https://<hostname>:port

As the connection is through HTTPS, you will be prompted to accept security certificate. Hit 'Yes' and then type the user name and password in the login screen and press Enter. For an unconfigured setup, the default user name and password will be admin and admin respectively. Every time you start the server, the browser will be automatically launched.

Quick Start Guide

Refer to the "Work flow in PMP" section of help documentation.

For any assistance, please contact passwordmanagerpro-support@mnageengine.com / Toll Free: + 1 925 924 9500

Managing PMP Encryption Key

PMP is secured using AES 128 encryption and all sensitive information are encrypted and stored in the database. AES is the strongest known encryption and has been approved by the US Government. During PMP installation, a unique encryption key is auto-generated using SHA1 hashing algorithm. The following options are provided to protect the encryption key:

1. Leaving PMP to store and manage the key securely by itself  (OR)

2. Securely storing it outside PMP and instructing the application to read the key from the location that you specify. PMP will not store this key anywhere

To specify your option,

• Go to "Admin" >> "General" >> "Manage Encryption Key" in PMP web GUI

• In the GUI that opens up, select one of the radio buttons - "Let PMP manage the encryption key" or "I will manage the encryption key"

Leaving it to PMP

• If you choose to leave it to PMP, it will securely store the key and manage it and takes care of backing up the key for disaster recovery purposes. You can click "Save" and exit.

Storing it by yourself

• If you choose to manage it by yourself, you need to store the key somewhere securely and instruct the location of the file to PMP. The key is nowhere stored by PMP and hence it cannot be backed up. You need to take care of secure storage, secure backup and secure retrieval.

• Click "Save"

• The Encryption Key for the installation will be available under <PMP Installation Folder>/conf/pmp_key.key

• You can move this key to a secure location, which can be a local directory or a mapped network drive accessible to the PMP server. When you do so, you need to specify the location to PMP through the file manage_key.conf present under <PMP Installation Folder>/conf directory.

Managing PMP Database Key

• Apart from the AES encryption, the PMP database is secured through a separate key, which is auto-generated and unique for every installation

• The key for the database can be stored securely in the PMP itself

• There is also option to store it at some other secure location accessible to the PMP server

Leaving it to PMP

• If you choose to leave it to PMP, you need not do anything. PMP will take care of it automatically

Storing it by yourself

• By default, the database password is present in the file <PMP Installation Folder>/conf/database_params.conf file

• If you choose to manage the database key by yourself, you need to store this configuration file somewhere securely and instruct the location of the file to PMP

• If you are starting PMP as service, go to <<PMP Installation Folder>/conf/wrapper.conf (in Windows) / <PMP Installation Folder>/conf/wrapper_lin.conf (in Linux) and edit the following entry under "Java Additional Parameters"

wrapper.java.additional.9=-Ddatabaseparams.file=<full path of the database_params.conf file location>
 

• If you are starting PMP from command line or through Start >> Programs, you need to edit the file system_properties.conf present in <PMP Installation Folder>/conf directory. In this file, edit the following entry under "Splash Screen default Properties"

databaseparams.file=<full path of database_params.conf file>

Ports Used by PMP

PMP uses the following two ports:

• MySQL port : 2345

• Web client port : 7272

Licensing

There are three license types:

• Evaluation download valid for 30 days capable of supporting a maximum of 2 administrators  

• Free Edition licensed software allows you to have 1 administrator and manage up to 10 resources. Valid forever.

• Registered Version - need to buy license based on the number of administrators required and the type of edition Standard/Premium:

• Standard - If your requirement is to have a secure, password repository to store your passwords and selectively share them among enterprise users, Standard Edition would be ideal.

• Premium - Apart from storing and sharing your passwords, if you wish to have enterprise-class password management features such as  remote password reset, password alerts and notifications, application-to-application password management, reports, high-availability and others, Premium edition would be the best choice.

Features Matrix

• For more information and to get license, contact sales@adventnet.com 

© 2007, ZOHO Corp. All Rights Reserved.