Veritas NetBackup™ Appliance Commands Reference Guide
- Overview
- Appendix A. Main > Appliance commands
- Appendix B. Main > Manage > FibreChannel commands
- Appendix C. Main > Manage > HighAvailability commands
- Appendix D. Main > Manage > Libraries commands
- Appendix E. Main > Manage > Libraries > Advanced > ACS commands
- Appendix F. Main > Manage > License commands
- Appendix G. Main > Manage > MountPoints commands
- Appendix H. Main > Manage > NetBackup CLI commands
- Appendix I. Main > Manage > OpenStorage commands
- Appendix J. Main > Manage > Software commands
- Appendix K. Main > Manage > Storage commands
- Appendix L. Main > Manage > Tapes commands
- Appendix M. Main > Manage > Certificates commands
- Appendix N. Main > Monitor commands
- Appendix O. Main > Network commands
- Appendix P. Main > Network > Security commands (IPsec)
- Appendix Q. Main > Reports commands
- Appendix R. Main > Settings commands
- Appendix S. Main > Settings > Alerts commands
- Appendix T. Main > Settings > Notifications view commands
- Appendix U. Main > Settings > Security commands
- Appendix V. Main > Support commands
Name
Main > Settings > iSCSI > Target — These commands help you to manage the connections between an initiator and targets.
SYNOPSIS
Target Discover Portal IP: [port] Interface name
Target Discover iSNS iSNS address Interface name
Target Connect Target IQN
Target Disconnect Target IQN
Target Show All
Target Show Connected
DESCRIPTION
The iSCSI Target Connect or iSCSI Target Disconnect commands can help you to connect to or disconnect from a target device.
You can discover targets by using the target portal address or the iSNS address (Internet Storage Name Service).
The Target Discover Portal command can help you discover targets by using the target portal address.
The Target Discover iSNS command can help you discover targets by using the iSNS server.
The Target Show command displays all of the targets or the connected targets.
OPTIONS
- Target Discover Portal IP: [port] Interface name
Run this command to discover iSCSI targets by using the target portal address. You are asked to provide a username and password. Type
if your target requires authentication. The targets that are available on the specified portal address and interface are discovered and displayed.Note the following considerations:
The target portal address must be of the following format: <IPv4 address/hostname>[:port]. The host name can be a short name or a fully qualified domain name. Example: 192.116.116.50 or abc:3260.
The iSCSI interface name can only contain numbers (0-9), letters (A-Z and a-z), colons (:), hyphens (-), under scrores (_) and periods (.) It must begin with numbers (0-9), letters (A-Z and a-z) and underscores (_) only.
You must first discover a target in order to connect to it.
Note:
If you run the Target Discover Portal or the following Target Discover iSNS command again after the targets are connected, it overrides the existing connection settings like target credentials. If the target requires authentication, you need to enter the target credentials again when the existing sessions are reconnected. The existing sessions need to be reconnected if the appliance restarts, or when you change the IQN for the appliance, or when the iSCSI processes are restarted, etc.
- Target Discover iSNS iSNS address Interface name
Use this command to discover iSCSI targets by using the Internet storage name service (iSNS) method. Use this method if you have at least one iSNS server on your network. This method enables the iSCSI initiator to discover targets that are registered to the iSNS server. You must supply the iSNS server address and/or port. The iSCSI initiator can then query the specified iSNS server to discover targets. The default port for an iSNS server is 3205.
- Target Connect Target IQN [Portal Address] [Interface Name]
After initiator and target connections are discovered, iSCSI initiators must be logged on to targets to establish connections and transfer data over iSCSI. To connect an initiator to a single target, specify the target IQN. Optionally, you may enter the portal address and the iSCSI interface name. Enter a user name and password if the target needs authentication.
Note the following about IQN, portal address, and user name:
The IQN can only contain numbers (0-9), letters (A-Z and a-z), colons (:), hyphens (-), and periods (.) Example: iqn.1999-06.com.veritas:storage.lun1
The target portal address must be of the following format: <IP address/hostname>[:port]. Only IPv4 addresses are supported. The host name can be a short name or a fully qualified domain name. Example: 192.116.116.50 or abc:3260.
The user name can only contain numbers (0-9), letters (A-Z and a-z), hyphens (-), underscrores (_), and periods (.). It must begin with numbers (0-9), letters (A-Z and a-z), and underscores (_) only. Example: john.smith.
- Target Disconnect Target IQN Portal Address
Disconnects the target session that has the specific IQN and portal address. Other sessions that are connected to the target will not be affected.
- Target Show All
Use this command to view all the discovered targets.
Note:
When targets are discovered by using iSNS on two iSCSI interfaces like first run theTarget Discover iSNS command for iscsi1 and then iscsi2, only the recent record is displayed by the Target Show All command. For example, the column in the Target Show All command may not show both the interfaces (iscsi1, iscsi2) for some targets. It actually shows the interface from the most recent command (iscsi2 in this case) for some targets.
- Target Show Connected
Use this command to view the connected targets.
EXAMPLES
The following are example outputs when you run the iSCSI > Target command:
appliance.iSCSI> Target Discover Portal 10.182.35.51 iscsi1 Does your target require a username and password? (yes,no)[no]:no Showing the discovered targets... +-----+------------------------|---------------------|----------------+ | No. | Target IQN |Target Portal Address| Interfaces | +-----+------------------------|---------------------|----------------| | 1 |iqn.1996-03.veritas:abc | 10.121.98.22:3260 | iscsi1, iscsi2 | +-----+------------------------|---------------------|----------------| | 2 |iqn.1996-03.veritas:xyz | 10.121.98.23:3260 | iscsi1, iscsi2 | +-----+------------------------|---------------------|----------------+ | 3 |iqn.1996-03.veritas:host| 10.121.98.24:3260 | iscsi1, iscsi2 | ------|------------------------|---------------------|----------------|
appliance.iSCSI > Target Show All Showing all the targets... +-----+------------------------|---------------------|----------------+ | No. | Target IQN |Target Portal Address|Interfaces | +-----+------------------------|---------------------|----------------| | 1 |iqn.1996-03.veritas:abc | 10.121.98.22:3260 | iscsi1 | +-----+------------------------|---------------------|----------------| | 2 |iqn.1996-03.veritas:xyz | 10.121.98.23:3260 | iscsi1 | +-----+------------------------|---------------------|----------------+ | 3 |iqn.1996-03.veritas:host| 10.121.98.24:3260 | iscsi1 | ------|------------------------|---------------------|----------------|