


JB_CONFIG(8)                                         JB_CONFIG(8)


NNAAMMEE
       jjbb__ccoonnffiigg - jukebox resource configuration tool

SSYYNNOOPPSSIISS
       jjbb__ccoonnffiigg [ --ss _s_e_r_v_e_r ] [ --ll ]

DDEESSCCRRIIPPTTIIOONN
       The  jjbb__ccoonnffiigg  program provides an interactive script for
       configuring a jukebox (Media Autochanger Device)  for  use
       with  a  NetWorker server.  The script pauses periodically
       for you to enter a response to a prompt.  If you  want  to
       accept  the  default  choice  displayed  in  braces, press
       [RETURN] or [ENTER].

       After the jukebox is configured, use the nnssrrccaapp(8) command
       or  the  Registration window to enter the enabler code for
       your Autochanger Software Module. You must have a separate
       enabler  code  for  each jukebox you want to use with Net-
       Worker.

OOPPTTIIOONNSS
       --ss _s_e_r_v_e_r
              Specifies the controlling server, when jjbb__ccoonnffiigg is
              being  used from a storage node.  To define a juke-
              box resident on a storage node, the jjbb__ccoonnffiigg  com-
              mand must be run on the storage node. See nnssrr__ssttoorr--
              aaggee__nnooddee(5) for additional information  on  storage
              nodes.

       --ll     Performs   a  complete  LUN  search  for  all  SCSI
              adapters in the system when  performing  Autodetec-
              tion.   Normal behavior is to start checking at LUN
              0 for SCSI devices.  The first empty LUN found will
              end  the search for a given target ID.  With the --ll
              option, all LUNS present on all target IDs for  all
              SCSI busses in the system will be checked for juke-
              boxes.  This can take a vveerryy lloonngg ttiimmee  and  should
              therefore  only  be used when necessary.  For exam-
              ple, a Fibre Channel adapter can support 126 target
              IDs,  each  of  which  may  have  80  or more LUNs.
              Checking all LUNs on this single adapter  may  take
              over 10 minutes.

CCOONNFFIIGGUURRAATTIIOONN DDIIAALLOOGG
       The  first question jjbb__ccoonnffiigg will ask you, is to select a
       type of jukebox to install.


                       1) Install an Autodetected SCSI Jukebox.
                       2) Install a  Serial Jukebox.
                       3) Install an SJI Jukebox.
                       4) Install an RLM Jukebox.
                       5) Install an STL Silo.




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





JB_CONFIG(8)                                         JB_CONFIG(8)


              What kind of Jukebox are you installing? [1]

              You can either accept the default (1), by  pressing
              [RETURN] or [ENTER] or enter
               the number
               corresponding   to   the   jukebox  type  you  are
              installing.

              An Autodetected SCSI Jukebox  is  any  SCSI  (Small
              Computer  System Interface) based jukebox connected
              to  a  system  that  NetWorker  can   automatically
              detect.

              A  Serial  Jukebox  is  one  following  the IGM-ATL
              serial protocol connected to a serial (RS-232) port
              on  the  system.  This type of jukebox is only sup-
              ported on Sun and AIX platforms.

              An SJI Jukebox is a Standard Jukebox Interface com-
              pliant  jukebox.  This is a list of well known SCSI
              based jukeboxes, plus any  additional  third  party
              jukebox  devices  that adhere to this protocol that
              the you may have added to the system.

              If you select the first choice (Install an  Autode-
              tected  SCSI  Jukebox),  jjbb__ccoonnffiigg will print out a
              list of jukeboxes it detects on the system.

              For example:
                   These  are  the   SCSI   Jukeboxes   currently
                   attached to your system:
                          1) scsidev@0.2.0: other, Vendor <AIWA>,
                        Product <AL-17D>
                          2) scsidev@2.2.0: DLI Libra Series
                          3) scsidev@1.4.1: ARC-DiamondBack
                   Which one do you want to install?
              When this message appears, enter the number  corre-
              sponding to the jukebox that you wish to configure.
              If you choose to install a Serial Jukebox,  jjbb__ccoonn--
              ffiigg  will  print out list of known Serial Jukeboxes
              and ask which one they wish to select.

              For example:
                   Enter the number corresponding to the type  of
                   jukebox you are installing:
                     1) Lago Datawheel (serial)
                     2) STK-9709/Odetics (serial)
                     3) ATL (serial)
                   Choice?

                   When  this  messages appears, you should enter
                   the number corresponding to the  jukebox  that
                   you want to configure.




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





