N2SVCD Configuration - PIApp

PI Application Configuration

The N2SVCD PI Application is a protocol gateway application which can perform client requests using the Man-Machine Language (MML) protocol used by the Oracle OCNCC "Provisioning Interface" service component running on an Oracle SMF node. The N-Squared Tester Application requires a PI Application instance to be installed in order to execute PI tests.

The following configuration is used to create a PI Application instance to act as a protocol gateway to an Oracle OCNCC Provisioning Interface. A single PI Application instance will maintain a pool of connections to a single PI Server Address. If you need to connect to more than one remote PI Server Address, you must configure multiple PI Application instances (each with unique names).

<?xml version="1.0" encoding="utf-8"?>
<n2svcd>
  ...
  <applications>
    ...
    <application name="PI-SMF01" module="PIApp">
      <include><lib>../apps/pi/lib</lib></include>
      <parameters>
        <parameter name="remote_host" value="10.42.2.154"/>
        <parameter name="remote_port" value="4999"/>
        <parameter name="username" value="admin"/>
        <parameter name="password" value="admin"/>
        <parameter name="pool" value="3"/>
      </parameters>
    </application>
    ...
  </application>
  ...
</n2svcd>

The application element attributes for a PI Application instance are:

Attribute	Type	Description
name	String	[Required] A unique name for this application instance.
module	String	[Required] PIApp
include.lib	String	[Required] ../apps/pi/lib
parameters	Array	[Required] Array of name = value Parameters for this Application instance.
.remote_host	String	[Required] IPv4 Host Name or A.B.C.D IPv4 Address for PI Server.
.remote_port	Integer	[Required] IPv4 Port Number for PI Server.
.username	String	[Required] Username to present to OCNCC PI as credentials.
.password	String	[Required] Password to present to OCNCC PI as credentials.
.pool	Integer	Number of simultaneous TCP client connections to this PI end-point. (Default = 2).
.backlog_timeout	Integer	Number of seconds to wait for a free connection before abandoning the request. (Default = 10 seconds).
.server_timeout	Integer	Number of seconds to wait on a submitted request before abandoning the request. (Default = 20 seconds).
.reconnect_interval	Integer	Time in seconds between attempts to re-connect a failed PI connection. (Default = 5 seconds).

Note: The PI Server allows only one outstanding request per client connection.