Overview

main.yml file is located in $JLUPIN_HOME/server/start/configuration directory and it contains general configuration that controls all function of Main Server.


main.yml parameters

The main configuration file consists of the following sections:

Section 'ZONE'

The appropriate part of the configuration file:

ZONE:
  name: default
[...]

Description:

Parameter Description
name The name of the zone, to which JLupin Node belongs to. This parameter is managed only by JLupin Control Center.

The idea of zone is described in this chapters.

Section 'MAIN_SERVER'

The appropriate part of the configuration file:

[...]
MAIN_SERVER:
  name: NODE_1
[...]

Description:

Parameter Description
name The name of jBrick - a node identifier used by built-in load balancers and by JLupin Control Center to manage nodes in zones.

Section 'SERVERS'

This section contains infrastructural definitions of an interface (logical server). The detailed description is provided in chapter about Automatic interfaces.

Section 'ENTRY_POINT'

This section contains the logical definitions of an interface (entry point). The detailed description is provided in chapter about Automatic interfaces.

Section 'ENTRY_POINTS_SECURE_INFO'

The set of parameters that controls security mechanisms run around entry point.

The appropriate part of the configuration file:

[...]
ENTRY_POINTS_SECURE_INFO:
  isServerNameEnable: false
[...]

Description:

Parameter Description
isServerNameEnable Determines if a name of an entry point is forwarded from entry point to a microservice. This name then can be used for athorization purposes.

Section 'INITIALIZING_LOGGER'

This section contains configuration of main server logger.

The appropriate part of the configuration file:

[...]
INITIALIZING_LOGGER:
  #directoryPath: 'c:/server/alternative_path/logs'
  fileName: 'main_server_initialize'
  fileExtension: 'log'
  fileSizeInMB: 10
  maxFiles: 10
[...]

Description:

Parameter Description
fileName The prefix main server log file.
fileExtension the extension of main server log file.
fileSizeInMB The maximum log file size, expressed in MB.
maxFiles The maximum number of files. If the limit is exceeded, the first file is used again.

Section 'MICROSERVICES_LOCAL_PORT'

The appropriate part of the configuration file:

[...]
MICROSERVICES_LOCAL_PORT:
  offset: 20000
[...]

Description:

Parameter Description
offset Main Server needs port sets to establish communication to microservices. These sets are managed automatically by default which means that ports in the set is assigned dynamically. Main Server starts this dynamic allocation from offset port number, so the first dynamically chosen port will equal to offset.

Section 'PROCESS_MANAGER' and 'TECHNICAL_PROCESS_MANAGER'

This section contains the logical definitions of an interface (entry point). The detailed description is provided in chapter about Automatic interfaces.

Section 'EVENT_LOG_MANAGER'

Event log manager handles internal events regarding JLupin Platform components and managed microservices. For example, if a microservice disappears the process manager will recover this microservice while putting appropriate message to event log about taken actions. Event log can accessed though different tools:

  • JLupin Local Console (see events list command)
  • HTTP INFORMATION PORT (see /getEventLog URI)

The appropriate part of the configuration file:

[...]
EVENT_LOG_MANAGER:
    howOftenCheckingExpireTimeInMillis: 20000
    logExpireTimeInMillis: 120000
    maximumSizeInMegabytes: 5
[...]

Description:

Parameter Description
howOftenCheckingExpireTimeInMillis How often (the period is expressed in milliseconds) event log manager checks the event log against expired events that should be removed.
logExpireTimeInMillis The expiration time of events, expressed in milliseconds.
maximumSizeInMegabytes The maximum size od event log , expressed in MB. If it is exceeded the event log is flushed immediately.

Section 'MONITORING_MANAGER'

Monitoring manager is responsible for collecting monitoring data from enviroment and provide them do access channels:

  • JMX interface
  • HTTP INFORMATION PORT
  • JLupin Local Console

The appropriate part of the configuration file:

[...]
MONITORING_MANAGER:
    howOftenRefreshAllEnvironmentStateInMillis: 10000
    isJMXEnable: true
[...]

Description:

Parameter Description
howOftenRefreshAllEnvironmentStateInMillis How often (the period is expressed in milliseconds) monitoring manager collects data from the environment.
isJMXEnable The switch that determines is JMX service is enabled.

Section 'LOCK_MANAGER'

The lock manager supports concurrency in accessing individual components of the JLupin node. For example, after microservice restart is initialized no other commands can be performed on that microservice.

The appropriate part of the configuration file:

[...]
LOCK_MANAGER:
    isTurnedOn: true
[...]

Description:

Parameter Description
isTurnedOn The switch that determines of lock manager is turned on. We strongly recommend to keep it running in the production environments.

Section 'MICROSERVICES_LOAD_BALANCER_SETTINGS' and 'NODE_PEERS'

This section defines the behavior of built-in load balancer. The detailed description is provided in chapter about Load Balancer.


Default configuration file

