System Log Files

Boot.msg File: Contains information, including the current version, during the initial starting of the Multi-Tenant LoadMaster.

Warning Message File: Contains warnings logged during the operation of the Multi-Tenant LoadMaster.

System Message File: Contains system events logged during the operation of Multi-Tenant LoadMaster. This includes both operating system-level and Multi-Tenant LoadMaster internal events.

Reset Logs: This will reset all log files.

Save all System Log Files: This saves the files to your computer. It can be useful to send log files to Progress Kemp support when troubleshooting an issue.

Debug Options

The Multi-Tenant LoadMaster has a range of features that will help you and Progress Kemp Support staff with diagnosing connectivity issues. Clicking the Debug Options button will bring up the screen shown below.

Enable IRQ Balance: Enable this option only after consulting with Progress Kemp support staff.

Disable/Enable IRQ Pinning: Enable or disable Interrupt Request (IRQ) pinning. This is enabled by default on LoadMaster VNFs.

Note: When the IRQ pinning option is enabled, it is active on all network interfaces that are assigned an IP address. When IRQ pinning is enabled and you add an IP address to an unconfigured interface, that interface will not have IRQ pinning enabled until you either toggle the IRQ pinning off and back on again, or the system is rebooted.

Perform a PS: Performs a ps on the system.

Display Meminfo: Displays raw memory statistics.

Display RAID Information

Note: The Display RAID Information and Display RAID Disks Information buttons only appear if a RAID controller is installed on the Multi-Tenant LoadMaster host.

Display the Redundant Array of Independent Disks (RAID) controller details. Some example information is below:

-------------------------------------------------------------------
Controller details
-------------------------------------------------------------------
- Chip ID................: 10
- Parent Controller Index: 255
- OS Physical Name.......: /dev/sda
- Serial Number..........: 427491329
- AES Power on State.....: 0
- Sata Ports.............: 2
-------------------------------------------------------------------
Raid Port 0 details
-------------------------------------------------------------------
- Raid Model Name..............: H/W RAID1
- Raid Serial Number...........: OUEYEXCXTQ53GE1BSOSN
- EZBackup Disk Support........: 0
- Port Multiplier port.........: 0
- Raid Capacity................: 953 (29 GB)
- Raid Capacity low word.......: 0
- Raid State...................: 1 (Active)
- Raid Status..................: 3 (Normal)
- Raid Level...................: 1 (Raid 1 (mirror))
- Mark Type....................: 0
- Active Member................: 15
- Active Level.................: 0
- Rebuild Priority.............: 3
- Standby Timer................: 0
- Total members in the RAID....: 2
Member disk 0
- Ready....................: 1
- Lba 48 Bit Support.......: 1
- SATA Page................: 0
- SATA Port................: 0
- SATA Base................: 0
- SATA Size................: 953
----------------------------------------------------------
Member disk 1
- Ready....................: 1
- Lba 48 Bit Support.......: 1
- SATA Page................: 0
- SATA Port................: 1
- SATA Base................: 0
- SATA Size................: 953
----------------------------------------------------------

Display RAID Disks Information

Display details about the RAID disks. Some example information is below:

-------------------------------------------------------------------
Sata Port 0 details
-------------------------------------------------------------------
- Disk Model Name..............: 32GB SATA Flash Drive
- Disk Serial Number...........: C0122916B01000000074
- Disk Firmware Version........: SFDC001D
- EZBackup Disk Support........: 1
- Port Multiplier port.........: 15
- Disk Capacity................: 954 (29 GB)
- Port Type....................: 2 (RAID)
- Port Speed...................: 2 (GB)
- Page 0 State.................: 2
- Page 0 Raid Index............: 0
- Page 0 Member Index..........: 0
- Page 0 Raid Name.............:
- Page 0 Raid Serial Number....:
- Page 0 Raid Segment Base.....: 0
- Page 0 Raid Size.............: 953
- Page 0 Raid EZ Backup Support: 0
- Page 1 State.................: 0
- Page 1 Raid Index............: 0
- Page 1 MemberIndex...........: 0
- Page 1 Raid Name.............:
- Page 1 Raid Serial Number....:
- Page 1 Raid Segment Base.....: 0
- Page 1 Raid Size.............: 0
- Page 1 Raid EZ Backup Support: 0
- PortErrorStatus..............: 0
-------------------------------------------------------------------
Sata Port 1 details
-------------------------------------------------------------------
- Disk Model Name..............: 32GB SATA Flash Drive
- Disk Serial Number...........: E011321290100000005A
- Disk Firmware Version........: SFDC001D
- EZBackup Disk Support........: 1
- Port Multiplier port.........: 15
- Disk Capacity................: 954 (29 GB)
- Port Type....................: 2 (RAID)
- Port Speed...................: 2 (GB)
- Page 0 State.................: 2
- Page 0 Raid Index............: 0
- Page 0 Member Index..........: 1
- Page 0 Raid Name.............:
- Page 0 Raid Serial Number....:
- Page 0 Raid Segment Base.....: 0
- Page 0 Raid Size.............: 953
- Page 0 Raid EZ Backup Support: 0
- Page 1 State.................: 0
- Page 1 Raid Index............: 0
- Page 1 MemberIndex...........: 0
- Page 1 Raid Name.............:
- Page 1 Raid Serial Number....:
- Page 1 Raid Segment Base.....: 0
- Page 1 Raid Size.............: 0
- Page 1 Raid EZ Backup Support: 0
- PortErrorStatus..............: 0

