Installing OS/161 in Zeus

The following instructions describe how to install OS/161 into your account in the student.cs computing environment.

Step 0: Which Machine to Use?

Step 1: Setting Up Your Environment

Start by logging in to your account and modifying your PATH environment variable to ensure that various OS/161-related development tools are available. Your PATH is normally set in your shell's startup file each time you log in.

Edit your PATH variable in the .bash_profile file. Look for a line like this:

PATH=$PATH:/$HOME/bin

and make it

PATH=$PATH:/usr/local/sys161-1.14/bin:/usr/local/sys161-1.14

Note that you may need to log out and log back in again so that this PATH change will take effect. You can check the current setting of the PATH environment variable using the command

echo $PATH

Step 2: Obtain a Copy of the OS/161 Source Code

Obtain a copy of OS161 by entering:

wget http://mason.gmu.edu/~agumusal/os161-1.11.tar.gz

Now, extract the source code with the following:

tar -xzf os161-1.11.tar.gz

If you are planning to use Mason GitLab to manage the OS/161 source code, this is the right time to follow the separate GitLab setup instructions for OS/161. Do this before you continue with Step 3. Once your Git repository has been set up and you have checked out a working copy of a OS/161, you can proceed with Step 3 using your working copy.

Step 3: Configure and Build OS/161

Assuming you have already configured your Git repo and cloned the GitLab repo under the right directory. The next step is to configure OS/161 and compile the kernel. From the your $HOME/os161 directory, do the following:

cd os161-1.11
./configure --ostree=$HOME/os161/root
cd kern/conf
./config ASST0
cd ../compile/ASST0
make depend
make
make install

The string ASST0 in the commands above indicates that you are working on assignment 0. For Assignment X, replace ASST0 with ASSTX in the commands above. The make install command will create a directory called $HOME/os161/root ($HOME refers to your home directory), into which it will place the compiled kernel in a file called kernel-ASST0. It will also create a symbolic link call kernel referring to kernel-ASST0. Check the $HOME/os161/root directory to make sure that your kernel is in place.

Step 4: Try Running OS/161

You should now be able to use the SYS/161 simulator to run the OS/161 kernel that you built and installed. The SYS/161 simulator requires a configuration file in order to run. To obtain one, do this:

cd $HOME/os161/root
cp /usr/local/sys161-1.14/sys161.conf.sample sys161.conf

Now run your compiled kernel on the simulator. Assuming that you're still in the $HOME/os161/root directory, do this:

sys161 kernel-ASST0 or

sys161 kernel (since kernel is a symlink to kernel-ASST0)

You should see some output that looks something like this:

sys161: System/161 release 1.99.05, compiled Apr 28 2011 21:49:59

OS/161 base system version 1.11
Copyright (c) 2000, 2001, 2002, 2003
   President and Fellows of Harvard College.  All rights reserved.

Put-your-group-name-here's system version 0 (ASST0 #1)

Cpu is MIPS r2000/r3000
336k physical memory available
Device probe...
lamebus0 (system main bus)
emu0 at lamebus0
ltrace0 at lamebus0
ltimer0 at lamebus0
hardclock on ltimer0 (100 hz)
beep0 at ltimer0
rtclock0 at ltimer0
lrandom0 at lamebus0
random0 at lrandom0
lhd0 at lamebus0
lhd1 at lamebus0
lser0 at lamebus0
con0 at lser0
pseudorand0 (virtual)

OS/161 kernel [? for menu]: