HMC Manual Reference Pages - LPAR_NETBOOT (1)

NAME

lpar_netboot - retrieve MAC address and physical location code from network adapters for a partition or instruct a partition to network boot

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

To retrieve MAC address and physical location code:
lpar_netboot -M -n [-v] [-x] [-f] [-i] [-E environment [-E ...]]
[-A] -t ent [-T {on|off}] [-D -s speed -d duplex
-S server -G gateway -C client [-K subnetmask]
[-V vlan_tag] [-Y vlan_priority]]
partition-name partition-profile managed-system
To perform network boot:
lpar_netboot [-v] [-x] [-f] [-i] [-E environment [-E ...]]
[-g args] [{-A -D | [-D] -l physical-location-code |
[-D] -m MAC-address}] -t ent [-T {on|off}]
-s speed -d duplex -S server -G gateway -C client
[-K subnetmask] [-V vlan_tag] [-Y vlan_priority]
[[-a -B tftp_image_filename] |
-B bootp_image_filename]
partition-name partition-profile managed-system
To retrieve MAC address and physical location code on a system supporting a full system partition:
lpar_netboot -M -n [-v] [-x] [-f] [-i] [-E environment [-E ...]]
[-A] -t ent [-T {on|off}] [-D -s speed -d duplex
-S server -G gateway -C client [-K subnetmask]
[-V vlan_tag] [-Y vlan_priority]]
managed-system managed-system
To perform network boot on a system supporting a full system partition:
lpar_netboot [-v] [-x] [-f] [-i] [-E environment [-E ...]]
[-g args] [{-A -D | [-D] -l physical-location-code |
[-D] -m MAC-address}] -t ent [-T {on|off}]
-s speed -d duplex -S server -G gateway -C client
[-K subnetmask] [-V vlan_tag] [-Y vlan_priority]
[[-a -B tftp_image_filename] |
-B bootp_image_filename]
managed-system managed-system

DESCRIPTION

lpar_netboot instructs a logical partition to network boot by having it send out a bootp request to a server specified with the -S option. The server can be an AIX NIM server serving SPOT resources or any server serving network boot images. If specified with the -M and -n options, lpar_netboot will return the Media Access Control (MAC) address and the physical location code for a network adapter of the type specified with the -t option. When the -m option is specified, lpar_netboot will boot a partition using the network adapter which has the specified MAC address. When the -l option is specified, lpar_netboot will boot a partition using the network adapter which has the specified physical location code. The MAC address and physical location code of a network adapter is dependent upon the hardware resource allocation in the partition profile the partition was booted with. The lpar_netboot command requires arguments for partition name, partition profile, and the name of the managed system which has the partition.
Please note:
If the managed system is in co-management mode (set with is_master=1) when listed with the lscomgmt command, the partition profile value will need to be blanked out with "". The lpar_netboot command will also ignore the partition profile value if its managed system is in co-management mode.

OPTIONS

-A Return all adapters of the type specified with the -t option.

-B Network boot image filename, required option if IPv6 addresses.

-C The IP address of the partition to network boot.

-D Perform a ping test and use the adapter that successfully pings the server specified with the -S option.

-E Set environment variable setting. The -E LPAR_NETBOOT_DEBUG=1 is the same as export LPAR_NETBOOT_DEBUG=1. See ENVIRONMENT.

-G The gateway IP address of the partition specified with the -C option.

-K Subnetmask IP address.

-M Discover network adapter MAC address and physical location code.

-S The IP address of the machine from which to retrieve the network boot image during network boot.

-T Enable or disble firmware spanning tree discovery. Valid values are on, off.

-V Specifies the VLAN tag identifier to use for tagging Ethernet frames during network install for virtual network communication. Valid value is from 0 to 4094.

-Y Specifies the VLAN tag priority to use for tagging Ethernet frames during network install for virtual network communication. Valid value is from 0 to 7.

-a Network ip addresses for server, client and gateway are IPv6.

-d The duplex setting of the partition specified with the -C option. Valid values are full, half, and auto.

-f Force close the virtual terminal session for the partition.

-g Specify generic arguments for booting the partition.

-i Force immediate shutdown of the partition. If this option is not specified, a delayed shutdown will be performed.

-l The physical location code of the network adapter to use for network boot.

-m The MAC address of the network adapter to use for network boot.

-n Instruct the partition to not network boot.

-s The speed setting of the partition specified with the -C option. Valid values are 10, 100, 1000, and auto.

-t The type of adapter for MAC address or physical location code discovery or for network boot. The only valid value is ent for ethernet.

-v Display additional information during command execution.

-x Display debug output during command execution.

partition-name The name of the partition.

partition-profile The name of the partition profile.

managed-system The name of the managed system which has the partition.

--help Display the help text for this command and exit.

EXAMPLES

