The Steps

1. Create directory /usr/xkernel and use anonymous FTP to copy file xkernel.tar.Z from cs.arizona.edu/xkernel into this directory. Then type:

   cd /usr/xkernel
   uncompress xkernel.tar.Z
   tar xf xkernel.tar

   This will create several subdirectories in /usr/xkernel. A description of the x-kernel directory hierarchy can be found in /usr/xkernel/README. Note that you can skip this step if you are not the first person to install and use the x-kernel or x-Sim at your site.

2. Create a directory in which you will build an instance of x-Sim . This is called your build directory, and in general, each different configuration of the x-kernel and x-Sim has its own build directory.

   cd /usr/xkernel/simulator/build
   mkdir solaris

   If directory /usr/xkernel/simulator/build/solaris already exists---because someone else has already followed this procedure---then you have two choices.
   1. Select another name for your build directory (e.g., mydir) and create a directory with this name in directory /usr/xkernel/simulator/build. The catch to this option is that you have to either have write permission in directory /usr/xkernel/simulator/build, or you have to have someone that has write permission create your build directory for you.

   2. Create a build directory in your own home directory; e.g., /usr/llp/xsim/solaris. This is the preferred approach if a lot of different people are going to be building the x-kernel or x-Sim .

   Substitute the name of your build directory, as appropriate, in the rest of the steps.

3. Copy configuration files into your build directory.

   cd /usr/xkernel/simulator/build/solaris
   cp ../Template/Makefile.solaris Makefile
   cp ../Template/example/* .
   mkdir db
   chmod 664 *

   Note that if your build directory is not in /usr/xkernel/simulator/build, then you will have to use the full path names for these various files rather than the relative path names given above (i.e., /usr/xkernel/simulator/build/Template/example instead of ../Template/example).

4. Edit the `` XRT ='' line of the Makefile you just copied into your build directory to reflect the root of your x-kernel source tree. Assuming your tree is at /usr/xkernel, this means changing

   XRT = ../../..

   to

   XRT = /usr/xkernel

   Note that this step is necessary only if your build directory is underneath your home directory. It is not necessary if your build directory is in /usr/xkernel/simulator/build since from there, ../../.. already points to the root of the x-kernel source tree.

5. Put /usr/xkernel/bin/solaris-sparc and /usr/xkernel/bin in your search path. They should appear before /bin and /usr/bin in order to pick up GNU make before the standard Unix make. If you are building x-Sim on a platform other than Solaris, then substitute sunos-sparc or osf1-alpha for solaris-sparc, as appropriate. Also, make sure the GNU C compiler ( gcc) is in your search path. (At Arizona, gcc can be found in directory /usr/local/bin.)

6. Build libraries necessary for your x-Sim . This could take quite a while.

   cd /usr/xkernel/simulator/build/solaris
   make system

   Note that you can skip this step if you are not the first person to build an x-Sim for this platform.

7. You are now ready to build your x-Sim .

   cd /usr/xkernel/simulator/build/solaris
   make compose
   make depend
   make

   This sequence should result in the creation of the binary file xkernel in your build directory. Note that you may see what appear to be error messages about missing files (e.g., Makefile.local and DEPS/Makedep.*) when you run make compose. These warnings can be ignored.

8. You are now ready to run your x-Sim .

   cd /usr/xkernel/simulator/build/solaris
   xsim