45.2. SYSLOG configuration

45.2. SYSLOG configuration
	Chapter 45. SYSLOG - The syslog protocol

Add the resource to the Abilis system with the following command:

[11:09:16] ABILIS_CPX:a res:syslog

RES:SYSLOG ALREADY EXISTS

The SYSLOG resource may already exist in the system, but may not yet be active: set it active with the command:

[11:09:21] ABILIS_CPX:s act res:syslog

COMMAND EXECUTED

Use the following command to display the parameters of the resource:

[10:54:52] ABILIS_CPX:d p syslog

RES:SysLog --------------------------------------------------------------------
Run    DESCR:System_Log_protocol
       LOG:NO        ACT:YES      queue-size:64    udp-locport:514    RELAY:NO
       LOCAL-SEVERITY:ALL
       LOCAL-SOURCES:SYS
       SRCADD:R-ID (192.168.000.201)               TOS:0-N
       HOSTNAME:
       HOSTNAME-IP:R-ID (192.168.000.201)
       IPSRC:*                    IPSRCLIST:#
       RECEIVER1:#                RECEIVER2:#                
       RECEIVER3:#                RECEIVER4:#

	Warning
	After adding or setting the SYSLOG active, you must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis).

Below are descriptions of the most important parameters:

LOG

State changes log and alarm generation [NO, D (=Debug Log), S (=System Log), A (=Alarm view), L (=Local audible alarm), T (=SNMP traps), ALL] [+E (=Extended Log of state changes)].

ACT

Operation activation [NO, YES].

queue-size

Maximum pending SYSLOG requests [10..512 Kibyte].

udp-locport

Local UDP port on which the SYSLOG relay will receive requests [514]. Read Only.

RELAY

Activation/deactivation of SYSLOG relay [NO, YES].

TOS

enables Type Of Service (TOS) or Differentiated Services Field (DS) [-' p-t', i.e. PRECEDENCE and TOS values, where 'p' can be [0...7] and 't' can be [N (=None), D (=Min. Delay), T (=Max. Throughput), R (=Max. Reliability), C (=Min. Monetary Cost)] - 'bbbbbb', i.e. DS value bit by bit, where 'b' can be [0, 1]].

LOCAL-SEVERITY

Allowed message severities [EMERGENCY, ALERT, CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG, ALL]. Values can be joined using ',' character.

LOCAL-SOURCES

Allowed message sources [#, L, LDM, NPV, CP, IPRES, ETHMOD, IPSEC, SIPREG, SIPCALL, ALL], where:

# - no message source is allowed.
L - System log.
LDM - Debug log.
NPV - Npv log.
CP - CP commands log.
IPRES - IpRes log.
ETHMOD - EthMod log.
IPSEC - IpSec/Ike log.
SIPREG - Sip Registry log.
SIPCALL - Sip calls statistics.
ALL - all message sources.

Values can be joined using ',' (comma).

IPSRC

Incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

IPSRCLIST

Incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname].

SRCADD

Source IP address for outgoing messages [R-ID: the source IP address of the outgoing datagrams will be set to the current RouterID value; OUT-IP: the source IP address of the outgoing datagrams will be set on the base of the output IP interface; 1-126.x.x.x, 128-223.x.x.x: the source IP address of the outgoing datagrams will be set to the selected value; Ip-nnn: use the current IPADD of the specified IP resource].

HOSTNAME

Value of HOSTNAME part of outgoing SYSLOG messages. Max 32 chars in [0-9, A-Z, a-z, '-', '_'].

HOSTNAME-IP

IP form of HOSTNAME part of outgoing SYSLOG messages. [R-ID: HOSTNAME will be set to the IP address of the current RouterID value; OUT-IP: HOSTNAME will be set to the IP address of output IP interface; 1-126.x.x.x, 128-223.x.x.x: HOSTNAME will be set to the selected IP address.

RECEIVERx

IP address of SYSLOG receiver #x (collector or next relay) to forward SYSLOG messages [#, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

The following command allows the administrator to change the configuration of the resource:

s p syslog name:value...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:syslog; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).


45.1. SYSLOG resource		45.3. SYSLOG diagnostics and statistics