To retrieve the MAC address and physical location code for partition machA with partition profile machA_prof on managed system test_sys:
lpar_netboot -M -n -t ent "machA" "machA_prof" "test_sys"
To network boot the partition machA with partition profile machA_prof on managed system test_sys:
lpar_netboot -t ent -s auto -d auto -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234 "machA" "machA_prof" "test_sys"
To network boot the partition machA using the network adapter with a MAC address of 00:09:6b:dd:02:e8 with partition profile machA_prof on managed system test_sys:
lpar_netboot -t ent -m 00096bdd02e8 -s auto -d auto -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234 "machA" "machA_prof" "test_sys"
To network boot the partition machA using the network adapter with a physical location code of U1234.121.A123456-P1-T6 with partition profile machA_prof on managed system test_sys:
lpar_netboot -t ent -l U1234.121.A123456-P1-T6 -s auto -d auto -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234 "machA" "machA_prof" "test_sys"
To perform a ping test along with a network boot of the partition machA with partition profile machA_prof on managed system test_sys:
lpar_netboot -t ent -D -s auto -d auto -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234 "machA" "machA_prof" "test_sys"
To perform ping test along with a network boot of the partition machA with partition profile machA_prof on managed system test_sys and disable firmware spanning tree discovery:
lpar_netboot -t ent -T off -D -s auto -d auto -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234 "machA" "machA_prof" "test_sys"

ENVIRONMENT

INSTALLIOS_DEBUG The installios command used this environment variable to print out lpar_netboot debug.

LPAR_NETBOOT_3EXEC Executing OF "dev /" and "ls" returns nothing, retry reboot and "ls".

LPAR_NETBOOT_DEBUG Setting this variable will enable lpar_netboot debug. Similar to -x flag.

LPAR_NETBOOT_DEBUG_BOOT Setting this variable will initate the firmware boot command with -s trap.

LPAR_NETBOOT_ADD_TIMEOUT Extend timeout value by 5 seconds. Ex. LPAR_NETBOOT_ADD_TIMEOUT=5

LPAR_NETBOOT_SUB_TIMEOUT Lower timeout value by 8 seconds. Ex. LPAR_NETBOOT_SUB_TIMEOUT=8

LPAR_NETBOOT_SPANNING_TREE LPAR_NETBOOT_SPANNING_TREE=on enable spanning tree, LPAR_NETBOOT_SPANNING_TREE=off disable spanning tree. Similar to the -T flag.

OPEN_DEV_DEBUG Show firmware OPEN_DEV debug by setting value to yes.

FIRMWARE_DUMP Show firmware dump for firmware debugging by setting value to yes.

BUGS

None

AUTHOR

IBM Austin

HMC Manual Reference Pages - LPAR_NETBOOT (1)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

ENVIRONMENT

BUGS

AUTHOR

SEE ALSO

-A	Return all adapters of the type specified with the -t option.
-B	Network boot image filename, required option if IPv6 addresses.
-C	The IP address of the partition to network boot.
-D	Perform a ping test and use the adapter that successfully pings the server specified with the -S option.
-E	Set environment variable setting. The -E LPAR_NETBOOT_DEBUG=1 is the same as export LPAR_NETBOOT_DEBUG=1. See ENVIRONMENT.
-G	The gateway IP address of the partition specified with the -C option.
-K	Subnetmask IP address.
-M	Discover network adapter MAC address and physical location code.
-S	The IP address of the machine from which to retrieve the network boot image during network boot.
-T	Enable or disble firmware spanning tree discovery. Valid values are on, off.
-V	Specifies the VLAN tag identifier to use for tagging Ethernet frames during network install for virtual network communication. Valid value is from 0 to 4094.
-Y	Specifies the VLAN tag priority to use for tagging Ethernet frames during network install for virtual network communication. Valid value is from 0 to 7.
-a	Network ip addresses for server, client and gateway are IPv6.
-d	The duplex setting of the partition specified with the -C option. Valid values are full, half, and auto.
-f	Force close the virtual terminal session for the partition.
-g	Specify generic arguments for booting the partition.
-i	Force immediate shutdown of the partition. If this option is not specified, a delayed shutdown will be performed.
-l	The physical location code of the network adapter to use for network boot.
-m	The MAC address of the network adapter to use for network boot.
-n	Instruct the partition to not network boot.
-s	The speed setting of the partition specified with the -C option. Valid values are 10, 100, 1000, and auto.
-t	The type of adapter for MAC address or physical location code discovery or for network boot. The only valid value is ent for ethernet.
-v	Display additional information during command execution.
-x	Display debug output during command execution.
partition-name	The name of the partition.
partition-profile	The name of the partition profile.
managed-system	The name of the managed system which has the partition.
--help	Display the help text for this command and exit.

INSTALLIOS_DEBUG	The installios command used this environment variable to print out lpar_netboot debug.
LPAR_NETBOOT_3EXEC	Executing OF "dev /" and "ls" returns nothing, retry reboot and "ls".
LPAR_NETBOOT_DEBUG	Setting this variable will enable lpar_netboot debug. Similar to -x flag.
LPAR_NETBOOT_DEBUG_BOOT	Setting this variable will initate the firmware boot command with -s trap.
LPAR_NETBOOT_ADD_TIMEOUT	Extend timeout value by 5 seconds. Ex. LPAR_NETBOOT_ADD_TIMEOUT=5
LPAR_NETBOOT_SUB_TIMEOUT	Lower timeout value by 8 seconds. Ex. LPAR_NETBOOT_SUB_TIMEOUT=8
LPAR_NETBOOT_SPANNING_TREE	LPAR_NETBOOT_SPANNING_TREE=on enable spanning tree, LPAR_NETBOOT_SPANNING_TREE=off disable spanning tree. Similar to the -T flag.
OPEN_DEV_DEBUG	Show firmware OPEN_DEV debug by setting value to yes.
FIRMWARE_DUMP	Show firmware dump for firmware debugging by setting value to yes.