Unpacking the JNOS Package


The necessary preliminaries...

Before you even think about compiling JNOS, you need to create an environment in which these activities can take place. In fact, you should create these work areas, even before you FTP a copy of the JNOS package over to your system since it needs a place to "land."

Typically, on a Linux/UNIX system, this means creating directories, usually at the highest level, up one from where you logged in. You will probably need to create several directories to accomodate all the source code and documentation that comes in the JNOS packages.

If you are a little rusty with your Linux system commands, now is probably a good time to review before you jump in at the deep end, particularly if you intend to change or set permissions for certain groups. Generally though, logging in as "root" will give you all the "authority" on the system that you need.



Setting Up and Unpacking

Where to begin:

The first thing you need to do is to log in as root or do an SU (switch user) to root. As mentioned, this will give you broad authority when creating directories.

Go to the topmost directory by using this command:

  • "cd .."

Issue this command until you can't go any higher up the directory tree. You will then be at the top along with the other major directories, such as: usr, lib, bin, and etc, just to name a few. (Verify your resuts with the ls or ls -l command.) It is here that you need to create your new "jnos" directory work space.

You want to create at least two (2) directories and possibly a third. Use the following commands:

  1. "mkdir jnos"
  2. "mkdir jnos111f"

The name of the second item on the list above will depend on your version of JNOS. I removed all periods and hyphens to make a very simple, consolidated name. You may name it as you wish. (This is where the source code will be unpacked and subsequently configured.) Remember, you probably should do this before you "get" a copy of JNOS since you will be initiating your FTP from this directory. If you aready have a compressed or zipped file, then this is where you would copy it into.

It is often recommended that you obtain a documentation package for the version of JNOS you will be running. I would strongly advise you to do this. It really helps to have these files on your local system where you can consult them easily. You may create another toplevel directory or create one underneath the "jnos" directory, preferably not the "jnos111f" directory. Here is how to do that:

  • "mkdir jdocs111f"

You may call this directory anything you like as well; I just used something that would remind me of the version.


Making Directories:

Now we need to create some directories underneath the "jnos" directory. So change to that directory with cd jnos or cd /jnos, depending on where you are. Here is a minimum number of recommended sub-directories:

  • "mkdir finger"
  • "mkdir dump"
  • "mkdir logs"
  • "mkdir help"
  • "mkdir pub"
  • "mkdir spool"

Or, you may place the directory names all on one line as in "mkdir finger dump logs help pub spool." Verify with an ls to see them listed out. These are working directories that the program JNOS will need to run correctly. You may, however, create any number of additional directories. (I like to include a tmp, storage, and misc directories.)

Unpacking the Source:

If you don't already have a zipped copy of JNOS, then now is the time to download it via FTP. Change to the jnos111f directory and begin your FTP login to the site or machine where you will obtain your copy. When you have finished, you will see a file called jnos111f.zip. To unpack or unzip it, use this command:

  • "unzip -aL jnos111f.zip"

There may be nearly 60 files created. I counted about 56 on my setup. This will vary depending on the version you obtained. You should see many .c files and a few .h files. The .c files are the C source code and the .h are the header files used in compiling.

If you want the documentation files, you should also carry out the same procedure as above. Change to your jdocs111f directory, download your files and then unzip them. Again, the exact number of files will depend on your version number.

Next Steps:

At this point, you have everything you need to begin your configuration process. Read as much as you can about JNOS in the documentation files. When you think you have read enough, you need to configure two (2) files: the Makefile file and the config.h file. Click here JNOS , or return to the jnos index page, and under "The Compile Set Up Files," click on the Makefile link, editing that file; and then continue on in a similiar manner with the config.h file. These pages will guide you through the next steps...



(Courtesy KBNorton Computer Services)