So, how do you install this puppy? Well, that's a good question. There are two ways to do it -- from CPAN or from manual download.

Installing from CPAN is the easiest way to get there. As root (or equiv), type the following:

$ perl -MCPAN -e shell
A bunch of stuff will happen and you'll wind up with a cpan> prompt. At that prompt, type:
cpan> install Net::Telnet::Cisco::IOS
Again, it'll do some stuff and tell you that it's finished updating. Easy.

Some people hate CPAN, though. I've heard nasty horror stories about CPAN taking machines down and ruining Perl installs. I myself haven't had any issues with it, but just beware.

If you want to install manually, you can. The beta versions of NTCI will simply be the Perl module file tarred and gzipped up with some examples and maybe a README or two, so all you have to do is extract the files somewhere and put the IOS.pm file in the right place.

The easiest way to manually install is to extract the files as noted below and read the README file. That file will tell you latest and greatest technique for installation. Since I'm packing NTCI for CPAN, the archive is neatly packaged with a nice bow and everything, but the instructions below still apply as far as I can tell.

I'm going to assume that you went to the project page and downloaded whatever version in the latest and greatest. Let's say you downloaded the file ntci-0.2beta.tar.gz. Just uncompress it and you should wind up with a file IOS.pm somewhere.

How do you do that? If you're running Linux, put the file in your /tmp directory, cd over there, and type in this stuff.

$ gunzip ntci-0.2beta.tar.gz
$ tar xvf ntci-0.2beta.tar.gz
This will uncompress the file and extract all the files to your /tmp directory. If you're running Windows, you'll need to do something more extreme. Your choices are 1) install Cygwin or 2) install 7-zip. Both are well beyond the scope of this document, I'm afraid.

Alright, so at this point, we have a file called IOS.pm with a bunch of other files that may or may not be as important. We'll just focus on the IOS.pm file for now. This file has to be put in the right place on your system to be able to use it globally.

The way Perl does its directory structure relates directly to inheritance, so IOS.pm has to be put in a specific place. NTCI extends Net::Telnet::Cisco (which is required to install and covered under another doc) and has to be put in a directory called "Cisco" under the "Telnet" directory. Since you've never installed NTCI before, you'll have to create the "Cisco" directory yourself and put the IOS.pm file in it.

Where are these magical directories? That is also a good question. Technically, it's somewhere in your Perl library path. Specifically, I can't tell you where it is. At work on my Linux box, the full path is /usr/lib/perl5/vendor_perl/5.8.5/Net/Telnet/Cisco/IOS.pm. Same at home. If you don't know, look for something close and try it there. One tip I can give is to look in the /usr/lib/perl5 directory for a directory called "Net" and look under it. Other than that, you're on your own until I can it packaged properly. Once you put the file down, you can see if it's right by typing:

$ perl -e "use Net::Telnet::Cisco::IOS;"
If nothing happens, you got it right. If you get some errors, it's not in the right place. Try again.

If you need some help getting it installed, open up a Support Request and I'll see if I can help you.

© 2005-2006 -- Aaron Conaway