Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Linux DHCP Server

The Linux DHCP Server DSM for JSA collects DHCP events by using syslog.

To integrate Linux DHCP Server with JSA, complete the following steps:

  1. If automatic updates are not enabled, download the most recent versions of the RPMs from the Juniper Downloads

    • DSM Common RPM

    • GNU Linux DHCP DSM RPM

    • Protocol Common RPM

  2. Configure your Linux DHCP server to send syslog events to JSA.

  3. If JSA does not automatically detect the log source, add a Linux DHCP Server logsource log source on the JSA Console. For more information about configuring your Linux DHCP Server, consult the Linux man pages or associated documentation for your DHCP daemon.

Linux DHCP Server DSM specifications

When you configure Linux DHCP Server, understanding the specifications for the Linux DHCP Server DSM can help ensure a successful integration. For example, knowing what the supported version of Linux DHCP Server is before you begin can help reduce frustration during the configuration process.

The following table describes the specifications for the Linux DHCP Server DSM.

Table 1: Linux DHCP DSM Specifications

Specification

Value

Manufacturer

Linux

DSM name

Linux DHCP Server

RPM file name

DSM-GNULinuxDHCP-JSA_versionbuild_number.noarch.rpm

Supported version

Linux DHCP Server 2.4

Protocol

Syslog

Recorded event types

All events from a DHCP server

Automatically discovered?

Yes

Includes identity?

No

Includes custom properties?

No

More information

DHCP documentation

Syslog Log Source Parameters for Linux DHCP

If JSA does not automatically detect the log source, add a Linux DHCP log source on the JSA Console by using the Syslog protocol.

When using the syslog protocol, there are specific parameters that you must use.

The following table describes the parameters that require specific values to collect Syslog events from Linux DHCP:

Table 2: Syslog Log Source Parameters for the Linux DHCP DSM

Parameter

Value

Log Source type

Linux DHCP Server

Protocol Configuration

Syslog

Log Source Identifier

Type the IP address or host name for the log source as an identifier for events from your Linux DHCP Server.

Linux DHCP Sample Event Message

Use this sample event message to verify a successful integration with JSA.

Note:

Due to formatting issues, paste the message format into a text editor and then remove any carriage return or line feed characters.

Linux DHCP Sample Message When You Use the Syslog Protocol

The following sample event message shows the client determined that the offered configuration parameters are invalid and the client must begin the lease process again.

Table 3: JSA Field Names and Highlighted Values in the Event Payload

JSA field name

Highlighted values in the event payload

Event ID

DHCPDECLINE

Source IP

192.0.2.0

Source MAC

00-00-5E-00-53-00

Device Time

Sep 25 15:23:34