Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
outlinetrue
stylenone

A connector server is required when a connector bundle is not directly executed within your application. By using one or more connector servers, the connector architecture thus permits your application to communicate with externally deployed bundles.

...

Installing a Java Connector Server

Minimum Requirements:

  • Java 1.6 or later for 1.4.X.Y / Java 1.8 for 1.5.X.Y

  • Refer to your Java connectors to determine if there are any additional requirements 

Create your execution environment

  • Download the Connector Server package

  • Unzip it in a directory of your choice (e.g. /usr/jconnserv) on the host where you wish to run the Java connector server

Test your execution environment

From the directory created above, run the Java connector server with no arguments to see the list of command-line options:

  • Linux / MacOS: ./bin/ConnectorServer.sh

  • Windows: \bin\ConnectorServer.bat

You should see the following output:

 

...

 

...

Usage:

...


...

 

...

 

...

 

...

 

...

   Main -run

...

-properties

...


 

...

 

...

 

...

 

...

 

...

 Main -setKey

...

-key

...

 -properties

...


 

...

 

...

 

...

 

...

 

...

 Main -setDefaults

...

-properties

...

Configure your Java connector server

  • Run the connector server with the -setKey option as described above to set your desired key into your properties file

  • For all other properties (e.g. port), edit the conf/connectorserver.properties manually. The available properties are described in the connectorserver.properties file.

Running your Java connector server

Run the server by launching with the -run option:

  • Linux / MacOS: ./bin/ConnectorServer.sh -run -properties conf/connectorserver.properties

  • Windows: \bin\ConnectorServer.bat -run conf\connectorserver.properties

Installing Connectors on a Java Connector Server

To deploy a Java connector:

  • Copy the Java connector bundle jar file into the bundles directory in your Java connector server directory

  • If necessary, add to the classpath any 3rd party jars required by any Java connector

  • Restart the Java connector server

Using SSL to communicate with connector servers

The following steps are necessary to successfully communicate with a connector server using SSL:

  • Deploy an SSL certificate to the connector server's system.

  • Configure your connector server to provide SSL sockets.

  • Configure your application to communicate with the communicate with the connector server via SSL.

Configure your application to use SSL

...

Java applications may solve the non-standard certificate authority issue by expecting that the following Java system properties are passed when launching the application:

  • javax.net.ssl.trustStorePassword
    For example, -Djavax.net.ssl.trustStorePassword=changeit

  • javax.net.ssl.trustStore
    For example, -Djavax.net.ssl.trustStore=/usr/myApp_cacerts

Or, instead, the non-standard certificate authorities may be imported to the standard ${JAVA_HOME}/lib/security/cacerts.

...

Installing a .NET Connector Server

Minimum Requirements:

  • Windows Server 2003 or 2008

  • .NET Framework 3.5 or higher

  • Refer to your .NET connector to determine if there are any additional requirements

Execute ServiceInstall.msi. Just follow the wizard. It will walk you through the whole process step by step. Upon completion, the Connector Server will be installed as a windows service.

...

Start the Microsoft Services Console. Check to see if the Connector Server is currently running. If so, stop it. From a command prompt, set the key for the connector Server. This is done by changing to the directory where the connector server was installed (by default: \Program Files\Identity Connectors\Connector Server) and executing the following command:

...

ConnectorServer /setkey

...

<newkey>

where <newkey> is the value for the new key. This key is required by any client that connects to this Connector Server.

...

The port, address, and SSL settings are in the tag called AppSettings, and look like this:

...

<add key="connectorserver.port"

...

 value="8759" />

...

<add key="connectorserver.usessl"

...

 value="false" />

...


<add key="connectorserver.certificatestorename"

...

 value="ConnectorServerSSLCertificate" />

...

<add key="connectorserver.ifaddress"

...

 value="0.0.0.0" />

The port can be set by changing the value of connectorserver.port. The listening socket can be bound to a particular address, or can be left as 0.0.0.0. To setup to use SSL, you must set the value of connectorserver.usessl to true, and then set the value ofconnectorserver.certifacatestorename to your the certificate store name.

You will need to record for use later the following information regarding your connector server installation:

  • Host name or IP address

  • Connector server port

  • Connector server key

  • Whether SSL is enabled

Changing Trace Settings

Trace settings are in the configuration file. The settings look like this:

<system.diagnostics>
 

...

<trace autoflush="true"

...

 indentsize="4">

...

 

...

 

...

 <listeners>

...

 

...

 

...

 

...

 <remove name="Default" />
 

...

 

...

 

...

 <add name="myListener"

...

 type="System.Diagnostics.TextWriterTraceListener"

...

 initializeData="c:\connectorserver2.log"

...

 traceOutputOptions="DateTime">

...

 

...

 

...

 

...

 
 

...

 

...

 

...

 

...

 <filter type="System.Diagnostics.EventTypeFilter"

...

 initializeData="Information" />
 

...

 

...

 

...

 </add>
 

...

 

...

</listeners>
 

...

</trace>
</system.diagnostics>

The Connector Server uses the the standard .NET trace mechanism. For more information about the tracing options, see Microsoft's .NET documentation for System.Diagnostics.

...

If for some reason, this is not adequate, the connector server may be installed or uninstalled as a Windows service by using the /install or /uninstall arguments on the command line. To run the Connector Server interactively, issue the command:

...

ConnectorServer /run

Installing Connectors on a .NET Connector Server

...