The Server Configurator tool provides a single point of access for installing, configuring, and deploying JBoss server configurations. It supports multi-server configurations, enables multi-website installations, automatically tunes JBoss memory settings, and creates backups of critical configuration files. The tool guides the user through prerequisites, defines server roles, validates databases, installs components, resets security, and allows changing the application logon details. It also describes how to uninstall JBoss servers and addresses some common questions.

1. Imagination at work
How will the new JBoss Configurator
Tool affect my environment and
change my upgrade processes?

2. 2
©2015 General Electric Company.
The results expressed in this document may not be applicable to a particular site or installation and individual results may vary. This document and its contents are
provided to you for informational purposes only and do not constitute a representation, warranty or performance guarantee. GE disclaims liability for any loss, which
may arise from reliance on or use of information, contained in this document. All illustrations are provided as fictional examples only. Your product features and
configuration may be different than those shown. Information contained herein is proprietary to GE. No part of this publication may be reproduced for any purpose
without written permission of GE.
DESCRIPTIONS OF FUTURE FUNCTIONALITY REFLECT CURRENT PRODUCT DIRECTION, ARE FOR INFORMATIONAL PURPOSES ONLY AND DO NOT
CONSTITUTE A COMMITMENT TO PROVIDE SPECIFIC FUNCTIONALITY. TIMING AND AVAILABILITY REMAIN AT GE’S DISCRETION AND ARE SUBJECT TO
CHANGE AND APPLICABLE REGULATORY CLEARANCE.
GE, the GE Monogram, Centricity, and imagination at work are trademarks of General Electric Company.
All other product names and logos are trademarks or registered trademarks of their respective companies.
General Electric Company, by and through its GE Healthcare division.

3. Today’s Presenter and Panelists
Steve Oubre
Staff Software Quality
Test Engineer
Presenter
Hilari Scott
Product Manager
Ambulatory Practice Management
Panelist

4. Agenda
• Server Configurator: What, Why, Where, When, How
• Prerequisites
• Server Role Options
• Installation Workflow
• CPS Post Installation Requirements
• Multi-Website Installation Workflow
• Application Logon Changes
• Automatic Backups
• Tuning
• Uninstall Processes
• FAQs

5. Imagination at work
Server Configurator
Installation and Configuration of JBoss, Service Layer

6. What does it do?
• Single point of access for all Jboss server configurations
• Installation, Configuration, and Deployment
• Supports multi-server configurations for larger sites to separate GUI and
Interop servers
• Enabled Multi-website configuration for vertical scaling on a single Jboss
installation (2 to 8 websites for combined PM/EMR installs; 2 to 15 for
PM only installs) – Note this is only available for CPS
• Eliminates manual configuration changes
• JBoss memory tuning out of the box based on the number of Licensed
users or number of websites
• Automatically creates a backup of critical configuration elements

7. Launch Help

8. Server Configurator Help
• Press F1 Key to launch help
from within Server
Configurator
• Contains troubleshooting,
support, and prerequisite
details

9. Prerequisites

10. 10
1. Run Hardware calculator before running the
server configurator tool
2. Global Permissions must be set to not restrict
scripts
3. Install demo first

11. Server(s) Prerequisites
• Remember F1 Help in this tool is your best friend
• Windows Server 2012 or Windows Server 2008 R2 Service Pack
1
• Note: Windows Server 2012 R2 will be supported in CPS 12.2 and EMR 9.10
• Latest Windows updates and necessary reboots
• At least 10 GB free disk space
• Static IP addresses
• Servers are on the same domain
• Host names are less than 15 characters
• Microsoft .NET Framework 4.5 (dotNetFx45_Full_setup.exe)
11

12. Server(s) Prerequisites
• Run tool under Domain Admin Account
• Ensure Network Admin Shares are enabled. Enabled is the default.
• Test by accessing <JBOSS Host>c$
• Enabling details to follow
• Run this utility from your Centricity staging folder on a Windows based server
• Do not run this utility remotely from a mapped drive
• Servers with 64GB+ Memory require additional configuration
• Details to follow
• If Windows Firewall is on:
• Create a new inbound rule in the firewall to allow the appropriate port to communicate with the database.
• CPS – Port 1433 (Microsoft SQL default port number)
• EMR – Port 1521 (Oracle default port number)
12

13. Required Services
• Windows firewall can be
turned ON or OFF but
“Windows Firewall” windows
service must be running
• Windows Management
Instrumentation service must
be running
• These services can be turned off
when the Configurator is not in use

