summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* iscsiadm: add new discovery modeMike Christie2010-07-011-9/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | I really screwed up the old discovery mode record handling. This adds a discovery2 mode, which adds back the old features that got killed over time, and supports the new ones. iscsiadm -m discovery2 -t st -p ip:port --discover will discover targets like before. Note that you must pass in the --discover argument. This will try to read a record for [-t st -p ip:port]. If found it will use those settings. If not found then it will create a record using iscsid.conf discovery.* settings and use them. Note that iscsiadm -m discovery2 -t st -p ip:port will no longer perform discovery (yuou must pass the --discover arguement), because the type and portal [-t st -p ip:port] is now used as the record id. So the above command will now print out the record values. What is being added is discovery record support. iscsiadm -m discovery2 -o new -t st -p ip:port will create a record for [-t st -p ip:port]. You can then use iscsiadm -m discovery2 -o -t st -p ip:port -o update \ -n name -v value to set the settings for the discovery record with id [-t st -p ip:port]. You can also then do more advanced commands like before iscsiadm -m discovery2 -t st -p ip:port -o new -o delete --discover will do discovery and add new portals and delete portals that are no longer returned.
* iscsiadm: fix discovery record managementMike Christie2010-07-011-2/+9
| | | | | | | | | | | | | | | | | | | We recently added the ability to use and update discovery records. when this was done, we had iscsiadm -m discovery -t st -p ip:port use the record value if found. This will break compat with older releases and it is a little strange because iscsiadm -m discovery -p ip:port [ -o ... | -l ] works on or uses the discovery record. So this patch reverts iscsiadm behavior so that iscsiadm -m discovery -t st -p ip:port uses the iscsid.conf settings, and adds a new --discover|-D command that can be used to force discovery. iscsiadm -m discovery -p ip:port --discover will force discovery using the record with the ID ip:port.
* iscsi tools: use open-isns servicesMike Christie2010-03-221-6/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This replaces the native isns code with open-isns's libisns. I included the open-isns code in the open-iscsi tarball to make distribution easier since some distros use different isns clients and may not want to carry open-isns. This is based on open-isns commit 5e09f36d3446e41de0b8361601ffec4cd140d513. Changes in iSNS behavior/use: - To do discovery you must pass the ip and optionally the port to iscsiadm: iscsiadm -m discovery -t st -p 10.15.0.9 This command accepts the same ops as sendtargets so you can add/remove/update the node records that are created. It also supports ifaces properly now. - isns.address and isns.port in iscsid.conf are no longer used. - ESI is temporarily not supported. This will be fixed in the next patch when SCNs support is added. - The iscsiadm isns discovery command is not marked as stable. Signed-off-by: Mike Christie <michaelc@cs.wisc.edu>
* iscsiadm: add nonpersistent mode to discovery modeMike Christie2010-03-221-1/+3
| | | | | | | | | | | | | | | | | | | | The default behavior for iscsiadm discovery mode is to store the portals found in the node DB. This adds a op "nonpersistent" to run iscsiadm discovery in a nonpersistent mode. In thos mode iscsiadm will not access the node DB. iscsiadm -m discovery -t st -p ip -o nonpersistent will just print out the portals found. icssiadm -m discovery -t st -p ip -o nonpersistent -l will print out the portals found and login. If this command is run to logout you must run in session mode. iscsiadm -m session -u would logout all the sessions.
* minor manpage updatesRitesh Raj Sarraf2010-02-252-25/+25
| | | | Signed-off-by: Ritesh Raj Sarraf <rsarraf@netapp.com>
* doc: add iscsi-iname man pageMike Christie2010-01-151-0/+22
| | | | Add iscsi-iname man page
* doc: add iscsistart man pageMike Christie2010-01-151-0/+67
| | | | Add iscsistart man page.
* iscsiadm: fix discovery record useMike Christie2009-10-111-2/+2
| | | | | | | | | | | | | | | | | | iscsiadm is not using the discovery record settings. This has iscsiadm -m discovery -t st -p ip:port search for a discovery setting for ip:port. If found it will use those values for discovery. Previously it would always use the iscsid.conf settings. To change the discovery settings for a record you can do iscsiadm -m discovery -p ip:port -o update -n setting_name -v value like in node mode. Or you can completely remove the discovery record and targets found through it by doing iscsiadm -m discovery -p ip:port -o delete then run the discovery command which will then use the iscsid.conf values and create a new discovery record.
* iscsiadm: add host modeMike Christie2009-05-101-2/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This prints out the info for iSCSI hosts in the system. EXAMPLE ------- iscsiadm -m host cxgb3i: [9] 10.10.15.50,[00:07:43:05:97:07],eth3 <empty> $TRANSPORT: [$HOST_NO] $HOST_IP,[$MAC},$NETDEV $INITIATORNAME EXAMPLE --------- iscsiadm -m host -P 2 Host Number: 9 State: running Transport: cxgb3i Initiatorname: <empty> IPaddress: 10.10.15.50 HWaddress: 00:07:43:05:97:07 Netdev: eth3 ********* Sessions: ********* Target: iqn.2001-04.com.home:meanminna Current Portal: 10.10.15.10:3260,1 Persistent Portal: 10.10.15.10:3260,1 ********** Interface: ********** Iface Name: cxgb3i Iface Transport: cxgb3i Iface Initiatorname: iqn.2005-06.com.redhat:noisymax Iface IPaddress: 10.10.15.50 Iface HWaddress: 00:07:43:05:97:07 Iface Netdev: eth3 SID: 8 iSCSI Connection State: LOGGED IN iSCSI Session State: LOGGED_IN Internal iscsid Session State: NO CHANGE ********** Interface: ********** Iface Name: cxgb3i.def Iface Transport: cxgb3i Iface Initiatorname: iqn.2005-06.com.redhat:madmax Iface IPaddress: 10.10.15.50 Iface HWaddress: 00:07:43:05:97:07 Iface Netdev: eth3 SID: 9 iSCSI Connection State: LOGGED IN iSCSI Session State: LOGGED_IN Internal iscsid Session State: NO CHANGE
* docs: fix up iscsiadm man page iface infoMike Christie2009-02-211-1/+2
| | | | | | When the offload iface settings changed the doc page got misedited. This should fix it and add some info on what the hw address is.
* userspace - add new transport cxgb3iKaren Xie2008-12-051-4/+3
| | | | | | | | | added new transport cxgb3i. This patch is based on the master branch of the git tree. Signed-off-by: Karen Xie <kxie@chelsio.com> Signed-off-by: Mike Christie <michaelc@cs.wisc.edu>
* Minor fixes in iscsi_discovery documentationErez Zilber2008-10-221-5/+5
| | | | | | | Some changes that were made in iscsi_discovery were not reflected in the docs. Signed-off-by: Erez Zilber <erezzi.list@gmail.com>
* Fix transport_name compat support.Mike Christie2008-06-131-7/+8
| | | | | | | | This lists the default iface stuff as unstable and adds back support for node.transport_name and iface.transport_name. We will not merge Doran's patch for now because I just do not have time to deal with regressions., but I am adding in a hack to make sure we do not change the transport name while a session is running.
* disable iscsi_discovery qla4xxx supportMike Christie2008-04-081-1/+1
| | | | | | iscsi_discovery is not familiar with qla4xxx and cannot just set the transport name for it. This patch removes mentions of qla4xxx in the script.
* Add additional flags to iscsi_discoveryMike Christie2008-04-081-14/+27
| | | | | | | | | | | | | | | | | From Doron: Add additional flag: -t set trasnpot (default is tcp). -f force specific transport -disable the fallback to tcp (default is fallback enabled). force the transport specified by the argument of the -t flag. -m manual startup - will set manual startup (default is automatic startup). -l login - login to the new discovered nodes (defualt is false). Signed-off-by: Doron Shoham <dorons@voltaire.com> Signed-off-by: Erez Zilber <erezz@voltaire.com> Minor teak to get it merged from Mike Christie.
* Add options to modify the db manipulation behavior during discoveryMike Christie2008-02-201-7/+5
| | | | | | | | | | | | Instead of overwriting existing node records, you can modify the behavior by passing in different ops. Pass -o new to add new nodes. Pass -o delete to delete stale ones. Pass -o update to update the records of existing nodes. And pass combos of different ops for different behavior. Signed-off-by: Mike Christie <michaelc@cs.wisc.edu>
* Add iscsiadm -m fw -l commandMike Christie2008-01-221-2/+2
| | | | | | We can do iscsiadm -m node -l, and this logs into all the portals in the db. This patch adds the equivalent for fw mode.
* add SIGTERM iscsid handler and iscsiadm command to stop iscsidMike Christie2007-10-291-0/+10
| | | | | | | | | | | | You can now do killall iscsid or iscsiadm -k 0 to stop iscsid. This should not normally be done, because iscsid is required for normal initiator behavior. It is mostly for testing, iscsi boot or system shutdown. TODO: - more testing. I am pretty sure the original code is broken. For exmaple sending a SIGTERM to the log process then the daemon process will cause semop errors.
* fix up iscsiadm's debug_level documentationMike Christie2007-08-011-6/+6
| | | | | the iscsiadm man page and --help option do not list the debug_level argument.
* fix iscsid debug option documentationMike Christie2007-07-311-2/+2
| | | | iscsid's man page does not document the debug_level argument.
* make fw bits more iscsiadmishMike Christie2007-07-251-4/+23
| | | | | | | | | | | | | | | | | | | | | | | | This make the fw bits more iscsiadmish (adds new fw mode), and adds iscsiadm man page documentation. If you run iscsiadm -m discovery -t fw This will print out the portals in the fw. If you run iscsiadm -m discovery -t fw -l This will print them out and log into them. If you run iscsiadm -m fw This will print out the all fw values we copied in the open-iscsi node format, so tools can parse them like normal old node/discovery records.
* fix up iface mode, so it takes care of most of the grunt work and does lots ↵mnc2007-06-121-6/+8
| | | | | | of checks so users cannot really mess things up - hopefully git-svn-id: svn://svn.berlios.de/open-iscsi@861 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* Support bind by hw address or netdev (ip address is temp disabled because ↵mnc2007-05-301-22/+28
| | | | | | targets are not handling it well) and use the iface argument instead of the actual values git-svn-id: svn://svn.berlios.de/open-iscsi@845 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* Rename iface.name to iface.hwaddress and make transport name part of the ↵mnc2007-04-241-5/+39
| | | | | | iface (driver and hardware are bound). Also merge the -D and -I arguments so they are now -I driver,hwaddress. Also add some basic qla4xxx support. We can rescan/scan it and perform sendtargets through it but it stores the targets it finds in Flash and then logs into all of them autmatically (when we do discovery and later when reload the driver). So qla4xxx support is mostly to make sure we have the --interfae argument right. We will have to decide how to set other params, manage nodes, and if we should move scanning to the kernel and then also move some error recovery code to the kernel (today qla4xxx is calling block directly and is not able to export it iscsi state yet (the beginnings to fix that is in the git tree but we still need to reduce some code duplcation)). qla4xxx behavior and functionality is going to change as we learn more about the hw (what format the flash data is supposed to be in for example). git-svn-id: svn://svn.berlios.de/open-iscsi@816 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* add some discovery compat code. Use --print=1 if you want the tree output, ↵mnc2007-04-241-2/+3
| | | | | | else we get the old style by default git-svn-id: svn://svn.berlios.de/open-iscsi@811 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* This patch allows you to pass in any record id values (interface, ↵mnc2007-04-241-2/+1
| | | | | | targetname, portal) and iscsiadm will match the values passed in with node db entries or running sessions (depends on the mode) and execute the op on it git-svn-id: svn://svn.berlios.de/open-iscsi@807 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* merge node and session mode ops. session node takes a sysfs id or nothing ↵mnc2007-04-241-7/+6
| | | | | | and node mode takes the node record id values or nothing git-svn-id: svn://svn.berlios.de/open-iscsi@805 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* move --info output to common --print output.mnc2007-04-241-8/+0
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@802 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* some doc updatesmnc2007-04-241-2/+7
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@780 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* what is a node in open-iscsi terms (when open-iscsi states node it means ↵mnc2007-02-101-0/+10
| | | | | | portal :)) git-svn-id: svn://svn.berlios.de/open-iscsi@770 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* add some more comments to docs to doc -r sysfsdir and remove --map. Also add ↵mnc2007-02-081-6/+13
| | | | | | some notes about --targetname and --portal usage git-svn-id: svn://svn.berlios.de/open-iscsi@769 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from tomo: add basic isns supportmnc2007-01-271-10/+10
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@766 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* rm --map and replace with -m session -rmnc2006-11-221-19/+10
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@735 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* add -m session --info commandmnc2006-11-221-0/+8
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@734 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* add -m session --rescan commandmnc2006-11-221-1/+8
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@733 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* fixup login/logout docmnc2006-11-091-3/+3
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@726 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* add login/logout all commandsmnc2006-11-081-1/+18
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@722 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* update docs to show that files have movedmnc2006-10-131-5/+5
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@710 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from albert: update iscsiadm manmnc2006-09-021-18/+23
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@688 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from patmans@us.ibm.com: Add a -M --map sys option, so we can select a ↵mnc2006-05-281-1/+12
| | | | | | record based on the sysfs directory rather than a record id (maps a sysfs open-iscsi directory to a open-iscsi record). git-svn-id: svn://svn.berlios.de/open-iscsi@592 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from patmans@us.ibm.com: Add the iscsiadm option --show or -S to display the ↵mnc2006-05-281-1/+8
| | | | | | chap secret/password, mainly so it can be automatically retrieved, mainly by mkinitrd for use by iscsistart in an initrd. git-svn-id: svn://svn.berlios.de/open-iscsi@591 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from patmans@us.ibm.com: Add a more detailed synopsis, and output the ↵mnc2006-05-281-2/+8
| | | | | | synopsis for iscsiadm -h. git-svn-id: svn://svn.berlios.de/open-iscsi@590 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from patmans@us.ibm.com: add examples to sicsiadm manmnc2006-05-281-0/+33
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@589 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from patmans@us.ibm.com: fixup iscsiadm man pagemnc2006-05-281-79/+94
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@588 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from danb@voltaire.com: add iscsi discovery scriptmnc2006-05-271-0/+39
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@582 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from patmans@us.ibm.com: Fix man iscsiadm output to including some missing ↵mnc2006-04-272-81/+25
| | | | | | text by using \fI \fR for underlines instead of .I. Change iscsid for consistency (this patch doesn't change man iscsid outputat all). git-svn-id: svn://svn.berlios.de/open-iscsi@556 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from hare@suse.de: document disocvery typesmnc2006-04-271-0/+34
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@550 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* from robbat2@gentoo.org: Cleanup of manpages. - Remove old iscsid.conf ↵mnc2006-02-152-4/+30
| | | | | | references. - Document -u/-l short options for iscsiadm login/logout. - Fix FILES section of iscsiadm. - Add initial manpage for iscsistart ;-) . Signed-off-by: Robin H. Johnson <robbat2@gentoo.org> git-svn-id: svn://svn.berlios.de/open-iscsi@492 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* run dos to unix on our docsmnc2006-02-152-223/+223
| | | | git-svn-id: svn://svn.berlios.de/open-iscsi@491 d7303112-9cec-0310-bdd2-e83a94d6c2b6
* Hannes Reinecke: iscsid and iscsiadm manpages, initial revisionaaizman2005-08-222-0/+223
git-svn-id: svn://svn.berlios.de/open-iscsi@404 d7303112-9cec-0310-bdd2-e83a94d6c2b6