Linux iSCSI Target (tgt) - Revision history

Sertonix: use path, cmd & cat template

2023-09-13T15:06:31Z

use path, cmd & cat template

Forza: /* Installation */

2023-08-08T11:08:21Z

Installation

← Older revision		Revision as of 11:08, 8 August 2023
Line 13:		Line 13:

	To install scsi-tgt and the utilities to configure tgt:		To install scsi-tgt and the utilities to configure tgt:
	# apk add scsi-tgt scsi-tgt-scripts ~~scsi-tgt-openrc~~		# apk add scsi-tgt scsi-tgt-scripts

	{{note\|Note that without setting up the configuration file {{ic\|/etc/tgt/targets.conf}} first, the {{ic\|tgtd}} daemon will run with an empty configuration}}		{{note\|Note that without setting up the configuration file {{ic\|/etc/tgt/targets.conf}} first, the {{ic\|tgtd}} daemon will run with an empty configuration}}

Forza: /* Sample configuration */

2023-08-07T21:16:12Z

Sample configuration

← Older revision		Revision as of 21:16, 7 August 2023
Line 60:		Line 60:
	</backing-store>		</backing-store>
	</target>		</target>
			[[File:ISCSI device in Windows Device Management.png\|thumb\|A Windows initiator connected to an Alpine Linux iSCSI target. The virtual disk looks like a locally connected HDD.]]

	== tgt-admin ==		== tgt-admin ==

Forza: /* tgt-admin examples */

2023-08-07T21:15:32Z

tgt-admin examples

← Older revision		Revision as of 21:15, 7 August 2023
Line 78:		Line 78:

	=== tgt-admin examples ===		=== tgt-admin examples ===
	~~[[File:ISCSI device in Windows Device Management.png\|thumb\|right\|A Windows initiator connected to an Alpine Linux iSCSI target. The virtual disk looks like a locally connected HDD.]]~~
	To see the status of the running configuration, use the {{ic\|tgt-admin -s}} command:		To see the status of the running configuration, use the {{ic\|tgt-admin -s}} command:
	# tgt-admin -s		# tgt-admin -s

Forza: /* tgt-admin examples */

2023-08-07T21:11:51Z

tgt-admin examples

← Older revision		Revision as of 21:11, 7 August 2023
Line 78:		Line 78:

	=== tgt-admin examples ===		=== tgt-admin examples ===
			[[File:ISCSI device in Windows Device Management.png\|thumb\|right\|A Windows initiator connected to an Alpine Linux iSCSI target. The virtual disk looks like a locally connected HDD.]]
	To see the status of the running configuration, use the {{ic\|tgt-admin -s}} command:		To see the status of the running configuration, use the {{ic\|tgt-admin -s}} command:

	# tgt-admin -s		# tgt-admin -s
	Target 1: iqn.2023-07.net.tnonline.wiki:server.target1		Target 1: iqn.2023-07.net.tnonline.wiki:server.target1

Zcrayfish: /* Installation */ typo corrected :)

2023-08-07T19:34:26Z

Installation: typo corrected :)

← Older revision		Revision as of 19:34, 7 August 2023
Line 2:		Line 2:

	== Installation ==		== Installation ==
	I Alpine, {{ic\|scsi-tgt}} is split over several packages:		In Alpine, {{ic\|scsi-tgt}} is split over several packages:
	* {{pkg\|scsi-tgt}} - the tgtd daemon.		* {{pkg\|scsi-tgt}} - the tgtd daemon.
	* {{pkg\|scsi-tgt-scripts}} - tgt-admin helper utility. Makes it easier to configure targets via config files.		* {{pkg\|scsi-tgt-scripts}} - tgt-admin helper utility. Makes it easier to configure targets via config files.

Forza: /* Installation */

2023-08-07T13:49:08Z

Installation

← Older revision		Revision as of 13:49, 7 August 2023
Line 2:		Line 2:

	== Installation ==		== Installation ==
	I Alpine, {{~~pkg~~\|scsi-tgt}} is split over several packages:		I Alpine, {{ic\|scsi-tgt}} is split over several packages:
	* {{pkg\|scsi-tgt}} - the tgtd daemon.		* {{pkg\|scsi-tgt}} - the tgtd daemon.
	* {{pkg\|scsi-tgt-scripts}} - tgt-admin helper utility. Makes it easier to configure targets via config files.		* {{pkg\|scsi-tgt-scripts}} - tgt-admin helper utility. Makes it easier to configure targets via config files.

