diff --git a/XDS-Toolkit/installation.md b/XDS-Toolkit/installation.md new file mode 100644 index 0000000000000000000000000000000000000000..d605b110d60ad6b51faa23575314751cdefe64ba --- /dev/null +++ b/XDS-Toolkit/installation.md @@ -0,0 +1,166 @@ +# XDStools installation and configuration for eHealthSuisse + +## Installation + +Follow the officiel documentation: https://github.com/usnistgov/iheos-toolkit2/wiki/installing + +## Configuration + +### Environment + +Create ehealthsuisse environment: + +``` +cp -r #external_cache#/environment/default #external_cache#/environment/ehealthsuisse +chown -R tomcat:tomcat ehealthsuisse +``` + +In the GUI, in Toolkit configuration, change the Default Environment to **ehealthsuisse**. + +TODO: keystore conf + +#### code.xml + +Add code.xml (from https://ehealthsuisse.ihe-europe.net/xdstools7/sim/codes/ehealthsuisse) in /var/lib/tomcat9/webapps/xdstools7/toolkitx/environment/default/codes.xml + +In #external_cache#/environment/ehealthsuisse, codes.xml should be a symbolic link to the file previously mentioned: + +``` +ln -s #external_cache#/environment/ehealthsuisse/codes.xml /var/lib/tomcat9/webapps/xdstools7/toolkitx/environment/default/codes.xml +``` + +Repeat the same steps for all environment (I am not sure why but it is needed even if the simulators are all in the ehealthsuisse environment) + + +### Test Session + +In the GUI, at the top, create a test session named **epr-testing** + +In Toolkit configuration, change the Default Test Session to **epr-testing**. + +### Simulators + +All the following simulators need to be created in the GUI: + +#### for_registry_testing + +Actor type: Document Repository +Simulator ID: for_registry_testing +repositoryUniqueId: 1.1.4567332.1.64 +Register endpoint: https://ehealthsuisse.ihe-europe.net:10443/DocumentRegistry?wsdl +Register TLS endpoint: https://ehealthsuisse.ihe-europe.net:10443/DocumentRegistry?wsdl + +#### one_registry_to_rule_them_all + +Actor type: Document Registry +Simulator ID: for_registry_testing +Set **Update Metadata Option** and **Restricted Update Metadata Option** to **true** +Set **Validate Against Patient Identity Feed** to **false** + +#### imaging_document_source + +Actor type: Imaging Document Source +Simulator ID: imaging_document_source +IDS Repository UniqueId: 1.1.4567332.10.8 +IDS Image Cache: xds_i_conformity_repo #TODO create it + +#### resp_img_gw + +Actor type: Responding Imaging Gateway +Simulator ID: resp_img_gw +homeCommunityId: urn:oid:1.1.4567334.101.5 +Imaging Document Sources: epr-testing__imaging_document_source + +#### for_init_gw_testing + +Actor type: Responding Gateway +Simulator ID: for_init_gw_testing +homeCommunityId: urn:oid:1.1.4567334.1.6 +Set **Update Metadata Option**, **Restricted Update Metadata Option** and **Remove Documents Options** to **true** +Set **Validate Against Patient Identity Feed** to **false** +repositoryUniqueId: 1.1.4567332.1.75 + +#### for_repository_testing + +Actor type: Document Repository +Simulator ID: for_repository_testing +repositoryUniqueId: 1.1.4567332.1.5 +Register endpoint: http://<hostname>:<port>/xdstools7/sim/epr-testing__one_registry_to_rule_them_all/reg/rb +Register TLS endpoint: http://<hostname>:<mtls_port>/xdstools7/sim/epr-testing__one_registry_to_rule_them_all/reg/rb + +#### init_gateway + +Actor type: Initiating Gateway +Simulator ID: init_gateway +Responding Gateway: epr-testing__for_init_gw_testing + +#### docsrc_support + +Actor type: Document Repository/Registry +Simulator ID: docsrc_support +Responding Gateway: epr-testing__for_init_gw_testing +repositoryUniqueId: 1.1.4567332.1.8 + +#### init_img_gw + +Actor type: Initiating Imaging Gateway +Simulator ID: resp_img_gw +Responding Imaging Gateways: epr-testing__resp_img_gw + +#### for_doc_consumer_testing + +Actor type: Document Repository +Simulator ID: for_repository_testing +repositoryUniqueId: 1.1.4567332.1.69 +Register endpoint: http://<hostname>:<port>/DocumentRegistry?wsdl +Register TLS endpoint: http://<hostname>:<mtls_port>/DocumentRegistry?wsdl + +#### rr + +Actor type: Document Repository/Registry +Simulator ID: rr +Validate Against Patient Identity Feed ????? => was not here before TO TEST +repositoryUniqueId: 1.3.6.1.4.1.21367.13.71.101.1 + +#### ids + +Actor type: Imaging Document Source +Simulator ID: ids +IDS Repository UniqueId: 1.3.6.1.4.1.21367.102.1.1 +IDS Image Cache: idc-dataset-a #TODO create it + +#### imaging_document_source + +Actor type: Imaging Document Source +Simulator ID: imaging_document_source +IDS Repository UniqueId: 1.1.4567332.10.8 +IDS Image Cache: xds_i_conformity_repo #TODO create it + +#### ie_registry + +Actor type: Document Registry +Simulator ID: ie_registry + +#### for_doc_source_testing + +Actor type: Document Repository +Simulator ID: for_doc_source_testing +repositoryUniqueId: 1.1.4567332.1.70 +Register endpoint: http://<hostname>:<port>/DocumentRegistry?wsdl +Register TLS endpoint: http://<hostname>:<mtls_port>/DocumentRegistry?wsdl + +#### simulator_ids + +Actor type: Imaging Document Source +Simulator ID: simulator_ids +IDS Repository UniqueId: 1.3.6.1.4.1.21367.13.80.110 +IDS Image Cache: ids-repository #TODO create it + +#### idc + +Actor type: Imaging Document Consumer ?? Couldn't find it +Simulator ID: idc +IDS Repository UniqueId: 1.3.6.1.4.1.21367.13.80.110 +IDS Image Cache: ids-repository #TODO create it + +