Sun Microsystems Virtual Tape Library manual

Submit comments about thi s document at: glsfs@sun.com Sun Microsystems, In c. www.sun.com Virtual Tape Library VTL User Guide Part No. 9626 7 May 2008, Revision G[...]

Sun Microsystems, Inc. has intellectual pr op erty rights relating to tech nol ogy that is described i n this document. In particula r , and without limitation, these intellectual property right s may include one or more of the U.S. pa tents listed at http://www .sun.com/patents and one or more additional patents or pending patent app lications i n[...]

96267 • G iii Revision History Short Name Part # Revision Date Comments VTL User Guide 96267 Nov 2006 Base document supplied by the vendor . A Jan 2007 Major revision. B Mar 2007 Published. EC 131376. C Aug 2007 Major revision. D Nov 2007 Minor revision. E Feb 2008 Major revision to cover VTL Plus 2.0 F Mar 2008 Major revision to the commandline [...]

iv VTL User Guide • May 2008 G • 96267[...]

96267 • G v Contents About this book xi 1. Introduction:  VTL  appliances  and  enterprise  data ‐ protection 1 Features 2 Advantages  of  VTL  tape  virtualization 4 Shorter  runtimes  and  reduced  dependency  on  backup  windows 4 Shorter  run  times  for  non ‐ sequential  bac[...]

vi VTL User Guide • May 2008 G • 96267 2. Understanding  VTL  Zoning 15 Zoning  for  standard ‐ av ailability  systems 15 Zoning  for  high ‐ av ailability  systems 16 3. Us ing  the  VTL  console 19 Running  the  VTL  console  application 20 Populating  the  console 20 Understanding  th[...]

96267 • G Contents vii Copying  tapes 104 Moving  tapes  between  virtual  and  physical  libraries 107 Managing  tape  caching 120 Creating  and  viewing  reports 1 23 Encrypting  and  shredding  data 127 Working  with  the  Event  Log 135 Using  the  Attention  Required  tab 1[...]

viii VTL User Guide • May 2008 G • 96267 Get  client  properties 175 Assign  virtual  device 175 Unassign  virtual  device 176 Create  virtual  device 1 77 Delete  virtual  device 177 Get  supported  virtual  libraries 1 78 Get  supported  virtual  driv es 179 Create  virtual  tape  libra[...]

96267 • G Contents ix Get  import/ex port  job  status 198 Resume  import/export  jobs 199 Delete  import/export  jobs 200 Suspend  import/export  jobs 200 Cancel  import/export  jobs 200 Replication 201 Create  a  replica 201 Promote  a  replica 203 Remove  replication 2 03 Suspend  replication [...]

x VTL User Guide • May 2008 G • 96267 Server  throughput  report 215 SCSI  channel  throughput  report 2 16 Device  throughput  report 217 Physical  resources  configuration  report 2 18 Disk  usage  report 218 Physical  resources  allocation  re port 219 Specific  physical  resource  alloca[...]

96267 • G xi About  this  book This  book  introduces  tape  virtualization  and  gui des  you  through  the  administration  of  Sun  StorageT ek  Vir t u a l  Ta p e  Library  (VTL)  solutions,  including  VTL  Plus  2.0  and  VTL  Va l u e  systems.  It  [...]

xii VTL User Guide • May 2008 G • 96267 When  the  setup  process  branches,  the  task  ends  with  c onditional  alternativ es: Next  task:  ■ If  the  customer  does  not  plan  to  run  the  management  console  from  a  host  on  the  local  area  n[...]

96267 • G About this book xiii Understanding  the  conventions  used  in  this  book The  table  below  illustrates  the  conv entions  that  represent  literal  and  va r i a b l e  va l u e s ,  commands,  and  property  name s  in  this  book. Obtaining  the  latest [...]

xiv VTL User Guide • May 2008 G • 96267[...]

96267 • G 1 CHAPTER 1 Introduction:  VTL  appliances  and  enterprise  data ‐ protection Sun  StorageT ek  Vi r tu a l T a p e  Library  (VTL)  technology  makes  the  benefits  of  disk ‐ to ‐ disk ‐ to ‐ tape  architecture  available  to  co mplex  backup  environments [...]

Features 2 VTL User Guide • May 2008 G • 96267 Features The  Sun  StorageT ek  VTL  soluti on  has  the  followin g  features: ■ Emulation  of  most  widely  used  tape  libraries,  drives,  and  media  types,  including  the  latest  Sun  StorageT ek  T10000 ‐ series ?[...]

Features 96267 • G Chapter 1 Introduction: VTL appliances and enterpr ise data-protection 3 The  Shred  featur e  insures  military  standard,  secure  data  destru ction  by  overwriting  virtual  tape  with  random  bit  patterns.  Data  destructi on  jobs  are  queued  so  th[...]

Advantages of VTL tape virtualization 4 VTL User Guide • May 2008 G • 96267 Adv antages  of  VTL  tape  virtualization Adding  Sun  StorageT ek  Vi r t ua l T a p e  Library  appliances  to  an  existing  tape ‐ based  backup  architecture  can  thus  realize  the  follow ing  adv[...]

Advantages of VTL tape virtualization 96267 • G Chapter 1 Introduction: VTL appliances and enterpr ise data-protection 5 Shorter  run  times  for  non ‐ sequential  backup  jobs Disk ‐ based  VTL  systems  reduce  run  time  when  storage  operations  are  poorly  matched  to  the  o[...]

Advantages of VTL tape virtualization 6 VTL User Guide • May 2008 G • 96267 that  produce  intermittent  or  non ‐ sequential  I/O,  such  as  incrementals  and  backups  of  wor k  stati ons,  are  copied  to  tape  only  after  they  have  been  backed  up  to  di[...]

Advantages of VTL tape virtualization 96267 • G Chapter 1 Introduction: VTL appliances and enterpr ise data-protection 7 Operating  systems  and  backup  applications  that  currently  interact  with  a  physical  library  via  ACSLS  continue  to  use  ACSLS  when  accessi ng  VTL  v[...]

Key VTL features and options 8 VTL User Guide • May 2008 G • 96267 Key  VTL  features  and  options ■ “NDMP  migrati on”  on  page 8 ■ “VTL  high ‐ av ai lability  option”  on  page 9 ■ “A u t o m a t e d  Ta p e  Caching”  on  page 12 ■ “Vi rtual  tape  replica tion” [...]

Key VTL features and options 96267 • G Chapter 1 Introduction: VTL appliances and enterpr ise data-protection 9 controls  NDMP  agent  softw ar e  on  the  filer  ( D below).  This  agen t  software  copies  data  from  the  filer  over  the  SAN  to  virtual  tape  vo lu m es  [...]

Key VTL features and options 10 VTL User Guide • May 2008 G • 96267 includ ing  the  device  in  question,  the  failure  is  local  to  the  primary ,  an d  the  secondary  initiates  failov er .  If  the  secondary  cannot  access  devices,  the  outage  is  global[...]

Key VTL features and options 96267 • G Chapter 1 Introduction: VTL appliances and enterprise data-protection 11 Storage  path  failover In  a  standard ‐ availabili ty  VTL  system,  there  is  one  logica l  path  from  a  VTL  client  to  VTL  storage,  and  every  Fibre  Chann[...]

Key VTL features and options 12 VTL User Guide • May 2008 G • 96267 Automated  Ta p e  Caching The  Automated  Ta p e  Caching  option  presents  backup  appl ications  with  virtual  tape  vol u me s  that  are  physically  implemented  on  disk,  tape,  or  both .  This  [...]

Key VTL features and options 96267 • G Chapter 1 Introduction: VTL appliances and enterprise data-protection 13 Auto  Replication The  Auto Replication  option  copies  virtual  tapes  from  a  virtual  library  to  another  VTL  server  whenever  a  backup  application  or  utility  [...]

Key VTL features and options 14 VTL User Guide • May 2008 G • 96267 Remote  Copy Remote  Copy  copies  a  single  virtual  tape  to  another  serv er  on  demand. VTL  Secure  Ta p e  encryption  option The  VTL  Secure  Ta p e  option  uses  the  Ad vanced  Encryption  [...]

96267 • G 15 CHAPTER 2 Understanding  VTL  Zoning Zoning  is  the  crucial  first  step  when  integrating  a  storage  system,  suc h  as  the  VTL  appliance,  in to  a  Fibre  Channel  storage  area  netw ork  (SAN).  While  specific  zoning  recommendations[...]

16 VTL User Guide • May 2008 G • 96267 Zoning  for  high ‐ av ailability  systems Zoning  a  high ‐ ava ilability  system  is  slightly  more  complex  than  zoning  a  standard  system,  due  to  the  need  for  redundant  paths  between  initiators  and  targe t[...]

96267 • G Chapter 2 Understanding VTL Zoning 17 Po r t  zoning  (hard  zoning) A  hard ‐ zoned  SAN  maps  initiator  to  target  using  a  physical  port  address.  This  port ‐ to ‐ port  zoning  establishes  a  fixed,  physical  rout e  through  the  SAN.  So, [...]

18 VTL User Guide • May 2008 G • 96267 During  failover ,  the  standby  port  becomes  active  by  spoofing  the  WWPN  of  the  failed  port.  The  figure  below  represent s  a  hard ‐ zoned  SAN  after  VTL  failover: SAN  clients  include  backup  applica[...]

96267 • G 19 CHAPTER 3 Using  the  VTL  console The  Vi r tu a l  Ta p e  Library  console  applicatio n  is  the  graphica l  user  interface  that  yo u  use  when  administering  and  managing  the  VTL  system.  The  console  provides  you  with  full  c[...]

Running the VTL console application 20 VTL User Guide • May 2008 G • 96267 Running  the  VTL  console  application ▼ Launching  the  VTL  console 1. T o  launch  the  console  on  a  Sun  Solaris  worksta tion,  open  a  terminal  window  and  enter  the  command  shown ?[...]

Populating the console 96267 • G Chapter 3 Using the VTL console 21 1. Fro m  the  console  main  menu ,  select  Tools  ( A be low),  then  selec t  Discover VTL Servers  from  the  submenu  ( B ). 2. When  the  Discover Virtual Tape Library Server  dialog  ap pears,  enter  the  sub[...]

Understanding the VTL console interface 22 VTL User Guide • May 2008 G • 96267 3. When  the  VTL User Login dialog  appears,  ente r  the  VTL Server  host  name  or  IP  address  ( C above)  and  the  User Name ,  and  Password  ( D ),  and  press  OK  ( E ). Stop  here.  [...]

Understanding the VTL console interface 96267 • G Chapter 3 Using the VTL console 23 Once  you  have  logged  in  to  the  serv er ,  clicking  on  the  plus  ( + )  symbol  next  to  the  icon  expands  the  serv er  branch  of  the  interface,  rev ealing  the  sub[...]

Understanding the VTL console interface 24 VTL User Guide • May 2008 G • 96267 Vi r t u a l  Ta p e  Library  System The  Virtual Tape Library System  branch  of  the  object  tree  is  the  primary  management  tool  for  routine  VTL  operations.  Right ‐ clicking  on  the  s[...]

