Skip to main content

%DotNet Server

Define a .NET Gateway.

Synopsis

[Gateways] %DotNet Server=.NET,Server,Port[,optional fields]

%DotNet Server is the definition of a DotNet Gateway. ServerIP and Port are required fields. All the comma-separated fields are described below.

Description

The [Gateways] section of the configuration parameter file contains entries for each External Language Gateway configured on the InterSystems IRIS® data platform instance. Each entry contains a comma-separated list of values defining a Gateway Server. Some fields are required, and default values are used for blank fields.

The fields for a .Net Gateway, in order, are as follows:

  1. Type (required) — Type of the Gateway Server. When the Gateway is for .Net, this is set to .NET.

  2. Server (required) — IP address or name of the machine where the Gateway Server executable is located. The maximum length is 256 characters; 127.0.0.1 is the default.

  3. Port (required) — TCP port number for communication between the Gateway Server and the proxy classes in InterSystems IRIS. This port number must not conflict with any other local TCP port on the server. This port number must not conflict with any other local TCP port on the server.

  4. DotNetVersion — Specifies the .NET version to be used (see Object Gateway Server Versions).

  5. FilePath — Location of the Gateway Server executable. This is used to find the target executable and assemble the command to start the Gateway on a local server. If this setting is not specified, the default directory <install-dir>\dev\dotnet\bin\ is used.

  6. Exec32 — On 64-bit platforms, indicates if the Gateway server is executed as 32-bit or 64-bit.

  7. LogFile — Full pathname of the file used to log all communication between InterSystems IRIS and the Gateway Server. This optional property should only be used when debugging. The maximum length is 1023 characters.

  8. UseSharedMemory — Whether to use shared memory for connection if available. The default is 1 (use shared memory).

  9. AllowedIpAddresses (only used for .NET Gateways) — IP address of the local network adapter to which the server listens. Specify 0.0.0.0 to listen on all IP addresses local to the machine (127.0.0.1, VPN address, etc.). You can also specify a single existing local IP address to restrict the listener to that IP address. 127.0.0.1 is the initial expression.

  10. UsePassphrase — Whether the Gateway requires a passphrase for connection on startup. The default is 0 (do not use passphrase).

  11. ConnectionTimeout — Number of seconds to wait for a connection to be established with the Gateway Server. The range is 2-300; the default value is 5.

  12. HeartbeatFailureAction — Action to take if the Object Gateway goes into a failure state. The default is R. Valid values are:

    • N – No action.

    • R – Restart the Gateway Server.

    • A – Generate an Alert entry in the Interoperability event log.

    • RA – Restart and generate an alert.

    Note:

    If Server points to a remote system, this feature can't be set to restart the Server.

  13. HeartbeatFailureTimeout — Number of seconds to wait for a heartbeat response before deciding that the Gateway Server is in failure state. If this value is smaller than HeartbeatInterval, the Gateway Server is in failure state every time the communication check fails. The range is 0–86400 (1 day); the default is 30.

  14. HeartbeatInterval — Number of seconds between each communication with the Gateway Server to check whether it is active. A value of 0 disables the heartbeat and related Heartbeat settings. When enabled, valid values are from 5 to 3600 seconds (1 hour); the default is 10 seconds.

  15. HeartbeatFailureRetry — Number of seconds to wait before retrying the HeartbeatFailureAction when the Gateway Server is in a failure state. A value of 0 disables this retry, meaning that once there is a failure that cannot be immediately recovered, there are no attempts at automatic recovery. When enabled, valid values are from 1 to 86400 (24 hours); the default is 300 seconds (5 minutes).

  16. InitializationTimeout — Number of seconds to wait for a response during initialization of the Gateway Server. The range is 2-300; the default value is 5.

Changing This Parameter

On the External Language Servers page of the Management Portal (System Administration > Configuration > Connectivity > External Language Servers), click %DotNet Server to edit this Gateway. You can also click Create External Language Server to create a new .Net Gateway.

Instead of using the Management Portal, you can change %DotNet Server in the Config.Gateways class (as described in the class reference) or by editing the CPF in a text editor (as described in the Editing the Active CPF section of the “Introduction to the Configuration Parameter File” chapter in this book).

Feedback