Publishing Web service providers to a custom port

You may want to publish a REST or a SOAP provider on a node other than the Connect GUI node. You may have this requirement in both single node and multiple nodes (clustered) environment. To achieve this, Adeptia Connect equips you with a feature to define a custom port and then publish the provider on that port. Doing this, you can have different web service providers running on different nodes.

The following section explains how to add a custom port and publish a provider on that port.

Defining custom port in Server.xml file

Follow the steps below to publish a web service provider to a custom port:

1. Go to ...<ConnectPortalInstallfolder>/<conf> location.
2. Open Server.xml file.

3. Define a custom port by adding and updating the following section:
   

   <!-- <Connector port="443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="5000" scheme="https" secure="true" compressionMinSize="128" connectionTimeout="20000" maxConnections="10000" clientAuth="false" sslProtocol="TLSv1.2" sslEnabledProtocols="TLSv1.2" keystoreFile="./keystore/adeptiaBPM.keystore" keystoreType="JKS" keystorePass="password" compression="on" noCompressionUserAgents="gozilla, traviata" compressableMimeType="text/html,text/xml,text/css,application/javascript,application/json" useSendfile="false" server="Adeptia" xpoweredby="false" />

   1. In the code block, update the following parameters:

      Parameter	Value
      Connector Port	Set the port number.
      Protocol	Sets the protocol to handle incoming traffic. The default value is HTTP/1.1.
      Max thread	The maximum number of request processing threads to be created by this Connector, which therefore determines the maximum number of simultaneous requests that can be handled. If not specified, this attribute is set to 200.
      SSLEnabled	Use this attribute to enable SSL traffic on a connector. To turn on SSL handshake/encryption/decryption on a connector set this value to true. The default value is false.
      Scheme	Set this attribute to the name of the protocol you wish to have returned by calls. For example, you would set this attribute to "https" for an SSL Connector. The default value is "http".
      Secure	Set this attribute to true if you wish to have calls to return true for requests received by this Connector. The default value is false.
      ClientAuth	Put the value as true or false.
      SSLProtocol	JSSE only. The SSL protocol(s) to use (a single value may enable multiple protocols - see the JVM documentation for details).

   You can add multiple ports by adding the code block in the respective SoapService and RestService sections.

   In case of the clustered environment, you need to define the custom ports on every node.

4. Save the file.

5. Restart the Connect Portal.
   Once you have added the ports in the Server.xml file, they will be visible in the Select Port drop-down list while creating or editing the REST and SOAP Provider.

6. Select the port number other than the default port (Connect GUI port) while creating or editing a provider.
   You can publish only on one port at a time.

7. Click Yes, Publish it to confirm.
   Once published, a confirmation message is displayed.