Agenda: exercises-rancid-2.txt

Network Management & Monitoring

Using RANCID Part II

Notes:
------
* Commands preceded with "$" imply that you should execute the command as
  a general user - not as root.
* Commands preceded with "#" imply that you should be working as root.
* Commands with more specific command lines (e.g. "RTR-GW>" or "mysql>") 
  imply that you are executing commands on remote equipment, or within 
  another program.

Exercises
---------

0.      Become the RANCID user

        - Make sure you are the root user first. If not, then do:
        
        $ sudo bash
        
        - To become the RANCID user do:

        # su -s /bin/bash rancid

1. Note the IP addresses for the routers

        10.10.254.xxx  where xxx goes from 1 to 16

2. Update /var/lib/rancid/.cloginrc

        Change the file to look like this:

        $ joe /var/lib/rancid/.cloginrc

        add user 10.10.254.* sysadmin
        add password 10.10.254.* menog7 menog7

        (This tells RANCID that all hosts called "10.10.254.*" use the
        same password and user -- no need to add every router by hand!
        The first match in the file wins)

3. Update the router.db

    $ joe /var/lib/rancid/all/router.db

        Add some other classroom routers to the file. You should end up with
        something like:

        10.10.5.254:cisco:up 
        10.10.6.254:cisco:up 
        10.10.7.254:cisco:up 
        10.10.8.254:cisco:up 

        (Note that "cisco" means this is Cisco equipment -- it tells Rancid
        that we are expecting to talk to a Cisco device here.  You can also
        talk to Juniper, HP, ...)

4. Run rancid again:

        $ /usr/lib/rancid/bin/rancid-run

        (Should take a few seconds)

5. Check out the logs:

        $ cd /var/lib/rancid/logs
        $ ls -l

        ... Pick the latest file and view it

        $ less all.YYYYMMDD.HHMMSS

6. Look at the configs

        $ cd /var/lib/rancid/all/configs
        $ less 10.10.*

        - If all went well, you can see the configs of ALL routers

7. Change the configuration on the router (change the description on
    an interface, for example)

8. Run rancid again

        $ /usr/lib/rancid/bin/rancid-run

9. Play with clogin:

        $  /usr/lib/rancid/bin/clogin -c "show clock" 10.10.254.x

- What do you notice ?


10. Add the RANCID CVS repository in to CVSweb

        - if you are still logged in as user rancid, get back to root

        $ exit
        # 

        - Now install CVSweb:

        # apt-get install cvsweb

11. Edit the file /etc/cvsweb/cvsweb.conf

        # joe /etc/cvsweb/cvsweb.conf

        - Below the line

'local'   => ['Local Repository', '/var/lib/cvs'],

        add

'rancid'   => ['Rancid Repository', '/var/lib/rancid/CVS'],

        - Save and exit

12. Fix a link:

        # cd /var/www
        # ln -s /usr/share/cvsweb .
        
        - Open a web browser to the link:

        http://MyMachine/cgi-bin/cvsweb/

    Select the RANCID repository and browse the files under the 'all'
    directory.