input/howto/export-iscsi.creole

   1 = Export iSCSI with gustini =
   2 This document describes how to add new new volumes on gustini and add them into the OS.
   3
   4 == via Web-Frontend ==
   5 {{{
   6 * Log into gustini via webfrontend
   7 * Manage
   8   + Volume Management
   9     - add volume
  10       add volume size and name but leave LUN blank (NONE)
  11     - volume mapping
  12       find the next free scsi-lun
  13       * run "multipathd -k" on dijkstra
  14         + show topology
  15         geo2-boot (3600c0ff000d5f6bde2d4cf4901000000) dm-7 HP      ,MSA2012i
  16         [size=245M][features=0][hwhandler=0]
  17         \_ round-robin 0 [prio=0][active]
  18          \_ 1:0:0:1 sda 8:0   [active][ready]
  19          \_ 0:0:0:1 sdb 8:16  [active][ready]
  20                   ^ that is the LUN
  21       find the next unused one and map it
  22   + on dijkstra: rescan the iscsi bus
  23     iscsiadm -m node --targetname "iqn.1986-03.com.hp:storage.msa2012i.0834d5ecda.a" --rescan
  24
  25   + on dijkstra: add aliases to the wwids (show topology)
  26   + on dijkstra: service multipath-tools reload
  27 }}}
  28
  29 == via telnet interface ==
  30 {{{
  31 * Log into gustini via telnet
  32 * create a new volume (eg berlioz-boot) on vdisk giustini-vdisk-1:
  33   + create volume vdisk giustini-vdisk-1 size 256MB berlioz-boot
  34   (there is a 'help create volume' command with lots of informations)
  35 * find the next free LUN numbers on traetta:
  36   + show host-maps traetta
  37 * map the new volume to traetta.debian.org, LUN 12
  38   + map volume berlioz-boot lun 12 host traetta access rw
  39   (again, there is a 'help map volume' command with lots of informations)
  40
  41 * Run 'show host-maps $host' again, then, on the host, run:
  42         convert_sn() {
  43           local sn a b c d
  44           sn="$1"
  45           a="${sn%??????????????????????????}"; sn="${sn#??????}"
  46           b="${sn%????????????????????}"; sn="${sn#??????}"
  47           c="${sn%??????????????}"; sn="${sn#??????}"
  48           d="$sn"
  49
  50           if [ "${c#0000}" = "$c" ]; then
  51             echo >&2 "sn has unexpected value ($1: $a - $b - $c - $d)"
  52             return 1
  53           fi
  54
  55           echo "36${a}000${b}${c#0000}${d}"
  56           return 0
  57         }
  58
  59         parse_volume() {
  60           host=`hostname`
  61           echo "Paste appropriate 'show host-maps $host' output line:"
  62           read name sn id lun access channels
  63
  64           if [ "$access" != "rw" ]; then
  65             echo >&2 "Do not have rw access"
  66             return 1
  67           fi
  68
  69           if [ "$(echo -n "$sn" | wc -c)" != "32" ]; then
  70             echo >&2 "Unexpected sn length in '$sn' (wanted 32 chars)"
  71             return 1
  72           fi
  73
  74           wwid=$(convert_sn "$sn")
  75
  76           if [ -z "$wwid" ]; then
  77             return 1
  78           fi
  79
  80           echo ""
  81           echo "  multipath {"
  82           echo "    wwid $wwid"
  83           echo "    alias $name"
  84           echo "  }"
  85           echo ""
  86
  87           mp="$(multipath -ll $wwid)"
  88           if [ -z "$mp" ]; then
  89             echo >&2 "Warning: multipath does not know about $wwid"
  90             return 1
  91           fi
  92
  93           if ! echo "$mp" | grep -q ":$lun "; then
  94             echo >&2 "Warning: Are you sure $wwid is lun $lun?  multipath -ll disagrees"
  95             return 1
  96           fi
  97         }
  98
  99         parse_volume
 100 }}}