ZONE:
  name: default
MAIN_SERVER:
  name: NODE_1
SERVERS:
  JLRMC: #JLupin Remote Method Call Fast Protocol
    port: 9090
    readTimeout: 480000
    waitForFinishExecuteAllRequests: true
    waitToShutdownThreadsOnStop: 60000
    backlog: 0
    receiveBufferSize: 0
    isReuseAddress: false
    threadPoolSize: 128
    logPeriodicOnDebug: true
    destroyThreadOnTimeout: false
    threadExecutingTimeOut: 240000
    entryPoint: 'JLRMC'
    SSL:
      isSSL: false
      isTwoWaySSLAuthentication: false
      X.509.Format:
        isActive: true
        #search in path $SERVER_HOME$/server-resources/ssl/server
        serverX509CertificateWithRSAPublicKeyFileName: 'serverX509Certificate.crt'
        serverPKCS8EncodedWithRSAPrivateKeyFileName: 'serverPrivateKey.pk'
        #clientsX509CertificateWithRSAPublicKeyDirectoryPath: 'C:/server/server-resources/ssl/client'
  ELASTIC_HTTP:
    port: 8082
    readTimeout: 480000
    waitForFinishExecuteAllRequests: true
    waitToShutdownThreadsOnStop: 60000
    backlog: 0
    receiveBufferSize: 0
    isReuseAddress: false
    threadPoolSize: 128
    logPeriodicOnDebug: true
    destroyThreadOnTimeout: false
    threadExecutingTimeOut: 240000
    entryPoint: 'ELASTIC_HTTP'
    SSL:
      isSSL: false
      isTwoWaySSLAuthentication: false
      X.509.Format:
        isActive: true
        #search in path $SERVER_HOME$/server-resources/ssl/server
        serverX509CertificateWithRSAPublicKeyFileName: 'serverX509Certificate.crt'
        serverPKCS8EncodedWithRSAPrivateKeyFileName: 'serverPrivateKey.pk'
        #clientsX509CertificateWithRSAPublicKeyDirectoryPath: 'C:/server/server-resources/ssl/client'
  QUEUE:
    port: 9095
    readTimeout: 480000
    waitForFinishExecuteAllRequests: true
    waitToShutdownThreadsOnStop: 60000
    backlog: 1024
    receiveBufferSize: 1024
    isReuseAddress: false
    threadPoolSize: 1024
    logPeriodicOnDebug: true
    destroyThreadOnTimeout: false
    threadExecutingTimeOut: 240000
    entryPoint: 'QUEUE'
    SSL:
      isSSL: false
      isTwoWaySSLAuthentication: false
      X.509.Format:
        isActive: true
        #search in path $SERVER_HOME$/server-resources/ssl/server
        serverX509CertificateWithRSAPublicKeyFileName: 'serverX509Certificate.crt'
        serverPKCS8EncodedWithRSAPrivateKeyFileName: 'serverPrivateKey.pk'
        #clientsX509CertificateWithRSAPublicKeyDirectoryPath: 'C:/server/server-resources/ssl/client'
  TRANSMISSION:
    port: 9096
    readTimeout: 480000
    waitForFinishExecuteAllRequests: false
    waitToShutdownThreadsOnStop: 60000
    backlog: 0
    receiveBufferSize: 0
    isReuseAddress: false
    threadPoolSize: 64
    logPeriodicOnDebug: true
    destroyThreadOnTimeout: false
    threadExecutingTimeOut: 240000
    entryPoint: 'TRANSMISSION'
    SSL:
      isSSL: true
      isTwoWaySSLAuthentication: true
      X.509.Format:
        isActive: true
        #search in path $SERVER_HOME$/server-resources/ssl/server
        serverX509CertificateWithRSAPublicKeyFileName: 'serverX509Certificate.crt'
        serverPKCS8EncodedWithRSAPrivateKeyFileName: 'serverPrivateKey.pk'
        #clientsX509CertificateWithRSAPublicKeyDirectoryPath: 'C:/server/server-resources/ssl/client'
  INFORMATION:
    port: 9097
    readTimeout: 480000
    waitForFinishExecuteAllRequests: true
    waitToShutdownThreadsOnStop: 60000
    backlog: 0
    receiveBufferSize: 0
    isReuseAddress: false
    threadPoolSize: 64
    logPeriodicOnDebug: true
    destroyThreadOnTimeout: false
    threadExecutingTimeOut: 240000
    entryPoint: 'INFORMATION'
    SSL:
      isSSL: false
      isTwoWaySSLAuthentication: false
      X.509.Format:
        isActive: true
        #search in path $SERVER_HOME$/server-resources/ssl/server
        serverX509CertificateWithRSAPublicKeyFileName: 'serverX509Certificate.crt'
        serverPKCS8EncodedWithRSAPrivateKeyFileName: 'serverPrivateKey.pk'
        #clientsX509CertificateWithRSAPublicKeyDirectoryPath: 'C:/server/server-resources/ssl/client'
  INFORMATION_HTTP:
    port: 9098
    readTimeout: 480000
    waitForFinishExecuteAllRequests: true
    waitToShutdownThreadsOnStop: 60000
    backlog: 0
    receiveBufferSize: 0
    isReuseAddress: false
    threadPoolSize: 64
    logPeriodicOnDebug: true
    destroyThreadOnTimeout: false
    threadExecutingTimeOut: 240000
    entryPoint: 'INFORMATION_HTTP'
    SSL:
      isSSL: false
      isTwoWaySSLAuthentication: false
      X.509.Format:
        isActive: true
        #search in path $SERVER_HOME$/server-resources/ssl/server
        serverX509CertificateWithRSAPublicKeyFileName: 'serverX509Certificate.crt'
        serverPKCS8EncodedWithRSAPrivateKeyFileName: 'serverPrivateKey.pk'
        #clientsX509CertificateWithRSAPublicKeyDirectoryPath: 'C:/server/server-resources/ssl/client'