Understanding the VTL console interface 96267 • G Chapter 3 Using the VTL console 25 The  Virtual Vault  branch  lists  the  virtual  tapes  that  are  currently  being  stored  outside  the  virtual  tape  libraries,  in  barcode  order .  Vi r t u a l  tapes  in  the  vau l[...]

Understanding the VTL console interface 26 VTL User Guide • May 2008 G • 96267 ■ virtual  tape  and  library  information ■ job  status By  right ‐ clicking  on  this  branch,  you  can  select  and  generate  reports. Physical  Resources The  Physical Resources  branch  of  the [...]

96267 • G 27 CHAPTER 4 VTL  operations This  chapt er  covers  routine  configura tion,  administration,  and  management  of  server  nodes,  virtual  tape  libraries,  drives,  and  tapes,  including: ■ “Managing  netw ork  connectivity”  on  page 27 ■ “Managing  vir[...]

Managing network connectivity 28 VTL User Guide • May 2008 G • 96267 ▼ Configuring  local  area  netw ork  connections 1. In  the  Network Configuration  property  sh eet,  ente r  the  Domain name  ( A below).  Check  the  Append suffix t o DNS lookup  check  box  ( B )  if  the [...]

Managing network connectivity 96267 • G Chapter 4 VTL operations 29 5. When  the  IP Address Configuration  property  sheet  appears,  click  the  Static  radio  button  ( F below). 6. Click  the  Edit  button  ( G above),  and  enter  the  IP  address  that  the  customer  p[...]

Managing network connectivity 30 VTL User Guide • May 2008 G • 96267 Note  the  Enable SSH ,  Enable FTP ,  and  Allow root to login in telnet session  check  boxes.  While  ssh  is  enabled  by  default,  ftp  and  remote login  by  root  are  disabled  for  security  reasons[...]

Managing network connectivity 96267 • G Chapter 4 VTL operations 31 3. When  prompted  to  restart  the  network  and  server ,  press Yes ( C  below). 4. Log  back  in  to  th e  server  to  con tinue  working. Stop  here.  ▼ Obtaining  SAN  interface  configuration  informat[...]

