The rmhostiogrp command enables you to delete mappings between one or more I/O groups and a specified host object.
Syntax
>>- svctask -- -- rmhostiogrp -- -------------------------------> >--+- -iogrp -- -- iogrp_list -+--+----------+-- ---------------> '- -iogrpall ---------------' '- -force -' >--+- host_name -+--------------------------------------------->< '- host_id ---'
Parameters
- -iogrp iogrp_list
- (Required) Specifies a set of one or more I/O group mappings that will be deleted from the host. You cannot use this parameter with the -iogrpall parameter.
- -iogrpall
- (Optional) Specifies that all the I/O group mappings that are associated with the specified host must be deleted from the host. You cannot use this parameter with the -iogrp parameter.
- -force
- (Optional) Specifies that you want the system to remove the specified I/O group mappings on the host even if the removal of a host to I/O group mapping results in the loss of VDisk-to-host mappings.
- host_id | host_name
- (Required) Specifies the identity of the host either by ID or name from which the I/O group mappings must be deleted.
Description
The rmhostiogrp command deletes the mappings between the list of I/O groups and the specified host object.
This command fails if any of the I/O groups that
are deleted from the host contain VDisks that have host mappings to
the host. To resolve this problem, do one of the following:
- Delete the VDisks-to-host mappings that are causing the error.
- Delete the VDisks or the host.
- Issue the rmhostiogrp command with the -force parameter.
Note: When all
I/O groups are removed from an iSCSI host, and you want to add an
iSCSI port to the host, refer to the svctask
addhostport and svctask chhost commands.
An invocation example
svctask rmhostiogrp -iogrp 1:2 host0
The resulting output
No feedback