Retrieves the media access control (MAC) address and physical location code from network adapters for a logical partition, or instructs a logical partition to do a network boot. This command is operable only in an Integrated Virtualization Manager environment.
To retrieve a MAC address:
lpar_netboot -M -n [-v] [-x] [-f] [-i] [-A] -t ent [-D -s Speed-d Duplex -S Server -G Gateway -C Client -K subnetmask] partition name partition profile manage system
To perform a network boot:
lpar_netboot [-v [-x] [-f] [-i] [-g args] [-A -D | [-D] -l phys_loc | [-D] -m maddress] -t ent [-D -s Speed-d Duplex -S Server -G Gateway -C Client -K subnetmask partition name partition profile manage system
The lpar_netboot command instructs a logical partition to do a network boot by having the logical partition send out a bootp request to a server that is specified with the -S flag. The server can be a network installation management (NIM) server serving SPOT resources or any server serving network boot images.
If the -M and -n flags are specified, the lpar_netboot command returns the MAC address and the physical location code for a particular type of network adapter that is specified with the -t flag. When the -m flag is specified, lpar_netboot boots a partition using a specific network adapter that matches the specified MAC address. When the -l flag is specified, lpar_netboot boots a logical partition by using a specific physical location code for the network adapter that matches the specified physical location code. The matching MAC address or physical location code is dependent on the hardware resource allocation in the profile in which the logical partition was booted. The lpar_netboot command also requires arguments for the partition name and the partition profile (which contains the allocated hardware resources), and the name of the managed system in which the logical partition was defined.
Flag name | Description |
---|---|
-A | Returns all adapters of the given type. |
-C Client | Specifies the IP address of the machine to do a network boot. |
-D | Performs a ping test so the adapter can successfully ping the server that is specified with the -S flag. |
-d Duplex | Specifies the duplex setting of the machine that is specified with the -C flag. |
-f | Forces a close virtual terminal session for the logical partition. |
-G Gateway | Specifies the gateway IP address of the machine that is specified with the -C flag. |
-g args | Specifies generic arguments for booting. |
-i | Forces an immediate shutdown of the partition. |
-K subnetmask | Specifies the mask that the gateway should use in determining the appropriate subnetwork for routing. The subnet mask is a set of 4 bytes, as in the Internet address. The subnet mask consists of high bits (1's) corresponding to the bit positions of the network and subnetwork address, and low bits (0's) corresponding to the bit positions of the host address. |
-l phys_loc | Specifies the physical location code of the network adapter to do a network boot. |
-M | Displays the network adapter MAC address and physical location code. |
-m maddress | Specifies the MAC address of the network adapter to do a network boot. |
-n | Instructs the logical partition to not do a network boot. |
-S Server | Specifies the IP address of the machine to retrieve the network boot image during the network boot. |
-s Speed | Specifies the speed setting of the machine that is specified with the -C flag. |
-t ent | Specifies the type of adapter for MAC address or physical location code discovery, or for a network boot. |
-v | Displays additional information while the command is running. |
-x | Displays debug output while the command is running. |
Parameter name | Description |
---|---|
partition_name | Specifies the name of the partition. |
partition_profile | Specifies the name of the partition profile to use. |
managed_system | Specifies the name of the managed system on which the partition is defined. |
Value | Description |
---|---|
0 | The command completed successfully. |
>0 | An error occurred. |
Access Control: You must have root authority to run the lpar_netboot command.
lpar_netboot -M -n -t ent "machA" "machA_prof" "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"
OS_install -o allocate -a os_resource=my53resource myclient01
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"
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"