Command and Technical Reference, Volume 2

spdeladap

Purpose

spdeladap - Removes configuration data for adapters for a node or series of nodes from the System Data Repository (SDR).

|Syntax

|spdeladap: |-h
| |

|spdeladap: |-P physical_location_code
|: |{start_frame start_slot node_count | -N |node_group | -l node_list}
| |

|spdeladap: |{start_frame start_slot node_count | -N |node_group |
|: |-l node_list} adapter_name |

Flags

|-h: |Displays usage information. |
|-P physical_location_code: |Specifies the physical location of the adapter to be deleted. When |using this flag, do not specify an adapter_name.
-N node_group: Specifies a node group to be used for this operation. This node group must be bound to the current system partition.
-l node_list: Specifies a list of nodes to be used for this operation. Either specify a comma-delimited list of node numbers, or a file containing one line of data which is a comma-delimited list of node numbers. The file can also contain comment lines (preceded by a #) and lines that are all white space. If you use the node_list field, do not use the start_frame, start_slot, or node_count fields. (This is lowercase l, as in list.)

Operands

start_frame

Frame number of first node to be used for this operation. Specify a value between 1 and 128 inclusive.

start_slot

Slot number of first node to be used for this operation. Specify a value between 1 and 16 inclusive.

Note:: The start_frame and start_slot must resolve to a node in the current system partition.

|node_count

|Number of nodes to be used for this operation. The adapter |information is deleted for successive nodes within a frame and, when the count |of nodes causes the nodes in a frame to be exhausted, for nodes in the next |sequential frame. Specify a value between 1 and 512 inclusive.

|Note:: The node_count is considered to be within the current system |partition. |

|adapter_name

|Specifies the name of the adapter. Valid adapter names are: |enn (Ethernet), fin (FDDI), |trn (token ring), and cssn (switch), where |n is the logical device number assigned to the adapter by AIX. |You cannot specify an adapter type (an adapter name without the logical device |number, such as en, fi, ti, or |css). If you do not have a fully qualified adapter name with a |logical device number, use the -P flag instead.

|Note:: This command cannot be used for aggregate IP (ml) adapters; use |the spdelagg command instead. |

Description

Use this command to remove configuration data for adapters for a node or series of nodes from the SDR. |You cannot use this command to delete data for the SP Ethernet |administrative local area network (LAN) adapter for this node. |If you want to remove configuration data for this adapter, you must |first use the spadaptrs command to specify a different the SP |Ethernet administrative LAN adapter for the node. Note that doing so |will require you to reinstall the node.

|You cannot use this command to remove configuration data for the |adapter from which the initial host name of this node is derived. If |you want to remove configuration data for this adapter, you must first use the |sphostnam command to specify a different initial host name for the |node.

|For css adapters on SP Switch2 systems, the |spdeladap command also checks for the presence of virtual ml |device names associated with the adapters being deleted. If an |ml adapter is present, it is removed only if all of the |adapters it aggregates are being deleted. For example, if ml0 |aggregates only css0, ml0 is removed from the SDR when |css0 is deleted. If ml0 aggregates css0 and |css1, ml0 will remain if only css0 is deleted |without css1.

You can use the System Management Interface Tool (SMIT) to run the spdeladap command. To use SMIT, enter:

smit delete_data

and select the Delete Adapter Information option.

Notes:

This command should be run only on the control workstation. You must be logged into the control workstation as root to execute this command.
After running this command, you must issue the syspar_ctrl -r command to refresh system partition-sensitive subsystems in each system partition where node customization was performed. Subsystems like hats, hb, and hr need to be refreshed whenever nodes or adapters are added or deleted.
Any changes made will not take effect on the nodes until they are customized.
|In SP Switch2 systems, a node must either be connected to all switch |planes in the system or none of the switch planes in the system. A node |cannot be connected to only a portion of the switch planes in the |system. If you are removing a node from the switch network on a |multiplane system, you must delete all switch adapters on that node through |multiple executions of the spdeladap command.
|You cannot delete switch adapters (css adapters) from systems |containing an SP Switch.
|This command cannot be used for aggregate IP (ml) |adapters; use the spdelagg command instead.

Security

You must have root privilege and write access to the SDR to run this command.

Location

/usr/lpp/ssp/bin/spdeladap

Related Information

Commands: syspar_ctrl

Examples

This example deletes tr0 adapter information for the first two nodes in frame 2:
```
spdeladap 2 1 2 tr0
```
This example deletes the adapter with the physical location code of P2/E1 on node 5:
```
spdeladap -P P2/E1 -l 5
```

|spdelagg

|Purpose

|spdelagg - Removes an aggregate IP object from the System |Data Repository (SDR). |

|Syntax

|spdelagg: |[-h] {-l node_list | |-N node_group |
|: |start_frame start_slot node_count} |

|Flags

|-h: |Specifies that the command should only display valid command |syntax. When this flag is specified, other flags and operands are |ignored.
|-l node_list: |Specifies the nodes using a comma-separated list of node numbers.
|-N node_group: |Specifies the nodes using a node group. |

|Operands

|start_frame

|Specifies the frame number of the first node to be used for this |operation. Specify a value between 1 and 128 inclusive.

|start_slot

|Specifies the slot number of the first node to be used for this |operation. Specify a value between 1 and 16 inclusive.

|Note:: The start_frame and start_slot must resolve to a node in |the current system. |

|node_count

|Specifies the number of nodes to be used for this operation. The |adapters are deleted from the nodes, beginning with the node that the |starting_frame and starting_slot resolves to, and continuing |sequentially through each node after that one until adapters have been created |for node_count nodes. If node_count nodes spans |multiple frames, when the nodes in a particular frame are exhausted, the |command continues with the first node in the next sequential frame. |Specify a value between 1 and 512 inclusive. If rest is |specified, all of the nodes from start_frame start_slot to |the end of your system are used. |

|Description

|The spdelagg command is used to delete aggregate IP adapter |entries which represent one or more SP switch adapters for the SP Switch2 on a |node. This command assumes the deletion of the aggregate IP object |ml0.

|Notes:

|Aggregate IP adapter objects are automatically deleted when all of the |adapters they aggregate together are deleted. They are also deleted |when the nodes they aggregate adapters on are deleted.
|Any changes made will not take effect on the nodes until they are |customized. |

|Files

|None.

|Standard Output

|This command writes informational messages to standard output.

|Standard Error

|This command writes all error messages to standard error.

|Exit Values

|0: |Indicates successful completion of the command.
|1: |Indicates that an error occurred. |

|Security

|You must have root privilege or be a member of the system group to run this |command.

|You must have write access to the SDR to run this command.

|Restrictions

|This command can only be issued on the control workstation.

|Implementation Specifics

|This command is part of the IBM Parallel System Support Programs (PSSP) |Licensed Program (LP).

|Location

|/usr/lpp/ssp/bin/spdelagg

|Related Information

|Commands: spaggip, spdeladap

|Examples

|To remove aggregate IP addresses for the first 16 nodes in the system, |enter:
```
|spdelagg 1 1 16
```
|To remove aggregate IP addresses for nodes 7 and 22, enter:
```
|spdelagg -l 7,22
```
|

spdelexp

Purpose

spdelexp - Removes configuration data for node expansion units from the System Data Repository (SDR).

Syntax

spdelexp: {start_frame start_slot expansion_count | -x expansion_list |
: -l associated_node_list | -N node_group}

Flags

-x expansion_list: Specifies a list of node expansion units to be used for this operation. Either specify a comma-delimited list of expansion numbers, or a file containing one line of data which is a comma-delimited list of expansion numbers. The file can also contain comment lines (preceded by a #) and lines that are all white space. If you use the expansion_list field, do not use the start_frame, start_slot, or expansion_count fields, the -l flag or the -N flag.
-l associated_node_list: Specifies a list of nodes whose attached node expansion units are to be used for this operation. Either specify a comma-delimited list of node numbers, or a file containing one line of data which is a comma-delimited list of node numbers. The file can also contain comment lines (preceded by a #) and lines that are all white space. If you use the associated_node_list field, do not use the start_frame, start_slot, or expansion_count fields, the -x flag or the -N flag.
-N node_group: Specifies a node group containing nodes whose attached node expansion units are to be used for this operation. If you use the node_group field, do not use the start_frame, start_slot, or expansion_count fields, the -x flag or the -l flag.

Operands

|start_frame

|Specifies the frame number of the first expansion unit to be used for this |operation. Specify a value between 1 and 250 inclusive.

start_slot

Specifies the slot number of the first expansion unit to be used for this operation. Specify a value between 1 and 16 inclusive.

Note:: The start_frame and start_slot must resolve to an expansion unit in the current system partition.

expansion_count

Specifies the number of expansion units to be used for this operation. The expansion information is removed for successive node expansion units within a frame and, when the count of expansion units exceeds those in a frame, processing continues with the next sequential frame. Specify a value between 1 and 1024 inclusive.

Note:: The expansion_count is considered to be within the current system partition.

Description

Execute this command to remove configuration data for a node expansion unit or series of units from the SDR. All the nodes to be deleted must be shut down. The expansion_number is also removed from the expansion_list of the node that it is connected to.

This command can be used to delete node expansion units in the current system partition. To delete expansion units in another system partition, you must make it your current system partition. Node expansion units reside in the system partition that their associated node resides in, or in the default system partition if the node expansion unit is not connected to a node.

You can use the System Management Interface Tool (SMIT) to run the spdelexp command. To use SMIT, enter:

smit delete_data

and select the Delete Node Expansion Information option.

Note:: This command should be run only on the control workstation.

Security

You must have root privilege and write access to the SDR to run this command.

Location

/usr/lpp/ssp/bin/spdelexp

Related Information

Commands: syspar_ctrl

Examples

This example removes configuration data for node expansion unit 2 from the SDR:
```
spdelexp -x 2
```
This example deletes the first two node expansion units in frame 2:
```
spdelexp 2 1 2
```
To delete the node expansion units connected to node 5, enter
```
spdelexp -l 5
```

spdelfram

Purpose

spdelfram - Removes configuration data for a frame or series of frames from the System Data Repository (SDR).

Syntax

spdelfram [-c] {start_frame frame_count | -l frame_list}

Flags

-c: Specifies that switch port number verification should be bypassed. Use this flag when reconfiguring your existing SP system to a system of clustered enterprise servers.
-l frame_list: Specifies a list of frames to be used for this operation. frame_list is a comma-delimited list of frame numbers. If you use this flag, do not use the start_frame and frame_count operands.

Operands

|start_frame: |Specifies the frame number of the first frame to be used for this |operation. Specify a value between 1 and 250 inclusive. If you |are using the -l flag, do not use this operand. |
|frame_count: |Specifies the number of consecutive frames to be used for this |operation. Specify a value between 1 and 128 inclusive. If you |are using the -l flag, do not use this operand.

Description

Execute this command to remove configuration data for a frame or series of frames from the SDR. Any node information for nodes on the frames is also removed, as well as adapter information for any of the nodes on the frames. All the nodes on all the frames to be deleted must be shut down. A frame containing a node acting as a server for another node on a frame not being removed with this operation cannot be removed with this command. To remove a frame containing such a node, you must configure a different boot/install or /usr server for the client nodes on the other frames. If a definition for a node being removed exists in /etc/switch.info, this definition will be removed from that file. If a non-SP frame is using a switch port number within an SP frame, that SP frame may not be deleted.

All node expansion information is removed from the SDR for expansion units that reside on frames being deleted, or that reside on other frames and are connected to nodes residing on frames being deleted. These node expansion units must be shut down before invoking this command.

The spdelfram command removes all extension node and extension node adapter information for extension nodes whose node numbers are within the range of node numbers represented by a frame being deleted.

You can use the System Management Interface Tool (SMIT) to run the spdelfram command. To use SMIT, enter:

smit delete_data

and select the Delete Frame Information option.

Notes:

This command should be run only on the control workstation. You must be logged into the control workstation as root to execute this command.
You should stop the Resource Manager before the command and start it again afterward.
There must be only one system partition defined when deleting a frame. This is to aid in the configuration of the system once the frame is deleted.
|Use the -c flag only when you are reconfiguring your |system to a system of clustered enterprise servers. Using this flag for |any other spdelfram operation causes configuration errors to |occur. When reconfiguring your SP system to a system of clustered |enterprise servers, delete all SP frames containing SP nodes from the system |in a single spdelfram command.
|The spdelfram command will remove the entry for an attached |server node from the /etc/switch.info file on a switchless or |SP Switch system.

When a frame is deleted (if DCE is configured on the control workstation), the hmdceobj command will run to remove a Hardware Monitor DCE objects, if defined for this frame or slots in the frame.

Security

You must be logged onto the control workstation and have root privilege to run this command. You must also have Hardware Monitor VFOP authority and SDR write access to run this command.

Location

/usr/lpp/ssp/bin/spdelfram

Examples

To delete frames 2, 3, and 4, enter:
```
spdelfram 2 3
```
|To delete frames 2 and 4, enter:
```
|spdelfram -l 2,4
```

|spdelhmcid

|Purpose

|spdelhmcid - Deletes a previously-saved user ID and |password used by the Hardware Monitor (hardmon) to establish a remote |client session with the |IBM pSeries 690 Hardware Management Console (HMC). | |

|Syntax

|spdelhmcid [-h] | |[host_name | ip_address]

|Flags

|-h: |Displays usage information. |

|Operands

|host_name: |Specifies the host name of the HMC. |
|ip_address: |Specifies the IP address of the HMC. |

|Description

|Use this command to remove previously-stored user ID and password |information that the Hardware Monitor used to establish a remote client |session with an |HMC. The information to be deleted is specified by the IP address of the |HMC for which the user ID and password information had been |saved. If a host name is specified, it will be resolved to its IP |address before attempting the delete operation.

|Standard Error

|This command writes all error messages to standard error.

|Exit Values

|0: |Indicates the successful completion of the command.
|1: |Indicates that no user ID information exists for the specified IP |address.
|2: |Indicates that the command could not delete the stored data. |
|3: |Indicates that the host name and IP address could not be |resolved. |
|4: |Indicates that the file access permission was altered. |
|5: |Indicates a syntax error. |

|Security

|You must have root privilege to run this command.

|Restrictions

|The spdelhmcid command may only be run on the control |workstation.

|Implementation Specifics

|This command is part of the IBM Parallel System Support Programs (PSSP) |Licensed Program (LP) (file set ssp.basic).

|Location

|/usr/lpp/ssp/bin/spdelhmcid

|Examples

|To delete the stored user ID and password for an HMC with IP address |9.10.11.12, enter:

|spdelhmcid 9.10.11.12

spdelnode

Purpose

spdelnode - Removes configuration data for a node or nodes from the System Data Repository (SDR).

Syntax

spdelnode {start_frame start_slot node_count | -N node_group | -l node_list}

Flags

-N node_group: Specifies a node group to be used for this operation. This node group must be bound to the current system partition.
-l node_list: Specifies a list of nodes to be used for this operation. Either specify a comma-delimited list of node numbers, or a file containing one line of data which is a comma-delimited list of node numbers. The file can also contain comment lines (preceded by a #) and lines that are all white space. If you use the node_list field, do not use the start_frame, start_slot, or node_count fields. (This is lowercase l, as in list.)

Operands

start_frame

Specifies the frame number of the first node to be used for this operation. Specify a value between 1 and 128 inclusive.

start_slot

Specifies the slot number of the first node to be used for this operation. Specify a value between 1 and 16 inclusive.

Note:: The start_frame and start_slot must resolve to a node in the current system partition.

|node_count

|Specifies the number of nodes to be used for this operation. The |node information is added for successive nodes within a frame and, when the |count of nodes causes the nodes in a frame to be exhausted, for nodes in the |next sequential frame. Specify a value between 1 and 512 |inclusive.

|Note:: The node_count is considered to be within the current system |partition. |

Description

Issue this command to remove configuration data for a node or series of nodes from the SDR. Any adapter information associated with the node, |including virtual ml devices, is also removed. All |the nodes to be deleted must be powered off. A node acting as a server |for another node cannot be removed with this command. To remove a node |which is a server, you must configure a different boot/install server for the |client nodes.

All node expansion information is removed from the SDR for expansion units that are connected to nodes being deleted. These node expansion units must be shut down before invoking this command.

This command can be used to delete nodes in the current system partition. To delete nodes in another system partition, you must make it your current system partition.

You can use the System Management Interface Tool (SMIT) to run the spdelnode command. To use SMIT, enter:

smit delete_data

and select the Delete Node Information option.

Notes:

This command should be run only on the control workstation.
After running this command, you must issue the syspar_ctrl -r command to refresh system partition-sensitive subsystems in each system partition where node customization was performed. Subsystems like hats, hb, and hr need to be refreshed whenever nodes or adapters are added or deleted.
|After running this command, the data is only removed from the |SDR. You must customize the node to have the changes take effect on the |node.

When a node is deleted (if DCE is configured on the control workstation), the hmdceobj command will run to remove a Hardware Monitor DCE object if it is defined for this node.

|Environment Variables

|PSSP 3.4 provides the ability to run commands using secure remote |command and secure remote copy methods.

|To determine whether you are using either AIX rsh or rcp |or the secure remote command and copy method, the following environment |variables are used. |If no environment variables are set, the defaults are |/bin/rsh and /bin/rcp.

|You must be careful to keep these environment variables consistent. |If setting the variables, all three should be set. The DSH_REMOTE_CMD |and REMOTE_COPY_CMD executables should be kept consistent with the choice of |the remote command method in RCMD_PGM: |

|RCMD_PGM - remote command method, either rsh or |secrshell
|DSH_REMOTE_CMD - remote command executable
|REMOTE_COPY_CMD - remote copy executable |

|For example, if you want to run spdelnode using a secure remote |method, enter:

|export RCMD_PGM=secrshell
|export DSH_REMOTE_CMD=/bin/ssh
|export REMOTE_COPY_CMD=/bin/scp

Security

|In order to run this command, you must:

|Be logged onto the control workstation
|Have root privilege
|Have Hardware Monitor VFOP authority
|Have SDR write access
|Have remote command authority to the boot/install server that manages the |node being deleted

Location

/usr/lpp/ssp/bin/spdelnode

Related Information

Commands: syspar_ctrl

Examples

This example deletes the first two nodes in frame 2:
```
spdelnode 2 1 2
```
To delete the nodes in the node group temp_nodes, enter:
```
spdelnode -N temp_nodes
```

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]