ietadm − iSCSI Enterprise Target Administration Utility.
ietadm −−op [operation] −−tid=[id] [−−sid [id]] [−−params [key=value,...]]
ietadm is used to monitor and modify in real-time the iSCSI Enterprise Target targets and volumes.
You’ll have to get target ids from /proc/net/iet/volumes and sessions ids from /proc/net/iet/session. Some usage examples can be :
ietadm −−op show −−tid=1
display status of target 1 (see /proc/net/iet/volumes to get the matching target name)
ietadm −−op new −−tid=2
create dynamically a new target, numbered 2. CAUTION : the target will disappear if you restart ietd, you’ll have to edit /etc/ietd.conf to make it permanent!
ietadm misses error messages. Look carefully the STDERR output : in case of error it will send a 3 number error code, ending with −1, for instance :
ietd_request 203 3 −1
−−op new −−tid=[id] −−params Name=[name]
add a new target with [id]. [id] must not be zero.
−−op delete −−tid=[id]
delete specific target with [id]. The target must have no active sessions.
−−op show −−tid=[id]
show target parameters of target with [id].
−−op show −−tid=[id] −−sid=[sid]
show iSCSI parameters in effect for session [sid]. If [sid] is "0" (zero), the configured parameters will be displayed.
−−op new −−tid=[id] −−lun=[lun] −−params Path=[path]
add a new logical unit with [lun] to specific target with [id]. The logical unit is offered to the initiators. [path] must be block device files (including LVM and RAID devices) or regular files.
−−op delete −−tid=[id] −−lun=[lun]
delete specific logical unit with [lun] that the target with [id] has.
−−op delete −−tid=[id] −−sid=[sid] −−cid=[cid]
delete specific connection with [cid] in a session with [sid] that the target with [id] has. If the session has no connections after the operation, the session will be deleted automatically.
−−op delete
stop all activity.
−−op update −−tid=[id] −−params=key1=value1,key2=value2,...
change iSCSI IET target parameters of specific target with [id]. You can use parameters in ietd.conf as a key.
−−op new −−tid=[id] −−user −−params=[user]=[name],Password=[pass]
add a new account with [pass] for specific target. [user] could be [IncomingUser] or [OutgoingUser]. If you don’t specify a target (omit −−tid option), you add a new account for discovery sessions.
−−op delete −−tid=[id] −−user −−params=[user]=[name]
delete specific account having [name] of specific target. [user] could be [IncomingUser] or [OutgoingUser]. If you don’t specify a target (omit −−tid option), you delete the account for discovery sessions.
−−version
display version and exit
−−help
display a list of available options and exits
• |
ietdadm doesn’t return any human-readable error message, only error codes. |
||
• |
ietadm doesn’t modify or read the /etc/ietd.conf ietd configuration file. |
||
• |
ietadm can’t use target names or aliases, only the tid found in /proc/net/iet/volumes. |
||
• |
/proc/net/iet/session may list inactive sessions if the initiator doesn’t logout properly. |
Report bugs to <iscsitarget−devel AT sourceforge DOT net>.
/proc/net/iet/session, /proc/net/iet/volumes