N2SVCD Configuration - OSDApp

OSD Application Configuration

The N2SVCD OSD Application is a protocol gateway application which can perform client requests using the SOAP/XML protocol used by the Oracle OCNCC "Open Services Development" service component running on an Oracle SLC node. The N-Squared Tester Application requires a OSD Application instance to be installed in order to execute OSD tests.

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

<?xml version="1.0" encoding="utf-8"?>
<n2svcd>
  ...
  <applications>
    ...
    <application name="OSD-SLC01" module="OSDApp">
      <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"/>
        <parameter name="security" value="inline"/>
        <parameter name="ssl" value="1"/>
        <parameter name="ssl.SSL_verify_mode" value="0"/>                 
      </parameters>
    </application>
    ...
  </application>
  ...
</n2svcd>

The application element attributes for a OSD Application instance are:

Attribute Type Description
name String [Required] A unique name for this application instance.
module String [Required] OSDApp
include.lib String [Required] ../apps/osd/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 OSD Server.
.remote_port Integer [Required] IPv4 Port Number for OSD Server.
.uri String URI to pass in HTTP Request.
(Default = "http://<remote_host>:<remote_port>").
.username String Username to present to OCNCC OSD as credentials.
.password String Password to present to OCNCC OSD as credentials.
.security String Mechanism for passing username/password.
basic (Basic Auth in HTTP Headers), inline (OSD parameters), or none.
(Default = basic).
.ssl Integer Should this OSD application use SSL/TLS for its sever connections.
1 (Use SSL/https) or 0 (No-SSL, use http).
(Default = 0).
.ssl.SSL_verify_mode Integer Should this OSD application verify the Server Peer's certificate?
1 (Verify Server's Certificate) or 0 (Do not verify Server's Certificate).
(Default = 1).
.ssl.SSL_ca_file String Use a Certificate Authority contained in the indicated file.
(Default = Use system default Certificate Authorities).
.ssl.SSL_ca_path String Use all Certificate Authority files contained in the indicated directory.
Multiple directories may be delimited by the : character.
(Default = Use system default Certificate Authorities).
.pool Integer Number of simultaneous TCP client connections to this OSD 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 OSD connection.
(Default = 5 seconds).

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