iscsi_config.8

iscsi源代码 UNH的progect 有initiator端和target端的源码

.\* /***************************************************************************
.\"     Copyright 2003 HP-UNH
.\" ***************************************************************************/
.TH ISCSI_CONFIG 8 "10 Jan 2004" "Linux" "UNH-iSCSI"
.UC 4
.SH NAME
iscsi_config \- a tool to specify iSCSI targets to the UNH iSCSI Initiator and establish iSCSI sessions.
.SH SYNOPSIS
iscsi_config up/down [ip=<address/name>] [port=<no>] [target=<no>] [lun=<number>]
.SH DESCRIPTION
iscsi_config is a tool to specify iSCSI targets to the UNH iSCSI
Initiator module to establish iSCSI protocol operations. It uses iSCSI 
parameters that have been set using iscsi_manage(8). 
.SH OPTIONS

The iscsi_config command is invoked with at least one 
of the following arguments given below.
.nf
.IP "[up/down]" 
This mandatory parameter determines whether an iSCSI 
session has to be established between an iSCSI initiator and an 
iSCSI target or whether an existing iSCSI session needs to be 
closed. It can be one of the following:

.nf
up   \- an iSCSI session needs to be established.
down \- an iSCSI session needs to be closed.
.fi



.IP "[host=number]" 
This is an optional parameter. If omitted assumes a value of 0. This value 
specifies the Host SCSI Adapter (HBA) number assigned by the kernel 
to the iSCSI initiator. This number can be determined by examining 
the /proc/scsi/iscsi_initiator directory.


.IP "[ip=<address/name>]" 
This optional field specifies the IP address or name of the iSCSI 
target to which a connection has to be established. If omitted, 
the local IP address is assumed.

.IP "[port=number]"
This parameter specifies the TCP port on which the iSCSI target is listening. 
If omitted assumes the port number of 3260.

.IP "[target=number]"
This is an optional field that specifies the target number (id number in 
hierarchical addressing scheme for Linux SCSI devices) for the target that 
the initiator is connecting to. 

.IP "[lun=number]"
This parameter specifies a specific LUN on the target that the 
initiator connects to.  If omitted, all LUNs offered by the 
target are connected.

.if


.SH EXAMPLES


.nf


*   The minimal iSCSI setup would involve connecting to
    an iSCSI target with no negotiations:

     iscsi_manage init restore host=1
     iscsi_manage init set InitiatorName=`uname -n` host=1
     iscsi_manage init set TargetName=MyTarget host=1
     iscsi_manage init set SessionType=Normal  host=1
     iscsi_config up ip=123.45.67.89  port=3260 host=1 lun=1

    If the iscsi_config request has activated a target that
    resides at the server 123.45.67.89, listening on port 3260, 
    a disk will appear as /dev/sdb or /dev/sdc, 
    etc., depending on how many other scsi disks have 
    been activated prior to issuing the iscsi_config command.  
    These names are printed by the SCSI subsystem in the 
    /var/log/messages file after a successful login.

    Once an iSCSI device is created, other disk 
    management commands such as fdisk(8) and mkfs(8) can 
    be used against the new device.

*  Session Termination

     iscsi_config down ip=123.45.67.89

*  Multiple Sessons and Connections  

   The general form of parameters to iscsi_config are:

    iscsi_config up ip=123.45.67.089 port=5142 host=1 target=2 lun=3 cid=4
  or
    iscsi_config down host=1 target=2 lun=3 cid=4

   Where the "up" or "down" parameter is required. 
   If any other parameter is missing, its value defaults to 0.

   The ip and port numbers are used to locate the target 
   session) associated with the device. The lun and cid 
   locate the logical lun and connection.


*  to add a new session to an already established iSCSI target:

     iscsi_config up ip=123.45.67.89  host=1 lun=2


*  If the iSCSI Target supports multiple connections to the same lun:

     iscsi_manage init restore host=1
     iscsi_manage init set InitiatorName=`uname -n` host=1
     iscsi_manage init set TargetName=MyTarget host=1
     iscsi_manage init set SessionType=Normal  host=1
     iscsi_manage init set MaxConnections=2  host=1
     iscsi_config up ip=123.45.67.89  host=1 lun=1

     iscsi_manage init restore host=1
     iscsi_manage init set InitiatorName=`uname -n` host=1
     iscsi_manage init set TargetName=MyTarget host=1
     iscsi_config up ip=123.45.67.89  host=1 lun=1 cid=2


.fi


.SH NOTES
The iscsi_manage and iscsi_config commands are typically executed from the 
UNH startup scripts found at /opt/unh/iscsi/conf. 

.SH REPORTING BUGS
Report bugs to <[e-mail]>
.SH COPYRIGHT
Copyright (c) 2003 UNH Interoperability Labs.
This is free software; see the source for copying conditions.  There is NO warranty; not even for MERCHANTABILITY 
or FITNESS FOR  A  PARTICULAR PURPOSE.

.SH SEE ALSO
iscsi_manage(8) fdisk(8) mkfs(8)