System Administration Commands                   niscachemgr(1M)



NAME
     niscachemgr - NIS] utility to  cache  location  information
     about NIS] servers

SYNOPSIS
     /usr/sbin/niscachemgr [-i] [-v]


DESCRIPTION
     The niscachemgr daemon maintains a cache of NIS]  directory
     objects  and  active  servers for domains. It is responsible
     for locating servers  for  a  domain  on  behalf  of  client
     processes.   This improves performance because only one pro-
     cess has to search for servers. The cache contains  location
     information  necessary  to  contact  the  NIS] servers. This
     includes transport addresses, information neeeded to authen-
     ticate  the  server,  and a time to live field which gives a
     hint on how long the directory object  can  be  cached.  The
     cache  helps  to improve the performance of the clients that
     are traversing the NIS] name space. niscachemgr  should  be
     running on all the machines that are using NIS]. However, it
     is not required that the niscachemgr program be running  in
     order for NIS] requests to be serviced.


     The cache maintained by this program is shared  by  all  the
     processes  that access NIS] on a machine. The cache is main-
     tained in a file that is memory mapped by all the processes.
     See mmap(2). On start up, niscachemgr initializes the cache
     from the cold start file  and  preserves  unexpired  entries
     that already exist in the cache file. See nisinit(1M). Thus,
     the cache survives machine reboots.


     The niscachemgr program is normally started from  a  system
     startup  script. nisshowcache(1M) can be used to look at the
     cached objects and active servers.


     The nisprefadm(1M) command can be used to control which NIS]
     servers the niscachemgr program will try to select.


     The niscachemgr program makes NIS] requests under the  NIS]
     principal  name of the host on which it runs. Before running
     niscachemgr, security credentials for the  host  should  be
     added  to  the cred.orgdir table in the host's domain using
     nisaddcred(1M). Credentials of type DES will  be  needed  if
     the  NIS]  service  is  operating  at  security level 2 (see
     rpc.nisd(1M)). See  the   section,  below.  Additionally,  a
     "keylogin -r " should be done on the machine.




SunOS 5.11          Last change: 13 Aug 2004                    1






System Administration Commands                   niscachemgr(1M)



     svc:/network/rpc/keyserv:default is required for NIS] opera-
     tion. See NOTES.

OPTIONS
     -i    Force niscachemgr to ignore the previous  cache  file
           and  reinitialize  the  cache from just the cold start
           file. By default, the cache manager initializes itself
           from  both the cold start file and the old cache file,
           thereby maintaining the entries in  the  cache  across
           machine reboots.


     -v    This  flag  sets  verbose  mode.  In  this  mode,  the
           niscachemgr  program  logs  not only errors and warn-
           ings, but also additional status messages.  The  addi-
           tional  messages  are  logged  using syslog(3C) with a
           priority of LOGINFO.


FILES
     /var/nis/NISHAREDIRCACHE

         the shared cache file


     /var/nis/NISCOLDSTART

         the coldstart file


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    


SEE ALSO
     keylogin(1),    svcs(1),    nisaddcred(1M),     nisinit(1M),
     nisprefadm(1M),  nisshowcache(1M), rpc.nisd(1M), svcadm(1M),
     mmap(2), rpc(3NSL), syslog(3C), nisfiles(4),  attributes(5),
     smf(5)

DIAGNOSTICS
     The niscachemgr daemon logs  error  messages  and  warnings
     using  syslog(3C).  Error  messages are logged to the DAEMON



SunOS 5.11          Last change: 13 Aug 2004                    2






System Administration Commands                   niscachemgr(1M)



     facility with a priority of LOGER . Warning  messages  are
     logged  with  a  priority  of LOGWARNING. Additional status
     messages can be obtained using the -v option.

NOTES
     NIS] might not  be  supported  in  future  releases  of  the
     Solaris  operating  system.  Tools to aid the migration from
     NIS] to LDAP are available in the current  Solaris  release.
     For            more            information,            visit
     http:/www.sun.com/directory/nisplus/transition.html.


     The niscachemgr service is managed by the  service  manage-
     ment facility, smf(5), under the service identifier:

       svc:/network/rpc/nisplus:default




     Administrative actions on this service,  such  as  enabling,
     disabling,  or  requesting  restart,  can be performed using
     svcadm(1M). The service's status can be  queried  using  the
     svcs(1) command.































SunOS 5.11          Last change: 13 Aug 2004                    3