Forza: /* installation */

2023-08-07T13:48:19Z

installation

← Older revision		Revision as of 13:48, 7 August 2023
Line 1:		Line 1:
	The Linux target framework (tgt) is a user space SCSI target framework that supports the iSCSI and iSER transport protocols and that supports multiple methods for accessing block storage. tgt consists of user-space daemon and tools. Being a user space server, it does not require a kernel module to run. In Alpine Linux, the package is called {{pkg\|scsi-tgt}}		The Linux target framework (tgt) is a user space SCSI target framework that supports the iSCSI and iSER transport protocols and that supports multiple methods for accessing block storage. tgt consists of user-space daemon and tools. Being a user space server, it does not require a kernel module to run. In Alpine Linux, the package is called {{pkg\|scsi-tgt}}

	== ~~installation~~ ==		== Installation ==
	I Alpine, {{pkg\|scsi-tgt}} is split over several packages:		I Alpine, {{pkg\|scsi-tgt}} is split over several packages:
	* {{pkg\|scsi-tgt}} - the tgtd daemon.		* {{pkg\|scsi-tgt}} - the tgtd daemon.

Forza: /* installation */

2023-08-07T13:45:59Z

installation

← Older revision		Revision as of 13:45, 7 August 2023
Line 2:		Line 2:

	== installation ==		== installation ==
	~~Install~~ the utilities to configure tgt:		I Alpine, {{pkg\|scsi-tgt}} is split over several packages:
	# apk add scsi-tgt scsi-tgt-scripts		* {{pkg\|scsi-tgt}} - the tgtd daemon.
			* {{pkg\|scsi-tgt-scripts}} - tgt-admin helper utility. Makes it easier to configure targets via config files.
			* {{pkg\|scsi-tgt-doc}} - documentation, man pages and example configurations.
			* {{pkg\|scsi-tgt-openrc}} - init scripts for runnit tgt as a service.

			Only {{pkg\|scsi-tgt}} is required to run the tgt target daemon. A running daemon can be configured with {{ic\|tgtadm}} command line tool. However, if you want to use configuration files you need the {{ic\|tgt-admin}} helper tool, which reads the config and emits appropriate {{ic\|tgtadm}} commands. The tgt-admin tool is written in perl, and so depends on perl being installed, which is why we have it as a separate package.

			This guide assumes that you want to configure iSCSI targets via a configuration file, and have it automatically start during boot.

			To install scsi-tgt and the utilities to configure tgt:
			# apk add scsi-tgt scsi-tgt-scripts scsi-tgt-openrc

			{{note\|Note that without setting up the configuration file {{ic\|/etc/tgt/targets.conf}} first, the {{ic\|tgtd}} daemon will run with an empty configuration}}

			Once you have editited the configuration file, you can activate the service with
	# rc-update add tgt-admin		# rc-update add tgt-admin
	# service tgt-admin start		# service tgt-admin start

	~~{{note\|Note that without setting up the configuration file {{ic\|/etc/tgt/targets.conf}} first, the {{ic\|tgtd}} daemon will run with an empty configuration}}~~

	=== Sample configuration ===		=== Sample configuration ===
Line 48:		Line 60:
	</backing-store>		</backing-store>
	</target>		</target>


	== tgt-admin ==		== tgt-admin ==

Forza: Spelling

2023-08-05T10:10:22Z

Spelling

← Older revision		Revision as of 10:10, 5 August 2023
Line 111:		Line 111:
	If you want to see that native commands are needed you can use the {{ic\|--verbose}} option.		If you want to see that native commands are needed you can use the {{ic\|--verbose}} option.

	Here you can see the the ~~actuall~~ commands used when issuing {{ic\|tgt-admin --update ALL --verbose}}:		Here you can see the the actual commands used when issuing {{ic\|tgt-admin --update ALL --verbose}}:
	# Removing target: iqn.2023-07.net.tnonline.wiki:server.target1		# Removing target: iqn.2023-07.net.tnonline.wiki:server.target1
	tgtadm -C 0 --mode target --op delete --tid=1		tgtadm -C 0 --mode target --op delete --tid=1