(apologies for the suckiness of this installation manual)

Installation

• download and unpack the latest tarball from the downloads page above.
• The runtests program in the source directory can be used to validate that the source passes all unit tests.
• run ./setup.py build
• run sudo ./setup.py install --prefix=/usr/local
• sudo chmod 0600 /etc/nsscache.conf

(to use the libnss-cache NSS module)

• download and unpack the libnss-cache tarball from the downloads page above
• run sudo make install

Configuration

• edit /etc/nsscache.conf to set up which system databases you wish to synchronise, and to set local configuration parameters.
• nsscache update --full will perform a full update
• nsscache verify will confirm that the system is configured
• Edit /etc/nsswitch.conf to point your local database to use the cache nss module, or the db module.

Testing

• compare the results of getent passwd before and after changing /etc/nsswitch.conf to ensure the results are the same.