SIEM, Vulnerability Scanning, Server Monitoring and Compliance Training for IT Professionals
Table of Contents

Agent Configuration File Reference

The agent configuration file is located in the following locations:

  • Windows:
    C:\ProgramData\Corner Bowl\Server Manager Agent\tcpserver.json
  • Linux:
    /usr/share/corner-bowl/server-manager-agent/tcpserver.json

Configuration File Reference (tcpserver.json)

AttributeDescriptionRange of ValuesDefault Value
HostThe hostname the Corner Bowl Server Manager Service is running.Any network routable hostname or IP address. Values must be wrapped with quotes."0.0.0.0"
PortThe port the Corner Bowl Server Manager Service is running.1 - 6553521843
IdleTimeoutA Int32 that specifies the maximum number of seconds allowed to pass between command packets. Once exceeded, the remote connection is closed.1 - 65535300
ReceiveTimeoutAn Int32 that specifies the amount of time, in seconds, that will elapse before a read operation fails.1 - 65535120
SendTimeoutAn Int32 that specifies the amount of time, in seconds, that will elapse before a read operation fails.1 - 65535120
TempDirectoryA string that specifies the path to save temporary files. If the value is set to NULL, the default system temporary directory is used.The full path to save temporary files.NULL
KeepAliveIntervalAn Int32 that specifies the amount of time, in seconds, the keep-alive protocol sends heartbeats.1 - 6553510
TlsConfigurationEncapsulates the SSL/TLS 1.2 configuration properties.
EnabledA Boolean that specifies whether SSL/TLS 1.2 is enabled.true or falsefalse
CertificateA string that specifies the name of the X509Certificate used to authenticate.

On Windows, the Thumbprint is suggested, however, you can also specify the Serial Number, Subject Distinguished Name or Subject Name.

On Linux, the value must be the network routable hostname.

If specified, the value must be wrapped in quotes otherwise specify null without quotes.

null
AllowSelfSignedCertificateA Boolean value that specifies whether self-signed certificates are supported.true or falsetrue
CheckCertificateRevocationA Boolean value that specifies whether the certificate revocation list is checked during authentication.true or falsefalse
AllowCertificateChainErrorsA Boolean value that specifies whether the certificate chain is checked during authentication.true or falsetrue
InstanceNameThe connection instance name. This value is used in verbose logging messages when connecting to multiple Management Server instnaces.Any string. Values must be wrapped with quotes.NULL
InstancesLists multiple Management Server's to connect.An array of Server Configuration objects.NULL

Sample File Contents (tcpserver.json)

{
  "Host": "localhost", 
  "Port": 21843, 
  "IdleTimeout": 300, 
  "ReceiveTimeout": 120, 
  "SendTimeout": 120, 
  "TempDirectory": "d:\temp", 
  "KeepAliveInterval": 30,  
  "TlsConfiguration": {
    "Enabled": false, 
    "Certificate": null, 
    "RequireRemoteCertificate": false, 
    "AllowSelfSignedCertificate": false, 
    "CheckCertificateRevocation": false, 
    "AllowCertificateChainErrors": false 
  }, 
  "Instances": [
    {
      "InstanceName": "Monitor Server (Port 80)", 
      "Host": "MonitorServer", 
      "Port": 80, 
      "IdleTimeout": 300, 
      "ReceiveTimeout": 120, 
      "SendTimeout": 120, 
      "TempDirectory": null, 
      "TlsConfiguration": {
        "Enabled": false, 
        "Certificate": null, 
        "RequireRemoteCertificate": false, 
        "AllowSelfSignedCertificate": true, 
        "CheckCertificateRevocation": false, 
        "AllowCertificateChainErrors": true 
      }
    }, 
    {
      "InstanceName": "Compliance Server (Encrypted TLS 1.2 Port 443)", 
      "Host": "ComplianceServer", 
      "Port": 443, 
      "IdleTimeout": 300, 
      "ReceiveTimeout": 120, 
      "SendTimeout": 120, 
      "TempDirectory": null, 
      "TlsConfiguration": {
        "Enabled": true, 
        "Certificate": null, 
        "RequireRemoteCertificate": false, 
        "AllowSelfSignedCertificate": true, 
        "CheckCertificateRevocation": false, 
        "AllowCertificateChainErrors": true 
      }
    }
  ]
}

Troubleshooting

If the Agent does not appear to be connecting or processing templates as expected, you can view the agent's verbose output log for detailed information. The agent's log file is located in the following locations:

  • Windows:
    C:\ProgramData\Corner Bowl\Server Manager Agent\agent.log
  • Linux:
    /var/log/corner-bowl/agent.log

Related Topics

Server Configuration

Windows Agent Installation

Linux Agent Installation

New-SelfSignedCertificate