


NSRCAP(8)                                               NSRCAP(8)


NNAAMMEE
       nnssrrccaapp  - update the capabilities of a NetWorker installa-
       tion

SSYYNNOOPPSSIISS
       nnssrrccaapp [ --vvnn ] { --cc | --uu | --dd } eennaabblleerr--ccooddee

DDEESSCCRRIIPPTTIIOONN
       The nnssrrccaapp program is primarily used to  enable  new  fea-
       tures on NetWorker.  You can also use nnssrrccaapp to upgrade or
       downgrade NetWorker software features that  are  currently
       being  used  (upgrades  and downgrades should be performed
       carefully; read the  descriptions  below).   Enablers  are
       separate from the NetWorker software, and are specified by
       an 18-digit code, usually displayed as 3 groups of 6  dig-
       its  each.   To  enable a new feature, the nnssrrdd(8) program
       must be running on the system where the  NetWorker  server
       software  is  installed.  To enable a new feature you must
       be logged in to the NetWorker server as  administrator  or
       root.  The nnssrrccaapp program is run once for each feature you
       want to enable by specifying the 18-digit code each  time.
       If no errors occur, no output is printed.  You can inspect
       the enablers currently loaded by viewing the  NSR  license
       resources using nnwwaaddmmiinn(8) or nnssrraaddmmiinn(8).

OOPPTTIIOONNSS
       --cc     Causes  nnssrrccaapp to enable a feature that is not cur-
              rently installed, using the specified enabler code.
              You  can  only  load  a  feature  once; an error is
              returned if you attempt to load  the  enabler  more
              than once.  You can only specify one of the --cc, --dd,
              or --uu options.

       --dd     Causes nnssrrccaapp to  downgrade  an  existing  Base  or
              Jukebox  enabler.  After you downgrade the enabler,
              you cannot return to the previous level enabled  on
              the  system.   _D_o  _n_o_t  use  the  --uu  option unless
              instructed to do so by  Legato  Technical  Support.
              You  must specify one of the --cc, --dd, or --uu options.

       --uu     Causes nnssrrccaapp to enter an enabler that upgrades  an
              existing   Base  or  Jukebox  enabler.   After  you
              upgrade the enabler, you cannot return to the  pre-
              vious  level enabled on the system.  _D_o _n_o_t use the
              --uu option unless instructed  to  do  so  by  Legato
              Technical Support.


       --vv     Causes  nnssrrccaapp to display more verbose information,
              describing the  enabler  being  loaded.   You  must
              specify one of the --cc, --dd, or --uu options.

       --nn     No load.  Causes nnssrrccaapp to inspect the enabler code
              for validity. When you specify the --nn  option,  the



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSRCAP(8)                                               NSRCAP(8)


              enabler  code  you  enter  on  the  command line is
              inspected and verified, but is not entered into the
              NetWorker server's nnssrr__lliicceennssee resource.

SSEEEE AALLSSOO
       nnwwaaddmmiinn(8), jjbb__ccoonnffiigg(8), nnssrraaddmmiinn(8), nnssrrdd(8).

DDIIAAGGNNOOSSTTIICCSS
       eennaabblleerr--ccooddee iiss ttoooo lloonngg
              Enabler codes must be 18 digits in length. The code
              entered is longer than 18 digits, and is invalid.

       iinnvvaalliidd ccooddee:: xxxxxxxxxxxx--xxxxxxxxxxxx--xxxxxxxxxxxx
              The 18-digit code entered on the  command  line  is
              invalid.  Re-check the enabler-code on your enabler
              sheet.

       ccaannnnoott ffiinndd aa jjuukkeebbooxx rreessoouurrccee ttoo eennaabbllee
              The code word entered is a jukebox license enabler,
              but  there are no jukebox resources to enable.  You
              need to run jjbb__ccoonnffiigg(8) to  complete  the  jukebox
              installation before running nnssrrccaapp.

       ffoouunndd aa jjuukkeebbooxx,, bbuutt iitt hhaadd mmoorree tthhaann NN sslloottss..
              Jukebox  enablers can only enable jukeboxes with at
              most NN physical slots, where NN is the type of juke-
              box  enabler.   Either  the  jukebox  was installed
              incorrectly, or you need to obtain a larger jukebox
              enabler.

       tthhiiss enabler-code iiss aallrreeaaddyy aassssiiggnneedd
              The enabler-code entered is already loaded onto the
              system and cannot be used again for an upgrade.

       nnoo aapppprroopprriiaattee jjuukkeebbooxxeess ttoo uuppggrraaddee
              An upgrade was attempted, but no jukebox  resources
              were  found.   Only use the --uu option for jukeboxes
              when upgrading from one jukebox level  to  another,
              not  on the initial installation.  You also need to
              run jjbb__ccoonnffiigg(8) before running nnssrrccaapp.

       tthhiiss enabler-code pprreevviioouussllyy llooaaddeedd
              The enabler-code entered has been loaded  onto  the
              system  previously  and  cannot be used again.  You
              need  to  purchase  a  new  enabler-code  for   the
              upgrade.

       ddoonn''tt kknnooww hhooww ttoo uuppggrraaddee tthhiiss eennaabblleerr
       ddoonn''tt kknnooww hhooww ttoo ddoowwnnggrraaddee tthhiiss eennaabblleerr
              The enabler-code entered is not for a base or juke-
              box enabler.  These are the only types of  enablers
              that you can currently upgrade or downgrade.





NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSRCAP(8)                                               NSRCAP(8)


       bbaassee eennaabblleerr mmuusstt bbee llooaaddeedd bbeeffoorree uuppggrraaddiinngg
       bbaassee eennaabblleerr mmuusstt bbee llooaaddeedd bbeeffoorree ddoowwnnggrraaddiinngg
              You  cannot perform an upgrade or downgrade until a
              base product has been installed.   Install  a  base
              enabler, and then perform the upgrade or downgrade.

       ccaannnnoott ffiinndd tthhee eennaabblleerr ttoo uuppggrraaddee
              A jukebox upgrade was attempted,  but  the  license
              enabler  for  the  jukebox is not currently loaded.
              You must use the --cc option for the initial  instal-
              lation of a jukebox enabler, not the --uu.  option.

       RRPPCC eerrrroorr,, PPrrooggrraamm nnoott rreeggiisstteerreedd
              The nnssrrccaapp program requires that the NetWorker dae-
              mons be running.  Start your NetWorker daemons  (cd
              /; nsrd) and re-run the nnssrrccaapp program.  If nnssrrdd is
              already  running,  you  have  probably  reached   a
              resource  limit  on  the  server  (for example, not
              enough memory, or no more processes).

       RRAAPP eerrrroorr,, uusseerr _l_o_g_i_n _n_a_m_e nneeeeddss ttoo bbee ooff tthhee  ttyyppee::NNSSRR
       aaddmmiinniiss-- ttrraattoorr lliisstt..
              Your login name is not listed  in  the  administra-
              tor's  list for the server.  You need to be a valid
              administrator to run nnssrrccaapp.

       RRAAPP eerrrroorr,, ......
              Various other errors can be returned from  nnssrrdd  if
              the  enabler is invalid. For example, if you try to
              load a base enabler onto a system that already  has
              a  base enabler loaded, or if you attempt to load a
              jukebox enabler before the jukebox  has  been  com-
              pletely  installed.  The specific problem will fol-
              low the RRAAPP eerrrroorr prefix.























NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3


