Bug 716280

Summary: Need documentation for setting up an iSCSI target in RHEL 6
Product: Red Hat Enterprise Linux 6 Reporter: Sayan Saha <ssaha>
Component: doc-Storage_Admin_GuideAssignee: Jacquelynn East <jeast>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: medium Docs Contact:
Priority: medium    
Version: 6.2CC: agrover, alyoung, coughlan, mchristi, rlandman
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-06-22 00:50:24 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Deadline: 2012-03-06   
Attachments:
Description Flags
draft documentation none

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.