Where is the CONNECT source code repository?

https://github.com/CONNECT-Solution/CONNECT

Do I need to build CONNECT from source code?

You can Download CONNECT as a pre-compiled binary. Please note that each CONNECT release has its own version of the Admin GUI, which has only been tested for compatibility with those specific CONNECT versions. These CONNECT and Admin GUI files are clearly grouped together on our download page.

How do I install CONNECT?

Depending on which release you wish to build, you can get installation instructions from the following wiki page - /wiki/spaces/CONNECTWIKI/pages/117529193.  Software requirements and deployment instructions for each application server, binary or source code installation instructions are available through the installation instructions of each release's link. 

How to do configurable builds?

An in-depth summary can be found here for details on building a customized CONNECT EAR. In short, the EAR is sectioned into various Maven profiles which will add the chosen services into the compiled EAR. They are as follows:

• AD - Admin Distribution
• PD - Patient Discovery
• DQ - Document Query
• DR - Document Retrieve
• DS - Document Submission
• DDS - Document Data Submission (Pilot)
• X12 - Core X12
• Direct - Direct Core
• admingui - Administrative GUI *.WAR, and the corresponding web services into the compiled *.EAR.
• was - Enterprise Application Archive (EAR ) for websphere application server
• weblogic - Enterprise Application Archive (EAR ) for weblogic application server 
• jboss7 - Enterprise Application Archive (EAR ) for Jboss EAP 7 and wildfly application server.

Can CONNECT be used for Carequality implementation?

CONNECT is not currently designed for Carequality exchange although ongoing NHIN and Carequality specification harmonization efforts could eventually lead to CONNECT being a suitable platform for Carequality implementors.

How do I configure my CONNECT TLS/SSL settings?

TLS settings are not configured via CONNECT but CONNECT does provide some TLS override features such as /wiki/spaces/CONNECTWIKI/pages/118035664

What are the different layers of CONNECT, and how are they used?

• Entity - Internal endpoints used to construct NwHin requests to be sent to an external Gateway via NwHin endpoints.
• NwHin - Endpoints that will be hit from an external gateway. This is the crossover point between the Initiating and Responding gateways. For the Initiating gateways, this will be an outbound request to another implementor. For the Responder, this will be an inbound request in which the gateway is expected to process and respond to the request by calling its Adapter.
• Adapter - Implementor specific components which will serve as the communication layers between CONNECT and the proprietary databases,architecture, and services of the implementor. These get called by CONNECT through the NwHin layer when the gateway in question is a responder to a request.

What are all these beans defined in the proxy property files for each service?

Each service may have a respective property file to configure a proxy to be used when communicating with a service. By default, there may be up to four pre-configured beans: NoOp, Java, Secured and Unsecured beans.

• NoOp - Will always return a successful invocation, or a blank response - depending on the expected context of the bean. Does not invoke any web services or call any methods.
• Java - Will use pure java calls to CONNECT code, can be substituted for any java class compiled with the CONNECT EAR, including custom Entity, NwHin, and Adapter implementations
• Secured - Will use a secured port to communicate to a given endpoint configured via the internalExchangeInfo.xml file.
• Unsecured - will use an unsecured port to communicate to a given endpoint configured via the internalExchangeInfo.xml file.

As an implementer, how do I configure my own Entity, NwHin, and Adapter processors?

Injection points into CONNECT are controlled by Spring Bean lookups. Injection can be done in one of 2 ways: Java or Web Services.

For Java injections, simply point the bean for the service you wish to replace in its respective property file to your custom implementation. For example, to change the Document Submission Adapter, the "adapterdocsubmission" alias inside the DocumentSubmissionProxyConfig.xml file would be changed to your custom bean. By default, there are example beans for most services with the "java" postfix - in this case "adapterdocsubmissionjava". This pre-defined bean may be repurposed by changing the "class" to your own java class file.

For webservice injections, the bean alias would be set to either the secure or unsecure beans already defined in the respective XML file. Instead of injecting a custom java class, the appropriate endpoint inside of the internalExchangeInfo.xml file must be changed to point to the URL of where your custom service is deployed. As an example, if we wanted to change the Document Submission Adapter endpoint, we would find the "adapterxdrsecured" service name (Or "adapterxdr" if you are using an unsecured service) and change its URL to point to the custom service. It should be noted that these custom services must implement their respective WSDLs