14. PowerShell 3.0
• PowerShell 3.0 must be
installed
• This is included if using
Windows Server 2012
• PowerShell 3.0 is
included in the
CPS_12_Staging or
CentricityStage folders
• Ensure all Windows
updates have been
applied before installing 14
CPS
EMR

15. Enabling File and Printer Sharing
• Enable File and
Printer Sharing for
Windows Server 2012
systems
• Go to Control
PanelNetwork and
InternetNetwork and
Sharing
CenterAdvanced
sharing settings
15

16. WinRM QuickConfig Command
16

17. Run WinRM quickconfig command
• Run Command prompt
as administrator. WinRM
quickconfig command
to be run on all servers
with no errors.
• Possible Error # 1
• Resolution: Choose Y to
enable

18. Run WinRM quickconfig command
Possible error #2
• If Network Connection
Type is set to Public it
can cause a failure

19. Run WinRM quickconfig command
Resolution of error #2
• Remove the public
network shown below
to eliminate this
• Run the command again

20. Configuration for Servers with
64+ GB Memory
20

21. For servers with more than 64GB
• Modification to WinRM
configuration are required
• From the JBoss target
deployment Server
• Launch PowerShell ISE
(Integrated Scripting
Environment) as Administrator

22. For servers with more than 64GB
From PowerShell run the following queries
• Change default from 1GB to 5GB:
winrm set winrm/config/winrs '@{MaxMemoryPerShellMB="5120"}'
Get-Item WSMan:localhostShellMaxMemoryPerShellMB
• Increase the default from 1GB to 2GB or more, but less than 5GB. This example shows
3GB:
Set-Item
WSMan:localhostPluginMicrosoft.PowerShellQuotasMaxMemoryPerShellMB 3072
Get-Item
WSMan:localhostPluginMicrosoft.PowerShellQuotasMaxMemoryPerShellMB
• Restart the WinRM service
Restart-Service winrm
Verify there are no errors in the output window

23. Example

24. Server 2008 R2 SP1
Enabling Network Admin Shares
24

25. Enabling Network Admin Shares Using Regedit
• HKEY_LOCAL_MACHINESYSTEMCurrentControlSetServicesLan
manServerParametersAutoShareServer
• The registry subkey AutoShareServer must be set as type
REG_DWORD.
• When this value is set to 0 (zero), Windows does not automatically
create administrative shares. Be aware that this does not apply to the
IPC$ share or shares that you create manually.
• On the Edit menu, click Modify
• Enter 1 for Value data and click OK
• Exit Registry Editor
25

26. Enabling Network Admin Shares Using CMD
• At the command prompt, type the following lines. Press Enter
after each line:
net stop server
net start server
• Type exit to close the Command Prompt window
26

27. Jboss Server Roles
Defined

28. Single Server Role
• Used for both the client application processing and
interop (Common Event Model) web services. This
configuration is only recommended for sites with less
than or equal to 200 licensed users.
• If this server is taken offline, both the client application
and interop utilities will not function.
• The URL containing this host name should be deployed
to the client workstations

29. GUI Server Role
• Used for client application processing, client web
services, and application business logic. Used in
conjunction with an interop server for sites with over 200
licensed users.
• If this server is taken offline, the application client is not
accessible.
• The URL containing this host name should be deployed
to the client workstations

30. Interop Server Role
• Only one Interop Server currently allowed per
configuration.
• Used for interop processing for interfaces, (CEM) web
services and business logic. Handles subscriptions
including Functional Measure, Clinical Quality Measure,
and Immunization registry. Used in conjunction with a
GUI server for sites with over 200 licensed users.
• If this server is taken offline, the Common Event Model
will not function. Examples utilities that utilize the
Common Event Model are QIE interfaces for CQR or
Immunization Registries.
• There will not be a URL that points to this hostname
Can there be mutliple interops and do they
assist with load balancing? If so, what are the
thresholds/failovers?

31. Using the Server Configurator

32. Launching Server Configurator

33. CPS Database Validation
33

34. EMR Database Validation
34

35. Recommended Configuration
35

36. Single Server Installation
36

37. Adding a Single Server Host
• Input Hostname
• Select Single Server
from the Server Role
List
• Click Validate & Add

38. Validation Results
• Validation results
displayed
• Server added to grid
for installation

39. Installation
• Click Validate &
Install button to start
JBoss, Service
Layer, Website
installation

40. Installation
• Server Readiness
validation complete
• Click Yes to start
installation

41. Single Server Use Case
• Installation progress
meter

42. Single Server Use Case
• Installation complete
• Read and acknowledge
the message

