Configure the network settings on the LOM port
The default IP address for initial access to the LOM port is 192.168.1.3. Change the default credentials and IP address the first time you log on. All LOM GUI operations require you to connect to the appliance by typing the LOM IP address in a web browser and then entering the administrator credentials. Alternatively, you can access LOM functionality through the command line by using the
ipmitool utility. Using the
ipmitool utility remotely, you can:
- Determine the LOM firmware version number.
- Perform warm and cold restarts.
- Configure LOM network settings.
- Monitor the health of the appliance.
- Perform power control operations.
The utility is available for download at http://ipmitool.sourceforge.net/. The
ipmitool utility is also included in Citrix ADC MPX and CloudBridge/SDX (dom0) appliances for initial LOM port network configuration. When using the shell, you can choose to use DHCP or static IP settings for initial network configuration. After configuring the network settings, you can use the
ipmitool commands over the network. For example, the BMC firmware revision command would need the same user name, password, and IP address that is used to access the BMC/LOM GUI port.
For initial configuration, connect the network port on your laptop or workstation directly to the LOM port with a crossover cable. Or connect to a switch in the same local subnet(192.168.1.x) as the LOM port. Assign a network-reachable IP address and change the default credentials. After saving the new settings, the LOM restarts and the changes take effect. After the restart, you must use the new address to access to the LOM.
If you make a mistake that results in losing network connectivity at both the old and new IP addresses, you must use the local shell method to recover.
See the Secure Deployment Guide for best practices for managing administrative credentials and configuring your network for a secure LOM deployment.
Note: On all MPX platforms, except MPX 22040/22060/22080/22100/22120 and MPX 24100/24150, the LEDs on the LOM port are nonoperational by design.
Tip: For first-time setup in a network, to facilitate troubleshooting, make sure that a laptop/PC is connected directly to the LOM port. Do the following if you can ping and access the LOM GUI at the default IP address (192.168.1.3) by using static addressing on the laptop/PC, but remote access does not work.
- Take a closer look at network firewall settings and access control list (ACL) policies of all network devices along the network path.
Tip: If some LOM GUI features work but others do not (for example, normal ADC console output is visible in the ADC console window in the LOM GUI, but typing in the console does not work), try the preceding method to isolate the cause to the specific BMC protocol being blocked by the network.
Tip: Use the iKVM (HTML5) feature to access the LOM GUI. Alternately, use Java. Ensure that the latest Java updates are installed on your computer.
Configure the Citrix ADC LOM port by using the GUI
- In a web browser, type http://192.168.1.3 and enter the default user credentials. Note: The Citrix ADC LOM port is preconfigured with IP address 192.168.1.3 and subnet mask 255.255.255.0.
- On the Configuration tab, click Network and type new values for the following parameters:
- IP Address—IP address of the LOM port
- Subnet Mask—Subnet mask used to define the subnet of the LOM port
- Default Gateway—IP address of the router that connects the LOM port to the network
- Click Save.
- If you want to change the user credentials, navigate to Configuration > Users, select the user, click Modify User, and change the credentials.
Configure the Citrix ADC LOM port by using the shell
Note: You need superuser (admin) credentials to access the shell.
Configure the IP addressing mode:
To use DHCP, at the shell prompt, type:
ipmitool lan set 1 ipsrc dhcp
No further IP-level configuration is required.
To use static addressing, at the shell prompt type:
ipmitool lan set 1 ipsrc static
ipmitool lan set 1 ipaddr <LOM IP address>
ipmitool lan set 1 netmask <netmask IP address>
ipmitool lan set 1 defgw ipaddr <default gateway IP address>
The BMC reboots to apply the changes. Pings to the BMC succeed after approximately 60 seconds.
Optionally, to configure Ethernet VLAN ID and priority, at the Citrix ADC shell prompt type:
ipmitool lan set 1 vlan id <off|<ID>>
ipmitool lan set 1 vlan priority <priority>
You can either disable or enable the VLAN. Set the VLAN ID to a value from 1 to 4094, and the VLAN priority to a value from 0 to 7. After the network settings have been correctly applied, you can access the
ipmitoolremotely from a physically separate machine over the network. For remote access, enter the BMC user name, BMC password, and the BMC IP address. For example, to run the
ipmitool mc infocommand, at the shell prompt on a remote machine, type:
ipmitool –U <username> –P <password> –H <bmc IP address> mc info
Obtain health monitoring information
There are two ADC MIBs: the Citrix ADC software management MIB and the ADC IPMI LOM hardware management MIB. The software management MIB is primarily used for monitoring the application software and the application software’s utilization of hardware resources, such as CPU % and memory %. It provides a high level view of the appliance and is therefore suitable for the application monitoring function carried out by an application group within an organization. The LOM MIB is used for monitoring the hardware health and therefore provides a lower level view of the appliance. It is more applicable to the network monitoring function carried out by a network monitoring group.
The LOM SNMP traps in the LOM MIB report hardware failures. The ADC SNMP traps in the ADC MIB report software failures and hardware load issues.
The ADC MIB has a small subset of hardware sensors. It does not cover any BIOS level failures, because the BIOS checks the hardware primarily during boot time, before the Citrix ADC software starts. If the BIOS detects a failure, it does not load the boot loader. If the boot loader does not load, the operating system does not load, and therefore the ADC SNMP software service responsible for sending the traps does not load.
The Citrix ADC software Management MIB issues a warning under the following conditions only:
- If the failure is gradual enough for the main CPU to issue an SNMP alert. An electrical failure close to the CPU, such as a failed electrical capacitor, occurs too quickly for the CPU to issue an alert.
- If the failure happens after the BIOS, Operating System, and SNMP service have started and normal boot-up has been successful.
- If the failure happens while the operating system and other system software are in a stable enough state for the SNMP software service to run.
Whenever the ADC MIB is unable to report these warnings, because of hardware or software failure, the LOM MIB monitors and reports the warnings. The LOM microcontroller operates independently of the Citrix ADC software. To monitor the hardware and software of the Citrix ADC appliance, you must use both the ADC MIB and the LOM MIB.
The ADC IPMI LOM hardware management MIB SNMP firmware runs on the BMC microcontroller chip. The BMC chip CPU sends a warning in the case of a hardware failure, regardless of whether any of the preceding conditions occur. For example, if the BIOS halts the system during boot-up because of a memory DIMM failure, the BMC chip uses the BIOS POST code snooping mechanism to detect the failure. And then sends a bad DIMM SNMP alert.
You can log on to the LOM port to view the health information about the appliance. All system sensor information, such as system temperature, CPU temperature, and status of fans and power supplies, appears on the sensor readings page. The Event Log records time stamps of routine events such as a power cycle, in addition to recording hardware-failure events. If SNMP traps are enabled, these events can be sent to your SNMP Network Monitoring software. For more information about how to set up an SNMP alert, see Configuring SNMP Alerts.
- In the Menu bar, click System Health.
- Under Options, click Sensor Readings.
Install the MIB
Download the IPMI SNMP management information base (MIB) for your LOM firmware version, and import it into the SNMP monitoring software.
For a sample configuration, see http://www.net-snmp.org/tutorial/tutorial-5/commands/snmptrap.html. For the exact steps of this procedure specific to your environment, contact your SNMP network monitoring software provider.
Configure SNMP alerts
You can configure SNMP alerts on the LOM. Optionally, you can configure an alert to send emails.
To configure the alerts, you can use the LOM GUI or the Citrix ADC shell.
Configure SNMP alerts on the LOM by using the GUI
- Download the IPMI View utility from ftp://ftp.supermicro.com/utility/IPMIView/ and install it on your computer. Use this utility to test the configuration. For more information, see the section about configuring the alert settings in the IPMI View User Guide at http://supermicro.com.
- Open the IPMI View utility.
- In the LOM GUI, navigate to Configuration > Alerts, click Alert No 1, and then click Modify.
- Select the severity level of the events for which to generate alerts.
- Set Destination IP to the IP address at which you installed the IPMI View utility.
- Optionally, to receive alerts by email, specify an email address. To avoid receiving email for routine alerts, specify a severity higher than Informational.
- Click Save.
- The LOM starts sending alerts to the IPMI View utility within in a minute or two. After the IPMI View utility starts receiving alerts from the LOM, reconfigure the destination IP address to point to your SNMP Network Management Software, such as HP OpenView.
Set up SNMP alerts on the LOM by using the Citrix ADC shell
To customize your filter and policy settings, see the IPMI Specification 2.0 rev. 1.1 documentation.
The latest IPMI specifications are available from the IPMI section of the Intel website:
Usually, customization in the SNMP Network Management Software is the preferred method, because it can be done one time at a central location. Therefore, the following settings send all events for all sensors to the SNMP network management software. These events are low traffic events and therefore do not result in any significant network usage.
Set up SNMP filters
The following commands set up SNMP to allow all events:
ipmitool raw 4 0x12 0x6 0x10 0x80 1 1 0 0xff 0xff 0xff 0xff 0xff 0xff 0xff 0 0xff 0 0 0xff 0 0 0xff 0
Set up a policy list
The following command creates a policy list for all sensors and events:
ipmitool raw 4 0x12 9 0x10 0x18 0x11 0x81
Set up the destination address for SNMP events
The following command sets up a destination IP address for an SNMP event:
ipmitool lan alert set 1 1 ipaddr <x.x.x.x>
Where, <x.x.x.x> is the IP address to which the SNMP event is sent.
Specify an SNMP community string name
At the prompt, type:
ipmitool lan set 1 snmp <community string>