JB_CONFIG(8)                                         JB_CONFIG(8)


                   If  you  choose  to  install  an SJI compliant
                   jukebox, jjbb__ccoonnffiigg  will  print  out  list  of
                   known  SJI  Jukeboxes  and will prompt you for
                   the appropriate type that you want to  config-
                   ure.

                   For example:
                        Enter  the  number  corresponding  to the
                        type of jukebox you are installing:
                                1) ADIC-1200c/ADIC-1200d
                                2) ADIC-VLS
                                3) ARC-DiamondBack
                                4) Breece Hill
                                5) DLI Libra Series
                                6) Quantum DLT/Digital DLT
                                7) EXB-10e/EXB-10h
                                8) EXB-10i
                                9) EXB-60 10) EXB-120 11) EXB-210
                               12) EXB-218 13) EXB-400 Series 14)
                               HP-C1553A/Surestore   12000e   15)
                               Metrum  (SCSI)  16)  Qualstar  17)
                               Spectralogic 18) STK-9704/Lago 340
                               19)   STK-9708/Lago   380   (SCSI)
                               Datawheel 20)  IBM  7331/IBM  9427
                               21)  ATL/Odetics SCSI 22) HP-Opti-
                               cal 630MB/1.3GB 23) other
                        Choice?

                   When this message appears,  enter  the  number
                   corresponding  to  the  appropriate model, for
                   example, if you are installing an  HP  optical
                   jukebox select the number "22".

                   For  all  jukebox types, jjbb__ccoonnffiigg prompts you
                   for the _n_a_m_e you want to  call  this  jukebox.
                   This  is  a convenient way for you to identify
                   the jukebox for yourself  and  NetWorker,  for
                   example,  Engineering  Autochanger.  NetWorker
                   will store this name as a  NetWorker  resource
                   (see  nnssrr__rreessoouurrccee(5)).WWhheenndefiningaajukeboxaatt--
                   ttaacchheeddtoaastoragennooddee,,  jjbb__ccoonnffiigg  appends  the
                   hostname  of the storage node to the beginning
                   of the names using the  remote  device  syntax
                   ("rd=hostname:").  See nnssrr__ssttoorraaggee__nnooddee(5) for
                   additional information on storage nodes.

                   For all jukebox types, jjbb__ccoonnffiigg  prompts  you
                   for  the  name  of the control port associated
                   with the jukebox being configured. For Autode-
                   tected  SCSI  jukeboxes,  the  correct name is
                   presented  as  the  default  choice,   because
                   autodetection involves determining the correct
                   name. The name  is  in  the  form  of  _l_i_b_s_c_s_i
                   devices    (see   lliibbssccssii(8)).    For   Serial



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





