Platform User Manual
Contents
1. em 17 Ekaa EVIC ES ERR T 17 WiseWware UOVO 17 Ani OVC AETI O o H 19 Tr OUDS UO OLIN siina E 21 l g 4j properties ctus ist i ME BIDDER NUBE 21 August 2013 www oncaring com Page 3 of 21 Introduction This document describes the necessary information to install and configure the onAll system It has two major parts 1 onAll server describe the installation steps of the software part of the system 2 OnAll devices describes the preparation steps for each type of device that is integrated with the onAll core system Wireless network The onAll system works based on a wireless infrastructure All the considerations for its setup and configuration are not covered in this document For further detail on this subject please check the document named Wi Fi Network Best Practices August 2013 www oncaring com Page 4 of 21 onAll Server This section describes the necessary steps to install the software part of the onAll system in a Microsoft Windows environment The onAll system has 4 major components Database Front end Back end Location server xd cas oo Location prinlertys S erver Back end The 3 first components Database Front End and Back End are automatically installed in only one step The Location Server module is installed separately The installati2. wiseware xml To configure the belt clip device Explanation of each parameter can be found inside of the file as shown in the next example August 2013 www oncaring com Page 15 of 21 device connection port 5003 timeout check 2 info period 5 unreachable 300 gt ekahau connection enabled true port 8552 host 10 136 100 46 deviceType 3 penalty 10 gt lt device settings gt lt buzzer enabled true gt lt battery levels in gt battery low 12 depleted 3 very lowz 7 Time that the panic button needs to be pressed in order to trigger an alarm 0 zero to disable multiply by 10ms gt button duration 100 button duration default fall sensitivity Possible values are 1 Low 2 Medium 3 High fall threshold 2 fall threshold Time that the panic button needs to be pressed in order to shutdown the device in seconds 80 disables shutdown gt lt shutdown gt 10 lt shutdown gt lt Time after which an alarm is discarded if the device could not report it in seconds gt alarm discard 3600 alarm discard l Time between the moment the user removes the device and the reflection of that information in the INFO messages in seconds gt not worn 60 not worn Period during which the alarms are not reported after the device is worn in seconds gt event thr 7 event thr
3. 2 On the License Agreement dialog box make sure that the option for the acceptance of the terms is selected and click Next onAll Setup License Agreement Please review the license terms before installing onAll Press Page Down to see the rest of the agreement FFF FSS SS R SSS SSS SSS SSS SHS SHS SSS SSS SSH SSH SSH SSH HSS a zs222222222222222222222222222 a Insert License Agreement Header Here FFF FS SS SSS RRR R HSS HSS SHS SHS SHS SHS HSS HSS HSS HHS HHS l z2222222222222222222 2222222 Insert Licence Text Here Insert Licence Text Here Insert Licence Text Here Insert Licence Text Here If you accept the terms of the agreement click the check box below You must accept the agreement to install onAll Click Next to continue Nullsoft Install System v2 46 August 2013 www oncaring com Page 8 of 21 3 Select one or more components to install according to the options e For the onAll Back End Runtime environment Choose which features of onAll you want to install Check the components you want to install and uncheck the components you don t want to install Click Next to continue Description Select components to install Instalation of onAll Ruby Backend Runtime PostaresQL Environment onAll Backend onAll Frontend Apache Space required 16 3MB Nullsoft Install System v2 46 e For the onAll Front End Runtime environment Select components to install
4. Timeout value that the device waits for a reply to an INFO message with the COM TIMEOUT EN status flag on divided by 10s gt con timeout 5 con timeout Number of times the device sends INFO messages without waiting for a reply after waiting on one info wo cfg 2 info wo cfg device settings Step 4 Location server This step can be optional if the institution already has Ekahau services and the onAll application will use that same instance In this situation only the previous Back end configurations must be setup To install the Ekahau component just run the executable named Ekahau RTLS 6 0 2 Setup exe located in the root of the installation CD accepting all default options After the server is installed you are able to run the survey to map the areas that are going to be monitored according to what was defined initially For details about how to run the survey check the Wi Fi Network Best Practices Once the survey it is concluded it will be necessary to associate the identification of the areas given by Ekahau to the ones already inserted in the table with the Locations that must be done by editing directly the table in the database August 2013 www oncaring com Page 16 of 21 onAll Devices In this section you can find some specific configuration that need to be done on a device level for each type of device that is used with the onAll platform Ekahau devices The Ekahau devic
5. and select another folder Click Install to start the installation Destination Folder C onCaring Space required 121 9MB Space available 34 6GB Important Note In case he product is installed in a folder containing brackets for example C Program Files x86 then the following steps must be done v Go to command line and run command dir x in order to retrieve the short name for that directory ex progra 2 v Goto onAll installation directory and go to runtimeYapache conf extras v Edit the file httpd ssl conf v Search for the line normally line 62 with SSLSessionCache shmcb C Program Files x86 onCaring runtime apache logs ssl_scache 512000 And change the folder with the brackets for the short name so that it looks like this SSLSessionCache shmcb C progra 2 onCaring runtime apache logs ssl_scache 512000 Do not forget to escape the symbol with like shown above August 2013 www oncaring com Page 11 of 21 5 The installation process runs and gives a success message when concluded onAll Setup leo E 8 Installation Complete 2 Setup was completed successfully p Completed gg Copy to C onCaring yuntime apache conf Copy to C lonCaring runtime apache conf extra Delete file C Users ADMINI 1 AppData Local Temp apache msi Delete file C Users ADMINI 1 AppData Local Temp server crt Delete file C Users ADMINI 1 AppData Local Temp server key De
6. Java 4m Installation of onAll Support Database C PostgreSQL onAll Backend onAll Frontend Apache Space required 11 7MB e For the onAll Database Select components to install Java Diae Installation of onAll Ruby Support Database onAll Backend onAll Frontend Apache Space required 46 5MB e For the onAll Back End Runtime August 2013 www oncaring com Page 9 of 21 Description Installation of onAll _ Ruby Backend PostaresQL onAll Backend onAll Frontend Select components to install Java Apache Space required 42 9MB e For the onAll Front End Runtime Description Select components to install i L Java Installation of onAll _ Ruby Frontend C PostgreSQL onAll Backend onAll Frontend Apache Space required 14 6MB e For the onAll Front End Runtime Description Select components to install 7 Java Ruby PostgreSOL onAll Backend onAll Frontend Installation of Apache Space required 6 2M8 You can see the amount of needed disk space required the components being installed Once the intended components are selected click Next August 2013 www oncaring com Page 10 of 21 4 Select a folder for the installation location e g C onCaring and click Choose the folder in which to install onAll Setup will install onAll in the following folder To install in a different folder click Browse
7. atically If the device is off which usually is then you must click continuously on the help button until the red leds turn on and then change to blue the command window appears then Pos a August 2013 www oncaring com Page 18 of 21 The window shows the list of commands that can be executed the number to issue the command followed by the description of the action You just have to enter the number correspondent without clicking Enter to trigger the action you want to perform Regarding option 2 Change security the supported encryptions are WEP 40 or WEP 64 WEP 104 or WEP 128 and WPA WPA2 Note1 If there is a mistake writing the data needed for a specific option you will not be able to correct it the backspace will not work and you need to re enter the command Note2 the command window will not stay open for a long period of time if there is a period of inactivity it assumes option 9 Exit without saving and the window is closed Android device The Android mobile phone that will be used as the caregiver device needs to be prepared before handed to a caregiver so that there is a smoother adoption Install the application in the mobile phone You will find the application on Google Play https play google com store apps details id com oncaring onall caregiver After installed the application is not launched automatically you will need to start it manually and reboot the device After
8. e time it takes for an event to be escalated Escort Time The time after witch the users will be warned that an escort is taking too long Database Configuration dbHost 127 0 0 1 dbHost lt dbPort gt 5432 lt dbPort gt lt dbName gt b Luewater_new lt dbName gt lt dbUserName gt vital lt dbUserName gt lt dbPassword gt vitalsen lt dbPassword gt lt Database Configuration gt This represents the database configuration for the installation performed earlier and should not need to be change unless you are using your own database installation SMS enabled true gt lt ClickaTell gt username username lt username gt lt passSworc gt password lt passworc gt apilD apiD lt apilD gt lt ClickaTell gt lt SMS gt Allows the system to send SMS example the SMS that is sent to the Administrator as the last step of escalation of an alarm You must fill the credentials from the Clickatell service account from the organization If you do not have one you can create it on https www clickatell com August 2013 www oncaring com Page 13 of 21 ekahauConfig xml Configuration of the access to the Location server and the interpretation of some parameters of the Ekahau devices CommEkahau port 8550 host 10 11 128 11 username user password passwd gt port Ekahau s RTLS port 8550 by default host Location server ip username and password credentials to access Location ser
9. ender console layout ConversionPattern Xd amp 5p amp 9 24t 3L m n ilog4j appender console layout ConversionPattern Xd 5p amp 9 24t xc XL Sem also print category log43j appender SYSLOG org apache log4 j net Sys logAppender log4j appender SYSLOG syslogHost 127 8 80 1 Log43 appender SYSLOG Layoutzorg apache 10947j PatternLayout log4j appender SYSLOG Layout conversionPatternsXd 5p amp 9 24t XL m n log4j appender SYSLOG Facility LOCAL1 log43 appender f ile org apache log4j FileAppender log4j appender file File onall log log4j appender file layoutzorg apache log4j PatternLayout log4j appender file layout conversionPattern Xd 1p mm log4j rootLogger DEBUG console SYSLOG 3log4j logger onCaring DEBUG 309g43 logger onCaring Alarms DEBUG 30g43 Logger onCaring Generalz FF log4tj logger onCaring Lifecyc le O0FF log4j Logger onCaring Event 0FF 30g43 logger onCaring Event Siren OFF log4j logger onCaring Siren Wiseware O0FF log4 logger onCaring Siren Wiseware Wire OFF log4j logger onCaring Ekahau UI Menu 0FF log4j logger onCaring Ekahau UI Menu RTLS O0FF log4j logger onCaring Ekahau Alarm 0FF 30og43 logger onCaring Wiseware OFF log4j logger onCaring Wiseware Wire O0FF log tj logger onCaring Wiseware Lifecyc le O0FF Axis2 log43 logger org apache axiom zWARN log43 logger org apache axis2 WARN Hibernate log43 lo
10. es already come preconfigured by onCaring and they are automatically added to the onAll platform for usage as soon as they start communicating with the system Further information about these devices please contact the onCaring support team Wiseware device Follows the description of the configuration steps needed in order to setup the communication of the Wiseware devices with the onAll platform Connect your computer from the USB port to the serial port of the device and establish the connection using Putty or another remote communication tool with the following options o Connection type Serial o Serial Line Com1 COM2 o Speed transmission rate 230400 bps Click OPEN to create the connection August 2013 www oncaring com Page 17 of 21 Category Session Logging Terminal Keyboard Bell Features Window Appearance Behaviour Translation Selection Colours Connection Data Proxy Telnet Rlogin SSH Serial Bt purr coros li Basic options for your PuTTY session Specify the destination you wantto connect to Serial line Speed COM4 230400 Connection type Haw Telnet Rlogin SSH Serial Load save or delete a stored session Saved Sessions Wiseware games i Save Delete Close window on exit Always Never Only on clean exit Open Cancel If the device is turned on the command window will appear autom
11. gger org hibernate WARN log4tj logger org hibernate SOL O0FF 3log4j logger org hibernate tvpe O0FF 31og43j logger org hibernate tool hbm2ddl OFF log4 logger org hibernate pretty O0FF xlog4j logger org hibernate cache FF log4j logger org hibernate transact ion O0FF log4j logger org hibernate jdbc O0FF log4j logger org hibernate hgl ast AST OFF log4 logger org hibernate secure 0FF Log43 logger com mchange v2 4RN More details about this file can be found at http logging apache org log4j 1 2 manual html August 2013 www oncaring com Page 21 of 21
12. lete file C Users ADMINI 1 AppData Local Temp httpd vhosts conf Starting Apache Execute net stop Apache2 2 Execute net start Apache 2 2 Completed Nullsoft Install System v2 46 onAII Setup onAll has been installed on your computer Click Finish to close this wizard Click Finish to leave the installation wizard August 2013 www oncaring com Page 12 of 21 Step 3 Back end configuration There are 4 configuration files 1 configuration xml located in folder c etc vitalsen 2 ekahauconfig xml located in folder c etc vitalsen 3 constants rb located in folder onAll web config initializers 4 wiseware xml located in folder c etc vitalsen The detail about the possible configurations that can be done in each one is detailed below configuration xml Heart Rate polling 30 gt lt value in minutes Temperature polling 30 value in minutes Promote Event time 180 value in seconds Escort Timeout time 3 value in minutes Weight polling 60 gt BP polling 60 gt Heart Rate The interval between consecutive heart rate readings Temperature The period where the system will ask the devices for a new temperature measurement Weight The period where the system will ask the devices for a new weight measurement BP The period where the system will ask the devices for a new blood pressure measurement Promote Event Th
13. o possible to have all components running in one server only Installation Steps Step 1 Prepare Installation Get the CD with the complete installation package from onCaring team Firewall Ports The following ports should be open on the firewall in order for onAll to work properly Port Protocol Description tcp OnAll web access 443 onAll web access 8182 Android application 9090 Android application 8552 Ekahau 8553 Ekahau 8550 Ekahau 5432 PostgreSQL 5003 Step 2 Install the components Database Front End amp Back End The database is PostgreSQL the front end runs on Ruby and the back end framework is the knopflerfish an open source OSGI service platform All of the installation files that are necessary are available in the installation CD And the installation procedure for these components is very easy to follow in a Next Next approach with very few input options 1 Run the executable file named install exe that is located in the root of the CD You should get a welcome message marking the beginning of the installation Click Next August 2013 www oncaring com Page of 21 onAII Setup Welcome to the onAll Setup Wizard This wizard will guide you through the installation of onAll It is recommended that you close all other applications before starting Setup This will make it possible to update relevant system files without having to reboot your computer Click Next to continue
14. on procedures for both steps are described below August 2013 www oncaring com Page 5 of 21 Requirements The onAll platform needs the following infrastructure to work For the onAll core Front end Back end and Database it is necessary to fulfil the following requirements Minimum system e Single core processor Intel Pentium 4 or equivalent 2 4 GHz e 1 GB RAM e Windows 7 Professional Recommended System e Dual core processor Intel Core 2 Duo 2 10 Ghz e 2 GB RAM e Windows 7 Professional For the Ekahau location server the configuration should be evaluated for installations aimed to control a high number of customers For the Location server the requirements are Minimum system Intel Pentium processor 2GHz e 1 GB RAM e Minimum free space on hard disk 500 MB e Windows XP Professional 64 bits Windows 2000 or Windows 2003 Server 64 bits Recommended System for a monitoring are up to 5 000 m or up to 100 devices e Intel Pentium 4 e 1 GB RAM e Windows 7 Professional 64 bits Recommended System for a monitoring are up to 50 000 m or up to 500 devices Intel Pentium 4 or Intel Xeon e 1GBRAM e Windows 7 Professional 64 bits or Windows Server 2008 64 bits Recommended System for a monitoring bigger then 50 000 m or with more than 500 devices Intel Xeon e 2 GB RAM August 2013 www oncaring com Page 6 of 21 e Windows 2008 Server 64 bits It is als
15. oncaring onall Installation Manual Version 3 1 3 August 2013 www oncaring com Welcome We hope that the onAll platform will be a useful tool that will allow you to offer better care to your customers If you find anything that you would like to see improved in the product or if you have any suggestions or comments please report them to the onCaring team This document version applies to the Release 3 1 2 of the onAll product August 2013 www oncaring com Page 2 of 21 Table of Contents OBER CO iT 4 Mareless neEWOF Iioc eoa occ ann Edad ali koc inu De isa d zu o DACIA CORR ENERO E EC Re Cree IRSE 4 dni alg eae pees secu sc idee apse tee ects re 5 BG EEE CN CNG S sti sa ececta vaca E E E E 6 BES CAEN UN SU UNS TDI 7 Step 1 Prepare Installatio I uin ie ti een rer ciis euni cit s sinh erst rri trent EU sciet 7 Step 2 Install the components Database Front End amp Back End 7 Step 3 Back end configuration eee esee eene nenne tenete nnne retten tuno oni 13 OWA UT AGI ONL XD nentes oriri ae tete Po epp rte pci uns apre ERU 13 ekaan Con e me Q 14 COBSPIIES P DE ono ern ert nner ce ee DUE OMM DIGNE EUER IE MEINE 15 MES VV Ns IH E espe E hu DERNIER MEIN M M CE aeecseeeee 15 SU CY Oe v EDOCOHOISODURT aosdcustntuE Itin cater am bp REDIMI Dd M DR eer rete eer 16 OF DC VC ERE
16. this first launch the app will start automatically each time the device is turned off The Caregiver user will not be able to stop the app without knowing the settings access code pin By default this pin code is 0000 There are some Settings options accessible through the app menu that allows the Administrator user to configure some parameters 1 onAll generic configuration e Hostname e Port e Connection Timeout e Retry Alive e Wi Fi Scan for location purposes e Wi Fi Update time to send Wi Fi scans for location updates e Rest Settings o Port o Timeout Movement Settings o Use Motion if enabled allows the device motion to trigger actions o Location Threshold The lower the value the more frequent locations updates due to location will happen August 2013 www oncaring com Page 19 of 21 2 Ekahau configuration e Hostname e Ekahau Location Port e RTLS o Username and Password o RTLS Port o Connection Timeout In the Setting menu you will also be able to find the Close Application action August 2013 www oncaring com Page 20 of 21 Troubleshooting For advanced troubleshooting selective logging with different severity levels can be configured in the file log4j properties located in the folder onAll srv osgi conf log4j properties Configuration for logging log4j appender console org apache Log43 ConsoleAppender log4j appender console Llayoutzorg apache l0g4j PatternLayout log4j app
17. ver Battery low battery level value 11 gt this is a percentage depleted battery level value 2 gt this is a percentage lt Battery gt low battery level and depleted battery level battery level in that are interpreted by the onAll as low level and depleted level values are Configuration of the caregiver device o Uunreachable the interval in seconds since the last communication after which the device is considered out of range o yank propagation area considered for sending the request for help from one caregiver to the other caregiver devices all the caregivers in the same floor the entire facility or none that means that no alarm is sent Configuration of the wrist device for customers o unreachable how long after will the onAll platform wait after missing contact with the device to interpret the device as being out of range August 2013 www oncaring com Page 14 of 21 constants rb To configure the path to the Location Server by default it is located in localhost 8550 encoding utf 8 WS IP 127 0 0 1 MAX SESSION PERIOD 15 PATIENT MAP VIEW ENABLED true ASSET MAP VIEW ENABLED true EPE HOST localhost EPE PORT 8550 EPE USER admin user EPE PASS admin pass EPE ROOT http EPE_USER EPE_PASS EPE_HOST EPE_PORT SILENCE ENABLED false EMAIL BUG mail oncaring com EMAIL_SUG mail oncaring com
Download Pdf Manuals
Related Search