Installation on Microsoft Windows
Last updated
Was this helpful?
Last updated
Was this helpful?
When installing SanteDB iCDR server on a Microsoft Windows Server environment you should use the installation package for the latest version of the SanteDB iCDR server. Each solution within SanteDB iCDR Server has its own distribution which can be downloaded for their own source repository.
The installation process for SanteDB on Microsoft Windows is a three step process:
Copy software program files and pre-requisites
Initiate the configuration process
Customizing the behavior of the installed plugins
Entering implementation specific details about the deployment
Running/Initializing the Server
When running SanteDB iCDR server on Microsoft Windows you will require, at minimum:
Microsoft Windows Server 2012 Standard or Microsoft Windows 10
2 Core CPU (4 to 8 Cores recommended)
2 GB RAM (8 or 16 GB of RAM recommended)
300 MB of disk space (1 GB recommended)
Users should be familiar with basic Microsoft Windows concepts such as:
Basic familiarity with the Windows Command Line
Basic familiarity with Microsoft Management Console (MMC)
Basic familiarity with Windows Networking
The installation programs on Windows will:
Install the Visual C++ 2010 redistributable (for C++ libraries)
Install Microsoft .NET Framework 4.8 (if not already installed)
Copies the required files for the selected options to the Installation
Opens Firewall port 8080 and 2100 (for HL7v2) on the Windows Firewall
Create an un-installer which will clean the directory on uninstall
The installation process is a standard Windows installer experience, administrators can elect to install particular plugins that meet their needs.
The plugins available at the time of writing are enumerated below.
The SanteDB Core option installs the core Windows Service executable (santedb.exe
), as well as baseline files such as the API libraries, etc.
When installed, the SanteDB core business intelligence services for rendering and executing reports from applets will be enabled. The BIS should be installed on servers where you'd like the clients to be able to access shared report definitions.
If you're using a third party reporting tool like Jasper Reports, Crystal Reports, SQL Server Report Services, etc. you do not need to enable this.
Installation of the integration interfaces will allow SanteDB iCDR to interact with third party services using one of the standards based APIs such as:
JIRA Integration (which allow submission of Diagnostic reports from dCDR instances directly into JIRA)
ATNA & DICOM Messaging (which allows for dispatch of audits via NEMA DICOM over Syslog)
Installation of a TFA provider allows the iCDR to leverage multi-factor authentication workflows using either E-Mail based TFA codes or SMS based TFA codes (via Twilio)
Installation of the MDM plugin copies the necessary plugins to enable the Master Data Management Resource Manager.
The data persistence plugins enable the one or more of the persistence services in SanteDB on the server. The persistence layer plugins supported are:
PostgreSQL Server Plugin
Firebird Plugin
You should install , at a minimum the Memory Caching service plugin to improve the performance of your installation. If you're running SanteDB in a shared environment with multiple servers in a cluster environment, installation of REDIS is recommended.
Installing the Elbonia Quickstart pack will seed your SanteDB instance with sample data from the fake jurisdiction (from Dilbert) of Elbonia.
Configuration of the SanteDB service is covered in a series of discrete wiki articles which cover each configuration option in the platform and their impact on the system.
Configuration of the SanteDB server should be done prior to the first start of the software. The option to start the configuration tool for SanteDB is provided at the end of the SanteDB installation process.
See: Configuration Tool
When first configuring SanteDB iCDR server on a Windows environment you will need to select the database persistence technology the server will be using, the options are:
PostgreSQL 9+ : If you're running SanteDB with full functionality, select this option.
Firebird : If you're running SanteDB for a quick demonstration or test, select this option.
If you're running multiple instances of SanteDB on the same server, you will need to install the software in different file locations. When configuring the iCDR on the Windows host you can then set an instance name to isolate the Windows Services and event logs.
SanteDB iCDR server packages may be shipped with one ore more SanteDB Solutions included, you should select an appropriate template for the software solution that this instance of the iCDR will fulfill.
Once you've completed the installation options for the SanteDB server and press Continue
you will be prompted to confirm the initial configuration tasks.
You can use the configuration tooling to customize your installation of the SanteDB server. These settings are documented in Configuration Tool
Recommended configuration panels and settings to change include:
Changing the Performance/Caching to REDIS caching and setting up REDIS
Turning down the Diagnostics/Logging setting to Warning or Error
After you have applied the configuration from the Configuration Tool, the SanteDB service will automatically restart.
Once started you can validate connectivity to the SanteDB iCDR server by accessing the Start menu and running SanteDB Server Console (localhost)
. You should be prompted with a login prompt.
Once the login prompt is available you can login with Administrator
and password Mohawk123
.
SanteDB runs as a Windows service (equivalent of a daemon). These can be accessed using the services.msc
plugin an finding the SanteDB Host Process
service. Additionally the service can be restarted from an elevated command prompt using:
The JINT business rules engine allows applets to customize the iCDR and dCDR application behavior by writing .
If your installation of the iCDR will be (CDSS) via the built-in XML protocol format, you should enable CDSS support.
The messaging interfaces option installs the core REST APIs for the iCDR server. These messaging interfaces allow administrators to customize their deployment for scale-out by assigning servers to dedicated roles. For example, in a scaled-out solution an administrator may only install the to the server which controls the cluster, whereas other servers may only install the for clinical data access.
Selecting the PostgreSQL provider will expose the connection parameters for PostgreSQL. See for more information on these settings.
Selecting the Firebird provider will expose the connection parameter for Firebird 3.x provider, SanteDB iCDR will assume you're using the embedded version of Firebird. This database connector has three parameters. See connection details in the configuration tool documentation.