Installation


New Installation
Upgrade from a previous version

New Installation

Install/Verify the Java Runtime Environment :

Make sure you have java runtime environment installed in your machine. You should have Java 1.4.1 or above. Type java -version in the command prompt, you should get something similar to the following.
java version "1.4.2_03"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_03-b02)
Java HotSpot(TM) Client VM (build 1.4.2_03-b02, mixed mode)

If java runtime is not installed in your machine, download it from http://java.sun.com/j2se/downloads.html and following the instruction to install it on your platform.

Install Password Manager :

Unzip the passwordmanager.zip , which will create passwordmanager folder and all files will be put underneath this directory. The following files are distributed with this zip file.

passwordmanager.jar This is the application package.
lib This directory contains all the libraries needed by the Password Manager
readme.html This file
pwm.ico Icon for Password Manager

Run PasswordManager :

Setup is done. Double click on the passwordmanager.jar to bringup the application. (or) type java -jar passwordmanager.jar from the install directory.

Upgrade from previous version.

For all other versions :

  • Take a backup of all the data files which you are using to a different location.
  • Unzip the passwordmanager.zip to the same directory structure as you did in previous version. ( i.e if you have c:\passwordmanager directory created by version 1.0, unzip the passwordmanager.zip to c:\ which will overwrite all the files inside c:\passwordmanager )

From Version 2.x to Version 3.x

  • Step 1 : Take a backup of all the data files which you are using to a different location.
  • Step 2 : Take a backup of your previous version's install directory. ( i.e if you have installed previous version under c:\passwordmanager, take a backup of the whole directory. This step is needed because of the next step, where you have to export your *.pwm file to a text file. )
  • Step 3 : Important : Since a new encryption ( BlowfishJ is used in this release ), the *.pwm file of previous version cannot be directly opened from this version. Instead, take a export of the *.pwm file using your previous version of password manager first. Follow the steps below to take an export.
    • Launch your passwordmanager V2.x application
    • Open your *.pwm data file
    • Go to File Menu -> Export Menu -> To Text
    • Click on 'Password' and 'Additional Attributes' checkboxes. Make sure 'All Rows' radio button is selected. Make sure Account Name,UserId, Password, URL, Notes, Category and Additional Attributes are selected.
    • Click on Export, and give a file name and directory location where the text file needs to be stored [ Note : This file will have all the information in a clear text format including your password, make sure you delete this file once you import it to the new version of password manager. ]
  • Step 4: Unzip the passwordmanager.zip to the same directory structure as you did in previous version. ( i.e if you have c:\passwordmanager directory created by version 2.x, unzip the passwordmanager.zip to c:\ which will overwrite all the files inside c:\passwordmanager )
  • Step 5 : Now launch the new version of passwordmanager. Follow the steps below to import the records which you exported as mentioned above.
    • Launch your passwordmanager V3.x application
    • Click on 'New File'
    • Go to File Menu -> Import Menu -> Select the text file which you exported before.
    • This should've imported all your records.
    • Click on 'Save As' button from the toolbar, and save this new *.pwm file , which will be encrypted using the BlowfishJ encryption algorithm.
  • Note : In your exported text file of V2.x application, If you have any commas in a field [say for e.g. notes field had a comma in it], make sure you enclose the notes field within double quotes, by editing the exported *.txt file. In V3.x this issue is fixed, if any field has a comma in it, it will be automatically enclosed within double quotes during export.

From Version 1.0 to Version 1.1

  • Take a backup of all the data files which you are using to a different location.
  • Unzip the passwordmanager.zip to the same directory structure as you did in previous version. ( i.e if you have c:\passwordmanager directory created by version 1.0, unzip the passwordmanager.zip to c:\ which will overwrite all the files inside c:\passwordmanager )
    Rename all your old data files to *.pwm. From version 1.1, only *.pwm will be the standard extension for the data files.