Display Slabinfo: Displays raw slab statistics.

Perform an Ifconfig: Displays raw Ifconfig output.

Perform a Netstat: Displays Netstat output.

Reset Statistic Counters: Reset all statistic counters.

Ovs Logging Level: Specify the level of Open vSwitch logs to record. The default setting for this field is error.

Netconsole Host: The syslog daemon on the specified host will receive all critical kernel messages. The syslog server must be on the local LAN and the messages sent are UDP messages.

You can select which interface the Netconsole Host is set to using the Interface dropdown.

Note: Please ensure that the netconsole host specified is on the selected interface as errors may occur if it is not.

Ping Host: Performs a ping on the specified host. The interface which the ping should be sent from can be specified in the Interface drop-down list. The Automatic option selects the correct interface to ping an address on a particular network.

Traceroute Host: Perform a traceroute of a specific host.

Kill MT Console (): Permanently disables all Multi-Tenant LoadMaster functions. The Multi-Tenant LoadMaster can be re-enabled by being relicensed.

Note: Please do not kill your Multi-Tenant LoadMaster without consulting Progress Kemp Technical Support first.

TCP dump

A TCP dump can be captured either by one or all Ethernet ports. You can specify the address and port parameters in the WUI. To specify additional, optional parameters - use the Application Programming Interface (API) to perform a TCP dump.

You can stop and start the dump. You can also download it to a particular location.

For detailed information related to TCP dump, refer to the Packet Trace Guide Technical Note.

Syslog Options

The Multi-Tenant LoadMaster can produce various warning and error messages using the syslog protocol. These messages are normally stored locally.

It is also possible to configure the Multi-Tenant LoadMaster to transmit these error messages to a remote syslog server by entering the relevant IP address in the relevant text box and clicking Change Syslog Parameters.

Six different error message levels are defined and each message level may be sent to a different server. Notice messages are sent for information only; emergency messages normally require immediate user action.

Examples of the type of message that may be seen after setting up a Syslog server are below:

  • Emergency: Kernel-critical error messages
  • Critical: Unit has failed
  • Error: Authentication failure for root from 192.168.1.1
  • Warn: Interface is up/down
  • Notice: Time has been synced
  • Info: Local advertised Ethernet address
Note: One point to note about syslog messages is they are cascading in an upwards direction. Thus, if a host is set to receive WARN messages, the message file will include message from all levels above WARN but none for levels below WARN.

We recommend you do not set all six levels for the same host because multiple messages for the same error will be sent to the same host.

To enable a syslog process on a remote Linux server to receive syslog messages from the Multi-Tenant LoadMaster, the syslog must be started with the “-r” flag.

SNMP Options

With this menu, the SNMP configuration can be modified.

Enable SNMP

This check box enables or disables SNMP metrics. For example, this option allows the Multi-Tenant LoadMaster to respond to SNMP requests.

By default SNMP is disabled.

When the feature is enabled, the following traps are generated:

  • ColdStart: generic (start/stop of SNMP sub-system)
  • VsStateChange: (Virtual Service state change)
  • RsStateChange: (Real Server state change)

The information regarding all Multi-Tenant LoadMaster-specific data objects is stored in three enterprise-specific MIBs (Management Information Base).

ONE4NET-MIB.txt

enterprise id

IPVS-MIB.txt

Virtual Server stats

B-100-MIB.txt

Multi-Tenant LoadMaster configuration data

These MIBs (which can be found on the Progress Kemp website) need to be installed on the SNMP manager machine in order to be able to request the performance-/config-data of the Multi-Tenant LoadMaster using SNMP.

