IVM lpar_netboot command

Purpose

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.

Syntax

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

Description

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 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 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 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.

Flags

-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 (1s) corresponding to the bit positions of the network and subnetwork address, and low bits (0s) 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.

Parameters

Parameter	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.

Exit Status

The following exit values are returned:

0	The command completed successfully.
>0	An error occurred.

Security

Access Control: You must have root authority to run the lpar_netboot command.

Examples

To retrieve MAC address and physical location code for partition machA with logical partition profile machA_prof on managed system test_sys, type:
```
lpar_netboot -M -n -t ent "machA" "machA_prof" "test_sys"
```

To do a network boot logical partition machA with a partition profile machA_prof on managed system test_sys, type:

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 do a network boot logical partition machA with the specific MAC address 00:09:6b:dd:02:e8 and logical partition profile machA_prof on managed system test_sys, type:
```
OS_install -o allocate -a os_resource=my53resource myclient01
```
To do a network boot logical partition machA with the specific physical location code U1234.121.A123456-P1-T6 and logical partition profile machA_prof on managed system test_sys, type:
```
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 and do a network boot of logical partition machA with logical partition profile machA_prof on a managed system test_sys, type:
```
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"
```

Related Information

The installios command.