GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  IETADM (8)

NAME

ietadm - iSCSI Enterprise Target Administration Utility.

CONTENTS

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

o ietdadm doesn’t return any human-readable error message, only error codes.
o ietadm doesn’t modify or read the /etc/ietd.conf ietd configuration file.
o ietadm can’t use target names or aliases, only the tid found in /proc/net/iet/volumes.
o /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)
Search for    or go to Top of page |  Section 8 |  Main Index


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

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.