Completing the Installation

This document covers the following topics:

Setting up Entire System Server Components

Entire System Server on UNIX is set up with the following steps

Step 1: Customize Entire Broker

The following definitions must be included in the Entire Broker attribute file: 

DEFAULTS=SERVICE
TRANSLATION=SAGTCHA
SERVER=<nodename>
CLASS=NPR
SERVICE=<npr_identifier>

where

<nodename> is the identification of the node where the server is active.
<npr identifier> is the identification of the service name provided for the NPR server.

Repeat these definitions for every NPR server specified in the npr.ini file. For instance, if an NPR server is available in the HP001 node with the service name nprdemo, the following definitions must be created: 

DEFAULTS=SERVICE
TRANSLATION=SAGTCHA
SERVER=HP001
CLASS=NPR
SERVICE=nprdemo

For installing Entire Broker, see the latest documentation.

Step 2: Set Environment Variable ETB_TIMEOUT

To enable an Entire System Server (NPR) service to stop while the TCP/IP connection to the Broker is down, the environment variable ETB_TIMEOUT is automatically set to 60 seconds by NPRETB and NPRMGR.This avoids a hang of the broker stub during a disconnected TCP/IP connection, and allows the stopping of npretb in such a situation. Note that ETB_TIMEOUT remains unchanged if it was set before the execution of npretb resp. nprmgr.

Step 3: Customize the NPR Server

The npr.ini file is used to define the behavior of the server processes. It is structured in one [DEFAULTS] section and one or more [<npr identifier>] sections.

You can define settings either in the [DEFAULTS] section or in an [<npr identifier>] section:

Define Settings in a Section

The [DEFAULTS] section contains default values that apply to all servers. For a particular server such a default can be overwritten by providing an [<npr identifier>] section with an alternative setting.

Settings in a [<npr identifier>] Section

The [<npr identifier>] sections are optional, and can be created or modified later. They are used to define items specific to a certain server when these are different from default.

Any item defined in the [DEFAULTS] section can also be defined for each [<npr identifier>] section.

Any item defined in the [DEFAULTS] section can also be defined for each [<npr identifier>] section. If an item is not defined in this section, it is taken from the [DEFAULTS] section.

Possible Settings

This section lists the relevant variables and valid values:

Local_Node=<node name>

Default Description
None Default local node name.

Integration_mechanism=ETB,<broker id>

Default Description
None

Default integration mechanism. This item identifies the integration mechanism for establishing the communication between the client and the NPR server. Currently, only Entire Broker is supported as integration mechanism.

Direct TCP/IP communication to the Entire Broker This requires the availability of an EntireX Broker stub on the machine where the NPR server is running. In this case, the following syntax is possible too: 

Integration_mechanism=ETB,<broker id>:<port number>:TCP

Please refer to the EntireX Broker documentation for details about connections using TCP/IP.

ETB_Wait=<seconds>

Default Description
30 Default Entire Broker timeout.

ETB_Replica={yes|no}

Default Description
No Default replica server option. Currently not supported.

Log_File_Prefix=<string>

Default Description
Default Default global log file prefix. This item identifies the prefix of the global log file that will be generated in the $NPRDIR/$NPRVERS/work directory.

Trace_Level=<number>

Default Description
0 Trace level for server's trace file. 0 (zero) means: no trace.

Trace_File_Prefix=<string>

Default Description
Trace Default global trace file prefix. This item identifies the prefix of the global trace file that will be generated in the $NPRDIR/$NPRVERS/work directory.

Command_Log_Level=<number>

Default Description
0 Sets different levels of NPR command logging.

Possible Values

  • 0 no command logging

  • 1 log after NPR call

  • 2 log before and after NPR call

  • 3 log before and after NPR call plus Entire Broker error code logging

  • 4 like 3, with more call parameter logging

IPC_Prefix=<4 hexadecimal digits>

Default Description
aaaa Default prefix for IPC resources. Each character must origin of the range 0...9 or a...f.

Administrator = <user name>

Default Description
root Default user authorized as administrator for Entire System Server. root is always authorized independently of the value specified here.

An npr.ini Sample File 

; Entire System Server
; Version 2.1.2 PL 0
; (C) 2001, Software AG
; Entire System Server INI file
; This file has been customized during the installation process,
; but it is possible to modify this information at any time using
; any text editor available on the system

[DEFAULTS]
Local_node=<node name>
Integration_Mechanism=ETB,<ETB id>
ETB_Wait=30
ETB_Replica=no
Log_File_Prefix=default
Trace_Level=0
Trace_File_Prefix=trdef
Command_Log_Level=0
IPC_Prefix=aaaa
Administrator=sag

[nprdemo]
Local_node=DEMONODE
Integration_Mechanism=ETB,ETB098
ETB_Wait=30
ETB_Replica=no
Log_File_Prefix=nprdemo
Trace_Level=10
Trace_File_Prefix=trdemo
Command_Log_Level=0
IPC_Prefix=dddd

Step 4: Start Work with Entire System Server

See chapter Product Operation: Windows Service Usage.