snIPL (simple network IPL) V.2.1.7

Back to snIPL Overview

2010-03-12 snIPL V.2.1.7 (Development stream)

This snIPL V.2.1.7 contains bugfixes and replaces all previous snIPL versions.

If you download any software from this web site please be aware of the Warranty Disclaimer and Limitation of Liabilities.

snipl-0.2.1.7.tar.gz MD5 recommended (2010-03-12)

This version supersedes all previous snIPL versions.

This version contains the following snIPL changes compared to snIPL V.2.1.6:

  • snipl --deactivate for LPAR: tolerate events other than 'command completion'
    On z10 the HMC/SE responds to a 'snipl --deactivate' with an unexpected disabled wait event and an expected command completion event. The unexpected disabled wait event causes a protocol error result for 'snipl --deactivate'. snipl is changed to tolerate this disabled wait event and return successfully.
    Note that with the November 2009 z10 MCL, the disabled wait event no longer occurs.

Note: Since snIPL version 2.1.3 only stonith version 2 is supported, while older snIPL versions support stonith version 1 only.

snIPL - simple network IPL (Linux Image Control for LPAR / VM) is a command line tool which serves as remote linux image control using basic Support Element (SE) functions or basic z/VM system management functions (available from z/VM 4.4 until z/VM 5.4) on one or more images.

Note: The z/VM System Management Application Programming Interfaces (APIs) used for snIPL for VM are no longer available with z/VM Version 6.

  • snIPL for LPAR utilizes the management application programming interfaces (APIs) provided by the HMC/SE. To communicate with the HMC/SE, snIPL establishes a network connection and uses the SNMP protocol to send and retrieve data. The HMC/SE has to be configured to allow the initiating host system to access the API. If your network is firewall-controlled, udp-port 161 and tcp-port 3161 have to be opened between snIPL-invoking Linux system and HMC/SE. In this mode snIPL can be used to boot Linux on System z in LPAR mode, to send and retrieve operating system messages, or to reset, activate or deactivate an LPAR for I/O fencing purposes.

    To compile and run snIPL for LPAR, it must be linked to the management library hwmcaapi (which can be downloaded from IBM Resource Link http://www.ibm.com/servers/resourcelink/). For further details please refer to System z Application Programming Interfaces (SB10-7030).

  • snIPL for VM serves as remote control of basic z/VM system management functions. It can be used to reset, activate or deactivate a Linux/VM image for I/O fencing purposes. In this mode snIPL utilizes the System Management Application Programming Interfaces (APIs) available from z/VM 4.4 until z/VM 5.4. To communicate with the z/VM host, snIPL for VM establishes a network connection and uses the RPC protocol to send and retrieve data. To compile and run snIPL for VM, the RPC protocol specification DMSVSMA.X has to be copied to the Linux system running snIPL (usually into /usr/share/dmsvsma/).

    Note: The z/VM System Management Application Programming Interfaces (APIs) used for snIPL for VM are no longer available with z/VM Version 6.

    For further details please refer to z/VM V5R4.0 Systems Management Application Programming (SC24-6122) (or equivalent documentation from the z/VM website: http://www.vm.ibm.com).

  • snIPL for STONITH (Linux Image Control - Virtual Power Switch) is an external stonith plugin.
    STONITH (Shoot The Other Node In The Head) provides an extensible interface for remotely powering down a node in a cluster. It is part of the Heartbeat framework of the High Availability Project (http://linux-ha.org).
    http://linux-ha.org/STONITH gives a general description of the STONITH technique. The latest STONITH release can be downloaded from http://linux-ha.org/download.

    snIPL for Stonith supports the remote image operations activate, deactivate, and reset, exploiting basic System z Hardware Management Console (HMC) and Support Element (SE) functions for Linux running in an LPAR and of basic z/VM System Management Functions for Linux running under control of z/VM.

Further requirement (in addition to the snIPL command line tool):

  • To compile and make use of the STONITH plugin lic_vps, package heartbeat has to be downloaded from http://linux-ha.org/download and installed.

Please refer to the README and manpage of snIPL enclosed in the tarball for further information and restrictions.