ENTRY_POINTS:
  JLRMC: #JLupin Remote Method Call Fast Protocol
    isSilentErrorMessageMode: false
    isSilentStackTraceMode: false
    logPeriodicOnDebug: false
  ELASTIC_HTTP:
    isSilentErrorMessageMode: false
    isSilentStackTraceMode: false
    keepAliveOverNetProtocolTimeInMillis: 1000
    checkKeepAlive: false
    logPeriodicOnDebug: false
    defaultSequenceName: jacksonParamArrayJsonInOutSequence
    defaultApiId: ROA
    simpleCORSEnabled: true
  TRANSMISSION:
    isSilentErrorMessageMode: false
    isSilentStackTraceMode: false
    logPeriodicOnDebug: false
  INFORMATION:
    isSilentErrorMessageMode: false
    isSilentStackTraceMode: false
    logPeriodicOnDebug: false
  INFORMATION_HTTP:
    isSilentErrorMessageMode: false
    isSilentStackTraceMode: false
    logPeriodicOnDebug: false
    keepAliveOverNetProtocolTimeInMillis: 1000
    checkKeepAlive: false
  QUEUE:
    logPeriodicOnDebug: false
ENTRY_POINTS_SECURE_INFO:
  isServerNameEnable: false
INITIALIZING_LOGGER:
  #directoryPath: 'c:/server/alternative_path/logs'
  fileName: 'main_server_initialize'
  fileExtension: 'log'
  fileSizeInMB: 10
  maxFiles: 10
MICROSERVICES_LOCAL_PORT:
  offset: 20000
PROCESS_MANAGER:
  isCheckAvailableOSMemoryOnMicroservicesStart: true
  OS_PROCESSES_KEEPER:
    isCheckOSProcessAlive: true
    howOftenCheckingProcessInMillis: 5000
    #logPath: 'c:/server/alternative_path/process_errors'
  JVM_MEMORY_ERRORS_KEEPER:
    isCheckMemoryErrors: true
    howOftenCheckingProcessInMillis: 5000
    #heapDumpPath: c:/server/restart_log/heap_dump
    #logPath: 'c:/server/alternative_path/memory_errors'
    #archiveLogPath: 'c:/server/alternative_path/memory_errors_archive
    #restartLogPath: c:/server/restart_log/
TECHNICAL_PROCESS_MANAGER:
    isCheckOSProcessAlive: true
    howOftenCheckingProcessInMillis: 5000
    responseOSTimeToCheckProcessAliveInMillis: 2000
EVENT_LOG_MANAGER:
    howOftenCheckingExpireTimeInMillis: 20000
    logExpireTimeInMillis: 120000
    maximumSizeInMegabytes: 5
MONITORING_MANAGER:
    howOftenRefreshAllEnvironmentStateInMillis: 10000
    isJMXEnable: true
LOCK_MANAGER:
    isTurnedOn: true
MICROSERVICES_LOAD_BALANCER_SETTINGS:
  singleRequestRepeatsAmount: 3
  howOftenCheckingMicroservicesInMillis: 5000
  externalHealthCheckPeriod: 5000
  EXTERNAL_CONNECTIONS:
    connectionSocketTimeoutInMillis: 1000
    readTimeoutInMillis: 90000
    isKeepAlive: false
    isOOBInline: false
    isTcpNoDelay: false
    isReuseAddress: false
    sendBufferSize: 0
    receiveBufferSize: 0
    soLinger: 0
    trafficClass: 0
NODE_PEERS:
  NODE_1:
    ip: '127.0.0.1'
    jlrmcPort: 9090
    queuePort: 9095
    transmissionPort: 9096
    informationPort: 9097
  #NODE_2:
    #ip: '127.0.0.1'
    #jlrmcPort: 19090
    #queuePort: 19095
    #transmissionPort: 19096
    #informationPort: 19097