openMEDIS Installation Guide

August 2015
 openMEDIS | User Manual

Table of Contents
Introduction 1
1 openMEDIS as a tool for medical equipment inventory 2
1.1 What is openMEDIS? 2
1.2 Specifics of openMEDIS 2
2 Installation 3
2.1 Installation of web-server 3
2.2 Downloading the source code 3
2.3 Creating the Database 3
2.4 Deploying openMEDIS 4

i
 openMEDIS | User Manual

Introduction
openMEDIS software (SW) is an information system for medical equipment inventory making
and medical equipment maintenance. It allows the establishment of medical equipment
database on the level of the facility. Using such a database the users and managers can
obtain in fast way updated information about the equipment available, maintenance data and
make use of this information for decision making.
openMEDIS is very easy to use, the user interface is simple and intuitive, most of the
information is already embedded in the application (drop-down lists) and thus, there is no
need to enter it manually.
This document contains the basic instructions for installation of the system.

1
 openMEDIS | User Manual

1 openMEDIS as a tool for medical equipment

inventory

1.1 What is openMEDIS?

• openMEDIS (open medical equipment data international system) is a simple

and flexible open source tool for inventory and control of the medical equipment;
• Managerial decision-making tool on the medical equipment available in the facility;
• Key principle – enter minimum set of data to get the maximum information for the
management of medical equipment

1.2 Specifics of openMEDIS

The advantage of this software is that it can be installed and operated both locally and in the
network. Basic server and client requirements are described in Annex 1.

Working on a local computer. If the computers are not connected to the Internet, openMEDIS
application and web-server programme can be installed to the local computer. And thus, it
will be possible to run the programme from this computer only.

Working in a local computer network. openMEDIS is installed on the intranet server and all
the users from the facility have access to one database; meaning that all computers of the
facility connected to the intranet can have access to the software and the database.

Working on-line (in the Internet). Administrator installs openMEDIS on an Internet-server. All
the users can have access to the software and the database no matter what computer they
are using. In order to do that it is enough to enter the website address, go to the site and
enter one’s login and password. Working online makes it possible to establish a regional
medical equipment inventory database that is located on one server and all the registered
users (both from rayon and oblast level) have access to it.

2
 openMEDIS | User Manual

2 Installation
In this chapter we will describe the procedures needed to install openMEDIS system.

2.1 Installation of web-server

XAMPP is a free and open source cross-platform web server solution stack package
developed by Apache Friends, consisting mainly of the Apache HTTP Server, MySQL
database, and interpreters for scripts written in the PHP and Perl programming languages.
The basic steps to install XAMPP in your machine/server are:
i. Download latest version of XAMPP server from
https://www.apachefriends.org/index.html.
This installation contents Apache, MySQL and PHPMyAdmin.

ii. Run downloaded file and install the XAMPP Server.

iii. Be sure that XAMPP Server starts when the computer starts (For Windows
Operating Systems just put the shortcut in Start/All programms/startup)

iv. In case you’re installing openMEDIS in a server set up XAMPP Server for access
from network Downloading the source code

2.2 Downloading the source code

As mentioned before, openMEDIS is open source software. The source code is located in
the web repository SourceForge ( http://sourceforge.net/ )
The source code for the latest version of openMEDIS, version 1.4.1, is located on:
http://sourceforge.net/p/openmedis/code/HEAD/tree/branches/Version%201.4.1/

To download the source files, please click on “Download Snapshot” located in the top right
corner of the source code window.

2.3 Creating the Database

To create database, access the following link : http://localhost/phpmyadmin/
In PHPMyAdmin, create a new Database with the name “openmedis”. You can also create a
general user and password for “openmedis” database, if you do this save these credentials.
After this, import the openMEDIS DB file in PhpMyAdmin using the feature “Import”. The
database structure for openMEDIS version 1.4.1 can be found in the source code folder, in
DB_Scripts\openmedis_DB_1.4.1.sql.
The next step will be to verify the field “DefaultDB” of the database table login. The name in
the field should match the database name, in this case “openmedis”.

3
 openMEDIS | User Manual

2.4 Deploying openMEDIS

The basic steps to deploy openMEDIS are the following:

1. Create a folder called openmedis in the htdocs directory of XAMPP

2. Copy the openMEDIS source files to the htdocs directory:

3. After having all the source files of openMEDIS in the htdocs directory, edit
Common.inc.php file and update with the database credentials referred in the
chapter above
After this the openMEDIS application should be accessible by typing the following URL in a
web-browser window:
- http://localhost/openmedis - for local computer installation

- http://your_server_address/openmedis - for server installation

4
 openMEDIS | User Manual

Annex 1 – Basic Server requirements

The Server:

• Operating System: Windows (2000, 2003, XP, Vista, 7, 8)

• Web Server:
o Apache 2.2.x or higher
• PHP Compatibility:
o 5.4.4 or higher
o Memory_limit no less than 256Mb (preferably 512)
• MySQL:
o MySQL Community Server (GPL) version 5.5 or higher
o InnoDB storage engine
• Server - hosting - setup:
o Ability to run scheduled jobs (crontab) with PHP 5
o Ability to override options in .htaccess files
o Graphical database administration program (e.g. PhpMyAdmin)
• Storage (for application and database only)
o > 50 GB
• RAM
o > 2 GB
• Communications equipment for forming LAN and WAN networks

The Client:
• Operating System: Windows XP, 7, 8
• Dual_core Processor 1,50 GHz
• RAM
o 2 GB
• Web-browser (minimum):
o IE 8, Mozilla Firefox 4, Plugins Firefox:
Shockwave Flash 18
Adobe Acrobat 11
• Printers (for data collection forms and reports printout)
• Access to Internet
o Internet speed: no less than 5 Mb/s