Configuration

Configuration wizard

One of the possible options for configuring our services is to use our configuration wizard. It make basic configuration easier.

Configuration wizard will run automatically when configuration file was not found. Also is additional possibility to run configuration wizard by run application with the following parameter:

1
$  --edit-config 

NETframe 2.1.0

host

Allows to provide ip on which application should listen. Most common are 127.0.0.1 or 0.0.0.0

remoteURL

Specifies where the soap client should send the responses. It will append as a first entry in wsdl:service. You can also set it to null to use only the values from server's network interfaces.

listeners [array]:

Listeners on which application will wait for client's requests.

HTTPS require keys and certificates.

Keep in mind that you should always use your own certificate. The ones bundled with the app do not guarantee maximum security and should only be used in non-production environments.

registerGSDServiceRoute

Toggles /gsdservice route registration

registerWebserviceASMXRoute

Toggles /WebService.asmx route registration

connection

connectionAcquireTimeoutMillis

Specifies how long the application should wait for the connection queue to release the application.

connectionIdleTimeoutMillis

Specifies how long the connection pool should hold the connection before disconnecting the socket to SXP/RAS.

minimumActiveConnections

Specifies how many connections to SXP/RAS should be always alive.

maximumActiveConnections

Specifies maximum amount of opened sockets NETframe can have simultaneously.

sessionTimeoutInSeconds

Specifies the time after which session should be timed out. Timeout refreshes after successful request.

resolveHostNames

Allows to use IP address only in the configuration file.

Eg. If you use net-frame.local which resolves to 127.0.0.1 you don't have to explicitly use "net-frame.local" as a host value and use only the IP address.

You may still use domain names

If you specify "net-frame.local" and "127.0.0.1" in erpRASConfig then your call to "net-frame.local" will be used and the IP address won't be resolved. All resolved domains will be cached for the domain TTL.

dfRASConfig [array]

host

Remote access server host - domain or ip.

port [array]

Array of ports.

Info

If you specify more than one port then the fastest one will be used.

erpRASConfig

host

SXP host - domain or ip.

port [array]

Array of ports.

Info

If you specify more than one port then random service will be used.

loggerConfig

trimLogs

Allows to trim the logs.

maxLogLength

If trimLogs is enabled then this value changes the maximum length for single log.

prettyPrint:

Enables log coloring. If your logs contain strange characters and are not colored then turn this option off.

This feature requires an ANSI support in console.

It is enabled by default on Windows 10 and Unix. Older operating systems do not support ANSI characters.

statistics:

enabled:

Enables statistics logging.