warren/libiscsi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document the iSCSI URL syntax and how to specify username/password

Browse Source
This commit is contained in:
Ronnie Sahlberg
2011-01-03 15:10:15 +11:00
parent 178f9c8751
commit 51662af5ba
1 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README
+17
View File
@@ -34,3 +34,20 @@ Build RPM
To build RPMs run the following script from the libiscsi root directory To build RPMs run the following script from the libiscsi root directory
./packaging/RPM/makerpms.sh ./packaging/RPM/makerpms.sh
iSCSI URL Format
================
iSCSI devices are specified by a URL format on the following form :
iscsi://[<username>[%<password>]@]<host>[:<port>]/<target-iqn>/<lun>
Example:
iscsi://server/iqn.ronnie.test/1
When using CHAP authentication, username and password can be specified as part of the URL
iscsi://ronnie%password@server/iqn.ronnie.test/1
but this may make the user and password visible in log files as well as in ps aux output.
So it is also possible to provide either just the password or both the password and username
via environment variables.
The username and/or password can be set via
LIBISCSI_CHAP_USERNAME=ronnie
LIBISCSI_CHAP_PASSWORD=password
Example:
LIBISCSI_CHAP_PASSWORD=password iscsi-inq iscsi://ronnie@10.1.1.27/iqn.ronnie.test/1