Bug 716280 - Need documentation for setting up an iSCSI target in RHEL 6
Summary: Need documentation for setting up an iSCSI target in RHEL 6
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Deadline: 2012-03-06
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: doc-Storage_Admin_Guide
Version: 6.2
Hardware: All
OS: Linux
medium
medium
Target Milestone: rc
: ---
Assignee: Jacquelynn East
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-06-23 20:22 UTC by Sayan Saha
Modified: 2015-07-26 22:09 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-06-22 00:50:24 UTC
Target Upstream Version:


Attachments (Terms of Use)
draft documentation (911 bytes, text/plain)
2012-01-09 20:55 UTC, Andy Grover
no flags Details

Description Sayan Saha 2011-06-23 20:22:20 UTC
The Storage Administration Guide (SAG) needs a new chapter on how to setup an iSCSI target. There is no mention of how to do this in the current documentation.

At minimum the section should cover the following:

- How to edit /etc/tgt/targets.conf to add a new target.
- Starting the tgtd service
- Using the "tgtadm" user space utility to set up the target and add new ones dynamically.

Comment 5 Andy Grover 2012-01-09 20:55:00 UTC
Created attachment 551669 [details]
draft documentation

Draft documentation attached. It has a bare-bones description of targets.conf and starting/stopping tgtd, really as a strawman so you can tell me what more needs to be added.

Upstream also has a manpage for targets.conf (written by me) that it might be nice to include in the RHEL6 pkg.

Finally, I dimly remember mchristi in some bug saying something about executables that should not be considered user-visible. Was tgtadm one of them? Should we be documenting tgtadm usage? I'm sorry I can't remember the bz.

Comment 7 Mike Christie 2012-02-28 22:51:15 UTC
I don't remember what I said about this. I have happily forgot it :) I actually could never figure out a policy on if users should use tgt-adim or tgtadm or edit targets.conf then do service tgtd whatever.


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