JB_CONFIG(8)                                         JB_CONFIG(8)


                   jukeboxes, the default name  varies  based  on
                   the  appropriate serial line name used for the
                   platform which NetWorker is located (for exam-
                   ple,   //ddeevv//ttttyyaa  for  SunOS  or  Solaris,  or
                   //ddeevv//ttttyy00 for AIX).  For SJI  compliant  juke-
                   boxes,  no  default selection exists. The name
                   you enter should either be the device name for
                   the device as described in any third party SJI
                   compliant driver installed, or the format used
                   for autodetected jukeboxes. A list of attached
                   autochangers can be obtained  by  running  the
                   cchhaannggeerrss(8) command.

                   Once a control port is entered, jjbb__ccoonnffiigg will
                   check to see if the model selected is  a  SCSI
                   or SJI based jukebox.  If the jukebox model is
                   a SCSI or SJI based  jukebox,  jjbb__ccoonnffiigg  will
                   attempt  to  query  the  jukebox about various
                   internal parameters (for  example,  number  of
                   slots  and drives). If this query fails, it is
                   possible that there is a device driver instal-
                   lation  problem  or  hardware  problem. If the
                   jukebox  is  a   Serial   jukebox,   jjbb__ccoonnffiigg
                   attempts  to  establish  serial communications
                   with it. If this fails, then there is either a
                   setup problem or a hardware problem.

                   Next, if the jukebox contains tape devices you
                   are asked if automated cleaning of devices  in
                   the  jukeboxes  should  be turned on. If auto-
                   mated cleaning is enabled the jukebox and  all
                   devices  in  the  jukebox  are  configured for
                   automated cleaning. If the jukebox is success-
                   fully installed, the information that pertains
                   to device cleaning from the  jukebox  and  all
                   devices in the jukebox is displayed.

                   Next, jjbb__ccoonnffiigg prompts you to enter the path-
                   name for all the media devices  configured  in
                   the  jukebox.  You  must add an entry for each
                   device.  If the device has not been configured
                   for  NetWorker, then you are prompted to enter
                   the media device type.

                   If you  select  Autodetected  SCSI  jukeboxes,
                   NetWorker  determines  the  name of each media
                   device by sending inquiries for information to
                   the  jukebox.  Not  all jukeboxes support this
                   capability, but  many  do  (for  example,  the
                   Exabyte 210).

                   Finally,  NetWorker  asks  you  if the jukebox
                   supports a bar code label reader, and  if  so,
                   whether  NetWorker  support  for  it should be



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





JB_CONFIG(8)                                         JB_CONFIG(8)


                   turned on. If support for the bar  code  label
                   reader is turned on, then you are asked if the
                   media volume labels should match the bar  code
                   labels  on  the  media.  If  you  select  this
                   option, the label templates will not  be  used
                   by  the  jukebox,  and  each media volume must
                   have a readable bar code label.

                   If the jukebox has  been  configured  success-
                   fully you will see the following message:

                   Jukebox has been added successfully

JJBBCCOONNFFIIGG FFIILLEE
       The file _/_n_s_r_/_j_b_c_o_n_f_i_g is the jukebox models configuration
       file.  This file can be used to configure  a  non-standard
       list of jukebox models.
       VVEECCTTOORR--TTYYPPEE   MMOODDEELL--NNAAMMEE<<NNEEWWLLIINNEE>>,  where  VECTOR-TYPE  is
       either  SJI  (the  Standard  Jukebox  Interface)  or   ATL
       (RS232-based  devices speaking the IGM-ATL serial communi-
       cations protocol).  The MODEL-NAME can be any string.

EEXXAAMMPPLLEESS
       (User entries are in italics).  # jb_config
                1) Install an Autodetected SCSI Jukebox.
                2) Install a Serial Jukebox.
                3) Install an SJI Jukebox.
                4) Install an RLM   Jukebox.
                5) Install an STL Silo.

       What kind of Jukebox are you installing? [1] _<_R_E_T_U_R_N_>
       These are the SCSI Jukeboxes currently attached to your
       system:
         1) scsidev@0.6.0: EXB-210
       Which one do you want to install?  _1_<_R_E_T_U_R_N_>
       Installing an 'EXB-210' jukebox.

       Name you would like to assign to the jukebox device?
       _E_n_g_i_n_e_e_r_i_n_g_<_R_E_T_U_R_N_>

       Pathname of the control port for the jukebox device?
       [scsidev@0.6.0] _<_R_E_T_U_R_N_>

       Do you want automated device cleaning support enabled?
       (yes/no) _y_e_s_<_R_E_T_U_R_N_>

       Enter pathname of media drive 1: [/dev/rmt/0mbn]?
       _<_R_E_T_U_R_N_>

       Enter pathanme of media drive 2: [/dev/rmt/1mbn]?
       _<_R_E_T_U_R_N_>

       Following are attributes that define cleaning cartridge
       support for the jukebox 'Engineering':



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5





JB_CONFIG(8)                                         JB_CONFIG(8)


               auto clean: Yes
               default cleanings: 12
               cleaning slots: 1
                       Cleaning cartridge volumes      Slot num-
       ber
                       --------------------------
       -----------
                       Cleaning Tape (12 uses left)    1

       Make sure that the slots set aside for cleaning cartridges
       containing cleaning cartridges with the designated number
       of usable cleanings left.

       Following are attributes that define the cleaning schedule
       for each device in the jukebox.

               name: /dev/rmt/0mbn
                       date last cleaned: Thu Apr 13 11:41:58
       1995
                       cleaning interval: 2 weeks
                       cleaning required: No

               name: /dev/rmt/1mbn
                       date last cleaned: Thu Apr 13 11:41:58
       1995
                       cleaning interval: 2 weeks
                       cleaning required: No

       Verify that the values for these attributes are appropri-
       ate for your installation. If not check documentation on
       how to set up automated cleaning cartridge support.
       Jukebox has been added successfully


SSEEEE AALLSSOO
       jjbbeexxeerrcciissee((88)),, nnssrr__ddeevviiccee((55)),, nnssrr__jjuukkeebbooxx((55)),, nnssrr__ssttoorr--
       aaggee__nnooddee((55)),, nnssrr((55)),, nnssrrccaapp((88))..


DDIIAAGGNNOOSSTTIICCSS
       _u_n_k_n_o_w_n _m_o_d_e_l iinnvvaalliidd cchhooiiccee ffoorr ''mmooddeell'' ((3355002222))
              PPrroobblleemm:: The NetWorker system does not recognize
              the model chosen.  If you added a /nsr/jbconfig*
              file after starting the daemons, you will see this
              error.  SSoolluuttiioonn:: Restart NetWorker.

       _r_o_o_t oonn mmaacchhiinnee _h_o_s_t iiss nnoott oonn ttyyppee::NNSSRR''ss aaddmmiinniissttrraattoorr
       lliisstt
              PPrroobblleemm:: The user 'root' on the storage node 'host'
              is not on the administrator list of the NetWorker
              server.  SSoolluuttiioonn:: Add such an entry to the Net-
              Worker server's administrator list.  Note that the
              entry can be removed after this command completes.




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        6


