4.3 Installing Neo

The source for Neo is available at http://web.mit.edu/ktools/. Download the latest version and uncompress the package:

 Solaris% gunzip -c neo-1.2.12.tar.gz  tar xvf - 

The unpacked source can then be found in a directory with the same name as the version you have downloaded. Change to that directory:

 Solaris% cd neo-1.2.12 

And then configure and build the package:

 Solaris% ./configure   Solaris% make 

You may also then type:

 Solaris% make install 

which simply places the Neo binary in /usr/local/bin/ .

Neo should build without trouble on most platforms and is regularly tested on Solaris and Linux in particular. Because Neo is a relatively new piece of software, the configuration and build process has not yet been tested at many sites. If you encounter a problem with either step, you are encouraged to send email to [e-mail] with a detailed description of the failure.

If the configure script is not able to find the GNU readline library, Neo will successfully build without it, but command line editing will not be available. If your system does not have the readline library, you can download it at http://www.gnu.org/ and install it on your system. Solaris, for example, does not come with the readline library, though Linux typically does.

If you have readline installed in a nonstandard location, you may need to set the CFLAGS and LDFLAGS environment variables before running the configure script. For example, if your shell is csh or tcsh, you would use:

 Solaris% setenv CFLAGS -I/usr/local/include   Solaris% setenv LDFLAGS -L/usr/local/lib   Solaris% ./configure 

But if your shell is bash or the Bourne shell, it would instead be:

 Solaris% CFLAGS=-I/usr/local/include export CFLAGS   Solaris% LDFLAGS=-L/usr/local/lib export LDFLAGS   Solaris% ./configure 

Neo builds its own small SNMP implementation and therefore does not require any external SNMP packages.

Once the binary is built, try running it to make sure it works. You should see output like this:

 Solaris% ./neo   Welcome to neo version 1.2.12 (Atropine).   Consult 'help version' for information on features in this version.   neo: 

If so, you have successfully built Neo and are ready to begin using it.