Installing the Web Connector as a separate web application
An instance of the Web Connector is installed automatically with your Unica Interact runtime server, and is enabled by default. However, you can also deploy the Web Connector as its own web application (for example, in a web application server on a separate system) and configure it to communicate with the remote Unica Interact runtime server.
About this task
These instructions describe the process of deploying the Web Connector as a separate web application with access to a remote Unica Interact runtime server.
Before you can deploy the Web Connector, you must have installed the Unica Interact runtime server, and you must have a web application server on another system with network access (not blocked by any firewall) to the Unica Interact runtime server.
Procedure
- Copy the
jsconnector
directory containing the Web Connector files from your Unica Interact runtime server to the system where the web application server (such as WebSphere® Application Server) is already configured and running.You can find thejsconnector
directory in your Unica Interact installation director. - On the system where you'll be deploying the Web Connector
instance, configure the
jsconnector/jsconnector.xml
file using any text or XML editor to modify theinteractURL
attribute.This is set by default to
http://localhost:7001/interact
, but you must modify it to match the URL of the remote Unica Interact runtime server, such ashttp://runtime.example.com:7011/interact
.After you deploy the Web Connector, you can use a web interface to customize the remaining settings in the
jsconnector.xml
file. See Configuring the Web Connector for more information. - For the web application server on which you will be deploying
the Web Connector, set the following Java™ property:
-DUI_JSCONNECTOR_HOME=<jsconnectorHome>
Replace
<jsconnectorHome>
with the actual path to where you copied thejsconnector
directory onto the web application server.The way in which you set the Java™ properties depends on your web application server. For example, in WebLogic, you would edit the startWebLogic.sh or startWebLogic.cmd file to update the
JAVA_OPTIONS
setting, as in this example:JAVA_OPTIONS="${SAVE_JAVA_OPTIONS} -DUI_JSCONNECTOR_HOME=/Unica InteractFiles/jsconnector"
In WebSphere® Application Server, you would set this property in the Java™ virtual machine panel of the administration console.
See your web application server documentation for specific instructions on setting Java™ properties.
- Restart your web application server if it was already running,
or start your web application server in this step, to make sure that
the new Java™ property is used.
Wait for the web application server to complete its startup process before continuing.
- Connect to your web application server management interface with the necessary privileges to deploy an application.
- Follow the instructions for your web application server
to deploy and run the following file:
jsConnector/jsConnector.war
Results
http:// <host>: <port>/interact/jsp/WebConnector.jsp
, where <host> is the system running the web application
server on which you just deployed the Web Connector, and <port>
is the port on which the Web Connector is
listening, as specified by the web application server.