The description of the counters can be taken from the Multi-Tenant LoadMaster MIBs (the description clause). Apart from just reading the MIB this can be done for Linux (nad ucdsnmp) with the command:

snmptranslate -Td -OS <oid>

where <oid> is the object identifier in question.

Example: <oid> = .1.3.6.1.4.1.one4net.ipvs.ipvsRSTable.rsEntry.RSConns

snmptranslate -Td –Ov .1.3.6.1.4.1.one4net.ipvs.ipvsRSTable.rsEntry.RSConns.1.3.6.1.4.1.12196.12.2.1.12

RSConns OBJECT-TYPE

-- FROM IPVS-MIB

SYNTAXCounter32

MAX-ACCESSead-only

STATUScurrent

DESCRIPTION"the total number of connections for this RS"

::= { iso(1) org(3) dod(6) internet(1) private(4) enterprises(1) one4net(12196) ipvs(12) ipvsRSTable(2) rsEntry(1) 12 }

The data object defined in the Multi-Tenant LoadMaster MIBS is a superset to the counters displayed by the WUI.

Note: The data objects on the Multi-Tenant LoadMaster are not writable, so only GET requests (GET, GET-NEXT, GET-BULK, and so on) should be used.

Enable SNMP V3

This check box enables SNMP v3 metrics. SNMPv3 primarily added security and remote configuration enhancements to SNMP.

When this option is enabled, two additional fields become available - Username and Password.

Note: The Username and Password must be set in order for SNMP v3 to work.
Note: The password must be at least 8 characters long.

Authentication protocol

Select the relevant Authentication protocol - MD5 or SHA. SHA is a more secure protocol.

Privacy protocol

Select the relevant Privacy protocol - AES or DES. AES is a more secure protocol.

SNMP Clients

With this option, the user can specify from which SNMP management hosts the Multi-Tenant LoadMaster will respond to.

Note: If no client has been specified, the Multi-Tenant LoadMaster will respond to SNMP management requests from any host.

SNMP Community String

This option allows the SNMP community string to be changed. The default value is “public”.

Allowed characters in the Community String are as follows: a-z, A-Z, 0-9, _.-@()?#%^+~!.

SNMP Contact

This option allows the SNMP Contact string to be changed. For example, this could be e-mail address of the administrator of the Multi-Tenant LoadMaster.

SNMP Location

This option allows the SNMP location string to be changed.

SNMP traps

When an important event happens to a Multi-Tenant LoadMaster, a Virtual Service or a Real Server, a trap is generated. These are sent to the SNMP trap sinks.

Enable/Disable SNMP Traps

This toggle option enables and disables the sending of SNMP traps.

Note: SNMP traps are disabled by default.

Send SNMP traps from the shared address

Note: This check box is only visible when the LoadMaster is in HA mode.

By default, SNMP traps are sent using the IP address of the master HA unit as the source IP address. Enabling this option will send SNMP traps from the master HA unit using the shared IP address.

SNMP Trap Sink1

This option allows the user to specify a list of hosts to which a SNMPv1 trap will be sent when a trap is generated.

SNMP Trap Sink2

This option allows the user to specify a list of hosts to which a SNMPv2 trap will be sent when a trap is generated.

Email Options

This screen permits the configuration of email alerting for Multi-Tenant LoadMaster events. Email notification can be delivered for six predefined informational levels. Each level can have a distinct email address and each level supports multiple email recipients. Email alerting depends on a mail server, support for both an open relay mail server and a secure mail server is provided.

SMTP Server

Enter the FQDN or IP address of the mail server. If you are using FQDN please make sure to set the DNS Server.

Port

Specify the port of the SMTP server which will handle the email events.

Server Authorization (Username)

Enter the username if your mail server requires authorization for mail delivery. This is not required if you mail server does not require authorization.

Authorization Password

Enter the password if your mail server requires authorization for mail delivery. This is not a required if you mail server does not require authorization.

Local Domain

Enter the top-level domain, if your mail server is part of a domain. This is not a required parameter.

Connection Security

Select the type of security for the connection;

  • None
  • STARTTLS, if available
  • STARTTLS
  • SSL/TLS

Set Email Recipient

In the various Recipients text boxes, enter the email address that corresponds with the level of notification desired. Multiple email addresses are supported by a comma-separated list, such as:

Info Recipients: info@progress.com, sales@progress.com

Error Recipients: support@progress.com

Clicking the Send Test Email to All Recipients button sends a test email to all the listed email recipients.