Connectathon Brussels Nov. 2020

Table of Contents

• Accessing Toolkit Components
  • Launching FHIR Toolkit UI
  • Launching XDS Toolkit UI
• Useful Connectathon Toolkit Links
• Overview
• System Requirements
  • FHIR Toolkit Ports
  • HAPI FHIR Ports
  • XDS Toolkit Ports
• Terms
• Contents
• Installation
• Configuration
• HL7 HAPI FHIR
• The version of the HAPI FHIR that was used to test FHIR Toolkit can be found here
• The Default External Cache Location

Accessing Toolkit Components

Launching FHIR Toolkit UI

https://cat-nist-tools.ihe-europe.net:9443/

Channel Configurations

To view a channel configuration, select a channel first, and then click "Config" above the list box.

Note	HTTPS on FHIR is not supported. You must the HTTP Channel Base address in the channel config.

Launching XDS Toolkit UI

https://cat-nist-tools.ihe-europe.net:8099/xdstools/

Red/Green/Blue simulators

The cat__regrep simulator is configured to accept Red/Green/Blue Patient ID Assigning Authority. homeCommunityID OID urn:oid:1.3.6.1.4.1.21367.2011.2.6.233 repositoryUniqueID OID 1.3.6.1.4.1.21367.2011.2.3.383

Useful Connectathon Toolkit Links

Managing System Configurations at Connectathon https://github.com/usnistgov/iheos-toolkit2/wiki/Managing-System-Configurations-at-Connectathon

Overview

The toolkit download is a zip file named asbestos.version.zip. It contains a full installation of Tomcat pre-loaded with the FHIR Toolkit component and allows for additional components. The components are:

• FHIR Toolkit (proxy, test engine, and UI)

• XDS Toolkit (needed for testing MHD XDSonFHIR option)

• HAPI FHIR server

While there is one Tomcat Home there are several Tomcat Bases (independent instances of Tomcat). The overall contents look like:

asbestos/
   tomcat/
      bin/
          start.sh            Starts entire tool
          start.bat
          stop.sh             Shuts down entire tool
          stop.bat
          startup.sh          Starts a component defined by the CATALINA_BASE system environment variable
          startup.bat
          shutdown.sh          Stops a component defined by the CATALINA_BASE system environment variable
          shutdown.bat
      Toolkits/
          ExternalCache/      External Cache shared between XDS Toolkit and FHIR Toolkit
                              All internal tools auto-configure to use it (through the component base's bin/setenv.sh script)
          FhirToolkit/
              conf/
                  service.properties   Controlling properties file for server
              webapps/
                  asbestos    FHIR Toolkit WAR
                  ROOT/
                      serviceProperties.json   Secondary properties file for UI
          HapiFhir/
               base/          HAPI FHIR
          XdsToolkit/
              conf/
                  toolkit.properties
              webapps/
                   xdstools/  XDS Toolkit

System Requirements

Java 8 should be installed and accessible through your system shell environment or command prompt. The system should also meet requirements to run Apache Tomcat Server Version 9.0.26. At least one of these environment variables is needed to run this program: JAVA_HOME or JRE_HOME. The following system ports should be available and free to use:

FHIR Toolkit Ports

Port	Used by
9705	Tomcat Shutdown port
9709	AJP
9443	HTTPS GUI
9760	HTTP Proxy Channels

HAPI FHIR Ports

Port	Used by
7705	Tomcat Shutdown port
7709	AJP
7080	GUI and HAPI FHIR port

XDS Toolkit Ports

Port	Used by
5000-5035	PIF Listener port range
8080	Non-TLS HTTP simulators
8099	HTTPS GUI Only
8297	Proxy Port
8443	TLS simulators
8888	HTTP GUI redirect port to HTTPS
9775	Tomcat Shutdown port
9779	AJP

Terms

Term	Description
CATALINA_HOME	The Tomcat installation directory.
CATALINA_BASE	The CATALINA_BASE environment variable specifies location of the root directory of the "active configuration" of Tomcat. See tomcat/RUNNING.txt for more details on CATALINA_BASE. Each type of Toolkit (FHIR, XDS) makes use of a dedicated CATALINA_BASE.
FHIR Toolkit	NIST FHIR Toolkit is used for the IHE MHD profiles and FHIR testing.
XDS Toolkit	NIST XDS Toolkit is used for the IHE XDS profiles.
HAPI FHIR	HL7 HAPI FHIR Server

Contents

The asbestos_complete1.0.0.zip file contains a Tomcat Application Server bundled with the following Java Web Applications: * FHIR Toolkit v2.1.0 * XDS Toolkit v7.6.0 * HL7 HAPI v3.7

Installation

/opt/asbestos is the <installation-directory> on the server.

Configuration

See https://github.com/usnistgov/asbestos/wiki/Configuration.

HL7 HAPI FHIR

https://hapifhir.io/

The version of the HAPI FHIR that was used to test FHIR Toolkit can be found here

• https://github.com/usnistgov/asbestos/releases/download/0.1/fhir.zip

• The fhir.zip file can be extracted to <installation-directory>/tomcat/Toolkits/XdsToolkit/webapps

• You may need to update the FHIR Toolkit service.properties file to reflect the FHIR Base URL that is in use.

The Default External Cache Location

The default ExternalCache location for all Toolkits is <installation-directory>/tomcat/Toolkits/ExternalCache

HL7®, HEALTH LEVEL SEVEN®, FHIR® and the FHIR Logo ® are trademarks owned by Health Level Seven International, registered with the United States Patent and Trademark Office.

Sun, the Sun logo, Sun Microsystems, Solaris, HotJava, and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and certain other countries.