43. Viewing the Log File
• Click View Log
button
• Identifies Installation
Failures per Server
• Identifies URL for a
CPS website

44. Sample Log File
• Example of URL location
in the log
• Failed install information
will be listed at the
bottom of the log

45. GUI & Interop Server Installation
45

46. Adding a GUI Server
• Input Host name
for the GUI server
• Select GUI Server
from the Server
Role List
• Click Validate &
Add

47. Adding an Interop Server
• Follow the same
process as GUI
• Select Interop Server in
the Server Role list
• Validate & Add

48. Installing Servers in Parallel
• Click Validate &
Install button to start
JBoss, Service Layer,
Website installation

49. Server Readiness Validation
• Server Readiness
validation complete
• Click Yes to start
installation

50. Installation Progress
• Installation process runs
in parallel

51. Installation Complete
• Read and acknowledge
the message
• If CPS Proceed to reset
security for all
databases

52. Reset Security (CPS Only)

53. Resetting CPS Security
• Advanced Setup
OptionsUtilitiesSecurity

54. Resetting CPS Security
• Select Security

55. Resetting Active Directory Security
• Re-input Password/Confirm
password fields
• Click Finish to write and
encrypt password to the
database and website

56. Resetting Active Directory Security
• Click OK to complete

57. Application Security
57
• Click Application
• Click Finish

58. Application Security
58
• Click OK to complete

59. CPS Multi Website
Installation

60. Multi Website Configuration
• Additional hardware may be
required
• Not to be used for Demo
website install
• Largest concurrent user
count website must be
installed last
• Select Multi-Website
checkbox
• Select the number of
websites from the
dropdown

61. Multi Website Configuration
• Add Host name of JBoss
Server
• Server Role is defaulted
to “Single Server”
• Click Validate & Add
button

62. Example Resource Blocking Message
• In this example, the
server does not meet
requirements for Logical
Processors and Memory
• Installation is halted

63. Host Server Validate & Add
• Validation results
displayed
• Server added for
installation

64. Host Server Validate & Install
• Click Validate & Install
button to start JBoss,
Service Layer, Website
installation

65. Host Server Validate & Install
• Server Readiness
validation complete
Click Yes to start
installation

66. Host Server Validate & Install
• Installation complete
• Read and acknowledge
the message

67. Install Subsequent Database
• Check Modify
Configuration Information
• Ensure Multi Website is
selected
• Select database
• Proceed with Validate &
Add
• Proceed with Validate &
Install

68. Set Application
Logon

69. Application Logon Details
• Behind the scenes user for website and database
communications
• User is a database owner user
• This is not an actual live user account that would login to the
client
• Changing the password is not required
• Useful if you do not know the current password

70. Launch Server Configurator

71. Changing EMR Application Logon
• Click Change
Password
• Input ML password
• Select Database
• Enter New/Confirm
passwords
• Click Continue
• Stop JBOSS Service
on GUI/APP server

72. Changing CPS Application Logon
• Click Change
Password
• Input SA
username/password
• Select Database
• Enter New/Confirm
passwords
• Click Continue
• Stop JBOSS Service
on GUI/APP server

73. Changing Application Logon
• This message needs
JBOSS service
stopped before
proceeding
• Confirm Service
status stopped on
GUI/Single Server
• Click Yes to continue

74. Changing Application Logon
• Acknowledge the
message by clicking
OK
• If additional JBOSS
servers in place,
repeat process for
each
• Upon completion
restart JBOSS service
• Test Logon to
application

75. Backup Files and Folders

76. Backup location
Shows folders by DateTime stamp

77. Drill into the folder
JBoss folder - contains backup of JBoss related files
ServiceLayer folder – contains backup of Service Layer related
files
jboss-ews-2.0 – reserved for future use

78. Files backed up for JBoss

79. Files backed up for Service Layer

80. Backup of Encounterforms
Anything within this folder will be included in the backup

81. Backup of properties files

82. Backup of jobs.txt and Source Folder

83. Out of Box Tuning for
• Licensed Users
• Multi-website

84. Licensed user memory tunings
Number of
Licenses/Users
JVM Memory
(Xms, XmX)
OS Memory Total Memory
0-200 5 GB 3 GB 8 GB
201-500 9 GB 3 GB 12 GB
501 – 1000 12 GB 3 GB 15 GB
1000 + 17 GB 3 GB 20 GB
PM Only: 0 –
1000+ Users
5 GB 3 GB 8 GB