Managing network connectivity 32 VTL User Guide • May 2008 G • 96267 2. Sel ect  the  HBA  that  you  wish  to  check  ( C above),  and,  in  the  pane  at  right,  use  the  tabs  to  locate  the  required  inform ation  ( D ). Stop  here.  ▼ Administering  SAN [...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 33 3. T o  see  virtua l  device  assignments,  ex pand  the  client  node  ( Db e l o w )  an d  Fibre Channel  protocol  node  ( C )  of  the  tree  view . 4. Rig ht ‐ clicki ng  on  the  client  node  ( D above) [...]

Managing virtual libraries 34 VTL User Guide • May 2008 G • 96267 Configuring  physical  libraries  and  devices VTL  software  supports  either  dir ect ‐ attached  libraries  or ,  optionally ,  shared  libraries  managed  by  ACSLS/Libr ary  Station  software.  ■ If  you  are[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 35 2. Otherwise,  in  the  object  tree  of  the  VTL  console,  right ‐ click  the  Physical Resources  node  ( A below),  and  select  Prepare Devices  from  the  context  menu ( B ). 3. When  the  Select a Preparati[...]

Managing virtual libraries 36 VTL User Guide • May 2008 G • 96267 5. When  the Select Physical Devices  pa nel  appears,  use  the  check  boxes  and/or  the  selection  buttons  ( F below)  to  select  the  libraries  or  devices  th at  you  want  to  assign  to  the ?[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 37 ▼ Assigning  direct ‐ attached  physical  tape  libraries/devices 1. In  the  object  tr ee  of  the  VTL  console  application,  open  the  branch  for  the  VTL  server  ( A below). 2. Ope n  the  bran ch  fo[...]

Managing virtual libraries 38 VTL User Guide • May 2008 G • 96267 Managing  ACSLS  and  Library  Station  tape  pools When  the  VTL  softw are’ s  ACSLS/Library  Station  option  is  enabled,  Sun  Storag eT ek  ACSLS  Manager™  or  Library  Station  software  manages [...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 39 Configuring  and  provisioning  virtual  libraries This  section  describes  the  procedures  for  creating  and  maintain ing  virtual  libraries,  with  their  virtual  drives  and  media.  It  documents  the [...]

Managing virtual libraries 40 VTL User Guide • May 2008 G • 96267 both  the  needed  long ‐ term  storage  capacity  and  the  fastest  possible  transfer  to  tape  media.  Compression  hardw are  cannot  further  compress  data  that  has  been  compressed  by  softw[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 41 ▼ Creating  virtual  tape  libraries 1. When  the  Create Virtual Librar y Wizard  appears,  select  the  type  of  library  that  you  want  to  emulate  ( A below),  enter  a  Virtual Library Name  ( B )  or  u[...]

Managing virtual libraries 42 VTL User Guide • May 2008 G • 96267 If  you  plan  to  attach  a  physi cal  tape  li brary  to  the  VTL  appliance  for  tape  import  or  export,  emulate  the  physical  li brary  so  that  virtual  tapes  will  be  compatible ?[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 43 6. If  you  do  not  intend  to  implement  autoarchiving  or  repl ication,  press  Next  ( L below)  to  skip  over  the  Auto Archive/Replication  dialog. The  Auto Archive  option  writes  data  to  physic a[...]

Managing virtual libraries 44 VTL User Guide • May 2008 G • 96267 7. Indicate  if  you  want  to  use  tape  duplication. Ta p e  duplication  allows  you  to  make  up  to  five  dupl icate  copies  of  a  phy sical  tape  whenever  virtual  tape  data  is  export[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 45 Next  task:  ■ If  you  are  going  to  conf igur e  tape  caching  on  this  virtual  library ,  go  to  “Configuring  Automated  Ta p e  Ca ching”  on  page 45.  ■ If  you  are  going  to  use[...]

Managing virtual libraries 46 VTL User Guide • May 2008 G • 96267 ▼ Creating  simple  schedule ‐ driven  migrat ion  policies When  the  Please select migration trigge r(s)  dialog  appears,  proce ed  as  follows. 1. Click  the  Time Based  radio  button  ( A below ). 2. T o  mi grate  [...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 47 2. T o  mi grate  data  when  ALL  of  of  the  conditions  specified  are  satisfied,  click  the  And  radio  button  ( B below).  3. T o  mi grate  data  when  ONE  OR  MORE  of  the  conditions  [...]

Managing virtual libraries 48 VTL User Guide • May 2008 G • 96267 ▼ Creating  a  reclamation  policy The  reclamati on  policy  determin es  when  expired  virt ual  volu me s  are  released .  Proceed  as  follows.  1. When  the  Please select a reclamat ion trigger  dialog  appears[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 49 ▼ Setting  up  the  Auto  Archiv e  feature 1. When  the  Auto Archive/Replication  dialog  appears,  check  the  Auto Archive/Replication  check  box  ( A below). 2. Specify  Auto  Archive  by  clicking  the  Auto Arc[...]

Managing virtual libraries 50 VTL User Guide • May 2008 G • 96267 ▼ Setting  up  the  Auto  Replication  option 1. When  the  Auto Archive/Replication  dialog  appears,  ch eck  the  Auto Archive/Replication  check  box  ( A below). 2. Click  the  Auto Replication  radio  button  ( B[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 51 ▼ Generating  the  virtual  library Using  this  procedure,  you  define  the  remaining  charac teristics  of  you r  vir tual  library  and  media.  Yo u  supply  a  barcode  range,  slot  count,  and  im[...]

Managing virtual libraries 52 VTL User Guide • May 2008 G • 96267 3. Usi ng  the  spi nner  control  provided,  adjust  the Number of Slots to  4096 ,  the  maximum  supported  by  major  backup  app lication  software  for  a  single  virtual  library ( C above) . In  most  case[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 53 6. When  the  Enter virtual tape proper ties  dialog  appears,  check  th e  Tape Capacity On Demand  check  box  ( E below). Sun  recommends  capacity  on  demand  for  most  users.  7. If  you  are  not  using  t[...]

Managing virtual libraries 54 VTL User Guide • May 2008 G • 96267 10. Press  Next  ( E above). 11. When  the  confirmation  screen  appears,  press  Finish  ( F below). 12. When  the  Batch Creation Status  panel  appears,  press  OK  ( G below). Next  task:  If  you  decided  to ?[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 55 3. Under  the  Virtual Tape Libraries  node,  right ‐ click  on  the  virtual  tape  library  that  you  want  to  enable,  and  select  Properties . 4. When  the  Change Virtual Library Pr operties  property  sheet ?[...]

Managing virtual libraries 56 VTL User Guide • May 2008 G • 96267 Creating  virtual  tapes Follow  the  proc edures  outlined  below: ■ “Enabling  the  adv anced  tape  creation  method”  on  page 56 ■ “Setting  replication  parameters  for  virtual  tape  volu m es ”  on ?[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 57 tries  to  calcul ate  this  va l u e  for  you ,  it  does  so  using  the  currently  allocated  size  of  the  virtual  tapes.  If  you  are  using  the  capacity  on  dem and  feature  of  the[...]

Managing virtual libraries 58 VTL User Guide • May 2008 G • 96267 ■ Otherwise,  the  wizard  skips  directly  to  the  Specify Batch Mode Information  dialog.  So  go  to  “ Allocating  disk  space  to  virtual  tapes”  on  page 6 0. ▼ Setting  Auto  Archiv e  parameters [...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 59 2. In  the  Select Physical Tapes  dialog  ,  select  physical  tapes  using  the  check  boxes  ( C below)  and/or  button  controls  provided  ( D ).  Then  press  Next  ( E ).  Next  task:  “ Allocating [...]

Managing virtual libraries 60 VTL User Guide • May 2008 G • 96267 ▼ Allocating  disk  space  to  virtual  tapes 1. When  the  Specify Batch Mode Infor mation  panel  appears,  en ter  a  descriptive  prefix  for  the  virtual  tape  labels  ( A below). Choose  a  meaning  name [...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 61 3. Otherwise,  if  you  plan  to  create  additional  libraries  later ,  divide  the  Maximum  ( B above)  between  the  libraries,  and  enter  the  number  allocated  to  this  library  as  the Number of V[...]

Managing virtual libraries 62 VTL User Guide • May 2008 G • 96267 1. When  the  Select Target Server for Auto-Replication Option  dialog  appears,  check  the  Automatically replicate the virtual tape(s) to the selected target server  check  box  ( A be low). 2. Sel ect  the  remote  server  from  th[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 63 4. When  the  Specify Replicati on Timeout and Retry Policy  property  she et  appears,  configure  timeout  and  retry  intervals  using  the  spinner  controls  provided  ( F below).  Then  press  Next  ( G ). 5. When [...]

Managing virtual libraries 64 VTL User Guide • May 2008 G • 96267 7. Pre ss  Next  ( K above). Next  task:  “Launching  the  virtual  tape  batch  creati on  process”  on  page 64. ▼ Launching  the  virtual  tape  batch  creation  process 1. When  the  Create Virtual Tapes  su[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 65 ■ “A d d i n g  Fi bre  Channel  SAN  clients”  on  page 66 ■ “ Assigning  virtual  libra ries  to  storage  clients”  on  page 69. ▼ Starting  the  Add  Client  W izard 1. In  the  tree  menu  of  the ?[...]

Managing virtual libraries 66 VTL User Guide • May 2008 G • 96267 ▼ Adding  Fibre  Channel  SAN  clients 1. When  the  Enter the Generic Client Name  dialog  appears,  enter  the  client  name  in  the  text  field  provid ed  ( A below).  Press  Next  ( B ). The  client  is[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 67 3. When  the  Set Client Fibre Channel Properties  property  sheet  appears,  select  the  Wo r l d  Wid e  Port  Name  ( WWPN )  of  the  initiator  by  checking  the  corresponding  check  box  ( E below),  or ?[...]

Managing virtual libraries 68 VTL User Guide • May 2008 G • 96267 5. When  the  Add the Generic Client  summa ry  screen  appears,  press  Finish  ( L below)  to  add  the  client. Next  task:  “Starting  the  Assign  a  Vir tu a l  Ta p e  Library  Wi zard”  on  page 68. [...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 69 ▼ Assigning  virtual  libraries  to  storage  clients 1. When  the  Assign a Virtual Tape Lib rary Wizard  appears,  check  the  Assign the tape library and all drive s...  check  box  ( A below),  select  a  client  ( B ), [...]

Managing virtual libraries 70 VTL User Guide • May 2008 G • 96267 3. When  the  Assign a Fibre Channel C lient to the Virtual Tape Library  confirmation  screen  appears,  press  Finish  ( F ). 4. Log  in  to  each  VTL  client  (each  backup  server),  and  scan  for  new  Fibre ?[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 71 3. Perform  a  configuration  reboot: Next  task:  “Crea ting  ACSLS  host  driver  instances  for  virtual  libra ries”  on  page 71. ▼ Creating  ACSLS  host  driver  instances  for  virtual  libraries Once  yo[...]

Managing virtual libraries 72 VTL User Guide • May 2008 G • 96267 5. Edi t  the  file  /usr/kernel/drv/mchanger.conf ,  adding  an  entry  for  each  virtual  library  that  the  oeprating  syst em  discovered.  Each  library  entry  includes  a  driver  name  ( mchanger ), ?[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 73 10. When  prompted,  confirm  your  entries  by  entering y (yes). The  script  builds  the  driver  instan ces  for  the  specified  libraries: 11. Load  the  driver: 12. Change  to  the  ACSSS  home  directory , [...]

Managing virtual libraries 74 VTL User Guide • May 2008 G • 96267 2. When  you  are  asked  if  the ACS (Automated  Cartridge  Subsystem)  is  in  a  partitioned  librar y ,  enter n (no): 3. When  you  are  prompted,  confirm  the  changes  by  entering y (yes): Is ACS in a partiti[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 75 4. W ait  for  60  seconds  (one  minute),  then  start  the  ACSLS  command  preocessor ,  cmd_proc : 5. Audit  the  newly  ad ded  libraries.  At  the ACSSA> prompt,  enter  audit : 6. Log  the  configuration [...]

Managing virtual libraries 76 VTL User Guide • May 2008 G • 96267 ■ “Manually  saving  the  VTL  configuration”  on  page 76 ■ “ Automatically  backing  up  the  VTL  configuration”  on  page 76. ▼ Manually  saving  the  VTL  configuration 1. In  the  object  tr ee  of[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 77 1. In  the  object  tr ee  of  the  VTL  console,  right ‐ click  on  the  the  VTL  server  branch  ( A below). 2. Fro m  the  context  menu,  select  Properties  ( B above). A B[...]

Managing virtual libraries 78 VTL User Guide • May 2008 G • 96267 3. Sel ect  the  Auto Save Config tab  ( C below). 4. Che ck  Enable Auto Save Configuration File check  box  ( D abov e). 5. In  the  field  provided,  enter  the  Ftp Server Name  for  the  machine  that  will  host  the [...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 79 Stop  here.  Recov ering  the  server  configuration If  the  VTL  server  configuration  is  lost  or  corrupt,  you  can  recover  it  from  a  backup  file  using  the  procedure  below .  Caution – T[...]

Managing virtual libraries 80 VTL User Guide • May 2008 G • 96267 Mirroring  supplies  an  additional  laye r  of  protection.  Mirrored  databases  maintain  two  separate,  synchronized  copies  of  th e  metadata,  either  of  which  can  provide  access  to  virtual [...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 81 5. When  the  Select a Creation Method  dialog  appears,  sele ct  Express  ( F below),  and  press  Next  ( G ). The  Express  method  takes  adv antage  of  the  intelligence  built  in  to  the  RA ID  subsys[...]

Managing virtual libraries 82 VTL User Guide • May 2008 G • 96267 6. When  the  confirmation  dialog  appears,  confirm  that  all  information  is  correct ,  and  then  click  Finish  to  create  the  mirrors. The  VTL  software  creates  and  synchronizes  the  mirror[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 83 ▼ Managing  administrators Only  the  root  user  can  add  or  delete  a  VTL  administrator  or  change  an  administrator ’ s  password.  1. In  the  ob ject  tree  of  the  VTL  console,  right  cl[...]

Managing virtual libraries 84 VTL User Guide • May 2008 G • 96267 ▼ Changing  administrator  passw ords  1. Rig ht ‐ click  on  the  VTL  server  node  name  ( A below ),  and  select  Change Password from  the  context  menu  ( B ). 2. When  the  dialog  appears,  enter  the[...]

Managing virtual libraries 96267 • G Chapter 4 VTL operations 85 VTL  supports  two  types  of  compressi on: ■ Hardw are  compression ‐  uses  a  Hif n  Express  DR10 00  (1  GB/sec  compressi on)  or  DR600  (600  MB/sec)  compression  card.  A  license  keycode  is [...]

Managing tapes 86 VTL User Guide • May 2008 G • 96267 UNIX  —  On  backup  servers  that  run  Solaris  or  other  UNIX  operating  systems,  specify  a  compressed  tape  device  file  such  as  /dev/rmt/0cbn  to  enable  compression  or  /dev/rmt/0ubn  to  d[...]

Managing tapes 96267 • G Chapter 4 VTL operations 87 ■ “Setting  up  replication  for  individual  tapes”  on  page 92 ■ “Manually  synchronizin g  replicas  (manual  replication)”  on  page 98 ■ “Stopping  a  replication  that  is  already  under  way ”  on  pa g[...]

Managing tapes 88 VTL User Guide • May 2008 G • 96267 6. When  the  Select Virtual Tapes to enable Replication...  panel  appears,  use  the  check  boxes  ( D below)  and/or  selection  buttons  to  select  tapes  ( E ).  Press  Next  ( F ). 7. When  the  Specify the Target serve r[...]

Managing tapes 96267 • G Chapter 4 VTL operations 89 8. When  the  Select Target Server  panel  appears,  use  the  list  ( J below)  to  select  or  server  or  press  Add  ( K )  to  add  one  to  the  list.  Press  Next  ( L ). 9. If  you  chose  the  Remote[...]

Managing tapes 90 VTL User Guide • May 2008 G • 96267 10. If  you  chose  the  Local Server  option  above,  in  Step 7,  press  Next  ( O below). 11. When  the  Select the Replication Po licy ...  panel  appears,  use  the  check  boxes,  list  boxes,  and  spinner  contro[...]

Managing tapes 96267 • G Chapter 4 VTL operations 91 12. When  the  Select the Replication Ti meout and Retry Policy  panel  appears,  use  the  spinner  controls  provided  to  define  the  policy  you  want  to  apply  ( S below).  Press  Next  ( T ). 13. When  the  Specify th[...]

Managing tapes 92 VTL User Guide • May 2008 G • 96267 14. When  the  confirmation  panel  appears,  press  Finish  ( W below). Stop  here.  ▼ Setting  up  replication  for  individual  tapes 1. In  the  object  tr ee  of  the  VTL  console,  expand  the  VTL  server ?[...]

Managing tapes 96267 • G Chapter 4 VTL operations 93 2. The n  open  the  node  for  the  library  that  holds  the  tape  you  want  to  replicate  ( A below),  and  open  the  Tapes  node  ( B ).  3. Rig ht ‐ click  on  the  virtual  tape  for  which  you ?[...]

Managing tapes 94 VTL User Guide • May 2008 G • 96267 6. When  the  Select Target Server  pa nel  appears,  use  the  list  ( H below)  to  select  or  server  or  press  Add  ( J )  to  add  one  to  the  list.  Press  Next  ( K ). 7. If  you  chose  the  Re[...]

Managing tapes 96267 • G Chapter 4 VTL operations 95 8. If  you  chose  the  Local Server  option  above,  in  Step 7,  press  Next  ( N below). 9. When  the  Select the Replication Pol icy ...  panel  appears,  use  the  check  boxes,  list  boxes,  and  spinner  controls ?[...]

Managing tapes 96 VTL User Guide • May 2008 G • 96267 10. When  the  Select the Replication T imeout and Retry Policy  panel  appears,  use  the  spinner  controls  provided  to  define  the  policy  you  want  to  apply  ( Q below).  Press  Next  ( R ). 11. When  the  Specify[...]

Managing tapes 96267 • G Chapter 4 VTL operations 97 12. When  the  Select a Creation Meth od  panel  appears,  click  the  Express  radi o  button  ( U below),  and  press  Next  ( V ). The  Sun  StorageT ek  VTL  appliance  includes  an  integrated  RAID  device,  so  th[...]

Managing tapes 98 VTL User Guide • May 2008 G • 96267 14. When  the  confirmation  panel  appears,  press  Finish  ( Y below). Note – Once  you  create  you r  replication  conf iguration,  you  should  not  change  the  hostname  of  the  source  (primary)  server .  If [...]

Managing tapes 96267 • G Chapter 4 VTL operations 99 ▼ Suspending  and  resuming  replication Yo u  can  manually  suspend  forthcom ing  replications  that  wou ld  otherwise  be  launched  automatically  from  yo ur  replication  policie s  (currently  active  replications  are[...]

Managing tapes 100 VTL User Guide • May 2008 G • 96267 ▼ Checking  replication  status  from  the  primary  VTL  server 1. In  the  object  tree  of  th e  VTL  console,  drill  down  to  the  Tapes  node,  and  select  the  primary  virtual  tape  ( A  below)[...]

Managing tapes 96267 • G Chapter 4 VTL operations 101 ▼ Checking  replication  status  from  the  target  VTL  server 1. In  the  object  tr ee  of  the  VTL  console,  drill  down  to  the  Replica Resources  node  ( A  below). 2. Sel ec t  the  replica  resour ce  c[...]

Managing tapes 102 VTL User Guide • May 2008 G • 96267 ■ all  tapes  on  a  group  of  servers Reports  can  be  filtered  to  exclude  all  but  current  replica tion  configurations,  all  but  deleted  or  prompted  configurations,  or  any  desired  combination.[...]

Managing tapes 96267 • G Chapter 4 VTL operations 103 ▼ Deleting  a  replication  configuration 1. Rig ht ‐ click  on  the  primary  virtual  tape ,  and  select  Replication  from  the  context  menu. 2. Sel ec t  Remove  from  the  following  context  menu.  This  allows ?[...]

Managing tapes 104 VTL User Guide • May 2008 G • 96267 3. Fro m  the  context  menus,  select  Replication  ( B below),  Promote  ( C ). 4. When  the  confirmation  panel  appears,  press  OK  ( D below). 5. Rescan  devices  from  the  SAN  client  or  restart  the  client [...]

Managing tapes 96267 • G Chapter 4 VTL operations 105 Yo u  can  only  copy  tapes  with  barcodes  that  are  not  found  on  the  remote  server .  If  a  copy  exists  and  you  wish  to  proceed,  yo u  must  first  delete  the  existing  remote  copy[...]

Managing tapes 106 VTL User Guide • May 2008 G • 96267 5. When  the  Select the Target Serve r  panel  appears,  use  the  list  to  select  the  server  where  you  want  to  copy  the  tape  ( E below)  or  press  Add  ( F )  to  add  a  server  to  the [...]

Managing tapes 96267 • G Chapter 4 VTL operations 107 7. When  the Specify a Location  panel  appe ars,  select  a  location  on  the  remote  server  ( K below),  and  press  Next  ( L ). 8. When  the  confirmation  panel  ap pears,  press  Finish  ( M below). Stop  here.  M[...]

Managing tapes 108 VTL User Guide • May 2008 G • 96267 ■ copy  a  physical  tape  to  a  virtual  tape  that  emulates  the  same  type  of  media ■ directly  access  a  physical  tape  without  copying  the  entire  tape ■ recycle  a  physical  tape  after ?[...]

Managing tapes 96267 • G Chapter 4 VTL operations 109 ▼ Importing  a  physical  tape  into  a  virtual  library 1. In  the  object  tr ee  of  the  VTL  console,  right ‐ click  the  node  for  the  physical  tape  library  or  drive  that  ho lds  the  tape ?[...]

Managing tapes 110 VTL User Guide • May 2008 G • 96267 3. When  the  Select the import mode ...  pa nel  appears,  click  the  radio  button  that  corresponds  to  the  behavior  you  want  ( E below).  4. If  the  tape  is  encrypted  and  you  wish  to  decrypt [...]

Managing tapes 96267 • G Chapter 4 VTL operations 111 6. When  the  Select the physical tape to import ...  panel  appears,  use  the  check  boxes  and/or  selection  buttons  provided  to  select  the  tape(s)  that  you  want  to  import  ( H below).  Then  press  Next [...]

Managing tapes 112 VTL User Guide • May 2008 G • 96267 8. When  the  Select Physical Devices  panel  appears,  use  the  ch eck  boxes  and/or  selection  buttons  provided  to  select  the  LUNs  that  you  wish  to  use  ( M below).  Press  Next  ( N ). 9. When  the[...]

Managing tapes 96267 • G Chapter 4 VTL operations 113 10. Set  the  Virtual Tape Size  to  the  full  size  of  the  emulated  media  ( Q below),  and  Tab  to  another  field  to  recalculate  the  Maximum  number  of  tapes  possible  with  the  available  stora[...]

Managing tapes 114 VTL User Guide • May 2008 G • 96267 12. Otherwise,  reset  the  Virtual Tape Size  to  the  default  value  for  using  capacity  on  demand  with  th is  type  of  media  ( T below).  Check  the  Use default ID for Starting Number  check  box  ( U ), [...]

Managing tapes 96267 • G Chapter 4 VTL operations 115 ▼ Importing  cartridges  in  an  IBM  iSeries  environment 1. If  you  have  not  already  done  so,  import  ta pes  into  the  virtual  library  using  the  VTL  console,  as  described  in  “Importing  a ?[...]

Managing tapes 116 VTL User Guide • May 2008 G • 96267 2. When  the  Move Tape to Virtual Vault  dialog  ap pears,  select  the  tape(s)  that  you  want  to  move  using  the  check  boxes  and/or  selection  buttons  provided  ( C below).  Press  OK  ( D ). 3. Now ,  i[...]

Managing tapes 96267 • G Chapter 4 VTL operations 117 4. When  the  Select a physica l library or drive  panel  appears,  use  the  list  to  select  the  library  or  device  to  which  you  want  to  export  virtual  tape  ( G below).  Press  Next ( H ). 5. Sel ec t  how[...]

Managing tapes 118 VTL User Guide • May 2008 G • 96267 6. Sel ect  or  clear  the  Eject  physical  tapes  to  I/E  slots  after  export  check  box. 7. Sel ect  Encrypt  data  when  exporting  to  physical  tape  with  the  selected  key  if  you  want  to  [...]

Managing tapes 96267 • G Chapter 4 VTL operations 119 15. Press  Next  ( S below). 16. When  the  Verify and Export ...  panel  appears,  press  Finish  ( T below). Stop  here.  ▼ Exporting  cartridges  to  the  virtual  va u lt  in  an  IBM  iSeries  environment 1. Exp ort  a ?[...]

Managing tape caching 120 VTL User Guide • May 2008 G • 96267 Managing  tape  caching In  most  circumstances,  the  Automated  Ta p e  Caching  feature  maintains  tape  caches  and  linkages  automatical ly ,  provided  that  policies  are  suitably  defined.  Howev e r ,  w[...]

Managing tape caching 96267 • G Chapter 4 VTL operations 121 1. In  the  object  tr ee  of  the  VTL  console,  right ‐ click  on  the  direct  link  tape  that  you  wish  to  recache. 2. Sel ec t  Renew Cache  from  the  context  menu. Stop  here.  ▼ Disabling  a [...]

Managing tape caching 122 VTL User Guide • May 2008 G • 96267 3. When  the  Sync Librar y  dialog  appears,  check  the  checkbox  that  corresponds  to  the  physical  tape  that  needs  to  be  relinked  ( A belo w)  or  use  the  Selec t-All  button. 4. Pre ss  Next ?[...]

Creating and viewing reports 96267 • G Chapter 4 VTL operations 123 6. If  the  data  was  encrypted  before  being  migrat ed,  check  the  Use encryption/decryption on tape(s)  check  box,  and  supply  the  select  the  appropriate  key  using  the  list  control  provided[...]

Creating and viewing reports 124 VTL User Guide • May 2008 G • 96267 2. When  the  Select a Report Type  dialog  appears,  select  a  type  from  the  list  ( C below).  Press  Next  ( D ). 3. When  the  Select Report Options  panel  appears,  select  the  desired  report  pro[...]

Creating and viewing reports 96267 • G Chapter 4 VTL operations 125 4. When  the  Enter the Report Name  dialog  appears,  for  the  report ,  enter  the  name  in  the  field  provi ded  ( H below),  and  pres s  Next  ( J ). 5. When  the  Create the Report  panel  appears, [...]

Creating and viewing reports 126 VTL User Guide • May 2008 G • 96267 ▼ Vi e w in g  a  report 1. In  the  object  tree  of  the  VTL  console,  expand  the  Reports  node  ( A  below)  to  view  the  list  of  current  reports. 2. Sel ect  the  current  report  that[...]

Encrypting and shredding data 96267 • G Chapter 4 VTL operations 127 ▼ Exporting  data  from  a  report 1. In  the  object  tr ee  of  the  VTL  console,  expand  the  Reports  node  and  right ‐ click  the  name  of  the  report  that  you  want  to  export  [...]

Encrypting and shredding data 128 VTL User Guide • May 2008 G • 96267 Each  key  consists  of  a  secret  phrase.  For  additional  security ,  each  key  is  password ‐ protected .  Yo u  must  provide  this  passw ord  in  order  to  chang e  the  key  name,  pass[...]

Encrypting and shredding data 96267 • G Chapter 4 VTL operations 129 5. In  the  New Password and  Confirm Password  text  boxes  ( C belo w),  type  a  password  for  accessing  the  key  (10–16  characters). Yo u  will  need  to  provide  this  password  when  changin g  [...]

Encrypting and shredding data 130 VTL User Guide • May 2008 G • 96267 If  you  rename  a  key ,  you  can  still  use  that  key  to  decrypt  data  that  wa s  encrypted  using  the  old  key  name.  For  exampl e,  if  yo u  encrypt  data  using  Key1 , [...]

Encrypting and shredding data 96267 • G Chapter 4 VTL operations 131 ▼ Exporting  a  key When  you  export  a  key ,  you  create  a  separate  file  called  a  key package that  contains  one  or  more  ke ys.  Yo u  can  then  send  this  file  to  another  si[...]

Encrypting and shredding data 132 VTL User Guide • May 2008 G • 96267 6. Sel ect  Prompt for new password for all keys in package  if  yo u  want  to  create  a  new  password  for  the  key  package. If  you  select  this  option,  yo u  will  be  prompted  to  provide  th[...]

Encrypting and shredding data 96267 • G Chapter 4 VTL operations 133 the  key  package.  If  you  provide  an  incorrect  passw ord,  you  will  still  be  able  to  import  the  keys  in  the  packag e,  but  you  will  not  be  able  to  use  them  to  [...]

Encrypting and shredding data 134 VTL User Guide • May 2008 G • 96267 1. Mov e  the  tape(s)  you  want  to  shred  to  the  virtual  vault.  In  the  object  tree  of  the  VTL  console,  start  by  right ‐ clicking  on  a  tape  that  yo u  want  to  shre[...]

Working with the Event Log 96267 • G Chapter 4 VTL operations 135 4. Rig ht ‐ click  on  one  of  the  tapes  that  you  want  to  shred  (G above) ,  and  select  Tape Shredding  ( H )  and  Shred Tape  ( J )  from  the  context  menus. 5. When  the Shred Virtual Tape Resourc[...]

Working with the Event Log 136 VTL User Guide • May 2008 G • 96267 The  columns  displayed  are: The  VTL  console  lets  you  wor k  with  logs  in  the  following  wa y s : ■ “V iewing  an  ev e nt  log”  on  page 136 ■ “Sorting  an  ev ent  log”  on  page 136[...]

Working with the Event Log 96267 • G Chapter 4 VTL operations 137 ▼ Quickly  printing  an  event  log 1. Fro m  the  VTL  console  main  menu,  select File . 2. Fro m  the  submenu,  se lect Print .  Stop  here.  ▼ Filtering,  exporting,  purging,  and  printing  an  ev ent [...]

Working with the Event Log 138 VTL User Guide • May 2008 G • 96267 3. Fro m  the  submenu,  se lect  the  operati on  that  you  wish  to  perfo rm  ( D  above). If  you  wish  to  search  or  filter  the  log,  the Event Log Options dialog  ( E below)  lets  yo u  set ?[...]

Working with the Event Log 96267 • G Chapter 4 VTL operations 139 ▼ Accessing  the  Attention  Required  tab 1. In  the  VTL  object  tree,  locate  the  flagged  server  ( A below). 2. In  the  right ‐ hand  pane,  select  the  Attention Required  tab  of  the  server  p[...]

Managing VTL servers 140 VTL User Guide • May 2008 G • 96267 Managing  VTL  servers The  VTL  console  lets  you  manage  the  serv er  node  by: ■ “Setting  serv er  properties”  on  page 140 ■ “Configuring  SNMP  traps”  on  page 140 . ▼ Setting  serv er  properties [...]

Managing VTL servers 96267 • G Chapter 4 VTL operations 141 2. Sel ec t  the  SNMP Maintenance  tab. 3. Indicate  the  information  that  should  be  included  in  traps  sent  to  your  SNMP  manager . SysLocation ‐  Enter  the  location  that  should  be  included  in [...]

Managing VTL servers 142 VTL User Guide • May 2008 G • 96267[...]

96267 • G 143 CHAPTER 5 Installing  the  VTL  console  The  Vir t u a l  Ta p e  Library  console  application  can  be  i nstalled  on  a  full  range  of  operating  platforms.  In  most  cases,  a  Sun  service  representative  installs  the  c onsole  on[...]

144 VTL User Guide • May 2008 G • 96267 3. If  you  are  installing  th e  console  software  on  an  x86  platform,  enter  the  following  command,  and  respond  to  th e  on ‐ screen  prom pts: 4. If  you  are  installing  th e  console  software  on  a ?[...]

96267 • G Chapter 5 Installing the VTL console 145 2. Usi ng  Secure  File  Tr a n s f e r  Protocol  ( sftp ),  log  on  to  the  VTL  server ,  change  to  the  usr/vtl/packages/build/Windows/ directory ,  and  download  all  list ed  installa tion  files  to  a  temporary [...]

146 VTL User Guide • May 2008 G • 96267[...]

96267 • G 147 CHAPTER 6 Recov ery  following  a  system  failure To  recover  a  VTL  high ‐ avai lability  system  following  a  failure  on  one  node,  carry  out  the  following  task s: ■ “Failback”  on  page 147 ■ “Resuming  backups  following  a  fail[...]

Failback 148 VTL User Guide • May 2008 G • 96267 The  system  shoul d  display  the  expected  node  name. 3. If  you  are  not  logged  in  to  the  correct  system,  you  may  have  accidently  logged  into  the  service  (“monitoring”)  IP  addr ess  of ?[...]

Failback 96267 • G Chapter 6 Recovery following a system failure 149 7. Run  the  sms  command.  The  results  should  look  like  those  shown. 8. Ope n  a  terminal  window  on  the  management  host,  and ssh to  the  service  (“monitoring”)  IP  address  of  the ?[...]

Failback 150 VTL User Guide • May 2008 G • 96267 9. Mak e  sure  that  you  are  logg ed  in  to  the  actu al,  failed  node: The  system  shoul d  display  the  expected  node  name. 10. If  you  are  not  logged  in  to  the  correct  system,  you  have ?[...]

Failback 96267 • G Chapter 6 Recovery following a system failure 151 13. Run  the  sms  command,  and  make  sure  that  the  FailOve rStatus  is  DOWN (failed  over  to  th e  standby  server): 14. Restart  the  failed  se rver  node  gracefully ,  using  the  init6  comm[...]

Failback 152 VTL User Guide • May 2008 G • 96267 where  nnn.nn n.nnn.nnx  is  the  service  (“monitoring”)  IP  address  of  the  restarted  node,  and vtladmin is  the  VTL  administrator  account  user  ID. 16. Make  sure  that  you  are  logged  in  to  the [...]

Failback 96267 • G Chapter 6 Recovery following a system failure 153 21. Run  the  sms  command,  and  make  sure  th at  the  FailOverStatus  is  READY  for  failback: 22. Log  in  using  the  VTL  management  console. [ VTL_Plus ]vtladmin# sms Usage: sms {force|nas|nasc|fm|sm|bmr|b mrrese[...]

Failback 154 VTL User Guide • May 2008 G • 96267 23. In  the  object  tree  of  the  VTL  console,  right ‐ click  the  restarted  server  node,  VTLPLUSN1 ,  and  select  Failover > Stop Takeover  from  the  contex t  menu. 24. Open  a  terminal  window  on  the ?[...]

Failback 96267 • G Chapter 6 Recovery following a system failure 155 28. Run  the  vtl status  command: 29. If  one  or  more  VTL  processes  are  not  RUNNING ,  stop  the  server  software  and  then  restart:  [ VTL_Plus ]vtladmin# vtl status Sun Microsystems VTL Server v n.nn (Build nn[...]

Failback 156 VTL User Guide • May 2008 G • 96267 30. Run  the  sms  command,  Make  sure  that  the  FailOverStatus  is  now  UP : 31. In  the  object  tree  of  the  VTL  console,  make  sure  that  neither  node  name  is  shown  in  red,  indicating  an[...]

Resuming backups follow ing a failover/failb ack 96267 • G Chapter 6 Recovery following a system failure 157 Failover  eve nts  are  also  available  via  the  primary  server ʹ s  Ev ent  Log. Next  task:  “Resuming  backups  following  a  failov er/failback”  on  page 157. Resuming  [...]

Resuming backups follow ing a failover/failb ack 158 VTL User Guide • May 2008 G • 96267[...]

96267 • G 159 CHAPTER 7 Configuring email alerts Y ou can configur e VTL appliances to send automatic notifications to local system administrators via email wh enev er system pr oblems arise. ▼ Configuring email alerts 1. In the object tree of the VTL console, right-click on the VTL server node, and select Options > Enable CallHome . 2. When[...]

160 VTL User Guide • May 2008 G • 96267 Note that email notification s cannot use an SSL connec tion. If the e mail server requi res SSL, conf igure email notific ation to use the local host SMTP se rver , and make sur e that DNS and SMTP are set up and running on the VTL server node. The email account password is stored in plain text, so set u[...]

96267 • G Chapter 7 Configuring email alerts 161 ■ ipstorckcfg check ipstor.conf (VTL configuration check) notifies the administrator if the VTL software’s XML con figuration file, ipstor.conf , changes. If changes ar e found or if no previous version exists, the scrip t creates a copy of the current file under the name ipstorconf.diff. nnn ,[...]

162 VTL User Guide • May 2008 G • 96267 7. When the Set Email Alerts Event Notification Properties panel appears, use the radio buttons to select th e event-severity level that should trigger notification ( K below), use the spinner control to set the Maximum e vent wait time ( L ), and press Next ( M ). 8. When the Verify the Email Alerts Prop[...]

96267 • G Chapter 7 Configuring email alerts 163 1. In the object tree of the VTL console, right-click on th e VTL server , and select Email Alerts from the context menu. 2. When the Set Email Alerts Properties dialog appe ars, select the Trigger tab ( A below). 3. If you want to modify an existing trigger , highl ight the trigger ( B above), and[...]

164 VTL User Guide • May 2008 G • 96267 4. T o create a new trigger , press Add ( F below). Wh en the Add a Customized Trigger dialog appear s, supply a Trigger Name , a command line Argument string, and a File Location (path and filename) for th e script ( G ), and redirect notifications, if desired ( H ). Press OK ( J ). 5. Pre ss OK to exit [...]

96267 • G 165 CHAPTER 8 Updating  VTL  softw are When  softw are  patches  become  available,  they  are  pos ted  on  the  online  Sun  StorageT ek  Customer  Resource  Center  with  accomp anying,  explanatory  text  (“readme”)  files.  Download  the  patch  fi[...]

166 VTL User Guide • May 2008 G • 96267 3. The n,  from  the  VTL  console  main  menu,  select  Tools  ( A  be low).  4. Fro m  the  submenu,  se lect  Add Patch  ( B above). 5. When  the  warning  notice  appears,  click  OK  ( C below)  to  continue. A B C[...]

96267 • G Chapter 8 Updating VTL software 167 6. Loc at e  the  subdirectory  where  the  patch  files  reside  ( D  below),  select  the  patch  file  ( E ),  and  press  Open  ( F ). In  the  example,  the  patch  files  are  shown  in  the  standard  locatio[...]

168 VTL User Guide • May 2008 G • 96267 9. Rec on nec t  to  the  VTL  server  by  double ‐ clicking  on  the  server  node  in  the  object  tree  at  the  left  of  the  VTL  console. 10. V erify  that  the  patch  was  successfully  applied:  after  you [...]

96267 • G 169 APPENDIX A VTL  command  line  reference Virt ualT ape Library User Guide Vir t u a l T ap e  Library  (VTL)  provides  a  simple  utility  that  allows  you  to  perform  some  of  the  more  common  VTL  functions  at  a  command  line  instead  of ?[...]

170 VTL User Guide • May 2008 G • 96267 ■ For  a  va l u e  entered  as  a  literal,  it  is  necessary  to  enclose  the  val u e  in  quotes  (double  or  single)  if  it  contains  sp ecial  characters  such  as  *,  <,  >,  ?,  |,  %,  $,[...]

Login/logout to the VTL Server 96267 • G Appendix A VTL command line reference 171 Login/logout  to  the  VTL  Serv er Log  in  to  the  VTL  Serv er iscon login [-s <server-name> -u <username> -p <pa ssword>|-e] [-X <rpc- timeout>] iscon login [--server-name=<server-name> --server- usernam[...]

Virtual devices / Clients 172 VTL User Guide • May 2008 G • 96267 Log  out  from  the  VTL  Serv er iscon logout -s <server-name> [-X <rpc-timeout>] iscon logout --server-name=<server-name> [--rpc-ti meout=<rpc-timeout>] Description : This  command  allows  you  to  log  out  from  [...]

Virtual devices / Clients 96267 • G Appendix A VTL command line reference 173 ‐ C  ( ‐‐ long ‐ client ‐ list)  displays  the  assi gned  client  list  when ‐ l  ( ‐‐ long list)  option  is  specified. ‐ M  ( ‐‐ output ‐ delimiter)  can  be  specified  when ‐ l  is [...]

Virtual devices / Clients 174 VTL User Guide • May 2008 G • 96267 Add  client iscon addclient -s <server-name> [-u <username> -p <password>] -c <client-name> [-I <initiator-wwpns>] [-a <on|off>] [-A <on|off>]] | [-C <on|off>] [- X <rpc- timeout>] iscon addclient --server-name=<server-n[...]

Virtual devices / Clients 96267 • G Appendix A VTL command line reference 175 This  comm and  allows  yo u  to  delete  a  client  from  the  spec ified  server . ‐ c  ( ‐‐ client ‐ name)  is  the  name  of  the  client  to  be  deleted. ‐ X  ( ‐‐ rpc ‐ timeout) [...]

Virtual devices / Clients 176 VTL User Guide • May 2008 G • 96267 The  va l u e s  for  <access ‐ mode>  are:  Readonly ,  ReadWrite,  ReadWriteNonExclusive .  The  val u e s  for  the  short  format  are:  R  /  W  /  N. ‐ y  ( ‐‐ vlib ‐ only)  is  an  option [...]

Virtual devices / Clients 96267 • G Appendix A VTL command line reference 177 ‐ X  ( ‐‐ rpc ‐ timeout)  is  an  option  to  specify  a  number  between  1  and  30000  in  seconds  for  the  RPC  timeout.  The  system  will  retry  the  command  for  the  amo[...]

Virtual devices / Clients 178 VTL User Guide • May 2008 G • 96267 ‐ v  ( ‐‐ vdevid)  is  required  to  specify  the  virtual  device  ID. A  virtual  device  cannot  be  deleted  if  any  of  the  following  co nditions  apply: ■ The  specified  virtual  device  [...]

Virtual devices / Clients 96267 • G Appendix A VTL command line reference 179 ‐ X  ( ‐‐ rpc ‐ timeout)  is  an  option  to  specify  a  number  between  1  and  30000  in  seconds  for  the  RPC  timeout.  The  system  will  retry  the  command  for  the  amo[...]

Virtual devices / Clients 180 VTL User Guide • May 2008 G • 96267 [--capacity-on-demand --initial-size=<initial-size > --increment- size=<increment-size>] [--max-capacity=<max-capacity>] [--auto-loader=<on |off>] [--key-name=<key-name> --key-pasword=<key-password >] [--rpc-timeout=<rpc- timeout>] Descri[...]

Virtual devices / Clients 96267 • G Appendix A VTL command line reference 181 ‐ T  ( ‐‐ num ‐ of ‐ slots)  and ‐ E  ( ‐‐ import ‐ export ‐ slots)  are  optional.  The  <num ‐ of ‐ slots >  can  exceed  the  maximum  number  of  slots  supported  by  the  specif[...]

Virtual devices / Clients 182 VTL User Guide • May 2008 G • 96267 ‐ L  ( ‐‐ tape ‐ library ‐ vid)  is  required  to  specify  the  virtual  tape  library  to  add  the  virtual  tape  drive(s). ‐ r  ( ‐‐ vdrive ‐ name ‐ prefi x)  is  an  option  to  specify  t[...]

Virtual devices / Clients 96267 • G Appendix A VTL command line reference 183 The  unit  of  <max ‐ capacity>,  <initial ‐ size>  and  <in crement ‐ size>  are  all  in  GB. ‐ X  ( ‐‐ rpc ‐ timeout)  is  an  option  to  specify  a  number  between  1  a[...]

Virtual devices / Clients 184 VTL User Guide • May 2008 G • 96267 ‐ B  ( ‐‐ barcode)  is  an  option  to  either  set  the  virtual  tape  with  the  provided  barcode  or  create  virtual  tapes  in  batch  mode  configured  with  barc odes  form  the  speci[...]

Virtual devices / Clients 96267 • G Appendix A VTL command line reference 185 iscon movevirtualtape --server-name=<server-name> [--server-username=<username> --server-password=<p assword>] --vdevid=<vdevid> [--tape-library-vid=<tape-library-vid> | --tape-dr ive-vid=<tape-drive-vid> | --slot-no=<slot-no>] [...]

Virtual devices / Clients 186 VTL User Guide • May 2008 G • 96267 Ta p e  copy iscon tapecopy -s <server-name> [-u <username> -p <password>] -v <source-vdevid> -S <target-name> [-U <target-us ername> -P <target- password>] [-L <tape-library-vid> | -D <tape-drive-vid>] [-n <vdevname>[...]

Virtual devices / Clients 96267 • G Appendix A VTL command line reference 187 -v <vdevid> -Z <on|off> -Q <num-of-copies> [-X <rp c-timeout>] iscon setvirtuallibrarytapeduplication --server-na me=<server-name> [--server-username=<username> --server-password=<p assword>] --vdevid=<vdevid> --tape-dupli[...]

Virtual devices / Clients 188 VTL User Guide • May 2008 G • 96267 Description : This  comm and  sets  tape  properties. ‐ v  ( ‐‐ vdevid)  is  required  to  specify  the  ID  of  the  virtu al  tape  to  se t  the  properties. ‐ B  ( ‐‐ barcode)  is  the  option ?[...]

Automated tape caching 96267 • G Appendix A VTL command line reference 189 ‐ k  ( ‐‐ key ‐ name), ‐ W  ( ‐‐ key ‐ passw ord)  and ‐ d  ( ‐‐ disable ‐ key)  are  options  for  tape  encryption  support  to  be  set  in  conjunction  with  Auto ‐ Archiv e  Mode. ?[...]

Automated tape caching 190 VTL User Guide • May 2008 G • 96267 Description : This  comm and  can  be  used  in  order  to  enable,  disable,  or  change  the  Automated  Ta p e  Ca ching  policy  for  a  virtual  tape  library . ‐ L  ( ‐‐ tape ‐ library ‐ vid)  is ?[...]

Automated tape caching 96267 • G Appendix A VTL command line reference 191 ‐ X  ( ‐‐ rpc ‐ timeout)  is  an  option  to  specify  a  number  between  1  and  30000  in  seconds  for  the  RPC  timeout.  The  system  will  retry  the  command  for  the  amount[...]

Automated tape caching 192 VTL User Guide • May 2008 G • 96267 ‐ k  ( ‐‐ key ‐ name)  and ‐ W  ( ‐‐ key ‐ password)  are  options  for  tape  en cryption  support.  If  the  tape  to  be  synchronized  was  encrypted  through  the  sy stem,  you  need  to ?[...]

Automated tape caching 96267 • G Appendix A VTL command line reference 193 Reclaim  disk  space iscon reclaimtapes -s <server-name> [-u <username> -p <password>] -T <tape-vid-list> [-X <rpc-timeout>] iscon reclaimtapes --server-name=<server-name> [--server-username=<username> --server-password=<p[...]

System configuration 194 VTL User Guide • May 2008 G • 96267 ‐ I  ( ‐‐ scsiaddress)  is  the  option  to  specify  which  physical  devices  should  be  used  to  create  the  virtual  device.  It  can  be  a  list  of  ACSLs  separated  with  commas  or ?[...]

System configuration 96267 • G Appendix A VTL command line reference 195 Remov e  a  license  keycode iscon removelicense -s <server-name> [-u <username > -p <password>] -k <license-keycode> [-X <rpc-timeout>] iscon removelicense --server-name=<server-name> [--server-username=<username> --server-[...]

Import/Export 196 VTL User Guide • May 2008 G • 96267 ‐ F  ( ‐‐ vtl ‐ info ‐ filter)  is  an  additional  fi lter  that  can  be  combined  using  the  following  val u e s  separated  with  comma s:  library  or  drive  or  tape . ■ library  =  include  physica[...]

Import/Export 96267 • G Appendix A VTL command line reference 197 ‐ M  ( ‐‐ import ‐ mode)  is  an  option  in  one  of  the  following  val u es :  copy  (default)  or  dire ct ‐ access  or  recycle . ‐ v  ( ‐‐ pdrive ‐ or ‐ pdriv e ‐ vid)  is  required  to  spe[...]

Import/Export 198 VTL User Guide • May 2008 G • 96267 Description : This  comm and  exports  the  inform ation  from  a  vir tual  tape  to  a  physical  tape.  ‐ v  ( ‐‐ vdevid)  is  required  to  specify  the  ID  of  the  virtu al  tape  to  be  exported ?[...]

Import/Export 96267 • G Appendix A VTL command line reference 199 [-j <job-id-list>] [-T <job-type> -S <job_status>] [-X <rpc-timeout>] iscon getimportexportjobstatus --server-name=<serv er-name> [--server-username=<username> --server-password=<p assword>] [--job-id-list=<job-id-list>] | [--job-type[...]

Import/Export 200 VTL User Guide • May 2008 G • 96267 Delete  import/export  jobs iscon deleteimportexportjobs -s <server-name> [-u <username> -p <password>] -j <job-id-list> [-X <rpc-timeout>] iscon deleteimportexportjobs --server-name=<server -name> [--server-username=<username> --server-passwor[...]

Replication 96267 • G Appendix A VTL command line reference 201 [--server-username=<username> --server-password=<p assword>] --job-id- list=<job-id-list> [--rpc-timeout=<rpc-timeout>] Description : This  comm and  cancels  specified  import/export  jobs.  The  jobs  must  be  held  in  t[...]

Replication 202 VTL User Guide • May 2008 G • 96267 ‐ v  ( ‐‐ source ‐ vdevid)  is  required  to  specify  the  ID  of  the  virtual  tape  to  be  configured  for  replication. ‐ S  ( ‐‐ target ‐ name)  is  required  to  spec ify  the  target  server  na[...]

Replication 96267 • G Appendix A VTL command line reference 203 Promote  a  replica iscon promotereplica -s <server-name> -v <vdevid> | -S <target-name> -V <replicaid> [-u <username> -p <password>] [-U <target-username > -P <target-password>] [- f] [-X <rpc-timeout>] iscon promotereplica[...]

Replication 204 VTL User Guide • May 2008 G • 96267 --server-password=<password>] [--target-username=< target-username> --target-password=<target-password>] [--force] [--rpc-timeout =<rpc-timeout>] This  command  allows  you  to  remove  the  rep lication  configuration  from  the  primar[...]

Replication 96267 • G Appendix A VTL command line reference 205 Resume  replication iscon resumereplication -s <server-name> [-u <user name> -p <password>] -v <vdevid> [-X <rpc-timeout>] iscon resumereplication --server-name=<server-name > [--server-username=<username> --server-passwor d=<password&g[...]

Replication 206 VTL User Guide • May 2008 G • 96267 ‐ w  ( ‐‐ wa t e r m a r k )  is  a  data  size  based  trigger  in  MB.  The  wa t e r m a r k  is  check ed  when  the  tape  is  unloaded  from  the  tape  drive  and  the  replicatio n  is  triggered [...]

Replication 96267 • G Appendix A VTL command line reference 207 ‐ v  ( ‐‐ source ‐ vdevid)  is  required  to  specify  the  ID  of  the  source  virtual  tape. ‐ X  ( ‐‐ rpc ‐ timeout)  is  an  option  to  specify  a  number  between  1  and  30000  in  [...]

Physical devices 208 VTL User Guide • May 2008 G • 96267 Stop  replication iscon stopreplication -s <server-name> [-u <userna me> -p <password>] -v <vdevid> [-X <rpc-timeout>] iscon stopreplication --server-name=<server-name> [--server-username=<username> --server-password=<p assword>] -vdevid=[...]

Physical devices 96267 • G Appendix A VTL command line reference 209 Get  physical  tape  list iscon getphysicaltapelist -s <server-name> [-u <us ername> -p <password>] -l <physical-tape-library-vid> [-X <rpc-timeout>] iscon getphysicaltapelist --server-name=<server-na me> [--server-username=<userna[...]

Physical devices 210 VTL User Guide • May 2008 G • 96267 ‐ B( ‐‐ physical ‐ tape ‐ barcode)  iden tifies  the  physical  tape  to  be  mov ed.  If  barcode  is  not  provided ,  the  current  tape  location  must  be  provided  accordingly  to  the  requested  ope[...]

Physical devices 96267 • G Appendix A VTL command line reference 211 Assign  physical  resource  to  VTL iscon assignresourcetovtl -s <server-name> [-u <us ername> -p <password>] -I <ACSL> [-L <tape-library-vid>] [-X <rpc-timeout >] iscon assignresourcetovtl --server-name=<server-na me> [--ser[...]

Physical devices 212 VTL User Guide • May 2008 G • 96267 Get  physical  device  information iscon getpdevinfo -s <server-name> [-u <username> -p <password>] [-F [-M | -C <category>] | [-a] [-A] [-I <ACSL>] ] [-o <output-format>] [-X <rpc-timeout>] iscon getpdevinfo --server-name=<server-name[...]

Physical devices 96267 • G Appendix A VTL command line reference 213 Rescan  physical  devices iscon rescandevices -s <server-name> [-u <username > -p <password>] [-a <adapter-range>] [-i <scsi-range>] [-l <lun-ra nge>] [-L] [-X <rpc- timeout>] iscon rescandevices --server-name=<server-name> [[...]

Physical devices 214 VTL User Guide • May 2008 G • 96267 The  <guid>  is  the  unique  identifier  of  the  physical  device.  <ACSL >  is  the  SCSI  address  of  the  physical  device  in  the  following  format:  #: #:#:#  ( adapter:chann el:scsi  id:lun) [...]

Reports 96267 • G Appendix A VTL command line reference 215 Reports Serv er  throughput  report iscon createserverthroughputreport -s <server-name > [-u <username> -p <password] [-z <report period>] | [-D <date-range>] [-o <file name>] [-f] [-X <rpc- timeout>] iscon createserverthroughputreport --serve[...]

Reports 216 VTL User Guide • May 2008 G • 96267 SCSI  channel  throughput  report iscon createscsichannelthroughputreport -s <server -name> [-u <username> -p <password>] [-z <report period>] | [-D <date-range>] -t <adapter-no> [-o <filename>] [-f] [-X <rpc-timeout>] iscon createscsichanne[...]

Reports 96267 • G Appendix A VTL command line reference 217 Device  throughput  report iscon createdevicethroughputreport -s <server-name > [-u <username> -p <password>] -I <ACSL> [-z <report period>] | [-D <date-range>] [-o <filename>] [-f] [-X <rpc-timeout>] iscon createdevicethroughputrepor[...]

Reports 218 VTL User Guide • May 2008 G • 96267 Physical  resources  configuration  report iscon createphyresourcesconfreport -s <server-name > [-u <username> -p <password>] [-o <filename>] [-f] [-X <rpc-timeout>] iscon createphyresourcesconfreport --server-name=< server-name> [--server-username=<[...]

Reports 96267 • G Appendix A VTL command line reference 219 Specify  the ‐ f  ( ‐‐ force)  option  if  you  wa n t  to  overwrite  the  existing  file  if  the  output  file  already  exists. ‐ X  ( ‐‐ rpc ‐ timeout)  is  an  option  to  specify  a  number[...]

Reports 220 VTL User Guide • May 2008 G • 96267 This  comm and  creates  a  report  that  displays  the  physical  resource  a llocation  of  a  specific  device  on  a  specific  serv er . ‐ I  <ACSL>  ( ‐‐ scsiaddress)  is  the  LUN  address  of  the [...]

Reports 96267 • G Appendix A VTL command line reference 221 [-D <date-range>] [-r <repl-resource-type> | -R <r esourceList>] [-o <outputFilename>] [-f] [-X <rpc-timeout>] iscon createreplicationstatusreport --server-name= <server-name> [--server-username=<username> --server-password=<p assword>] [--[...]

Reports 222 VTL User Guide • May 2008 G • 96267 [-o <filename>] [-f] [-X <rpc-timeout>] iscon createvirlibinforeport --server-name=<server -name> [--server-username=<username> --server-password=<p assword>] [--output- file=<filename>] [--force] [--rpc-timeout=<rpc-timeout>] Description : This  comm a[...]

Reports 96267 • G Appendix A VTL command line reference 223 Create  job  report iscon createjobreport -s <server-name> [-u <userna me> -p <password>] [-z <report period>] | [-D <date-range>] [-o <file name>] [-f] [-X <rpc- timeout>] iscon createjobreport --server-name=<server-name> [--server-u[...]

Event Log 224 VTL User Guide • May 2008 G • 96267 Ev ent  Log Get  Event  Log iscon geteventlog -s <server-name> [-u <username> -p <password>] [-D <date-range>] [-F <fileFormat>] [-o <filename> ] [-H] [-f] [-X <rpc- timeout>] iscon geteventlog --server-name=<server-name> [--server-usernam[...]

Technical support 96267 • G Appendix A VTL command line reference 225 T echnical  support Get  X ‐ Ray iscon getxray -s <server-name> [-u <username> -p < password>] [-l <#|all|YYMMDDhhmm-YYMMDDhhmm>] [-r] [-o <filen ame>] [-f] [-X <rpc- timeout>] iscon getxray --server-name=<server-name> [--server[...]

Technical support 226 VTL User Guide • May 2008 G • 96267 Get  attention  required  information iscon getattentionrequired -s <server-name> [-u <u sername> -p <password>] [-X <rpc-timeout>] iscon getattentionrequired --server-name=<server-n ame> [--server-username=<username> --server-password=<p a[...]

96267 • G 227 APPENDIX B Required  ports In  order  to  mainta in  a  high  level  of  security ,  yo u  should  disable  all  unnecessary  ports.  The  only  ports  required  by  VTL  are: ■ TCP  port  11576 ‐  Used  for  VTL  Console  to  VTL  Se[...]

228 VTL User Guide • May 2008 G • 96267[...]

96267 • G 229 APPENDIX C T roubleshooting This  appendix  addresses  the  following  issues: ■ “Problems  during  console  opera tions”  on  page 229 ■ “Problems  affecting  physi cal  resources”  on  page 232 ■ “Problems  with  virtual  resources”  on  page 233 ■ “[...]

230 VTL User Guide • May 2008 G • 96267 5. If you still cannot connect, try to conn ect using the server ’s IP address instead of its server name (or vice versa). 6. If you can now connect , stop here. The  host  name  or  IP  address  that  failed  may  be  incorrect. 7. If you still cannot connect, check networ[...]

96267 • G Appendix C Troubleshooting 231 Case: Connection  fails  while  expanding  the  VTL  server  node 1. Chec k the memory consumption on the console host. 2. If memory consumption is excessive, stop unnecess ary pr ocesses, and retry . 3. If you can connect, stop here. Av o i d  running  memory ‐ intensive  a[...]

232 VTL User Guide • May 2008 G • 96267 Case: High  server  activity  1. Chec k the Event Log or syslog ( /var/adm/messages ) for CPU-intensive activity on the server . Backup  jobs  that  backup  to  multiple  virtual  or  physical  devices  in  parallel,  data  compression,  and  encrypti [...]

96267 • G Appendix C Troubleshooting 233 7. If you have still not solved the pr oblem, contact Sun technical support. Problems  with  virtual  resources Issue: V irtual  tapes  are  shown  offline  in  the  console  Indications: V irtual  tapes  are  offline . Diagnostics: Locate  th e  physical [...]

234 VTL User Guide • May 2008 G • 96267 5. If you fi nd disk space errors, ther e may not be enough physical dis k space for the expansion. Add more physica l stor age or ch ange the size of exp ansion. Then r etry . 6. If no disk space problems wer e found, or if correcting them does not solve the problem, ma ke sure that the physical storag e[...]

96267 • G Appendix C Troubleshooting 235 2. If the operating system does not show the device, go t to “The operating system cannot detect the device” on page 235. 3. If the operating sys tem does show the device, go to “App lications cannot se e the device” on page 235. Case: The  operating  system  cannot  detect  the  [...]

236 VTL User Guide • May 2008 G • 96267 Case: The  backup  applicati on  cannot  see  the  device  at  all 1. If the operating system sees the device but a backup applicatio n does not, check the drivers for the backup sof tware. Make sur e the driver is appropriate for the library and tape drive type. 2. If a driver app[...]

96267 • G Appendix C Troubleshooting 237 3. Using the VTL console, load a tape into a virtual drive. While  most  raw  device  utilities  work  with  tape  drives,  they  canno t,  in  most  cases,  load  tapes.  Even  if  some  can  mo ve  tapes,  you  need  to  know  [...]

238 VTL User Guide • May 2008 G • 96267 Yo u  can  only  import  and  export  data  between  a  physic al  tape  device  and  a  virtual  tape  device  of  the  same  type,  using  physic al  and  virtual  media  of  the  same  capacity .  2. If dissimilar[...]

96267 • G Appendix C Troubleshooting 239 2. If physical tape drives requir e cleaning, clean them, and stop here. Retry the import/export operation. 3. If cleaning is unnecessary or does not help, see if phy sical tapes need to be moved and mounted before the import/export operation can continue. 4. If tapes have to be moved, move th em, and stop[...]

240 VTL User Guide • May 2008 G • 96267 ▼ Ta k i n g  an  X ‐ Ray 1. In  the  object  tr ee  of  the  VTL  console,  right ‐ click  on  the  branch  representing  the  VTL  server  ( A below),  and  select  X-Ray  fr om  the  context  menu  ( B ). D A[...]

96267 • G Appendix C Troubleshooting 241 2. When  the  X-Ray Options  di alog  appears,  check  the  checkboxes  corresponding  to  the  items  that  you  need  to  include  ( C belo w). The  defaults  are  shown  below:  If  you  select  the  Log File  option,  y[...]

242 VTL User Guide • May 2008 G • 96267[...]

96267 • G 243 APPENDIX D SNMP  traps The  VTL  product  family  de fines  the  following  Simple  Network  Management  Protocol  (SNMP)  traps.  T rap Severity Message 9 Error SCSI Port E rror -- %1. 1000 Error Socket connecti on could not be terminate d properly -- %1. 1001 Error Socket connecti on could[...]

244 VTL User Guide • May 2008 G • 96267 1020 Informational Replication for virtual tape %1 started . 1021 Informational Replication for virtual tape %1 finishe d. 1022 Warning Replication has failed for virtual tape %1 -- %2. 1023 Error Failed to conn ect to physica l device %1. Switching alias to %2. 1024 Informational Device %1 has attached t[...]

96267 • G Appendix D SNMP traps 245 1047 Error Rescan replica has failed for virtua l device %1 -- the rep lica device failed with error %2. 1048 Error Rescan replica ha s failed for virtual devi ce %1 -- the network trans port returned error %2 . 1049 Error Rescan replica ca nnot proceed -- replica tion control area not pr esent on virtual devi [...]

246 VTL User Guide • May 2008 G • 96267 1074 Error Replication can not proceed -- unable to al locate memory. 1075 Error Replication can not proceed -- unexpected er ror %1. 1076 Informational Starting replicati on for virtual device %1 of group %2 to replica de vice %3. 1077 Informational Replication for group %1 has completed successfully. 10[...]

96267 • G Appendix D SNMP traps 247 7002 Error Patch %1 failed -- it ap plies only to build %2. 7003 Error Patch %1 failed -- you must be the root user to apply the patch. 7004 Warning Patch %1 installa tion failed -- it has already been applied. 7005 Error Patch %1 installa tion failed -- prerequi site patch %2 has not been applied. 7006 Error P[...]

248 VTL User Guide • May 2008 G • 96267 10206 Informational Add scsi alias=%1. 10207 Error "Add Adapter % 1 failed, not enough memory. " 10208 Informational "Set Adapter %1 offline , adapter count %2." 10209 Error "Add Physical Device %1 fail ed, not enough memory." 10210 Warning Marked Physical Dev ice [%1] OFFLIN[...]

96267 • G Appendix D SNMP traps 249 11006 Error VTL communicati on module failed to start . 11007 Warning There is not enough di sk space available to successfully comp lete this operation and mai ntain the integrity of the configuratio n file. There is currently %1 MB of disk space availab le. VTL requires %2 MB of disk space to continue. 11010 [...]

250 VTL User Guide • May 2008 G • 96267 11170 Error Failed to virtualiz e LUN %1 because of mis matching size betwe en configuration file and disk. Please do re scan and try it again. 11200 Error Buffer overflow. 11201 Error Too many Console connec tions. 11202 Error Console (%1): Illegal access. 11203 Error Console (%1): SCSI device re -scanni[...]

96267 • G Appendix D SNMP traps 251 11232 Error Console (%1) : Failed to g et memory stat us. 11233 Error Console (%1) : Failed to m ap the SCSI d evice name for [%2 %3 %4 %5]. 11234 Error "Console (%1): Fa iled to execute ""hdpar m"" for %2." 11235 Error Console (%1) : Failed to g et the VTL Se rver module status. 1[...]

252 VTL User Guide • May 2008 G • 96267 11265 Error Console (%1): Failed to rest art IOCore mod ule. 11266 Error Console (%1): Failed to eras e partition of virtual device %2. 11267 Informational Console (%1): Virtual device %2 partiti on erased. 11268 Error Console (%1): Failed to update meta informati on of virtual device %2. 11269 Error Cons[...]

96267 • G Appendix D SNMP traps 253 11298 Error Console (%1): Failed to reset cache on targe t device %2 (ID: %3) for %4 c opy. 11300 Error Invalid user name (%1) us ed by client at IP address %2. 11301 Error Invalid passwor d for user (%1) used by clien t at IP address %2. 11302 Error Invalid passcod e for machine (%1) used by cl ient at IP addr[...]

254 VTL User Guide • May 2008 G • 96267 11509 Informational Console (%1): Proper ties set for the VTL Server. 11510 Error Console (%1): Failed to save report -- %2 . 11511 Error Console (%1): Failed to get the informatio n for the NIC. 11512 Error "Console (%1): Faile d to add a replica for virtua l tape %2 to VTL Server %3 (watermark: %4 [...]

96267 • G Appendix D SNMP traps 255 11539 Error Console (%1): Fai led to import physical de vice %2. 11540 Error "Console (%1): Ho st name mismatch (old: %2 , new: %3)." 11541 Error Console (%1) : Failed to s ave event mess age (ID: %2). 11542 Error Console (%1): Fai led to remove virtual tap e replica %2. 11543 Informational Console (%[...]

256 VTL User Guide • May 2008 G • 96267 11575 Error Console (%1): Faile d to unassign Fibre C hannel device %2 fro m %3 (not rolled back) and retu rns %4. 11576 Informational Console (%1): Fibre Channel device %2 u nassigned from %3. 11577 Error Console (%1): Failed to get Fibre Channel target information. 11578 Error Console (%1): Failed to ge[...]

96267 • G Appendix D SNMP traps 257 11651 Error Medium Test faile d for SCSI device %1. 11652 Error "Could not get type fo r SCSI device %1, becaus e of inquiry string failu re." 11653 Error "Discarded s csi device %1, unsupported t ype ""%2""." 11654 Error "Discarded s csi device %1, missing MTI vendo[...]

258 VTL User Guide • May 2008 G • 96267 11711 Error Console (%1): The replication setup for %2 %3(s) was rolled back. 11712 Error Console (%1): Failed to configure replicati on for %2 %3(s). Error: %4 . 11713 Informational Console (%1): Replic ation for %2 %3(s) configured successfu lly. 11714 Error Console (%1): The confi guration file update [...]

96267 • G Appendix D SNMP traps 259 11740 Error Console (%1): Fai led to create virtual tap e drives. Error: %2. 11750 Informational Console (%1) : Add VirtualTape Library Emulation option successf ully. 11751 Informational Console (%1) : Remove VirtualTape Libr ary Emulation option succe ssfully. 11780 Informational Tape id %1 [%2] is enable d w[...]

260 VTL User Guide • May 2008 G • 96267 12005 Error Failed to allo cate memory. 12006 Warning Log size warning. 12007 Error Failed to delete file %1. 12008 Error Wrong file format %1. 12009 Error Missing paramet er %1. 12010 Error Invalid paramet er %1. 12011 Error Wrong status for file %1. 13000 Informational "VTL Failover Module started [...]

96267 • G Appendix D SNMP traps 261 13311 Error Failed to merge stat ic configuration for the primary server. 13312 Error Failed to m erge dynamic c onfiguration fo r the primary server. 13313 Error Out of memory -- %1. 13314 Error Failed to read from fi le %1. 13315 Error Failed to merge auth entication inform ation for the primary ser ver. 1331[...]

262 VTL User Guide • May 2008 G • 96267 13811 Informational Primary server failback initiated. 13812 Informational Server IP addr ess add successfully. 13814 Informational Quorum disk returned to primary. 13815 Informational Virtual drives added successfully. 13816 Informational Primary server restored. 13817 Critical Primary server failback wa[...]

96267 • G Appendix D SNMP traps 263 13843 Error Secondary se rver fail to get original c onf file from repository before failback . 13844 Error Failed to write %1 to re pository. 13845 Warning Quorum disk failu re detected. Secondary is still in takeove r mode. 13846 Informational Force takeover is initiated. Sec ondary will perfor m SCSI reserve[...]

264 VTL User Guide • May 2008 G • 96267 13878 Error Primary server has invalid f ailover configu ration. 13879 Critical Secondary server det ect kernel module failure, reboot machi ne may need. 15050 Error Server ioctl call %1 fail ed on vdev id %2: Invalid Arg ument (EINVAL). 15051 Error Server ioctl c all %1 failed on vdev id % 2: I/O error ([...]

96267 • G Appendix D SNMP traps 265 19051 Informational [Remote Copy ] The copying of the v irtual tape %1 to the r emote server has been started. 19052 Informational [Remote Copy] The copying of the virtua l tape %1 to the remote serve r has finished. 19053 Informational "[Remote Copy] Th e configuration for remote copy is removed . Server:[...]

266 VTL User Guide • May 2008 G • 96267 19204 Error Console (%1): Failed to dele te Key %2. 19205 Informational Console (%1): Key %2 has be en deleted successfully. 19206 Error Console (%1): Failed to update information fo r key %2. 19207 Informational Console (%1): Inform ation for key %2 has been updated successful ly. 19208 Error Console (%1[...]

96267 • G Appendix D SNMP traps 267 25001 Error %1 failed to start -- %2 . 25002 Informational %1 paused. 25003 Error %1 failed to pause -- %2 . 25004 Informational %1 resumed. 25005 Error %1 failed to resume -- %2. 25006 Informational %1 stopped. 25007 Error %1 failed to stop -- %2. 25008 Informational %1 shutdown. 25009 Informational %1 startin[...]

268 VTL User Guide • May 2008 G • 96267 26207 Error Failed to define device %1 -- %2. 26208 Error Failed to unde fine device %1 -- %2. 26209 Error Drive %1 is busy a nd cannot be det ached. The SAN C lient cannot stop at this time. 26210 Informational Both %1 and % 2 have the same disk sig nature (%3). 27000 Error Failed to conn ect to VTL Se r[...]

96267 • G Appendix D SNMP traps 269 40007 Error "Unload tape from drive f ailed, Drive % 1, EC %2" 40008 Error Failed to c reate new tape in Virtual L ibrary %1 40009 Error "HW Error with Move Me dium command, Lib %1, Sr cEle %2 DestEle %3" 40010 Error Attach to t ape %1 failed 40011 Error "Failed to read from Virt ual Ta[...]

270 VTL User Guide • May 2008 G • 96267 40038 Informational "Physical Library un assigned. Vid %1, [%2][%3]" 40039 Error Read Element c ommand to Phys ical Library % 1 failed. EC %2 40040 Error Attach to device %1 faile d. EC %2 40041 Informational "Physical Tape Drive assigned to exclus ive use for VTL. VID %1, [%2] [%3]" 4[...]

96267 • G Appendix D SNMP traps 271 40070 Error Cannot delete Tap e %1 40071 Error "Cannot impo rt Tape, dest slot %1 in V irtual Library %2 is ful l" 40072 Informational "Properties of Ta pe %1 has been changed. Barcode %2, MaxCapac ity %3 MB" 40073 Informational "Tape Created in Sta nd Alone Virtual Tape Drive. Tape VID[...]

272 VTL User Guide • May 2008 G • 96267 40100 Error Waited %1 seconds to get a re sponse from %2 (%3) after trying to retrieve drive information in ACS %4. Timing out. 40101 Error Failed to retr ieve volume in formation in A CS %1 and Pool %2. Erro r from %3 (%4): %5. 40102 Error Waited %1 seconds to ge t a response from ACSLS (%2) after trying[...]

96267 • G Appendix D SNMP traps 273 40127 Informational Disk space alloca ted for tape VID %1 Barcode [%2] in vault has bee n reclaimed successfully 40128 Error Failed to reclaim disk space allocated for tape VID %1 Barcode [%2] in va ult 40129 Informational No Free physical dri ve to load direct link tape VID %1 BarCode [%2]. 40130 Warning Unabl[...]

274 VTL User Guide • May 2008 G • 96267[...]

96267 • G 275 APPENDIX E E E ILOM  command  reference The  following  table  summarizes  Inte grated  Lights  Out  Manager  (ILOM )  commands  you  can  use  to  manage  the  service  processor .  For  more  information  on  ILOM  commands,  see  the  ILOM Adminis[...]

276 VTL User Guide • May 2008 G • 96267 Change  the  host  serial  port  configuration. Note:  This  sp eed  setting  must  match  the  speed  setting  for  ser ial  port  0,  COM1  or  /dev/ttyS 0  on  the  host  operating  system. set /SP/serial /host pendingspeed= int[...]

96267 • G Appendix E ILOM command reference 277 Host System Commands Delet e  thi s  device  from  an  SNMP  private  community . delete /SP/ser vices/snmp/communities/priva te/ comm2 Start  the  host  system. start /SYS Stop  the  host  system. stop /SYS Reset  the  host  system. reset /SYS Start ?[...]

278 VTL User Guide • May 2008 G • 96267[...]