PatientOS installation guide

PatientOS installation guide1. Overview1.1 ProcessThe basic steps to installing PatientOS are divided into the backend system and front end clienta) Backend formation piece the PatientOS software base version.Install the PatientOS updater software.Install and urinate a PostgreSQL database version 8.2 or higher. implication the PatientOS database contents.Start the PatientOS applications programme host.b) Frontend nodeInstall the PatientOS software.Install the latest software updates.Start the PatientOS client.1.2 DefinitionsPOSRefers to the PatientOS software as a system.JavaProgramming language developed by SunPostgreSQLAn Open Source (free) database server, an resource Oracle, SQLServer, etc.Application ServerThe backend J2EE server which clients connect to.ClientThe rich (fat) client computer graphic user interface (GUI) with which the users interact.2. Software Installation2.1 PatientOS Download2.1.1 WindowsThe PatientOS transfer is hosted at Sourceforge. Here is the direc t URLWindows Base Installhttp//downloads.sourceforge.net/patientos/PatientOS-0.97-Setup.exePostgreSQL Database Server Softwarehttp//downloads.sourceforge.net/patientos/postgresql-8.3.7-1-windows.exePatientOS Demo Database Contentshttp//downloads.sourceforge.net/patientos/ usher-0.97-database.ziphttp//downloads.sourceforge.net/patientos/demo-0.97-datafiles.zipLinks from the website redirect to sourceforge where it is often difficult to puzzle the download link look for the text use this direct link circled in red below.2.2 PatientOS Base Installation2.2.1 InstallerRun the downloaded setup executable PatientOS-0.97-Setup.exe and conserve the promptsa) Installer Language SelectionThe first language selection prompt is for the installer language not the PatientOS language.b) Destination DirectoryThe destination directory heedlessnesss to Program Files. The directorys disk should reserve at least 750MB space for the installation. A client only install will require less space, the ser ver will grow significantly larger. The target directory defaults to 0.97. It would recommended to install into a version agnostic directory such as CProgram FilesPatientOSdemoorCProgram FilesPatientOSproductionHowever for the rest of the document we will assume the thoroughfare installed as CProgram FilesPatientOS.97 c) StartProgramsBy default the software shortcuts will be stored in Start Programs PatientOS 0.972.3 PostgreSQL Installation2.3.1 InstallerRun the downloaded PostgreSQL installer postgresql-8.3.7-1-windows.exeAccept the default directory to install PatientOS into.The super user parole is critical to remember or write down it is required to administer the databases. go for the default port 5432.Use the default locale.Press next and finish to install the database software.3. Database Installation3.1 Create DatabaseBefore the PatientOS can start properly a database is requireed with a username and password the application server can connect to. There also needs to be PatientOS specific contents in the database.3.1.1 PGAdminIIIThe PostgreSQL installation also installs a graphic tool to manager the PostgreSQL databases. Use Start Programs PostgreSQL pgAdmin III to start the tool.Double ruffle on the single line PostgreSQL Database Server to connect to the database. You will be prompted for the postgres password entered during the PostgreSQL installation.3.1.2 Create Database LoginSelect Login Roles and skilful click and choose New Login Role.Enter demopos for the username, password and check off all the privileges.3.1.3 Create DatabaseSelect Databases and right click and choose New Database.Enter demopos for the database name and user name.The encoding will need to match the encoding selected for the installation. If you turn over an old installation need to drop the existing database. Stop the application server and execute the following commands.cd Cprogra1patientos.97serverdatabaseCprogra1postgresql8.3binpsql -U demopos demopos drop sc hema public cascadecreate schema publicq3.2 Import PatientOS Database ContentsLoad a Demo Database3.2.1 Import PatientOS Demo Database and Demo FilesThe demo database has binary files that are database specific.Download and unfasten the corresponding database files and database contentshttp//downloads.sourceforge.net/patientos/demo-0.97-datafiles.zipUnzip and overlay the files in the data directoryCprogra1patientos.97serverdatahttp//downloads.sourceforge.net/patientos/demo-0.97-database.zipStartRuncmdcd desktopCprogra1postgresql8.3binpsql -U demopos demopos demo_database.sqlSee forum for discipline on renaming the demo facility to a facility of your choice.4. System Startup4.1 InstallationIt is assumed that the Windows, Linux or other Installation Guide has been followed and that you havea) PostgreSQL database installedb) Import PatientOS database contentsc) Installed the application server softwared) Installed the client software4.2 Application ServerThe application server is JB oss version 4.2.0 GA with the PatientOS specific libraries and configuration files. The application server is required to be running before the client can start. The application server can run on the same server as the client.4.2.1 Appserver shell scriptThe windows installation creates a script appserver.bat with a shortcut in Start Programs PatientOS Start Application Server (first)The working directory must be the same as the script. Start the application server.For a successful installation the last line printed to the shell is Instances Found 04.2.2 ServiceThe application server runs perpetually and in a production setting should be configured as a service. The application server takes 20 seconds to start on a 2 ghz processor. Once started the server typically only needs to be restarted for upgrades.On windows this is the first time the server has been installed you may need to abbreviate Unblock for this dialog5. Client StartupThe client can run on the same server as the application server by default. To have the client connect to an application server running on a remote host edit the shell server patientos.batOn windows right click on the shortcut called Start Client (second) and select Edit. This should open an editor where you can change the script.On linux cd /patientos/0.97/client/binvi patientos.sh5.1.1 Client shell scriptTo connect to a remote host change localhost to the hostname or IP address of the server running the application server.5.2 LoginLogin to the client with demo/demo to access the system as a privileged physicianadmin/admin to access the system as an administrator