OpenVPMS Installation (Windows)

Important Note- when installing OpenVPMS you should be logged in on an account that has administrator privileges!

Download OpenVPMS Installation Files

  • Download the latest OpenVPMS Installation files . The following assumes OpenVPMS 1.5.1 is being installed.
  • Create a folder to unzip the release in. The following assumes a folder named C:\OpenVPMS
  • Unzip the Installation Pack to the C:\OpenVPMS folder. This should create a C:\OpenVPMS\openvpms-release-1.5.1 folder with the necessary files to install OpenVPMS.
  • Create a folder called C:\OpenVPMS\Installation

Open Office and JDK Installation

  • Download Open Office from openoffice.org and save in C:\OpenVPMS\Installation folder.
  • Double Click on the installation file in C:\OpenVPMS\Installation folder.
  • Unpack to the default location (Desktop)
  • Select Complete Installation
  • Select File Types Open Office will be default application for. This is your choice !
  • Remove Installation Files from Desktop.
  • Start Open Office and set options as required.

Open Office Path Configuration

  • In My Computer->Properties->Advanced->Environmental Variables double click on System Path variable and add path to OpenOffice program folder to end.
  • Click OK to save settings.

JDK Configuration

In order for other applications to be able to find the java installation we need to set an environmental variable on the system.

  • Using Windows explorer navigate the the location of the installed java installation.
  • Highlight the address bar and copy using Control-C
  • Right Click on My Computer and select Properties
  • Click on the Advanced tab and then click on Environmental Variable button
  • In the System variables section click New
  • In Variable Name type JAVA_HOME
  • In Variable value hit Control-V. This should enter the path name we copied before.
  • Click OK on all open Dialogues.

MySQL Installation

  • Download the Windows MySQL installation file from the MySQL site.
  • Select Windows Essentials (x86) and download into C:\OpenVPMS\Installation
  • Double click mysql-essential-5.0.45-win32.msi in c:\OpenVPMS\installation folder.
  • Select Typical Installation
  • Skip Sign Up
  • Select Configure MySQL Server Now
  • Select Developer Machine (Typically on server would select Server machine)
  • Select Multifunctional Database
  • Select Decision Support option (Larger installs would utilise manual connections settings. OpenVPMS application does connection pooling)
  • Select Enable TCP/IP Networking
  • Select Enable Strict Mode
  • Select Standard Character Set
  • Select Install as Windows Service
  • Select Include Bin Directory in Path
  • Enter the root password as openvpms twice
  • Select Enable root access from remote machine
  • De-select Anonymous User
  • Click Execute
  • Sometimes will fail on setting security and give option to Retry. Click Retry and should succeed.

MySQL Configuration

  • Stop the MySQL database server. My Computer->Manage->Services->MySQL. Right Click and Stop.
  • Navigate to MySQL application folder C:\Program Files\MySQL\MySQL Server 5.0
  • Save copy of my.ini file
  • Double click on my.ini file at the bottom of the file add the lines

    max_allowed_packet=16M
    innodb_file_per_table

  • save the file
  • Restart the MySQL server

MySQL GUI Tools Installation

  • Download the MYSQL GUI Tools the MySQL site
  • Select the Windows X86 option and save into C:\OpenVPMS\Installation folder.
  • Double click on mysql-gui-tools-5.0-r12-win32.msi file in C:\OpenVPMS\Installation folder.
  • Accept License
  • Select default location
  • Select Complete install
  • Create shortcut to to MYSQL Administrator on desktop

MySQL Administrator Configuration

  • Double Click MySQL Administrator icon
  • Click Elipses next to Stored Connections
  • Click New Connection Enter localhost, root, openvpms and localhost into fields.
  • Click Apply and then Close Select stored connection and enter root password (openvpms) and click OK.

Apache Tomcat Installation

  • Download Apache Tomcat and save in C:\OpenVPMS\Installation folder
  • Double click on apache-tomcat-5.5.28.exe file in C:\OpenVPMS\installation folder.
  • Select webapps in the available components
  • Select default location.
  • Set the admin password to openvpms
  • Select the default JRE location. (If you happen to have mutliple JRE locations select the one installed during the Java SDK installation - Must at least be a 1.5XXX version)
  • De-Select ReadMe and Run Apache Tomcat

Apache Tomcat Configuration

  • Run Configure Tomcat from Apache Tomcat program menu.
  • On Java tab in Java Options section add

-XX:PermSize=128m
-Xincgc

  • Set Initial Memory Pool and Maximum Memory Pool  to same value dependent on number of users.  Suggest 512M.
  • Clikc OK

IReport Installation

  • Download IReport  3.0.0 from sourceforge and save to C:\OpenVPMS\Installation folder.
  • Double click on the iReport installation file in the C:\OpenPMS\Installation folder.
  • De-select sources
  • Select default location

MySQL Database Driver Setup

  • Download MySQL connector from MySQL  and save to C:\OpenVPMS\Installation folder
  • Copy the connector file mysql-connector-java-5.1.6-bin.jar found in the downloaded zip file to c:\OpenVPMS\openvpms-release-1.5.1\lib folder.
  • Copy the same connector to Tomcat shared library folder i.e C:\Program Files\Apache Software Foundation\Tomcat 5.5\shared\lib

OpenVPMS Database Setup

  • Open a command prompt.
  • Navigate to C:\OpenVPMS\openvpms-release-1.5.1\db
  • Start the mysql command line client and enter the following commands

    mysql -u root -p
    mysql> source createdb.sql;
    mysql> use openvpms;
    mysql> source db.sql;
    mysql> quit;

  • Navigate to C:\OpenVPMS\openvpms-release-1.5.1\bin
  • To load the database with data suitable for a site converting from an existing system next enter dataload base
  • To load the database with data suitable for a new site enter dataload setup

OpenVPMS Service User setup

  • In My Computer -> Manage select Local Users and Computers -> Users
  • Right click in User Pane and select New User...
  • Enter user name and password as openvpms (you may use a different password for security but remember for later Apache Tomcat step)
  • De-select change password at next login.
  • Click Create.
  • Double click new user in list and add to Administrators group.
  • Logout and login as new openvpms user.
  • Run open office and check no startup prompts.
  • Logout and login as your local administrator.

OpenVPMS Application Install

  • Copy openvpms.war file from c:\OpenVPMS\openvpms-release-1.5.1\webapps to Tomcat Webapps folder at C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps

Apache Tomcat Service setup

  • In My Computer ->Manage ->Services right click the Apache Tomcat service and select properties
  • On General tab select a Startup type of Automatic
  • On Logon tab enter openvpms and your openvpms user account password setup above.
  • Click on OK
  • Start the service by right clicking and selecting Start

OpenVPMS Test