NAME

       ietadm - iSCSI Enterprise Target Administration Utility.

SYNOPSIS

       ietadm --op [operation] --tid=[id] [--sid [id]] [--params [key=value,...]]

DESCRIPTION

       ietadm is used to monitor and modify in real-time the iSCSI Enterprise Target targets and volumes.

USAGE

       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!

ERROR MESSAGES

       ietadm  misses  error  messages.  Look carefully at 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

OPTIONS

       --op new --tid=[id] --params Name=[name]

       add a new target with [id]. If [id] is zero, the lowest free [id] is allocated automatically to  the  new
       target.

       --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 update --tid=[id] --redirect=[destination]

       set  a  temporary target redirection for target [id]. [destination] MUST be in the form <ip address>:port
       where :port is optional and if not specified port 3260 is assumed. IPv6 addresses must be  surrounded  by
       square brackets, e.g. [<ipv6 address>]:port. If the destination is empty then any existing redirection is
       cleared.

       --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 show --tid=[id] --user

       show  a  list  of  CHAP  accounts.   If  --tid  is  omitted or [id] is "0" (zero), discovery accounts are
       displayed.

       --op show --tid=[id] --user --params=[user]=[name]

       show CHAP account information for the account specified by  [name].   [user]  can  be  [IncomingUser]  or
       [OutgoingUser].   If --tid is omitted or [id] is "0" (zero), [name] is supposed to be a discovery account
       name.

       --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

KNOWN ISSUES

       •   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@sourceforge.net>.

FILES

       /proc/net/iet/session, /proc/net/iet/volumes

SEE ALSO

       ietd(8),ietd.conf(5)

iSCSI Enterprise Target admin                      2006-06-06                                          IETADM(8)