What is the difference between Standard and Passthrough Modes?

Currently, the CONNECT gateway is designed to operate in two modes, entity (standard) and passthrough. Entity (Standard) allows for further processing by the gateway including policy checks, mpi queries, and fan-out capabilities. Passthrough sends the message directly from gateway to adapter and vice versa. 

What do I need to do if I only want some services deployed, and not others?

When building CONNECT, you may specify the appropriate maven profiles (DQ, PD, DS, DDS, admingui, etc.), which will compile and bundle the services into the resulting EAR file. Simply use the respective profiles only for the services you wish to deploy.

What is the Admin GUI, and how can I use it?

Admin GUI is meant to serve as an extension to CONNECT in order to manage the gateway, certificates, properties, and perform basic queries for information about the gateway. Admin GUI is also capable of serving a cross query client, as well as an interface for viewing Audit and Failure logs. Admin GUI may be deployed either on the same servlet container, as well as on a different server entirely (There may be some additional setup steps in order to configure your Admin GUI onto an external server).

A full user manual on the Admin GUI can be found here.

Can I override exchange's partners endpoints locally?

CONNECT facilitate custom overrides for an exchange partner. You can define them in exchangeInfo.xml. Refer to /wiki/spaces/CONNECTWIKI/pages/544899100

How do I initiate exchange directory download?

CONNECT can download from web services registry from both UDDI  and FHIR directroies. You can configure the download in exchangeInfo.xml. For more information see /wiki/spaces/CONNECTWIKI/pages/278528020 and Sample exchangeInfo

How can I import eHealth Exchange Chain of Trust?

/wiki/spaces/CONNECTWIKI/pages/94306306

How can I switch from MySQL to Oracle database?

See link to forum post on how a community member switched to use Oracle instead of MySQL - Switching-from-MySQL-to-Oracle-database-for-Connect-4-0

Follow the Steps below to run CONNECT Oracle Scripts for a fresh install:
1. Run dropall_oracle.sql
2. Run nhincdb_oracle.sql 
3. Run populateTestData_oracle.sql
4. Run loadTestDocumentData_oracle.sql (PLEASE NOTE this script can't be run from SQL Plus due to line limitation, you have to use SQLDeveloper or some other COTS product like TOAD, PL/SQL Developer)

How can I use PKCS12 KeyStore instead of JKS KeyStore in WebSphere Application Server?

See link to forum post on how a community member setup a JKS Keystore with WAS - Using-PKCS-KeyStore-in-WAS-instead-of-JKS-KeyStore

How can I use the CA Signed Certificate for CONNECT in WAS 8.5?

See link to forum post on how to use a CA signed certificate instead of self signed certificate in WebSphere Application Server 8.5 stand alone installation for CONNECT -  Using-CA-Signed-Certificate-for-Connect-4-0-in-WAS-8-5 

How can I create custom secure (SSL) port and unsecure port in WAS for CONNECT Validation Suite (SOAP-UI) Testing?

See link to forum post on how to use a create a custom secure and unsecure ports in WebSphere Application Server 8.5 for CONNECT Validation Suite (SOAP-UI) Testing 

How can I install CONNECT on Tomcat?

CONNECT currently is tested on Wildfly, JBoss, WebSphere and WebLogic. However there seems no reason why CONNECT would not work on Tomcat. See link to forum post on how some of our community members have successfully installed CONNECT on Tomcat and associated tips/changes needed in the configuration files - Deploying-Connect-4-on-tomcat

How can I resolve third party Dependency DTD/SCHEMA URLs?

CONNECT uses Java JEE standard for developing all the Web/Web Service modules. The JEE web application/Enterprise application uses DTD/SCHEMA to verify the XML deployment descriptors used, which are specific to each application server vendor and these DTD/SCHEMA are hosted by the application vendor and referenced from CONNECT Web/Web Service applications. We recently noticed that one of the application server vendor's site (hosting these DTD/SCHEMAs) was down causing the CONNECT system to be down. For example, the sun.com site which was hosting some DTD/SCHEMA was down and due to this CONNECT was not deploying/working for one of the CONNECT users. Implementation teams can resolve this issue by doing any of the following:

1. Creating a ticket with the application server vendor. 
2. Internally hosting DTD/SCHEMA site and put all the referenced DTD/SCHEMAs there.