85. Multi-Website memory tuning
Multi-
Website
Cumulative #
of
Concurrent
Users
CPU
(Processor
s / vCPUs)
JVM
Memory
(Xms,
XmX)
OS
Memory
Total
Memory
2-4
Websites
200 2 8 GB 3 GB 11 GB
5-10
Websites
400 4 10 GB 3 GB 13 GB
11-15
Websites
500 4 14 GB 3 GB 17 GB
Multi-
Website
Cumulative #
of
Concurrent
Users
CPU
(Processor
s/ vCPUs)
JVM
Memory
(Xms, XmX)
OS
Memory
Total
Memory
2-4
Websites
200 6 12 GB 3 GB 15 GB
5-8
Websites
400 12 18 GB 3 GB 21 GB
C-EMR, CPS (PM and
EMR), and CPS EMR
Module
CPS PM Module

86. How to Uninstall JBoss

87. • Do not complete from Control panel going forward
Uninstall JBoss on Windows Server 2012

88. Uninstall JBoss on Windows Server 2008R2

89. Q. Will the new server configurator allow installs with SQL Server clusters?
A. The configuration tool validates against the name of the database and does not discriminate whether the
database is running on a Cluster or an individual database.
Q. Is this solution only for multi-website configurations or for single-website configurations?
A. It is necessary for both.
Q. What about servers in a workgroup (i.e. no domain in the environment)?
A. It will work as long as you are using Application Authentication for security.
Q. We have servers that are DHCP, but they are reserved in DHCP so they are always the same. Do we need
to change this?
A. No
Q. Do you use the server configurator to uninstall and install the website instead of JBoss?
A. The current version of the server configurator will install the website but does not uninstall the website.
Serversetup is used to uninstall the website as always. You can only install the website using the server
configurator tool.
FAQ

90. FAQ continued
Q. Is this tool a requirement ?
A. All versions of CEMR 9.8.10+ and CPS 12.0.10+ will require this new tool to upgrade and install the product.
Q. When you say "Do not run this utility remotely from a mapped drive" do you run it remotely via a UNC path
or run it on the database server (where the CentricityStage folder is) and it remotely installs to your JBoss
server?
A. You can not run this tool from a mapped drive or UNC path. You will need to run this from the server that is
hosting the staging area.
Q. GE support made modifications to our JBoss files to maximize performance how does this new tool impact
our custom configurations?
A. The configurations will be backed up. The updated configuration files incorporate performance changes for
all customers. If a customer finds the new configuration is not optimal they can work with support to restore
their backed up configurations.
Q. What is the recommended number of Centricity clients per JBOSS server?
A. Please use the hardware calculator to determine this (calculators for CPS 12.0/12.2 and CEMR 9.8/9.10
can be found on the following links)
CPS link: https://engage.gehealthcare.com/community/en/cps/documentation
CEMR link: https://engage.gehealthcare.com/community/en/emr/documentation

91. Q. We current host 40 CPS databases on a single database server, with all the JBoss instances for each
database spread across 8 GUI/Interop servers. Does Server Configurator allow for such configurations?
A. Depending on the user load, you should be able up to 8 CPS Joint Websites(GUI/Interop) up to 15 CPS PM
Only Websites(GUI/Interop) Installations per JBoss server. Refer to hardware calculator for sizing.
Q. Once the tool has been installed will all users clients need to be upgraded ?
A. Yes
Q. Is the website URL no longer customizable?
A. The URL name is customized upon creation of the database name.
Q. Will the Immunization and Medication Administration HTML folders be retained on this tool? In past
updates, I have had to copy these folders out and then replace them after the upgrade. RE: on the JBOSS
folders on APP server
A. Yes
Q. What about AIX database installs?
A. Works the same as SQL or Oracle/Windows installs in terms of JBoss deployment.
FAQ continued

92. Q. If upgrading to SP10, how will our server setup be upgraded to the new server configurator tool before
upgrading?
A. It is now part of CPS Server Setup and CEMR SetStage.
Q. Can you add multiple JBOSS servers to load balance application presentation?
A. That will be officially supported in CPS 12.2 and CEMR 9.10
Q. When installing multiple websites, is a JBoss service restart required to install a new website on one JBoss
server?
A. Yes
Q. How do we determine which server is our InterOp server?
A. The ServerConfig table in the database contains this information ( i.e. select * from serverconfig; )
Q. For large groups (200+ users) on SP9 and earlier, can they go ahead and split GUI and Interop Server
functionality before their SP10 upgrades?
A. Yes
Q. Are the plans for CPS client updates to be automated? If so, what SP or version?
A. CPS 12.2 and CEMR 9.10 will include client MSI deployment packages
FAQ continued

93. Q&A?