-
Notifications
You must be signed in to change notification settings - Fork 4
xInstallation Guide v1.0.0
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. The following system ports should be available and free to use:
Port | Used by |
---|---|
9705 | Tomcat Shutdown port |
9709 | AJP |
9743 | TLS (reserved for future use) |
9760 | HTTP |
Port | Used by |
---|---|
5000-5015 | PIF Listener port range |
7297 | Proxy Port |
9770 | HTTP |
9773 | TLS |
9775 | Tomcat Shutdown port |
9779 | AJP |
Unzip the contents to a directory of your choice. The full path of the directory to which the ZIP file was extracted will be referred to as <installation-directory>
.
In the references below, you will have to replace with the directory location of the folder where the ZIP file was extracted.
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 <installation-directory>/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. |
The asbestos_complete1.0.0.zip
file contains a Tomcat Application Server bundled with the following Java Web Applications:
- FHIR Toolkit v1.0.0
- XDS Toolkit v7.3.0
- HL7 HAPI v3.7
The default ExternalCache location for all Toolkits is <installation-directory>/tomcat/Toolkits/ExternalCache
All of the FHIR Toollkit backend process API related URLs (XDS Toolkit, HAPI FHIR) are configured in the following file: <installation-directory>/tomcat/Toolkits/FhirToolkit/conf/service.properties
We have installed two custom scripts in tomcat/bin
. The scripts will start HAPI FHIR, XDS Toolkit, and FHIR Toolkit (in that order).
Script | |
---|---|
start.sh |
to start both the XDSToolkit base and the FhirToolkit base (in that order) |
stop.sh |
to stop both |
Batch file | |
---|---|
start.bat |
To start both the XDSToolkit base and the FhirToolkit base (in that order). Note: start.bat must be typed along with the .bat file extension. |
stop.bat |
To stop both |
To access FHIR Toolkit, open a Web browser to http://localhost:9760/
If you are using XDS Toolkit for MHD Document Source Testing, XDS Toolkit must be started BEFORE FHIR Toolkit. The FHIR Toolkit initialization will setup the required simulators on the backend using the XDS Toolkit Simulator API.
If you are NOT using XDS Toolkit, you should comment off the xdsToolkitBase
property in your service.properties file so that the FHIR Toolkit will not attempt to create the required XDS simulators.
Set the CATALINA_HOME
and the CATALINA_BASE
system environment variables and run the Tomcat startup batch file/script.
REM Set CATALINA_HOME to the Tomcat directory
SET CATALINA_HOME=<installation-directory>\tomcat
REM Set the FHIR Toolkit Catalina Base
SET CATALINA_BASE=%CATALINA_HOME%\Toolkits\FhirToolkit
REM Start Tomcat
%CATALINA_HOME%\bin\startup.bat
To access FHIR Toolkit, open browser to http://localhost:9760/
REM To shutdown Tomcat
%CATALINA_HOME%\bin\shutdown.bat
# Set CATALINA_HOME to the Tomcat directory
export CATALINA_HOME=<installation-directory>/tomcat
# Set the FHIR Toolkit Catalina Base
export CATALINA_BASE=$CATALINA_HOME/Toolkits/FhirToolkit
# Start Tomcat
$CATALINA_HOME/bin/startup.sh
To access FHIR Toolkit, open browser to http://localhost:9760/
# To shutdown Tomcat
$CATALINA_HOME/bin/shutdown.sh
- 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.
HOW-TOs can be found in the <installation-directory>/HOW-TO
File | |
---|---|
serviceProperties.json | Mainly used by the FHIR Toolkit Web Interface to communicate with the FHIR Toolkit backend API |
service.properties | FHIR Toolkit service properties |
toolkit.properties | XDS Toolkit properties |
hapi.properties | HAPI FHIR configuration properties |
HL7(R), HEALTH LEVEL SEVEN(R), FHIR(R) and the FHIR Logo (R) 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.