Read INSTALL for installation instructions.
Before running for the first time:
Make sure the MySQL server you will be using is running. It does not have
to be on the same machine as this application, but it needs to be running
and accessable. This application needs the MySQL root password when it first
runs so it can create the new database and user. It doesn't need to access
MySQL as root at any time after this.
Change into the directory where you copied the Password Manager Pro files.
Edit config.py and change PORT to be the TCP port you want this
application to listen on.
You shouldn't need to change any of the other variables in this file.
Make sure you have installed all the prerequistes described in INSTALL.
Make sure you are in the Password Manager directory.
If you set PORT to < 1024, make sure you are running Password Manager as root.
To run using the system supplied Python:
"sudo python cherry.py"
To run using the parallel version of Python you installed:
"sudo python2.6 cherry.py"
"sudo python2.7 cherry.py"
To use the application:
Make sure you know the IP of the server running Password Manager (or
the DNS name if it has one) and the TCP port it is listening on.
Open your web browser and go to the http://server:port in the location bar.
The first time you run this application, it will prompt you for the initial
setup values and create the databases. After this, it will start the
application. You will not need to re-enter the private key again unless
you restart the application.
A note about the private key:
This key is used as the AES-256 seed key for all encryption of sensitive
material. This key is not stored in memory or saved to disk. If you forget
this key you will NOT be able to recover your data. It must be between 16
and 32 characters. You will need to enter this key every time you start
the application before you can use it.
After it configures the databases, it will create an Administrator
access level with full permissions, and create a root user with the
Administrator access level. The initial password for the root user
will be set to the private key you created when you configured
the application, but it is strongly encouraged to change this.
Checking for errors:
All NON-SENSITIVE information is logged to the standard syslog facility.
On Linux, this is usually /var/log/messages.
Sensitive information is logged into the Password Manager audit log, which is in
/var/tmp/audit.log by default. This file is AES-256 encrypted, and can
only be read from the Password Manager application. This file is rotated daily.
Older log files are never removed, it's up to you to archive and delete them
To stop the application:
To completely erase Password Manager:
Log in to MySQL as root
"mysql -u root -p"
Delete the pwmanager database:
"drop database pwmanager;"
Delete the pwmanager user:
"drop user pwmanager;
Delete the Password Manager directory:
"rm -rf pwmanager /var/tmp/audit*"