Professional Documents
Culture Documents
Installation Guide
PHILIPS
453564589121
PRINTED IN THE U.S.A
OCTOBER 2017
REVISION G
IBE provides a single, standards-based point of interoperability between Philips clinical systems and enterprise
information systems while reducing complexity and cost in the healthcare environment. IntelliBridge Enterprise can
also be used to connect with other information systems such as those associated with comparative effectiveness
research. The below Figure 1.2.1 describes basic overview of IBE server.
The Figure 1.2.1 shows Philips products interoperating with Hospital external systems through IBE. Each component
shown in Figure 1.2.1 is described below:
Philips Products: This can be one or more Philips products/product portfolios that are supported on the
IBE.
Hospital External Systems: All external systems that Philips products/product portfolios interoperate with.
Examples: HIS, EMR, CPOE, LIS etc.
Philips Shared Staging Service: This is a software component that is shared between Philips client
applications/systems to provide a single service for processing patient demographics, order information and
lab information when interfacing to Hospital Information Systems (HIS). Example: HIF (Healthcare
Integration Foundation) / PI (Patient Index) is a shared staging service across all client application/systems
requiring Patient Demographics from EMR system.
Microsoft SQL Server: This is used to host the databases and its components required for IBE and
subsidiary components such as HIF
Orion Rhapsody Interface Integration Engine: This is the Interface Engine used to build the interfaces
between each Philips product and corresponding Hospital External System.
Philips Single Pipe and Product Profiles: Every product has its product specific profile using standard
messaging protocols and application specific messaging formats. These profiles are built on top of Orion
Rhapsody Interface Integration Engine.
Philips Product Extensions: These are the existing interfaces and interface features that are consumed in
IBE when the products/product portfolios are adopted. Example: Agilink, Surelink etc.
Services: There are several system level services required for IBE to function. These services run under
the administrator account on the operating system. Example: HIF service, PSA service, PIC iX ICIP service
etc.
Configuration/Tools: IBE consists of configuration tools and other tools that help in IBE deployment,
maintenance and monitoring. Below are the most commonly used tools:
o IBE Configuration Wizard: This is a UI based windows application that helps in installing and
configuring IBE database and service components.
o Audit Trail: This is a UI based application that allows viewing the user/product based Audit
information of the interface engine. This provides information on user logins and modifications to the
interface integration engine components.
o PSA: PSA allows network connectivity to Client systems from Philips network for Support and
Administration.
o Alert Viewer: This is a web based application that allows viewing any exceptions in the message
transfer related to particular features like Device Data in IBS, IIC, IICiX, IP5 and SSPM products.
o Rhapsody Lookup table and variables migration tool: Support for migration of values in Rhapsody
Lookup table and variables
On-site Configuration:
Site/environment preparedness is to be completed by Field Service Engineer along with Hospital IT staff to check
the system, configure and customize it for local conditions, perform a set of test runs in the presence of the customer,
and create a final Drive Image backup. Details of the procedures used are found in the Implementation Guide.
To facilitate rapid processing of the Field Problem Report, the following should be sent with the Field Problem Report:
A copy of the IBE error-log-files, screenshots, if available and System configuration. Use the Rhapsody Console or
Utility folders to collect these files.
Please note that IBE Support team mail id is for internal use only and should not be shared with customer.
CAUTION
Example(s) Explanation
Esc Keys on the keyboard – press indicated key to perform
action
Proceed with installation… General informative or instructional message
cardio, D:\MSSQL, John Smith Information which appears on the screen
C:\WINNT\System32… Information you enter (type) using the keyboard
Menu or pull-down list items in sequence to be
Start > Programs > …
followed
Application buttons on the screen – use mouse to
Cancel activate
Insert CD
Wait for the period shown in the instructions
Explanation of information with a direct bearing on
NOTE
current procedures
Explanation of potential system-wide or process
CAUTION specific problems or difficulties which may result if
certain steps are not followed
Explanation of potential system-wide or process
WARNING specific hazards, or safety risk problems which may
result if certain steps are not followed
IBE can be installed on a Physical server or on a VMware ESXi 5.0 (or later) virtual machine. The hardware and
software requirements are detailed in the IBE IT Specification. We recommend having 2 servers setup – one for
Production and the other for Test. This section details out the IBE installation.
Checkpoints
Both hardware and software requirements (as specified in IBE IT Specification) should be met.
The hardware should be up and running. Basic system configurations should be completed.
IBE server should be an independent box and should not be shared with other products.
This part is performed by customer IT personnel or by Philips as a service by the service team on behalf of the
customer, only if contracted to do so.
Install and configure the Operating System per requirements stated in the IBE IT Specification guide
Create Administrator level user with all necessary read/write/execute permissions on the local server for
installation
Download MS SQL software as per requirements stated in IBE IT specification guide
Install supporting applications IIS, .NET 3.5 SP1 and .NET 4.5.2
NOTE
The operating system, SQL Server and virtual machine are not part of IBE software package
but purchased by customer. The installation/configuration/maintenance details of the same are
out of scope of this guide except SQL Server.
Installation Responsibilities
IBE installation is performed by a combination of customer IT Personnel and Philips Technical Personnel.
1. Rhapsody default
2. IBE default
3. HIF SupportUser
This process refers to ordering licenses for the IntelliBridge Enterprise solution.
1. Field places Customer Order in Field Client MP1 or a similar system, with the option and quantity.
2. The Sales Order is transferred into factory MCP.
3. The factory turns the Sales Order into a Production Order, and releases to Production.
4. This Production Order triggers lower level BOM item (the License), and causes the buyer to place PO with
Orion, referencing the SSD number.
5. Production makes the Orion Label, processes and ships the production order.
6. Production sends an email to the predefined field addresses. All certificates go to all pre-defined mailboxes:
CIS-I@philips.com (GSSI),
CMSITPS@philips.com (NA),
NCCsupport@philips.com (Sure Signs),
GICC@philips.com (EMEA and APAC/Xcelera/ISCV) and
dl_DECG_IBE_Activate@philips.com (NA DECG)
7. The service organization checks their mailbox for the “license to use” certificate and when received can go
to the Orion webpage to make the request for the license
For COE PCMS International, please send your Orion Rhapsody License requests to: CIS-I@philips.com
For EMEA and APAC Xcelera\ISCV, please send your Orion Rhapsody License requests to: GICC@philips.com
For all others (Americas), please use the Orion IBE Licensing web site to place your request using the web
forms. The URL is: https://orionhealth.com/philips-license-request The current username and password can be
obtained by sending a request to ibesupport@philips.com If for any reason you cannot access the web site due to
network issues or system down, please send your Orion Rhapsody License requests to:
ibesupport@philips.com with the information listed in the table below
All requests for Non-Production licenses should be directly sent to ibesupport@philips.com with the information
listed in the table below.
License file will be emailed to the Email address entered in the form.
CAUTION
Orion Rhapsody PROD license should be installed within 90 days of procurement.
If not installed, the PROD license shall expire post 90 days.
Orion Rhapsody NON-PROD license should be installed within 30 days of procurement.
If not installed, the NON-PROD license shall expire post 30 days.
The Operating System (OS) installation is carried out by either Hospital IT or local vendors. Please choose default
settings while installing the OS.
The Software Installation section includes the installation of all 3rd Party software required by the system. After
installation, proceed to IBE Implementation Guide for product interface configuration in Rhapsody.
WARNING
Software Packages that are not specifically required and/or approved
should NOT be installed on the IntelliBridge Enterprise system
Failure to comply with this requirement may lead to performance degradation or even data loss
Use Figure 6.1: IBE System Setup Installation Flowchart for IBE System Setup
NOTE
Internet Connectivity and Windows updates should be enabled for .NET Framework
installation
6.1.1 Prerequisite
You can open the Local Group Policy Editor by using the command line or by using the Microsoft Management
Console (MMC).
To open the Local Group Policy, at a command prompt or in Search, type gpedit.msc, and then click OK or press
ENTER.
3. In the Add or Remove Snap-ins dialog box, click Local Group Policy Editor, and then click Add.
5. Click This computer to edit the Local Group Policy object, or click Users to edit Administrator, Non-
Administrator, or per-user Local Group Policy objects.
6. Click Finish, click Close, and then click OK. The Local Group Policy Editor opens the Group Policy object
(GPO) for you to edit.
Windows has to download the 3.5 installation files, but the server is configured not to use Windows Update
(common for managed servers), but WSUS.
1. Start the Local Group Policy Editor or Group Policy Management Console.
2. Expand Computer Configuration, expand Administrative Templates, and then select System.
4. Select the Contact Windows Update directly to download repair content instead of Windows Server
Update Services (WSUS) check box
Tools (gear wheel) > Internet Options > Security > Internet > Custom Level > Downloads | File Download = Enable
Run PowerShell as an Administrator and Enter this, to download and install .net 3.5:
Goto
Server should be able to download the updates for .Net 3.5 installation files and installed updates should be seen
in Update History. Below is a sample screen shot:
SP=1 and Version = 3.5.30729.4926 confirm .NET 3.5 SP1 is installed on the server.
3. Click Download
4. Below screen should appear which should start downloading the installer. If download does not start
automatically, click on Click here as marked in red below.
8. Use the checkbox I have read and accept the license terms.
10. Launch
https://www.microsoft.com/en-us/download/details.aspx?id=44211
12. Select the download as per the bitness of the IBE Server and click Next.
Pre-requisite
Correct version of MS SQL Server and/or Service Pack is downloaded as per IBE IT Specification Guide
Administrative rights to the Operating System of the IBE server to install MS SQL Server
2 Make sure the Windows Location is configured correctly (e.g. Japan, see section 5)
3 Right Click on SQL Server installer and select Run as administrator to launch the installation wizard
4 Press OK to install the prerequisites and continue
7 Select Installation
8 Select New SQL Server stand-alone installation or add features to an existing installation
14 If the License Terms are not acceptable, press Cancel to stop the install process
16 Global Rules screen appears in a flash and if all prerequisites are met, Microsoft Update screen appears.
Click Next.
17 Install Setup Files screen appears in a flash and if all successful Install Rules screen appears
18 Check that no errors appear, ignore the warnings on Computer domain controller (not on member servers),
Microsoft .NET Application Security and Windows Firewall.
Figure 6.2.1.1 Example SQL Server 2008 Setup Feature Selection screen
25 Change installation destination drive in Instance root directory to D and press Next to continue.
26 The Feature Rules screen appears in a flash and if successful, the Instance Configuration screen appears
29 Change the Startup Type for all the SQL Services to Automatic
31 Check that the Database Engine: field is configured to SQL_Latin1_General_CP1_CI_AS, if not press
Customize… to configure it
34 On the Server Configuration tab select Mixed mode (SQL Server authentication and Windows
authentication)
35 Type in the SQL Server system administrator password in Enter password: and Confirm Password: fields
38 Choose the directory as desired (E.g. Data root directory: E:\IBEDB). For recommendations on the drive
layout, refer to IT Specification Guide
43 Feature Configuration Rules screen appears in a flash and if successful, Ready to Install screen appears
47 The Complete screen appears and Succeeded status appears for all features
CAUTION
IBE recommends not using any default accounts for SQL access due to security threats but
disable/rename default accounts and creating new users as per hospital requirement.
Eg : sa account
3 One of the following versions can appear (Press F7 to view the Object Explorer Details):
8 If Service Pack 2 is installed, you can skip this service pack installation part.
NOTE
If Service Pack 1 is not installed, then directly proceed with Service Pack 2. SP2 covers SP1.
You need to download the applicable Service Pack for installation.
1 Login as Administrator
2 Copy the downloaded SQL Server 2014 Service Pack 2 installer SQLServer2014SP2-KB3171021-x64-
ENU.exe file on IBE installation server.
8 The Select Features screen appears where all features should be selected
11 Some processes needs to be stopped for updating but you can ignore this as a reboot is done when setup
is finished
17 When finished check that the status is success on the Complete screen
NOTE
If required named instance can be configured instead of Default instance. If named instance is
configured by default then follow below steps for assigning static port
Static port assignment for named instance which by default has dynamic port:
If the SQL Server Configuration Manager is not accessible, please follow the steps to enable or disable Server Network Protocol
Figure
6.2.3.4: SQL
service re-
start
Installation:
1. Login as Administrator
2. Launch Download Adobe Acrobat Reader and click Adobe Reader 11.0 - Multilingual (MUI) installer
> Download Now link
6. Follow the screens step by step to install Adobe Reader 11.0 on IBE Server.
1. Login as Administrator
2. Double click Acrobat Reader icon on the desktop or select Start > All Programs > Acrobat Reader
3. If Adobe Reader Protected Mode screen appears
select Always open with Protected Mode disabled and click OK
Rhapsody 6.2.2
1. Create a new folder on the IBE server named Orion Rhapsody 6.2.2 and open it
2. Create 2 subfolders named: Engine and IDE
3. Go to the Orion site for Rhapsody 6.2.2:
https://orionhealth.app.box.com/v/rhapsody622
a. Download the Engine/rhapsody-6_2_2-windows-x64.exe file into the Engine subfolder.
b. Download the IDE/RhapsodyIDE.exe file into the IDE subfolder
Prior to installing Rhapsody, we need to verify that port 8444 is not in use by any (web) application on your
IBE Server.
Open Internet Explorer and type in: https://localhost:8444
or use netstat –an | find “:8444” to find out if the port is in use
If port 8444 is not in use, Internet Explorer cannot display the webpage, and we are allowed to use port
8444 for Rhapsody. So accept the default port of 8444 for Rhapsody Management Console during the
Rhapsody installation.
Example
Figure 6.4.2.1: Select appropriate executable for Rhapsody installation for the system
2 Click Yes on the User Account Control security screen (if displayed).
4 Accept the default destination folder on the Select Destination Directory screen.
Click Next
NOTE
On production systems Drive D is recommended to be used as the Rhapsody Engine
Destination Directory for installation (as specified in the IBE IT Specification Guide)
5 Accept the default data folder on Data Directory Location screen. Click Next
NOTE
On production systems Drive E is recommended to be used as the Rhapsody Data
Directory (as specified in the IBE IT Specification Guide)
Suggested location E:\Rhapsody\data
Click Next
Accept the default 8444 port if no web page was found during the pre-check in Section 6.4.1.
Alternatively, if a web page was found during the section, use a different free port
8 Accept the default start menu folder on Select Start Menu Folder screen. Click Next
9 Accept the default names on the Rhapsody Service screen. Make sure that the Service Start Type is set to
Auto Start. Click Next
10 Provide Service User Account and Service User Password on Rhapsody User Account screen, if there is a
network share to be accessed by Rhapsody engine
12 Make sure to select both check boxes on Post Installation Options screen.
Run Rhapsody Service Monitor
Run Rhapsody 6.2.2
Click Next.
1 Right Click on RhapsodyIDE.exe and select Run as administrator to launch the installation of
Rhapsody IDE
2 Click Yes on the User Account Control security screen (if displayed).
3 Click Next on the IDE Welcome Wizard
4 Accept the default installation folder on Choose Install Location screen. Click Next
5 Accept the default start menu folder on Choose Start Menu Folder screen. Click Install
6 Click Finish
The Rhapsody Integration Engine license (Rhapsody Integration Engine.ohl) needs to be applied via the IDE
user interface.
CAUTION
1 Select Start > All Programs > Rhapsody 6 > Rhapsody IDE
2 The IDE Interface is launched with Username: Administrator pre-populated on the Rhapsody Login screen
To logon type in, the default first time Password: <Rhapsody default>. At a later step this password must
be changed to a new password as per the Hospital’s IT Policy.
4 The IDE Interface will be opened and first time login Rhapsody Configuration Wizard will popup. This wizard
will guide you through several configuration steps. Click Next
5 Fill in the site information for the Hospital and click Next
NOTE
Remember the changed Rhapsody Logon Administrator password and communicate to the
Implementation and Support team
Click Next
8 The application will now try to send the configuration information to Orion Health
9 It is expected that the transmission of this data will fail. Select Send Via E-mail
10 In case the IBE Server has no Email application installed the following screen will appear.
Rev G IBE B.08 Installation Guide 53 of 223
WARNING: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,
WITHOUT PERMISSION, IS A VIOLATION OF LAW.
Copyright © 2017 Koninklijke Philips N.V. All rights reserved
Click OK.
Figure 6.4.4.12: Save the Rhapsody information in a text file to send in future
12 Save the file to desktop to send this file to Orion Health (rhapsody.report@orionhealth.com) for registration
purposes. Click Close.
NOTE
This name must be unique; when you click the OK button to save the user, Rhapsody will
check that the entered name is unique and will display a warning if it is not.
It is advised to create personal logons for all people that are logging onto IBE\Rhapsody for
reliable audit logging.
CAUTION
When a user logs on for the first time, they must change their password. The new password will
then never expire. If a Password Policy has been defined, all password policy rules will be
displayed on the Change Password screen.
If a password policy is defined, and has set the password policy rule to Never Expire this will
override all the individual settings. Otherwise, the individual setting will be applied.
Column Description
Group The name of the group.
The lockers associated with the group that have custom
Lockers with Custom Rights
access rights
Number of Users The number of users in the group
Status Whether or not the group is disabled.
1. Click View > User Manager... , then click the Groups button.
2. Click the Add button.
3. Enter the following details for the new access group:
Field Description
Enter a Group Name for the group.
Select the Disabled checkbox to disable the group. All users associated with the
Group Details group will then have a status of Disabled and cannot access Rhapsody.
Select the Password Never Expires checkbox if you want all users in the group
to have passwords that do not expire
Lockers Select a locker associated with the group, whose permissions you want to set.
For each locker associated with the group, select the access rights that apply to that
locker by checking the appropriate checkboxes. You can use the search box to filter the
Access Rights
list of access rights displayed. Refer to Access Rights for a description of all available
access rights.
Selecting a preset checkbox selects all access rights associated with that preset as
Presets
indicated by the preset icon adjacent to every access right checkbox.
CAUTION
The user permission overrides the group permission. That is, if this field is not selected for the
group, but is selected for an individual, the user's password will not expire
Refers to:
* User Account and passwords, and settings
* Groups (access)
* Lockers (rights)
Groups
• PatientMonitoringGroup: HIF, PICiX, IICiX, OBTV, ICIP, IP5, Guardian, SSPM, Orders, PatientData
Query
• eICUGroup: eCareManager
• CardiologyGroup:
General Group User (default): e.g. CardioUser
Team User: e.g. CISupportUser, CIGICCUser…..
Single Team Member User: e.g. jansent
• HSDPGroup:
General Group User (default): e.g. HSDPUser
Team User:……….
Single Team Member User: …..
• ISPGroup:
General Group User (default): e.g. ISPUser
Team User:……….
Single Team Member User: …..
unlocked
unlocked
Locked
because
Foundation
unlocked
– Refers to:
locked
unlocked
user
locked
User that has access to
locked
ISP Lockers
• Cardiology Engineer
user
unlocked
unlocked
The Policy Password tab enables you to apply the following rules according to your organization requirements.
Option Description
Minimum Passwords must consist of at least a specified number of characters. With this
Length setting, users cannot use blank passwords, and they have to create passwords
that are a certain number of characters long.
Minimum Passwords must consist of at least a specified number of numerals;; for example,
Number 0 -- 9.
Minimum Passwords must consist of at least a specified number of symbols;; for example,
Symbols #,@,%, and so on.
Minimum Passwords must consist of at least a specified number of uppercase characters.
Uppercase
Minimum Passwords must consist of at least a specified number of lowercase characters.
Lowercase
Password • Never Expire -- prevents a user password from expiring.
Expiry Expire After -- define the Maximum password age setting so that passwords expire as often as
necessary for your environment, typically,
every 30 to 90 days.
• Reuse After -- users cannot reuse the same password when their
password expires and must wait <n> days before they can reuse a
password.
User Lockout • Never -- user account is never locked out if the password is entered
incorrectly.
1. Click View>User Manager..., then click the Password Policy button. The Password Policy
dialog is displayed:
3. Click the OK button. This temporarily locks out the user accounts in Rhapsody, if the password is
entered incorrectly more than <n> times.
The result of these default settings, with a threshold set at 3 attempts, is as follows:
After Delay
Failures 0--2 No delay
Failure 3 34 seconds
Failure 4 38 seconds
Failure 5 46 seconds
Failure 6 62 seconds
Failure 7 94 seconds
Failure 8 158 seconds
Failure 9 286 seconds
Failure 10 542 seconds
Failure 11 1054 seconds
Failure 12 1200 seconds (maximum delay of 20 minutes)
The password policy should be synchronized with the site password policy. IBE recommends below policy:
Please find the link below for steps to disable SSLv2, SSlv3, TLS1.0 on web server.
3. On Select installation type screen select Role-based or feature-based installation and click Next >.
4. On Select destination server screen select Select a server from the server pool. Local server should be
displayed and selected in the Server Pool frame. If not selected, Filter and select the local server and click
Next >.
5. On Select server roles screen select Web Server (IIS). Next a window pops-up. Click Add features to
continue. Click Next > to continue.
For Windows Server 2012 computers, enable "IIS-ASPNET45" using Server Manager, under "Web Server
(IIS) -> Web Server ->Application Development -> ASP.NET 4.5"
This section details the site preparation aspects and installation steps for IBE.
Checkpoints
Both hardware and software requirements (as specified in IBE IT Spec) should be met
Basic system configurations should be completed
IBE server should be an independent box and should not be shared with other product-lines
Orion Rhapsody should be up and running
http://incenter.medical.philips.com/Default.aspx?tabid=249&itemId=8310&LLClassId=9082509
Or
http://incenter.medical.philips.com/Default.aspx?tabid=839&itemId=9742&LLClassId=10393182
The URL opens up after providing the credentials, the below download window appears, Product documentation
can also be found in Installation and Reference tab
On choosing Release B, the latest software package gets downloaded. Within the zip file, the below is seen.
NOTE
1. Always download IBE latest 866183 “B” release via InCenter.
2. Remember to keep a backup of this software on the IBE Server.
3. Note IBE.B.xx.YY.zzz indicates IBE “B” Release with “xx” version “YY” indicates Patch
release and ”zzz” is the Build Number
Launch IBE
Installer
Specify IBE
Install location
IBE installation
complete
Launch IBE
Configuration
Wizard
Local
No
Required interface is
DECG/iECG/Xcelera/ISP?
Yes
Install HIF
Yes
HIF DB Remote Enter Remote
Installation? DB details
No
HIF installation
starts
HIF installation
complete
The starter-kits in the Common folder are used across multiple Philips product-lines.
Login to IBE server with the credentials of Admin privileges and check for the following essentials
NOTE
Page Writer/Stress/Holter interfaces and Alert Viewer application use IIS service
The user that installs IBE needs the dbcreator role. After the database is installed, the
dbcreator role can be removed from the user
7. Latest release of IBE is downloaded from InCenter on to the IBE server. Refer to Section-7.1 (IBE Release
Zip Overview) for further instructions on downloading the latest release of IBE
8. Prerequisites for HIF installation:
a. Installation drive should have minimum 25 GB free disk space on local server where HIF
application/service shall be installed
b. Recommended RAM memory is 8 GB
c. SQL Server 2008 R2 SP3 or above should be Installed on local/remote server where HIF DB shall
be installed
d. SQL Server Reporting Services should be installed and service should be running on local/remote
server where HIF DB shall be installed
NOTE
Installing HIF on remote database with named instance requires SQL authentication mode.
Currently, IBE supports having server-class hardware and VMs as members of a domain. Note that this
configuration change may impact the process by which servers may be accessed.
1. Open Control Panel > System and Security > System, and select the Change settings link under
Computer name, domain, and workgroup settings. A new window will open.
2. Under the Computer Name tab, select the Change… button. A new window will open.
3. In the Member of group box, select the Domain option and enter the domain name. Press the OK button at
the bottom of the window.
4. A credential window will open. Provide credentials for an Active Directory user in the domain used in the
previous step that has permission to add new computers to the domain.
5. Once adequate credentials have been applied, the computer is added to the domain, and will need to be
restarted for the changes to take effect. Following the reboot, note any domain prefixes added to logins,
particularly if attempting to log in using a local user account.
After the host has been added to a domain, active directory users can be added to the host.
1. Log in to the host using a local user account with Administrator privileges.
2. Go to Control Panel > User Accounts > User Accounts > Manage User Accounts. A new window will
open.
3. Press the Add… button beneath the list of available user accounts. A new window will appear to Add a
domain account.
4. Enter the information for the desired user account, or browse for it using the supplied tool. Repeat this
process until all desired user accounts are added.
5. Return to the User Accounts window. If any of the added users require administrative privileges, select
the user account from the user list and press the Properties button. The user type can be changed and
saved.
NOTE
Skip steps 7.2.3 and 7.2.5 if installing IBE for Xcelera/ISCV/DECG/iECG/ISP solutions.
These solutions do not use HIF.
CAUTION
Even if IBE is installed on any drive other than C, below components shall always be installed
in C drive: C:\philips\IBE\Xcelera, DicomService, HL7TestTool and Utilities folder
(C:\philips\IBE\Utilities)
Unattended Installation is not available for HIF but only for IBE product features
7. If SMO CLR installation status pending screen appears, Click Install to install these components.
Install location
13. If you wish to install HIF DB on local server with default instance
Choose None to Specify Database(s) to offload and Click Next
NOTE
This step configures the connection for HIF DB to be installed to SQL Server with or without
Named instance. If instance name is not provided it will consider the instance from the IP, Port
number provided (Default Port number:1433 if not mentioned)
a. Enter the SQL server Installed local/remote machine’s IP address in below format
If multiple instances, SQL ServerName: <IP Address>,<Port#>[\<SQL Instance Name>] where [ ]
denotes optional value.
If default instance, SQL ServerName: <IP Address>
b. You can also enter the instance name in SQL InstanceName, if not mentioned in SQL ServerName
field. If the installed SQL is default instance leave the field blank
c. Select the Authentication mode.
d. Enter SQL Username which has permissions to create DB
e. Enter the corresponding SQL Password for above username
f. Click Test Connection to see Successful connection message. Click OK, then Next.
Please take backup of existing HIF DB for migration before clicking Install in the next step.
14. Click Install on Database Installation screen to install the HIF database
17. Qualification and Validation screen will appear with rules. Warnings and errors may be displayed.
2. If you see below two icons on IBE Server desktop, it means IBE installation was successful
Search Philips Healthcare Integration Foundation service as shown below which marks successful
installation of HIF service.
CAUTION
NOTE
If user wishes to change the port 9000 to site specific, then remember to modify the HIF Patient
Demographics interface as well on
TCP Communication point: HIF PatientDemographics Consumer V2 Client HIFServerName
Route: HIF PatientDemographics Consumer V2 HL7ToXMLMappping in
Philips.IBE.B.xx\Rhapsody Files\HIF\Philips.IBE.B.08.HIF.PatientDemographics.rlc
3. Matching Criteria:
Click Configure > Patient Identification > Matching Criteria > Edit existing Rule set (Ruleset #1) >
Select required identifiers as per the implementation site. Below is an example:
NOTE
HIF Patient Match Criteria supports Multifacility using Patient External Identifier along with
Medical Record Number as shown in above example
4. Purge interval:
Click Configure > Patient Identification > Communication > Port
can be configured to maximum 180 days from Purge tab, by factory default it’s 10 days.
Then press Start Services to apply the changes. Press to close the window.
I. Pre-requisites check
II. Interface specific database schema configuration (under Installation).
III. Database password reset (under Additional Settings)
IV. Clinical Data Access configuration (under Additional Settings) is used for Alert Viewer
application.
CAUTION
If IBE is installed at a user defined custom location on IBE server, follow Local Server section
in Step 2 to change install path location in a sql script called during IBE DB configuration
If IBE database needs to be installed on a remote server, follow Remote Server section in
Step 2 to change install path location in a sql script called during IBE DB configuration
Rhapsody variables in Variable Manager should be updated with the new custom location
1. Local Server
Steps to change install path in install SQL script and manually copy configuration file:
I. Navigate to IBE install path <<IBE Install Path>>\IBEInstaller\SQLScripts\
II. Open the script Xcelera_Install_PatientQuery_V1.sql in Notepad and edit: C:\Program Files
(x86)\Philips\IBE\IBEInstaller\Utilities\Philips.IBE.PatientQuery.dll to
<<IBE installed directory>>\IBEInstaller\Utilities\Philips.IBE.PatientQuery.dll.
For example, if IBE install path is D:\Philips\IBE\ then modify to D:\Philips\IBE\
Utilities\Philips.IBE.PatientQuery.dll. Save the changes.
III. Copy <<IBE Install Path>>\IBEInstaller\Utilities\patientquery.app.config file to
C:\philips\IBE\PatientQuery folder
Remote Server
Steps to change install path in install SQL script and manually copy configuration file:
I. Navigate to IBE install path on local IBE server <<IBE Install Path>>\IBEInstaller\SQLScripts\
II. Open the script Xcelera_Install_PatientQuery_V1.sql in Notepad and edit: C:\Program Files
(x86)\Philips\IBE\IBEInstaller\Utilities\Philips.IBE.PatientQuery.dll to
<<Shared Path>>\Philips\IBE\PatientQuery\Philips.IBE.PatientQuery.dll.
For example, if <<Shared Path>> is \\IBESQLDBServer\ then modify to
\\IBESQLDBServer\Philips\IBE\PatientQuery\Philips.IBE.PatientQuery.dll.
Save the changes.
III. Copy Philips.IBE.PatientQuery.dll file from <<IBE Install Path>>\IBEInstaller\Utilities on local
IBE Server to <<Shared Path>>\Philips\IBE\PatientQuery folder and
Copy patientquery.app.config file from <<IBE Install Path>>\IBEInstaller\Utilities on local IBE
Server to <<Shared Path>>\Philips\IBE\PatientQuery folder
2.1 On the desktop Right click on Philips.IBE.ConfigWizard and select Run as administrator.
2.3.1 Select the Install Mode as Traditional and follow steps from 2.4
2.3.2 Select the Install Mode as Unattended (Beta Version) and follow steps from 2.11
2.4 Configurations for IBE-Database screen should be displayed.
2.5.2 If SQL Authentication is selected provide the local SQL server login credentials (Username
and Password for DB).
2.6.1 Provide the remote SQL server IP Address in Hostname: in one of the below formats
<IP>
<IP>,<PORT>\<INSTANCE NAME>
<IP>\<INSTANCE NAME>
(E.g.: 127.0.0.1,15000\NMDINST1)
2.6.2 Choose Authentication Type as SQL Authentication or Windows Authentication (if IBE
server is member server to Hospital Domain in which Remote server also resides and we are
logged in as Domain user to install IBE)
2.6.3 If SQL Authentication is selected provide the remote SQL server login credentials (Username
and Password for DB).
2.10 On Installation tab select features and click Add to move features from left list to right list. Select
features in the right list and choose Install, Un-install or Upgrade and
click Configure.
2.11.1 Philips.IBE.ConfigWizard can be found on desktop. Right Click and Run as Administrator to
open the below screen.
WARNING
Prerequisite check – If OS Version (Windows 2012 R2 or 2008 R2) or Powershell version (4.0)
is not as per specification, error will be displayed and installation shall not proceed
2.11.4. Provide path for Rhapsody Installation Root Folder containing “Rhapsody 6.2.2” Folder (Installation of
IDE, Engine and Dashboard) and “Rhapsody Files” (for RLCs loading) and click Next.
rhapsody-6_2_2-windows-x64.varfile – To update Rhapsody Engine install path & Rhapsody Data folder path
Copy the license file to <root folder>Rhapsody 6.2.2 folder and update License file name Rhapsody Integration
Engine.ohl in LicensePath accordingly
Rhapsody IDE shall be installed at <root folder>Program Files (x86)\Orion Health\Rhapsody IDE 6
2.11.5. If Rhapsody IDE and Engine already exists, provide Existing Rhapsody Password and Rhapsody
Files Root Folder (for loading RLCs) and Click Next.
2.11.6. If Selected Root Folder is not correct or Rhapsody install folder and Rhapsody Files folder is named
incorrectly, below error will be displayed.
2.11.7. Provide database connections details for silent product Database installation
Authentication Type:
Windows Authentication: Enter hostname
SQL Authentication: Enter hostname, username and password.
2.11.8.1 Provide the remote SQL server IP Address in Hostname: in one of the below formats
<IP>
<IP>,<PORT>\<INSTANCE NAME>
<IP>\<INSTANCE NAME>
(E.g.: 127.0.0.1,15000\NMDINST1)
2.11.8.2 Choose Authentication Type as SQL Authentication or Windows Authentication (if IBE
server is member server to Hospital Domain in which Remote server also resides and we are
logged in as Domain user to install IBE)
2.11.8.3 If SQL Authentication is selected provide the remote SQL server login credentials
(Username and Password for DB).
2.12 If system is according to specifications, all pre-requisites will be in green. Click Next.
NOTE
If specified IIS version is not installed, warning sign will be displayed but installation shall
proceed
2.13 Select Product in available product list and respective RLC to load in rhapsody and click (>>) button.
Selected product will be added to selected product list. If selected product has database, database will be
installed in background.
Click Submit.
2.14 By Clicking Submit, all configurations will be saved and UI will be closed opening below
progress bar window.
2.16 And all selected RLCs (Unified,PI,Orders and Dynalync) in Step 2.13 will be loaded into
Rhapsody.
2.17 All selected Product tables (PI, Study and Dynalync) are installed in database.
2.21 If any Error occurs during Silent Installation, below message will be displayed and Logs
can be found in folder mentioned in Step 2.19.
4. Reset the factory default password from Additional Settings tab and ensure to configure in Rhapsody
variable manager. Click Apply. (local windows password policy will be enabled by default)
NOTE
Default SQL authentication credentials for IBE user
Username: IBESISUser Password: <IBE default>
NOTE
Based on the site need choose appropriate features.
Since, HIF is not used by Xcelera/DECG/iECG/ISP solutions, and IIS is used only by
CartGateway and AlertViewer, its OK to get Warning messages for HIF and IIS components
not being installed on the system
1. Software Information
a. Windows Server available
b. SQL Server installed
c. IBE version installed
2. Services – IBE Services installed
3. IBE Configurations – system CPU utilization
4. Status – Logs for recent transactions in IBE Config Wizard
Alternatively, user can directly press Status button on Installation tab to move to Configurations tab.
NOTE
HIF DB does not get removed on Uninstallation of Philips Healthcare Integration Foundation
from Control Panel. Delete the HIF DB manually from SQL Server Management Studio
Removing HIF DB
8.1.4 IIS 8
Navigate to Server Manager Roles Web Server (IIS) and verify whether IIS is up and running.
Under Services World Wide Web Publishing Service and verify this service is up and running.
Open the MS SQL management studio and login as IBESISUser under SQL Server Authentication. On
providing correct password you will be logged-in.
Verify whether <<MS SQL installed path>>\Data is properly configured and periodic back-up is also setup
Start the Orion Rhapsody service (if not yet running) and login to Rhapsody IDE.
Verify whether <<Rhapsody installed path>>\data is properly configured.
Login to Rhapsody management console and ensure archive clean-up and periodic back-up is setup
In Windows services check if Rhapsody service is running under the correct user account
8.1.7 HIF
Verify whether HIF service Philips Healthcare Integration Foundation is up and running.
Navigate to <<HIF installed path>>Program Files (x86)\Philips\Healthcare Integration
Foundation\C.00\Product and open the Philips.HIF.ConfigurationHost tool. Verify whether the patient
matching criterion and purge is properly set as per site need
Open the Philips.HIF.Test.Manual tool and choose PPIS. Click on Publish tab and key in patient
demographics details manually. This inserts patient directly to IBE database (HIF).
8.1.8 CartGateway
Open IIS 8 and click Browse button. This opens up a blank Internet Explorer window
8.1.9 PSA
Please refer the IBE Training Course CMS9064 for further details.
1. IOAPIMessagesURL: should match the iECG Results Reporter V1 HTTPReceiver communication point.
2. OrdersURL: should match the DECG WorkListQuery Reporter V1 Communicator Receiver communication
point.
3. OrdersADTOptions: Code to be entered to support (ADT_ORDERS/ORDERS/ADT) options.
4. OrdersPassword: Should be the same Password in the lookup table
DECG_WorkListQuery_Common_V1_CartConfiguration
5. OrdersUsername: Should be the same as the CartID in the lookup table
DECG_WorkListQuery_Common_V1_CartConfiguration
WORKLIST WORKFLOW:
The worklist can be verified by login to the iECG application, the order inbox will get updated in the “Outbox” tab of
Order search window of iECG. This ensures we have already established the connection with IBE. If we then search
for the worklist the worklist should appear for the patient which we have already admitted for checking Order reporter
interface verification.
RESULTS WORKFLOW :
After receiving the results from the modalities iECG sends the preliminary results will be pushed to the iECG
Results Reporter V1 Preliminary Export communication point, which receives the result files (PDF,XML etc.,). And
configuring the iECG Results Consumer V1 HIS Outbound communication point to receive the result (ORU)
message from IBE. This ensures that IBE is receiving the message from iECG and sending the Result message to
the external application
If previous shutdown was not clean, Data Integrity Check will be executed
• The Blue line shows memory usage (currently assigned to support processes)
• The Green line shows the actual memory being used (currently active with data)
• Components will be started in one of 5 phases (Startup First, Startup Second,.. Startup Last) as configured
for each component:
• Determine which phase to start in by its relative position within the interface:
• Typically, you should start the components in the reverse order of the data flow:
• Safe-Mode is a startup state that will start the engine as usual but will not automatically start the interface
components.
• This is useful when troubleshooting a potential run-away component issue or just to make sure that a
reboot of the system will not start anything until you are ready, i.e.: in preparation for go-live.
• You can configure Rhapsody to startup in “Safe-Mode” by changing the setting in the “D:\Program
Files\Orion Health\Rhapsody\rhapsody\rhapsody.properties” file:
# If set to true, no components will start at startup # If set to true, no components will start at Startup
#StartupService.safeMode=false Service.safeMode=true
#StatisticsService.directory=statistics #StatisticsService.directory=statistics
… …
• Rhapsody engine shuts down all routes then communication points (not in the reverse order of the start up
sequence).
• After all interface components are stopped, the engine will shut down.
• When the OS is shutdown, it will issue a shutdown request to the Rhapsody service and wait 12-30 sec
before throwing an exception and killing the Rhapsody service.
• The Rhapsody service apparently does not RequestAdditionalTime() during the OnStop event, therefore, it
is to our benefit to do one of the following:
– Manually stop the Rhapsody service before shutting down the OS.
– Add a Wait4Service command to the Windows Shutdown process to prevent the Rhapsody service
from being killed by the OS before the shutdown completes.
Wait4Service.cmd
• The command file can be added to the Scripts(Shutdown) properties of the Windows Settings in the Local
Group Policy Editor (gpedit.msc)
• When Windows begins its shutdown procedure, it will execute the shutdown script and wait for its
completion before continuing.
• The shutdown script must stop the service and must have a mechanism to identify that the target service
has completed its shutdown before returning control back to the Windows shutdown process.
• See the section: IBE Clean Shutdown on Windows Restart for installation instructions.
8.5.1 Introduction
The Philips IBE product is built on the Orion Health™ Rhapsody Integration Engine, which is a Java-based solution
that is configured as a service when installed on a Microsoft Windows platform. In addition to the 20 +/- daemon
processes that make up the Rhapsody engine, stopping the Rhapsody service begins with stopping all interface
components. For an IBE solution, even the simplest product interface is made up of many components (routes &
communication points). Stopping all of these components takes time and as such, the Rhapsody engine often does
not complete its shutdown sequence in the time allocated, when requested to stop during an Operating System
(O.S.) shutdown/restart event. When this occurs, the Rhapsody service is killed, which introduces the risk of
corrupting managed data and always prevents it from registering a clean shutdown. As a result, upon the next
startup, the Rhapsody engine will invoke its Data Integrity Check process to validate that no data has been corrupted.
Although the Rhapsody engine is designed to perform the most crucial aspects of the check first then start the
interfaces and continue with the rest of the checks in the background, there is always a delay in startup of the
interfaces and depending on the volume of data, the background processing can take a while to complete. Startup
delays have taken as long as 10 minutes and background integrity checks have lasted as long as 90 minutes, during
which, a slightly reduced performance is apparent.
To ensure that the Rhapsody engine service completes a clean shutdown, the recommended procedure is to stop
the Rhapsody service before initiating an O.S. shutdown/restart event. Manually stopping the service is appropriate
for interactive shutdown events; however, that is not a practical solution for an automated restart of Windows after,
for instance, a centrally pushed Policies update. The following solution will provide a practical mechanism to ensure
a clean shutdown of the Rhapsody service for all O.S. Shutdown events.
1. Right click and Copy the Wait4Service.cmd file (contact IBE Support at ibesupport@philips.com for
the cmd file) to a folder on the drive that contains the IBE & Rhapsody binaries, for a standard installation
this should be the D: drive. For this example, the file is copied into a new folder named D:\Program
Files\IBE_Shutdown.
2. In preparation for configuring the Wait4Service command for execution, the following information is
required:
A. The complete path to the Wait4Service command file: for this example, it is D:\Program
Files\IBE_Shutdown\Wait4Service.cmd
B. The Rhapsody service name: depending on the version of Rhapsody installed, this might be
Rhapsody_6.2.2, etc.
C. The complete path to the file that will be deleted when the service shutdown has completed: for
Rhapsody, this is E:\rhapsody\data\engine.running
D. The complete path to a log file that will be created/overwritten each time the Wait4Service command
is executed; this can be anywhere on the server but for this example will be located in the same folder
as the Wait4Service.cmd file: D:\Program Files\IBE_Shutdown\RhapsodyShutdown.log
3. With the Wait4Service.cmd file copied into the designated folder and 3 additional information values
required, add the Wait4Service.cmd script to the Windows shutdown process as follows:
A. Open the Local Group Policy Editor by executing gpedit.msc at a command prompt or from the
Start Run command.
i. In the Local Group Policy Editor window, expand the left panel tree to display:
Local Computer Policy
[-] Computer Configuration
[-] Windows Settings
[-] Scripts (Startup/Shutdown)
ii. In the right panel, double-click Shutdown
c. In the Script Parameters field, enter each of the 3 values recorded in step 2B, 2C & 2D above
separated by a space.
NOTE
If the parameter itself contains a space, be sure to enclose the entire parameter in quotation
marks
This section details IBE upgrade principles, process and scenarios for field personnel. These guidelines should be
followed during any IBE upgrades.
The guiding principle for IBE upgrade is – as long as a version of interface is supported in a release of IBE,
irrespective of which previous release it was born, that interface will be able to function without change in
production.
Activity Description
System backup IBE system files such as RLC, Rhapsody engine configurations, database should be
backed up.
Reference documents TTS document and Acceptance test case document should be referenced.
Test server setup A test IBE server should be set-up to test all the upgradation/migration before
deploying on production.
Project planning A robust IBE upgrade project plan considering the below aspects should be created.
Impact analysis, technical/commercial risks, work-break down structure and risk
mitigation actions.
Scenario Customer is adding a new interface for existing product-line from the same release of IBE.
Example
Customer is currently using Unsolicited (basic) interface from IBE B.08 for PIIC product-line. Now
they are adding one more interface “Waveform export” from the same release of IBE.
Impact Analysis
Customer is still on the same IBE release and hence there is no impact on the existing interface
solution.
Upgrade steps
1) Backup the existing IBE production server and re-store the same on IBE test server.
1 Download the “Waveform export” interface (RLC file) from IBE B.08 release on test server.
(Refer IBE Implementation Guide for RLC download and import details).
2) Load the above RLC into Rhapsody IDE on the test server.
3) Perform all the necessary configurations/customizations of the interface on test server.
4) Run the acceptance test cases jointly identified by both customer and Philips IT personnel
on test server.
After successful completion of verification on the test server, the solution can then be deployed
on to production.
Scenario Customer is adding a new interface for an existing product-line from the latest IBE release.
Example
Customer is currently using PIIC Unsolicited (basic) interface from an older release of IBE (A.04).
Now they are adding a new interface “Waveform export” for the same product-line from the latest
2 release of IBE (B.08).
Impact Analysis
The Unsolicited (basic) interface from IBE A.04 for PIIC is still supported in the latest release (and
subsequent releases) of IBE. Therefore the existing interface should work without interruption after
the upgrade. However Orion Rhapsody upgrade to 6.2.2 should be carried out.
Upgrade steps : Refer upgrade/migration section
Example
Current System:
OS: Windows Server 2008 R2 SP1 (64bit)
IBE: B.02.01.007
HIF: B.00
Rhapsody: v4.1.1
New System:
OS: Windows Server 2012 R2 (64 bit)
IBE: B.08.00.020
HIF: C.0
Rhapsody: v6.2.2
IBE:
We install the standard IBE B.08 with HIF on the new hardware.
IBESIS:
Backup the existing IBESIS database only after ensuring that the purge works as expected and
restore the database on SQL server in B.08 environment
HIF:
Upgrade from older HIF version to newer is not possible.
Rhapsody:
New rlcs from IBE B.08 package should be imported on B.08 server and custom configurations
should be done as recorded in the TTS document.
Upgrade steps: Refer upgrade/migration section
B.01
B.01.02
B.02 (with or
without any
hotfix)
B.02.01 (with or
without any
hotfix)
Refer the Migration Instructions section and upgrade/migrate to B.08
B.03
B.03.01
B.04
B.05
B.06
B.07
B.08
2 Backup the existing IBESIS database only after ensuring that the purge works as expected.
3 If migration is from B.05 or lower versions, restore the database (backed up in step 2) on SQL server in B.08
environment.
Search Philips Healthcare Integration Foundation service, right click and Stop the service
3. Select Start > Control Panel > All Control Panel Items > Programs and Features > Right click and
Uninstall Healthcare Integration Foundation, for sites not using Xcelera/ISCV
4. Launch IBE Installer (Refer Section 7.2) and install IBE and HIF till Section 7.2.3 Step 13.
Click Cancel on Database Installation screen to cancel HIF database installation.
CAUTION
Do not install any database components from Installation tab at this stage
6. Launch IBE Configuration wizard. Enter Reason to Access and click OK.
10. Click OK
NOTE
For IBE versions B.00, B.01, B.01.01, B.01.02, B.02, B.02.01 follow the below steps from Step
14 – Step 28.
For IBE versions B.03, B.03.01, B.04, B.05, B.06, B.07 and B.07.01 follow the below steps from
Step 14 – Step 15 and then from Step 18 – Step 28.
14. Select Current IBE Version as per the IBE version from the drop down fields.
16. Select Choose the option for the Field name set as EpisodeNumber as per the site configuration from
the drop down fields.
17. Select Choose the option for Migration drop down fields.
Migration tab for IBE versions B.03, B.03.01, B.04, B.05, B.06, B.07 and B.07.01
19. Once Archive is selected Archive Information screen appears with data count. Click OK.
21. After Archiving is complete the IBE Configuration Wizard redirects to Installation tab to install the required
features
CAUTION
Only preinstalled product features’ data shall be migrated. If all preinstalled product features
are not reinstalled during migration, data will be lost for products not selected.
Eg. During database migration if three product features were initially installed but after
archiving if only two product features are selected, other not installed product data will be lost.
Refer Section 12.1.10. If migration is for non-Xcelera implementation from B.02 to B.07 and
above for:
DECG/iECG interface: Install Xcelera and DECG/iECG features from Config Wizard
ISP interface: Install Xcelera and ISP features from Config Wizard
25. Once Restore is selected, below warning message will be shown which shows the name of product lines,
separated by comma for which the data will be migrated. See example below:
27. Click OK on Restore Completed Screen
28. On Migration tab and check the information displayed for successful Migration. See example below:
NOTE
Refer Section 12.1.10. If migration is for non-Xcelera implementation from B.02 to B.07 and
above for:
DECG/iECG/ISP interface: Uninstall Xcelera from Config Wizard
1. Lookup Table Migration Tool can be found in the <<IBE Installed Drive>>:\philips\IBE\Utilities folder for IBE
B.08. For IBE B.08, Import the Lookup Table Migration Tool on the server.
Right Click and Run as Administrator to open the below screen.
2. Click on Browse to select the path to define the location where the Lookup Table configurations of B.08
version will be archived in csv format.
3. The Hostname and the Port number are selected by default. Rhapsody Port number can be modified if
required.
5. All the Lookup Table configurations of the B.08 will be displayed in the Selection screen
7. Proceed further to Archive the Rhapsody Variables or else Close the Lookup Table Migration Tool.
9. Click on Archive. The below popup will be displayed and click on OK. Rhaposdy Variables will be archived at
the same location with the file name VariableConfig.xml
10. Uninstall IBE B.07.01 and Install IBE B.08. Load the B08 RLCs as required.
11. Right Click on the Lookup Table Migration Tool and Run as Administrator.
12. The below screen will be displayed with the details auto saved. Type in the Rhapsody password and click on
Next.
13. Now only the common Lookup Table configurations between the B06 and B07 versions will be displayed. If
there are any site specific Lookup Tables implemented in B.06, they will have to be configured manually in
B.08 as they won’t be available for Migration via the tool.
14. Select Migrate and Click on the Migrate tab.
15. The below screen displays the B06 configurations, B07 configurations and the Merged configurations. Make
the modifications as required in the Merged configurations.
If any changes are required in any of the other Lookup Table configurations, click on Table Selection to go
back and select the appropriate Lookup Table.
Merged Configurations takes the data Values from the Old configuration. However, the additional Rows
and Columns from the New configurations will also be populated (See below screenshot for reference).
Rev G IBE B.08 Installation Guide 152 of 223
WARNING: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,
WITHOUT PERMISSION, IS A VIOLATION OF LAW.
Copyright © 2017 Koninklijke Philips N.V. All rights reserved
16. Click on Next to make the modifications in the next Lookup Table. If no changes are required in other Lookup
Tables, we can directly navigate to Save to Rhapsody.
The modifications that are made in the Merged configurations will be always saved at below location:
C:\Users\Administrator\AppData\Philips\LookupTableMigration\CSVFiles\Response.
17. This screen displays the List of Lookup Tables that have been selected to Save to Rhapsody.
19. The next screen shows the Logs with complete details of Lookup Tables that were migrated successfully as
well as the failures.
20. Click on Variables -> Selection to proceed further for Rhapsody Variables Migration else Click on Finish to
close the tool.
21. Now only the common Rhapsody Variables between the B06 and B07 versions will be displayed.
22. Select Migrate and Click on the Migrate tab
25. The pop-up shows the logs with details of the Rhapsody Variables which were not able to migrate successfully.
Note: Lookup Table migration tool is generally used for migration from B06 to B08.
However it can be used for migration from any Lower version using Rhapsody 4.x to either B06 / B07 which use
Rhapsody 6 (and above) by following the below steps:-
Note: In Step 10, you just need to remove the old RLC and import the RLC of new IBE version
The Lookup Table Migration Tool also handles the difference in change in names of Lookup Tables / Rhapsody
variables in the Old and New IBE version. Follow the below steps if there is a change in the names of any Lookup
Table / Rhapsody variable:-
i) Open the NameChange_config file which is found in the same location as the Lookup Table
Migration Tool.
ii) Add the names of Lookup Tables in below XML format for the Tool to address the name change
while Migration.
<LookupTables>
<lookuptable>
4. In next page, you can directly migrate the lookuptables (No need to archive lookuptables since it is done
manually)
3. Save xml file in same folder where lookuptables are manually saved as csv files
4. Open the tool, and select migrate option in variable selection page and continue migration as mentioned in
other document.
1. From IBE B.05 or lower versions (Rhapsody 4), save the rlc.
2. Load saved rlc into rhapsody 6.
3. Open the tool, archive lookuptables and variables (don’t migrate).
4. Clean the rhapsody and load B.06 rlc.
5. Continue migration as mentioned in other document.
2. Login to Rhapsody IDE and start required routes and communication points
1. Create a new folder on the IBE server named Orion Rhapsody 6.2.2 and open it
2. Create 3 subfolders named: Engine, IDE and Documentation
3. Go to the Orion site for Rhapsody 6.2.2: https://orionhealth.app.box.com/s/t5mvjq9jgt6xjy3efndp6obv1bursi62
a. Download the Engine/rhapsody-6_2_2-windows-x64.exe file into the Engine subfolder.
b. Download the IDE/RhapsodyIDE.exe file into the IDE subfolder
c. Download Documentation/Rhapsody 6.2.2 Installation and Upgrade Manual.pdf and other files into
the Documentation subfolder
6. Open the <InstallationFolder>\rhapsody\bin\monitor-start.bat and record the value that is described at the end
of the config line > http://localhost:8081
7. Open the <InstallationFolder>\bin\wrapper.conf file and note:
wrapper.java.maxmemory=1024 (should be changed to 4096)
8. Note the Rhapsody Administrator password
9. Note the Domain, User & Password that the Rhapsody service runs under Eg. PHC, Philips/Service;
The above-mentioned value is the default, at customer sites this might be a different value.
10. Open the Rhapsody Management Console and perform the following:
a. Click the Communication Points icon in the left side menu
i. Scroll to the bottom of the screen
ii. Click Stop for all Input communication points
iii. Ensure that all messages on the route have completed processing
iv. Click Stop for all output communication points
c. Navigate to the Server Settings > Backup screen and check the Current Backup Schedules section.
d. Backup your existing:
i. Configuration, including any custom communication points and filters. Refer to Configuration
Migration for details.
ii. Rhapsody installation directory.
Rev G IBE B.08 Installation Guide 162 of 223
WARNING: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,
WITHOUT PERMISSION, IS A VIOLATION OF LAW.
Copyright © 2017 Koninklijke Philips N.V. All rights reserved
iii. Rhapsody data directory.
e. If Type: Full backup is already defined where Area = All, click Action: Backup Now
f. If Type: Full backup is not defined, create a definition under the Create New Backup Schedule section
as follows:
i. Select Type: Full
ii. Select Area : All
iii. Select any Frequency and Time settings since these values are not used for this step.
iv. Enter a Directory path where the backup should be stored. Recommended drive is F.
v. Click Add
vi. Click Action: Backup Now and wait for the Status to change from Running to Completed
<date & time>
g. Note down the location of the Rhapsody Integration Engine installation directory. This is required to
update the existing installation.
h. Uninstall the existing Rhapsody IDE.
WARNING
Do NOT specify a location that falls under either of the directory paths recorded in steps 5 or 6
above.
12. Open the new Orion Rhapsody 6.2.2\Engine folder and double-click the rhapsody-6_2_2-windows-
x64.exe file to begin the installation and click the Next button on the Welcome to the Rhapsody
Installation Wizard screen.
13. Open the Rhapsody 6.2.2 Installation and Upgrade Manual v1.0.pdf and
14. Start the Rhapsody 6.2.2 service and wait for the red circling icon to become a red stationary icon in the
system tray.
15. Launch the Rhapsody IDE application from the IBE server desktop and do the following:
a. Logon to Rhapsody as Administrator using the same password recorded in step 8 above.
b. If the Untrusted Self Signed Certificate dialog is presented, place a check in the Permanently trust
this certificate check box and click Yes
c. Click the Next button to display the originally entered registration information
d. Click the Next button to display the originally entered Engine name & purpose info
e. Click the Next button to display the registration summary page (XML)
f. Click the Next button to complete the registration process - if network transmission fails, select
Retry Transmission or Send Via E-mail button as appropriate
g. Click the Finish button.
Term Definition
The Remote Service Network is the standard supported network for Philips Medical Systems.
RSN
It is a Virtual Private Network between Philips Medical Systems and hospitals.
M2M is commonly translated as Machine-to-Machine or Man-to-Machine.
M2M is a term used to designate the concept of communications between a device
M2M containing some amount of data and another device that requires the use of that data.
Within the context of Remote Services M2M describes the communication between the PSA
and the Enterprise Server
Questra Enterprise Server: Centralized, internet-accessible application installed in a data
M2M Enterprise center.
M2M Enterprise (Production) and M2M Enterprise (QA) is available
Philips Service Agent is a device service running on the medical device to monitor, alert and
PSA enable SW distribution to the device.
The PSA is a common interface to the Questra Enterprise Server.
System Identification and Data Standard
SIDS
Electronically readable information on the Medical Device.
User A person that supports devices remotely
IDM Intelligent Device Management – M2M Web Interface
(internet Secure Socket Layer) SSL-based connectivity for devices with PSA installed for
iSSL
delivering remote services as an alternative to establishing an IPSEC tunnel (i.e. VPN).
PRS Philips Remote Service – marketing name to describe the suite of tooling for remote service.
The M2M Enterprise Production Server – for Live Production “Field” use.
The M2M QA Enterprise Server – For Business unit testing of the solution prior to release.
By default, the installer package assumes that user wants to install a configuration that uses the M2M Enterprise
Production Server Address (This is not configurable).
To install the PSA with a configuration that uses the M2M Enterprise Production Server address:
o Click and invoke the installation process, which by default will extract the installation package files to:
“C:\Downloaded Philips\ PRS_IBE_Solution_A.00.01_Build”
To install the PSA with a configuration that uses the M2M Enterprise QA Server address:
o Exit out of the Installer Interface (Figure 2), and Open command prompt as Administrator, go to the
location where the package was downloaded and Run the following command:
“PRS_IBE_Solution_Installation_A.00.01.exe /QA”
Rev G IBE B.08 Installation Guide 165 of 223
WARNING: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,
WITHOUT PERMISSION, IS A VIOLATION OF LAW.
Copyright © 2017 Koninklijke Philips N.V. All rights reserved
Figure 1
1. The
installation
wizard
window
will open
(Figure 2).
The
Destination folder location is configurable, but points by default to:
“C:\Downloaded Philips\ PRS_IBE_Solution_A.00.01_Build”
Figure 2
3. The PSA Solution installation program provides two Connection Types that are specific to the installation
environment Internet (iSSL) or IPSEC VPN.
Figure 3 shows the PCCI PSA Solution Installer with the Internet (iSSL) Connection Type selected
Figure 3
Select Proxy Settings checkbox to enable insertion of site specific proxy information.
Note: Any Proxy information is ignored as soon as Proxy Settings checkbox is unchecked.
Find and Insert the Entitlement Information of the product that will be managed by the PSA. Use the
service number and serial number during the installation. Send email to PSA team at
iscs.developer.support@philips.com to get the above details.
Enable the Start PSA checkbox to enable/disable PSA service directly after installation.
4. Press Install button after inserting all required information as shown in the Figure 4.
Figure 4
Rev G IBE B.08 Installation Guide 167 of 223
WARNING: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,
WITHOUT PERMISSION, IS A VIOLATION OF LAW.
Copyright © 2017 Koninklijke Philips N.V. All rights reserved
5. PSA Solution Installation – Finish
After pressing the Install button, the installation continues displaying some installation windows and a command line
configuration window (all without user interaction). The “status bar” at the bottom of the installation interface shows
the current installation step progress.
At the end of the installation, the application window will display the message “Installation completed successfully.
Please close the application.” in the status bar.
When closing the “PSA Solution Installation” window, the user will be prompted with a Close Window dialog. The
user can choose to save the entered settings (except for password) into an xml file for future reference. The name
of the file the data is saved to is configuration.xml.
*** For security purposes, the proxy password is not saved in the XML file.
Figure 5
Figure 6
7. Windows Service
In order to be compatible with the PSA update process and the common agent features, the PSA is installed as a
Windows Service. Now Start the PSA service as shown in the below figure.
Figure 7
The PSA (Philips Service Agent) service can be started and stopped using either the Computer Management
Console (Services snap-in) or command line using the sc start/stop PSA command.
C:\Program Files\Philips\psa\<Revision.Update>”
C:\Program Files (x86)\Philips\psa\<Revision.Update>”
Figure 8
GCS provides a web based utility. Login into the Philips Remote Services Data Administration
website(https://pww.rsn.cle.ms.philips.com/RsnDataAdmin/), and select “M2MàM2M Registration
Tools”,
The M2M Registration of Service Number and Serial Number can be tested. This information is
entered in the PSA installation interface for IBE.
In the screenshot below, the FSE would enter the serial number and Material Number (this is
equivalent to the Service Number), and then click “Test M2M Registration”. The results will then
display if there is a matching installed base record in M2M.
Link : https://pww.portal.rs.healthcare.philips.com/RsnDataAdmin/M2MUtilities/M2MLookup.aspx
1. Open “qsaconfig.xml” file and add the below VirtualDirectory tag containing the path of the log file being
scanned, and also the FileWatcherTask as shown below.
<VirtualDirectory>
<Alias>RhapsodyFolder</Alias>
<Directory>C:\Program Files\Orion Health\Rhapsody 6\log </Directory>
</VirtualDirectory>
<FileWatcherTask>
<Path>/RhapsodyFolder</Path>
<Filter>log.*</Filter>
<FileWatcherSource ref="regexFW"/>
</FileWatcherTask>
Figure 1
<File>
<FileName>E:\Remote Monitoring\log\log.txt</FileName>
<StateFileName>__INSTALL_DIR__\etc\state\CMS_IBE_Solution\log.state</StateFileNam
e>
<SpecificRegex>
<Pattern>.*Login failed for user.*</Pattern>
<Abstract>Login failed for user</Abstract>
<ErrorCode>LOGIN_FAILED</ErrorCode>
<Description>See detail for user name, and refer to troubleshooting
guide.</Description>
</SpecificRegex>
<SpecificRegex>
<Pattern>.+Communication point.*stopped</Pattern>
<Abstract>Failed communication point</Abstract>
<ErrorCode>COMMUNICATION_POINT_STOPPED</ErrorCode>
<Description>Fix failed comm point.</Description>
</SpecificRegex>
<SpecificRegex>
<Pattern>.*There are too many messages on the error queue.*</Pattern>
<Abstract>Error Queue Size Exceeded</Abstract>
<ErrorCode>LARGE_ERROR_QUEUE</ErrorCode>
<Description>Check the cause of error.</Description>
</SpecificRegex>
<SpecificRegex>
<Pattern>.+Communication Point Connection *Failed</Pattern>
<Abstract>Failed communication connection point</Abstract>
<ErrorCode>COMMUNICATION_POINT_CONNECTION_FAILED</ErrorCode>
<Description>Fix failed comm connection point.</Description>
</SpecificRegex>
</File>
i. login failure
ii. Communication point stopped.
iii. Communication point connection failed
iv. Large queue size
Steps
to add
new
Alarm
and
rules
to the
Click on Edit.
Go to Alarm tab and Create a new alarm by entering the alarm name and alarm severity as shown below:
Go to Rules tab, fill in the required details like rule name, rule type, error code, procedure and alarm
associated to the rule as shown in the below figure.
Rev G IBE B.08 Installation Guide 176 of 223
WARNING: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,
WITHOUT PERMISSION, IS A VIOLATION OF LAW.
Copyright © 2017 Koninklijke Philips N.V. All rights reserved
Rev G IBE B.08 Installation Guide 177 of 223
WARNING: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,
WITHOUT PERMISSION, IS A VIOLATION OF LAW.
Copyright © 2017 Koninklijke Philips N.V. All rights reserved
11.2.3 Configuring alerts action (Email Configuration)
Action for the alarm can be configured in Alarm Disposition
As shown in the below diagram insert the required field and add the list of email id in the email rule one by one.
NOTE
In order to work with IPSEC VPN, system should be in PRS network lab.
To install the PSA with a configuration that uses the M2M Enterprise Production Server address:
o Click and invoke the installation process, which by default will extract the installation package files to:
“C:\Downloaded Philips\ PRS_IBE_Solution_A.00.01_Build”
To install the PSA with a configuration that uses the M2M Enterprise QA Server address:
o Exit out of the Installer Interface (Figure 2), and Open command prompt as Administrator, go to the
location where the package was downloaded and Run the following command:
“PRS_IBE_Solution_Installation_A.00.01.exe /QA”
The
installation
wizard
window
will open
(figure
below).
The Destination folder location is configurable, but points by default to:
“C:\Downloaded Philips\ PRS_IBE_Solution_A.00.01_Build”
Below figure shows the PCCI PSA Solution Installer with the IPSEC VPN Connection Type selected
Once after installation. Below are manual changes need to done in both QSA config file and Site.xml file.
<OCM name="httpsOCM">
<ServerAddress>https://192.68.49.50:443</ServerAddress>
To be replaced with
<OCM name="httpsOCM">
<ServerAddress>https://192.68.49.48:443</ServerAddress>
<replace>
<text symbol="__ASSET_PRODUCT__">IM</text>
<text symbol="__ASSET_MODEL__">SPF</text>
<text symbol="__ASSET_INITIALPOLLINTERVAL__">30</text>
</replace>
<replace>
<text symbol="__SERIAL_NUMBER__">123456789</text>
<text symbol="__PRODUCT_ID__">PSA_ENG_SYS</text>
<text symbol="__SYSTEM_IDENTIFIER__">00001111</text>
<text symbol="__ASSET_FRIENDLYNAME__">WIN-MLD9VDCTJC4_Administrator_12-20-
2016_03:32:06</text>
<text symbol="__ASSET_DESCRIPTION__">WIN-MLD9VDCTJC4</text>
</replace>
<replace>
<text symbol="__ASSET_PRODUCT__">CMS</text>
<text symbol="__ASSET_MODEL__">IBE_Solution</text>
<text symbol="__ASSET_INITIALPOLLINTERVAL__">30</text>
</replace>
<replace>
<text symbol="__SYSTEM_IDENTIFIER__">00001111</text>
<text symbol="__ASSET_FRIENDLYNAME__">CMS_IBE_Solution_DEVICE</text>
</replace>
<text symbol="__OCM_ADDRESS__">192.68.49.50</text>
3: Update TA address
<text symbol="__TA_ADDRESS__">192.68.49.49</text>
Run the following command “qsaMain.exe -menu -config ..\etc\qsaconfig.xml “ in command prompt shown
in below figure.
Rev G IBE B.08 Installation Guide 183 of 223
WARNING: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,
WITHOUT PERMISSION, IS A VIOLATION OF LAW.
Copyright © 2017 Koninklijke Philips N.V. All rights reserved
Checking the member name in PRS portal
Below are the sample entitlement information which was given at the time of installation.
DEVIBE-Service Number
503456789101-Serial number
In order to work with IPSEC VPN, system should be in PRS network lab.
To install the PSA with a configuration that uses the M2M Enterprise Production Server address:
o Click and invoke the installation process, which by default will extract the installation package files to:
“C:\Downloaded Philips\ PRS_IBE_Solution_A.00.01_Build”
To install the PSA with a configuration that uses the M2M Enterprise Production Server address:
o Exit out of the Installer Interface (Figure 2), and Open command prompt as Administrator, go to the
location where the package was downloaded and Run the following command:
“PRS_IBE_Solution_Installation_A.00.01.exe /PROD”
Figure 1
The installation wizard window will open (Figure 2). The Destination folder location is configurable, but points
by default to:
“C:\Downloaded Philips\ PRS_IBE_Solution_A.00.01_Build”
The PSA Solution installation program provides two Connection Types that are specific to the installation
environment IPSEC VPN.
Below figure shows the PCCI PSA Solution Installer with the IPSEC VPN Connection Type selected
Once after installation. Below are manual changes need to done in Site.xml file.
<replace>
<text symbol="__ASSET_MODEL__">SPF</text>
<text symbol="__ASSET_INITIALPOLLINTERVAL__">30</text>
</replace>
<replace>
<text symbol="__SERIAL_NUMBER__">123456789</text>
<text symbol="__PRODUCT_ID__">PSA_ENG_SYS</text>
<text symbol="__SYSTEM_IDENTIFIER__">00001111</text>
<text symbol="__ASSET_FRIENDLYNAME__">WIN-MLD9VDCTJC4_Administrator_12-20-
2016_03:32:06</text>
<text symbol="__ASSET_DESCRIPTION__">WIN-MLD9VDCTJC4</text>
</replace>
<replace>
<text symbol="__ASSET_NAME__">CMS_IBE_Solution</text>
<text symbol="__ASSET_PRODUCT__">CMS</text>
<text symbol="__ASSET_MODEL__">IBE_Solution</text>
<text symbol="__ASSET_INITIALPOLLINTERVAL__">30</text>
</replace>
<replace>
<text symbol="__SYSTEM_IDENTIFIER__">00001111</text>
<text symbol="__ASSET_FRIENDLYNAME__">CMS_IBE_Solution_DEVICE</text>
</replace>
Run the following command “qsaMain.exe -menu -config ..\etc\qsaconfig.xml “in command prompt shown
below
Below are the sample entitlement information which was given at the time of installation.
DEVIBE-Service Number
503456789101-Serial number
NOTE
Search M2M member name [Name defined by PRS team] in PRS portal. M2M member
name represents generated member name which exist in site.xml.
2) Enter name for the WatchList and click on the (+) icon.
4) Select the communication points and routes needed to be monitored from the list provided.
6) To check whether the WatchList is configured properly go to Rhapsody development console and
click on View->Object Browser.
7) It will display all the routes and the watchlist column should be containing the created watchlist
element against the specific route.
Setting Notification:
Then go to Delivery methods where server host and port settings to configure the email notification have to be
provided by selecting Enable notifications to be sent via email.
1) Go to default setting, add a mail ID in default notification for unmonitored components and click (+)
symbol.
2) Apply the changes.
3) In default threshold setting change the “Raise Issue” to yes for the issue for which monitoring is
required as shown in the below figure.
Figure-12.1.1.2 Appendix A
SQL Server was configured as follows for the MDF and LDF locations:
Changing the Data location to E:\MDF and the Log location to F:\LDF (and creating those directories on the file
system), we were able to install the HIF database without failure.
Symptoms:
• Available memory is almost exhausted.
• The system file cache consumes most of the physical RAM.
• The system has relatively high disk I/O
• There is a continuous and high volume of cached read requests to the hard disk.
• Obvious application performance issues due to increase in paging caused by lack of RAM
Solution:
• Set a Fixed Amount of Memory (SQL Server Management Studio)
• RAMMap to clear the cache/memory maps used by the system
Use the default settings to allow SQL Server to change its memory requirements dynamically based on
available system resources. The default setting for min server memory is 0, and the default setting
for max server memory is 2147483647 megabytes (MB). The minimum amount of memory you can
specify for max server memory is 16 MB
Recommendation:
1. Set the Max Server Memory of SQL Server to 5012 MB for an 8 GB RAM IBE Server. This setting is to
ensure the SQL Server doesn’t overuse the memory allocated for the server.
2. Place the MDF and LDF on different drives for better IO operation.
3. Create temp db files on different folder. Create multiple data files for temp db (if 8 core RAM then create 8
data files).
Download the tool called RAMMap (free and safe). This will provide you a real view of the memory working set
including metafile and memory mapped files. It is not advised to clear the mapped files/cache too frequently, as the
system would need to use some of those to perform. So when it tries to rebuild the needed ones, it utilizes more
memory than reading the available cache. There are recommendations, however, to set the maximum memory that
can be used by metafile and mapped file by the system.
Temporarily, you can use the RAM Map Tool: Go to Empty and click on System Working set. It will not release
your application/3rd party processes/memory but clear the cache/memory maps used by the system. This is safe
tool written by sysinternals (Microsoft) to troubleshoot memory related issues.
In some occasions MCAFEE’s ePO service claims port 8081. To verify (upfront) if port 8081 is claimed, type in the
web browser application http://localhost:8081. No webpage should be displayed.
This means that the management webservice of rhapsody can’t be launched. As a result Rhapsody server cannot
start. To change the port setting for Rhapsody, change the value in the rhapsody.properties file (install location of
rhapsody).
12.1.4 IBE
Yes, new release of IBE will first check for the existing IBE instance. User will be prompted to either retain or delete
existing configuration & database. If user chooses not to delete then the newer release will retain database and
adds only the new features/functionalities/database schemas without removing any of the existing configurations.
Open the command prompt and use the following command to delete the Philips Connected Care Services service.
Run system setup host. When the qualifiers page is reached, select Verify.
One or both of the ServiceHost Installation or ServiceHost Settings qualifiers will fail. This depends on whether
HIF service host has been previously installed.
Philips Healthcare Integration Foundation Services will be displayed in the Services as Running and with a
Startup Type of Automatic.
Orion Rhapsody engine is running but IDE is not logging-in. What could be the problem?
Some Customers enable FIPS. The engine will run with FIPS enabled. The IDE will not. Run regedit.exe and find
the key below
HKLM\System\CurrentControlSet\Control\Lsa\FIPSAlgorithmPolicy\Enabled
0 = off and 1 = on
Turn off the FIPS.
FAQs
Could you tell me how long we can use an IBE license? For how many years will we be able to request the
same license using the same sales order number?
IBE licenses are perpetual unless specified otherwise. This means, there is no time limit until when you
can use them. They do have installation window though in which they should be installed. There is no limit
on replacement licenses as well.
Is there any driver to get sites updated from Rhapsody 4 to Rhapsody 6, is Version 4 going out of support
any time soon?
Yes, version 4 would be out of support soon. We are still to identify the exact dates, but no new orders are
expected to be on version 4.
Steps followed:
1) Install the Barcode font on IBE and ISCV servers. Restart the servers.
3) Configure Study type with template to display barcode font in US reporting tool.
4) Open the Study using US reporting tool, finalize the report in ISCV.
CAUTION
Limitation: If the PDF generated by IBE is copied to a machine which doesn’t have barcode
font, it shall not display the Barcode font on the report
So if you see this issue, which you can see when IE using TCPView:
To resolve it set the below in the "wrapper-local.conf" file in "<Rhapsody Installed drive>:\Program Files\Orion
Health\Rhapsody\bin":
wrapper.jvm.port=31149
Impact: All site using iECG/DECG and planning to move to B.07 or above.
Observation & Resolution: Data will not populate in DECG data contracts until we install Xcelera/ISCV feature,
even though site is not using Xcelera/ISCV. There is a dependency with Xcelera/ISCV in our migration script code
to get data populated in DECG data contacts
For data migration from B.02 to B.07 and above, the following scenarios exist for different product lines:
1. To migrate data for DECG/iECG product line, Xcelera should be installed in the migrated version.
(Steps to be followed are mentioned in the table below)
2. To migrate data for ISP product line, Xcelera should be installed in both B.02 and the migrated version.
(Steps to be followed are mentioned in the table below)
When using IE, not all information might be visible. In screenshot below > no information is given in flat wire
section
Same section as
previous slide. You can
view it by using the
“download button”.
12.2.2 Steps to Uninstall and Install DICOM Manager Service from Command Prompt
1. Check if Dot Net Framework 2.0 or 4.0 is installed in your machine. If yes, go to the location as in below
screenshot to verify if you have InstallUtil.exe available with the .Net installed version. If not install .Net
Framework 4
2. In
preparation
for
configuring
the
a. Location for Dot Net Framework where InstallUtil.exe is available: for this example, it is
C:\Windows\Microsoft.NET\Framework\v4.0.30319
b. Current install location of DICOM Manager Service from where Service needs to be uninstalled: for this
example, it is C:\Program Files (x86)\Philips\IBE\IBEInstaller\
DICOMServiceManager\Philips.IBE.DICOMManagerService.exe
c. Location of the new installer of DICOM Manager Service: for this example, it is
C:\Users\Administrator\Desktop\Xcelera_07022013\DICOMServiceManager\Philips.IBE.DICOMMan
agerService.exe
C:\Users\Administrator>cd \
C:\Windows\Microsoft.NET\Framework\v4.0.30319>InstallUtil.exe C:\Users\Administr
ator\Desktop\Xcelera_07022013\DICOMServiceManager\Philips.IBE.DICOMManagerServic
e.exe <<value from 2c>>
Microsoft (R) .NET Framework Installation utility Version 4.0.30319.1
Copyright (c) Microsoft Corporation. All rights reserved.
The Install phase completed successfully, and the Commit phase is beginning.
See the contents of the log file for the C:\Users\Administrator\Desktop\Xcelera_
07022013\DICOMServiceManager\Philips.IBE.DICOMManagerService.exe assembly's prog
ress.
The file is located at C:\Users\Administrator\Desktop\Xcelera_07022013\DICOMServ
iceManager\Philips.IBE.DICOMManagerService.InstallLog.
Committing assembly 'C:\Users\Administrator\Desktop\Xcelera_07022013\DICOMServic
eManager\Philips.IBE.DICOMManagerService.exe'.
Affected parameters are:
logtoconsole =
logfile = C:\Users\Administrator\Desktop\Xcelera_07022013\DICOMServiceManager
\Philips.IBE.DICOMManagerService.InstallLog
assemblypath = C:\Users\Administrator\Desktop\Xcelera_07022013\DICOMServiceMa
nager\Philips.IBE.DICOMManagerService.exe
C:\Windows\Microsoft.NET\Framework\v4.0.30319>
Only Security Only patches should be installed on the IBE Server. All security patches released prior to the IBE
release should be installed first on IBE server and then approved patches only should be applied post IBE release
month.
For example: Windows Server 2012 R2 was introduced with IBE B.06 released in Oct 2016. ALL MS patches
published before IBE B.06 release should be applied on the IBE B.06 Server upto Oct 2016 – from Nov 2016
Philips has been releasing the approved Security patches. Hence, the security patches released by MS prior to IBE
release are not included in the list.
Applicable patches as of
IntelliBridge Enterprise 2017-10-16
Windows Server 2012 (R2
Version B.07.01 (inclusive of versions starting B.06)
standard(64 bit))
Vulnerability Last update Recommended
Activity Status Notes / Instructions
/ Patch ID by Philips Customer Action
No product Install recommended
4034672 2017-08-21 MS KB Article ID: 4034672
changes planned solution
No product Install recommended
4034733 2017-08-21 MS KB Article ID: 4034733
changes planned solution
No product Install recommended
4025333 2017-07-14 MS KB Article ID: 4025333
changes planned solution
No product Install recommended
4025252 2017-07-14 MS KB Article ID: 4025252
changes planned solution
No product Install recommended
4022717 2017-07-14 MS KB Article ID: 4022717
changes planned solution
2. Click Download for the item which is applicable to the environment where MS Security Patch is to be
deployed.
For example, if IBE Server is running on Windows Server 2012 R2 – we need to click the highlighted
item.
PSA was released to enable FSE’s to access IBE servers via PRS portal. Here are the instructions for applying the
PCCI PSA PRS Portal Patch.
12.4.1 Background
Symptom:
For some PCCI PSA-enabled solutions, the new PRS Portal does not list the associated M2M applications (e.g.
RDP, UltraVNC) under ApplicationsDevice.
Pictured below is the expected behavior (see Figure 12.4.1) and an example where the M2M application(s) are
missing (See Figure 12.4.2).
Figure 12.4.1– Example of M2M Application(s) listed in PRS Portal “Applications” window
Figure 12.4.2 – Example of missing M2M application(s) in PRS Portal “Applications” window
Cause:
A configuration component is not included in the currently deployed Philips Service Agent. This component is
required for M2M applications to be displayed in PRS Portal.
The patch utility is designed so that it can be applied to systems where the PSA is not communicating with
the Philips Remote Service (PRS)/M2M backend (for example, network connectivity is not available, or the
PSA service was manually stopped). However, it is recommended that issues impacting communication of
the PSA with the M2M/PRS backend are resolved prior to deploying the patch. This will minimize or
eliminate post patch deployment troubleshooting scenarios.
The Patch utility can be executed remotely via M2M/PRS, but it should be noted that the PSA service
needs to be restarted for the patch to be activated. Upon restart of the PSA, the remote connection will be
lost, and the remote user will have to wait for the PSA service to re-establish communication with
PRS/M2M. At that point the user can remotely reconnect to complete/validate the installation
The patch utility will launch, and Figure 8.3.2 is displayed. Click Install Patch to apply the fix.
Figure-12.4.3.3 cancellation
The Windows shown in Figure-8.3.4 are displayed indicating that the updated XML configuration has been applied
(new Solution Version shown as A.01.00 in Figure-8.3.4-top image). To start/restart the Philips Service Agent
Service and activate the updated PSA configuration, click OK in the Popup Window (Figure-8.3.4-bottom
image).
WARNING
If you are performing the upgrade via a M2M/PRS remote connection, restarting the PSA will
disconnect you from the device. You will need to wait for the PSA service to restart and re-
establish its communication with the M2M/PRS environment. Once the device is shown as
“Online” in M2M/PRS, you can remotely re-connect to the device to complete the installation. If
for some reason the PSA service does not start/restart (e.g. timeout), it may be necessary to
request that a Health Care Facility IT/Biomed restart the PSA service for you
Once the Service Restart has been completed, the text in Figure 8.3.6 is shown, indicating that the Patch utility
can be closed. Proceed to Section 12.4.5 for Post installation checks.
The /U switch allows the patch utility to be run as a silent unattended installation. The /S switch starts or restarts
the Philips Service Agent Service (depending on its state) after the PSA xml configuration has been updated.
NOTE
Remember that the patch utility and command window must be run with Administrator or
equivalent privileges.
For remote installations via M2M Enterprise, using the /S switch will disconnect the remote
session. Refer to Section 12.4.3 Attended Installation Mode for further details
The following verification steps assume that the PSA was working properly and communicating with M2M prior to
applying the patch utility:
Verify the PSA Service is running after applying the patch (Assumption is that the user chose to Re-/Start
the PSA after the patch was deployed to activate the new configuration.
Verify the PRS Portal shows the device as being Online, and M2M Application(s) are now displayed for the
device (e.g. RDP and/or UltraVNC) in PRS Portal as shown in Figure 8.5.1.
Figure-12.4.5.1 reachabilty
Troubleshooting:
Confirm the PSA service was restarted after the patch was deployed.
Review entries in the Patch utility log file for errors (PCCI_PSA_Patch_PortalAppVis_A.00.00.log), which
can be found at:
o 32 Bit Operating Systems: C:\Program Files\Philips\psa\4.2\logs
o 64 Bit Operating Systems: C:\Program Files (x86)\Philips\psa\4.2\logs
If it appears that the patch was deployed, but is not communicating properly with the M2M/PRS Portal backend,
refer to your relevant service documentation for troubleshooting PSA connectivity or entitlement issues.