Ubuntu Server Guide

iSCSI Initiator Install
To configure Ubuntu Server as an iSCSI initiator install the open-iscsi package. In a terminal enter:
$ sudo apt i n s t a l l open− i s c s i
Once the package is installed you will find the following files:
• /etc/iscsi/iscsid.conf
• /etc/iscsi/initiatorname.iscsi
iSCSI Initiator Configuration
Configure the main configuration file like the example bellow:
/etc/iscsi/iscsid.conf
### s t a r t u p s e t t i n g s
## w i l l be c o n t r o l l e d by systemd , l e a v e a s i s
i s c s i d . s t a r t u p = / u s r / s b i n / i s c s i d n o d e . s t a r t u p = manual
### chap s e t t i n g s
167

---

# node . s e s s i o n . auth . authmethod = CHAP
## a u t h e n t i c a t i o n o f i n i t i a t o r by t a r g e t ( s e s s i o n )
# node . s e s s i o n . auth . username = username
# node . s e s s i o n . auth . password = password
# d i s c o v e r y . s e n d t a r g e t s . auth . authmethod = CHAP
## a u t h e n t i c a t i o n o f i n i t i a t o r by t a r g e t ( d i s c o v e r y )
# d i s c o v e r y . s e n d t a r g e t s . auth . username = username
# d i s c o v e r y . s e n d t a r g e t s . auth . password = password
### t i m e o u t s
## c o n t r o l how much time i s c s i t a k e s t o p r o p a g a t e an e r r o r t o t h e
## upper l a y e r . i f u s i n g multipath , having 0 h e r e i s d e s i r a b l e
## s o m u l t i p a t h can h a n d l e path e r r o r s a s q u i c k l y a s p o s s i b l e
## ( and d e c i d e t o queue o r not i f m i s s i n g a l l p a t h s )
node . s e s s i o n . timeo . replacement_timeout = 0
node . conn [ 0 ] . timeo . l o g i n _ t i m e o u t = 15
node . conn [ 0 ] . timeo . l o g o u t _ t i m e o u t = 15
## i n t e r v a l f o r a NOP−Out r e q u e s t ( a p i n g t o t h e t a r g e t )
node . conn [ 0 ] . timeo . noop_out_interval = 5
## and how much time t o w a i t b e f o r e d e c l a r i n g a t i m e o u t
node . conn [ 0 ] . timeo . noop_out_timeout = 5
## d e f a u l t t i m e o u t s f o r e r r o r r e c o v e r y l o g i c s ( l u & t g t r e s e t s )
node . s e s s i o n . err_timeo . abort_timeout = 15
node . s e s s i o n . err_timeo . l u _ r e s e t _ t i m e o u t = 30
node . s e s s i o n . err_timeo . t g t _ r e s e t _ t i m e o u t = 30
### r e t r y
node . s e s s i o n . i n i t i a l _ l o g i n _ r e t r y _ m a x = 8
### s e s s i o n and d e v i c e queue depth
node . s e s s i o n . cmds_max = 128
node . s e s s i o n . queue_depth = 32
### p e r f o r m a n c e
node . s e s s i o n . x m i t _ t h r e a d _ p r i o r i t y = −20
and re-start the iSCSI daemon:
$ s y s t e m c t l r e s t a r t i s c s i d . s e r v i c e
This will set basic things up for the rest of configuration.
The other file mentioned:
168

---

/etc/iscsi/initiatorname.iscsi
I n i t i a t o r N a m e=i q n .1993 −08. o r g . d e b i a n : 0 1 : 6 0 f 3 5 1 7 8 8 4 c 3
contains this node’s initiator name and is generated during open-iscsi package installation. If you
modify this setting, make sure that you don’t have duplicates in the same iSCSI SAN (Storage
Area Network).