Friday, September 16, 2016

Oracle ILOM V3.0 CLI

Whenever installing, racking and cabling, a new Oracle server the first thing you most likely want to have access too is the ILOM. ILOM, or Oracle Integrated Lights Out Manager. The current version of ILOM shipping with Oracle servers is version 3.0.

In the words of Oracle ILOM is; "Oracle’s Integrated Lights Out Manager (ILOM) provides advanced service processor hardware and software that you can use to manage and monitor your Oracle Sun servers. Oracle ILOM’s dedicated hardware and software is preinstalled on a variety of Oracle Sun server platforms, including x86-based Sun Fire servers, Sun Blade modular chassis systems, Sun Blade server modules, as well as on SPARC-based servers. Oracle ILOM is a vital management tool in the data center and can be used to integrate with other data center management tools already installed on your systems.

Oracle ILOM is supported on many Oracle systems enabling users to experience a single, consistent, and standards-based service processor (SP) across all Oracle Sun server product lines."

Most users will never have access to the ILOM and there is not a reason for it, it is primarily used by the department that is responsible for the hardware and up to a certain level the people responsible for the operating system.

Cabling up:
The first thing you will need to do when a new server is landing in your datacenter is ensuring it is racked and cabled. You will need power, the second important thing is to ensure your ILOM cabling is connected, after that (right after that) the networking cabling for the “standard” network and other cabling will be required.

The above diagram shows the backplane of a Oracle X6-2 server. When talking about the ILOM functionality the most important cabling option is shown in 9 in the diagram. Below is a full list of all cabling options of the X6-2.


  1. Power Supply (PS) 0
  2. Power Supply (PS) 0 status indicators: Service Required LED: amber AC OK LED: green
  3. Power Supply (PS) 1
  4. Power Supply (PS) 1 status indicators: Service Required LED: amber AC OK LED: green
  5. System status indicators: Locator LED: white; Service Required LED: amber; Power/OK LED: green
  6. PCIe card slot 1 (Nonfunctional in single-processor systems)
  7. PCIe card slot 2
  8. PCIe card slots 3 and 4
  9. Oracle Integrated Lights Out Manager (ILOM) service processor (SP) network management (NET MGT) 10/100/1000BASE-T port
  10. Serial management (SER MGT)/RJ-45 serial port
  11. Network (NET) 100/1000/10000 port: NET 3 (Nonfunctional in single-processor systems)
  12. Network (NET) 100/1000/10000 port: NET 2 (Nonfunctional in single-processor systems)
  13. Network (NET) 100/1000/10000 port: NET 1
  14. Network (NET) 100/1000/10000 port: NET 0
  15. USB 2.0 connectors (2)
  16. DB-15 video connector


One thing is important to remember is that the initial address for the ILOM is based upon DHCP enabled. This can, if you have not ensured you have a solution for this, make it hard to initially find the IP address assigned to your new server.

Connecting to the ILOM:
As soon as you have the server powered on and cabled you would like to have access to the ILOM. In essence you can access the ILOM in two ways. You will have a GUI interface which can be accessed by using a browser, you can however also connect to it using SSH as your connection method.

The beauty of using SSH is that it is giving you a lot more freedom on what you can do, however, this is a preference thing. SSH authentication can be done based upon the traditional username/password way of working, however, also a key-based authentication method is available.

Getting to know the ILOM CLI:
When connecting to the ILOM you can use a SSH session and you will be logging in as the user root to ILOM. This means you can use a command like shown below

ssh root@ip-address

This will bring you directly to the CLI from the ILO where you can start using the ILOM functionality. The first what you will be exposed to is the CLI shown below:

Oracle(R) Integrated Lights Out Manager

Version 3.0.0.0 r54408

Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.

->

Oracle ILOM 3.0 will have a number of namespaces as shown below. For most activities and the most commonly used will be the /SP namespace, this is used on every Oracle server and is available on each machine.

/SP namespace
The targets and properties below this target type are used on a Sun server for configuring the Oracle ILOM service processor (SP) and for viewing logs and consoles.

/CMM namespace
On blade chassis platforms, this target type replaces /SP and is used for configuring the Oracle ILOM chassis monitoring module (CMM).

/SYS namespace
The targets and properties below this target type are used on a Sun server to monitor inventory status and environmental sensors, as well as to manage service components. The targets under this target type directly correspond to the names of the hardware components, some of which are printed on the physical hardware.

/CH namespace
On blade chassis platforms, this target type replaces /SYS and provides inventory status, environmental status, and hardware management at the chassis level. The target types directly correspond to nomenclature names for all hardware components, some of which are printed onto the physical hardware.

/HOST namespace
The targets and properties below this target type are used on a Sun server
to monitor and manage the host operating system.

After logging into the ILOM CLI the basic commands you can use are shown below. You can use this to navigate through the namespace, edit, create and delete objects in the namespace.

  • cd Navigates the object namespace.
  • create Sets up an object in the namespace.
  • delete Removes an object from the namespace.
  • exit Terminates a CLI session.
  • help Displays Help information for commands and targets.
  • load Transfers a file from an indicated source to an indicated target.
  • dump Transfers a file from a target to a remote location specified by the URI.
  • reset Resets the state of the target.
  • set Sets target properties to the specified value.
  • show Displays information about targets and properties.
  • start Starts the target.
  • stop Stops the target.
  • version Displays the version of service processor running

When navigating in a namespace in the ILOM it might be hard to find your way around, especially as you are not working on it on a daily basis. The below diagram can help you navigate the /SP namespace. Having this diagram as a reference can help your enormously.

ILOM CLI examples:
As stated, the ILOM CLI can be used to navigate the namespace, edit, change or delete objects. The set of commands provided to you will allow you to do virtually everything you would like to do on an ILOM. Below are some examples of how the CLI would work while interacting with the ILOM.
We will use the example on doing some work on the HTTP service of the ILOM. The HTTP service is located in the namespace in /SP/services/http

Getting the current settings can be done by executing the show command:
show /SP/services/http

Change HTTP settings, such as enabling automatic redirection to HTTPS:
set /SP/services/http port=portnumber secureredirect=[enabled|disabled] servicestate=[enabled|disabled]

Conclusion:
The above examples show how you can quickly change the state of an object while using the CLI. Understanding the ILOM CLI when operating a large number of systems will help you largely in debugging issues and getting to a lower (and more direct) interaction level with your servers. Even though the ILOM can be accessed using a GUI via http it is good practice to ensure you also have a good understanding on how the CLI would work.

No comments: