Bug 1946995 - Provide documentation for removing stale LUNs
Summary: Provide documentation for removing stale LUNs
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 4.4.0
Hardware: Unspecified
OS: Unspecified
high
unspecified
Target Milestone: ovirt-4.4.9
: ---
Assignee: Donna DaCosta
QA Contact: rhev-docs@redhat.com
URL:
Whiteboard:
Depends On: 1310330
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-04-07 13:03 UTC by Vojtech Juranek
Modified: 2022-03-17 08:25 UTC (History)
14 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-11-16 22:00:38 UTC
oVirt Team: Docs
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Vojtech Juranek 2021-04-07 13:03:06 UTC
Description of problem:
Provide documentation how to remove stale LUNs from the hosts (BZ #1310330). 

The process is as follows:
1. put SD into maintenance
2. detach SD
3. remove SD
4. remove/unzone LUN from storage server
5. run ansible playbook to remove stale LUNs from the hosts

Point 1.-3. are standard operation done via oVirt UI (ovirt ansible playbook ...).

Point 4. has to be done by administrator of storage server. The documentation should include explanation that oVirt/RHEV doesn't manager iSCSI servers and therefore cannot do the LUN removal itself. Similar to creating iSCSI SD oVirt expects LUNs forming SD already exists on storage server and doesn't create them during SD creation, during removal oVirt just removes SD and left LUNs on storage server.

As for point 5., ansible playbook for it is remove_mpath_device.yml, placed in example dir ovirt-ansible-collection and usage is as follows:

ansible-playbook --extra-vars "lun=<LUN>" /usr/share/doc/ovirt-ansible-collection/examples/remove_mpath_device.yml

where <LUN> should be replaced by the LUN forming SD, which was removed in step 4.

If the LUN is not removed from storage server (step 4.), step 5. will succeed, but as vdsm does iSCIS rescans on various occasions, the stale LUN will appear on the hosts again (after next iSCSI rescan).

Comment 1 Michal Skrivanek 2021-06-01 14:18:23 UTC
(In reply to Vojtech Juranek from comment #0)
> Description of problem:
> Provide documentation how to remove stale LUNs from the hosts (BZ #1310330). 
> 
> The process is as follows:
> 1. put SD into maintenance
> 2. detach SD
> 3. remove SD
> 4. remove/unzone LUN from storage server
> 5. run ansible playbook to remove stale LUNs from the hosts
> 
> Point 1.-3. are standard operation done via oVirt UI (ovirt ansible playbook
> ...).
> 
> Point 4. has to be done by administrator of storage server. The
> documentation should include explanation that oVirt/RHEV doesn't manager
> iSCSI servers and therefore cannot do the LUN removal itself. Similar to
> creating iSCSI SD oVirt expects LUNs forming SD already exists on storage
> server and doesn't create them during SD creation, during removal oVirt just
> removes SD and left LUNs on storage server.
> 
> As for point 5., ansible playbook for it is remove_mpath_device.yml, placed
> in example dir ovirt-ansible-collection and usage is as follows:
> 
> ansible-playbook --extra-vars "lun=<LUN>"
> /usr/share/doc/ovirt-ansible-collection/examples/remove_mpath_device.yml

we shouldn't make examples a mandatory part of supported feature.


Note You need to log in before you can comment on or make changes to this bug.