Installing tinyPM Standalone

These instructions will lead you through the process of installing tinyPM Standalone on your Windows machine. The standalone installer (tinypm-2.x-install.exe) can be downloaded from http://www.tinypm.com/download

By default tinyPM standalone runs on HSQLDB, which should not be used as a production database. It is used for evaluation purposes only. If you want to start working on your real projects we highly recommend to switch to MySQL.

We use %TINYPM_PATH% to refer to a base tinyPM installation path (C:\tinyPM by default). You don't need to set such environment variable anywhere. It's used only for the purpose of this documentation.

Installing JRE

To use tinyPM standalone you need to install JRE first (you can install or use JDK if you want but JRE is enough). You can downaload the latest version of Java JRE at http://www.java.com

After installing the JRE you need to setup %JRE_HOME% environment variable:

It’s also good to add %JRE_HOME%/bin to your %Path% variable to avoid problems with missing MSVCR71.dll:

Running tinyPM installer

When you are ready with JRE and variables, simply run tinyPM installer and follow the wizard which will guide you through the installation process.

When installing on Vista or Windows 7 choose a folder outside of C:\Program Files like C:\tinyPM to avoid security issues.

Now all you have to do is run the “Start tinyPM” link from your “Start/Programs” menu and open the following link in the web browser:

http://localhost:8080

tinyPM logon screen should appear and you are ready to start!
Use:

username: admin
password: admin

Installing tinyPM as a Windows service

Make sure to use a proper tinyPM installer distribution (32-bit or 64-bit) that matches your system, otherwise the service won't run properly

If you want tinyPM to automatically run when the machine starts (as a service in the background process) all you need to do is to run:

%TINYPM_PATH%/bin/service.bat install tinyPM

This will create a service called "Apache Tomcat tinyPM" which will start automatically after the next machine restart. You can also start it manually without restarting the machine by opening Control Panel > Administrative Tools > Services. You can also change the startup mode there (it can be Automatic or Manual)

If you are using HSQLDB, then you need to change one more file:

%TINYPM_PATH%/webapps/ROOT/WEB-INF/hibernate.properties

Assuming that your %TINYPM_PATH% is "C:/tinyPM", you need to provide a full path to your /db directory like this:

hibernate.connection.url = jdbc:hsqldb:file:C:/tinyPM/db/tinypm;shutdown=true

This is because the service is using some other directory as a working dir and seeks /db dir with tinyPM data there (which is wrong).

Changing service configuration

If you want to verify or change tinyPM service configuration, then run the following command:

%TINYPM_PATH%/bin/tomcat6w.exe //ES//tinyPM

This will open a graphical interface for configuring Tomcat service running tinyPM.

Troubleshooting

1. After installing tinyPM Standalone it does not start. Nothing happens.
Make sure that you've setup JRE_HOME (if you use JRE) od JAVA_HOME if you use JDK.

2. I've installed tinyPM in C:\tinyPM on Vista or Windows 7 and it crushes during start reporting bugs related to file permissions.
You will need to give the owner of the folder full control in permissions tab on Windows folder properties.

If this documentation doesn't solve your problem or has left you with any questions, please don't hesitate to contact us at support@tinypm.com

Standalone (for Windows)