Bug 1405770
Summary: | Improve documentation on adding direct LUNs via the API | ||
---|---|---|---|
Product: | [oVirt] ovirt-engine | Reporter: | Allon Mureinik <amureini> |
Component: | RestAPI | Assignee: | shani <sleviim> |
Status: | CLOSED CURRENTRELEASE | QA Contact: | Elad <ebenahar> |
Severity: | low | Docs Contact: | |
Priority: | unspecified | ||
Version: | 4.0.0 | CC: | amureini, bugs, ishaby, juan.hernandez, ratamir, sleviim, tnisan, ylavi |
Target Milestone: | ovirt-4.1.1 | Flags: | amureini:
needinfo+
amureini: needinfo+ rule-engine: ovirt-4.1+ |
Target Release: | --- | ||
Hardware: | Unspecified | ||
OS: | Unspecified | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Enhancement | |
Doc Text: | Story Points: | --- | |
Clone Of: | 1404389 | Environment: | |
Last Closed: | 2017-04-21 09:40:20 UTC | Type: | Bug |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | Storage | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: | |||
Bug Depends On: | 1275649 | ||
Bug Blocks: |
Description
Allon Mureinik
2016-12-18 09:51:46 UTC
If you are already into this, I'd appreciate if you can also give an example of creating one against multiple IPs - do you have to use multiple logical_unit objects with different ISCSI_SERVER_IP , etc. rhevm-4.1.0.3-0.1.el7.noarch The explanation why the disk size is reported wrongly is not documented in the response body, I this it should be. Add direct LUN request: <disk> <alias>direct_lun_test</alias> <lun_storage> <logical_units> <logical_unit id="3514f0c5a516008d7"> <address>10.35.146.129</address> <address>10.35.146.163</address> <address>10.35.146.193</address> <address>10.35.146.225</address> <port>3260</port> <target>iqn.2008-05.com.xtremio:xio00153500071-514f0c50023f6c00</target> </logical_unit> </logical_units> <type>iscsi</type> </lun_storage> </disk> =============================================================== Add direct LUN response: <disk href= "/ovirt-engine/api/disks/7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f" id="7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f"> <actions> <link href= "/ovirt-engine/api/disks/7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f/export" rel="export"/> <link href= "/ovirt-engine/api/disks/7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f/move" rel="move"/> <link href= "/ovirt-engine/api/disks/7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f/sparsify" rel="sparsify"/> <link href= "/ovirt-engine/api/disks/7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f/copy" rel="copy"/> </actions> <name>direct_lun_test</name> <link href= "/ovirt-engine/api/disks/7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f/permissions" rel="permissions"/> <link href= "/ovirt-engine/api/disks/7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f/statistics" rel="statistics"/> <alias>direct_lun_test</alias> <lun_storage id="3514f0c5a516008d7"> <logical_units> <logical_unit id="3514f0c5a516008d7"> <disk_id>7bb21c2d-9c68-4c28-8afa-1fb0e58cc86f</disk_id> <paths>0</paths> <size>0</size> </logical_unit> </logical_units> </lun_storage> <propagate_errors>false</propagate_errors> <shareable>false</shareable> <storage_type>lun</storage_type> <wipe_after_delete>false</wipe_after_delete> </disk> model doesn't include the fix for the bug. Please verify with CI it is in the latest build. This bug was accidently moved to ON_QA, and this build indeed does not include the fix. It is, however, merged to the correct branch, so the next build should include it. Pushing out to be verified when the build is available. The model now includes the right information regarding adding direct LUN: Adding a new direct LUN disk: When adding a new floating direct LUN via the API, there are two flavors that can be used: With a host element - in this case, the host is used for sanity checks (e.g., that the LUN is visible) and to retrieve basic information about the LUN (e.g., size and serial). Without a host element - in this case, the operation is a database-only operation, and the storage is never accessed. ============ Used: rhevm-4.1.1.2-0.1.el7.noarch ovirt-engine-restapi-4.1.1.2-0.1.el7.noarch |