Simics Installation Instructions

We recommend that Simics is installed in a directory called simics in your home directory. The following instructions are written with this assumption, also assuming that you are working on a Sun machine at the university. This will not work under Linux or Windows. You should not create a directory called simics before this installation, it will be created automatically during the installation!

Run the installation script for the global Simics install:

host$ cd /it/kurs/compsys/simics-2.0.23/
host$ ./scripts/user-install.sh . ~/simics

This will give you the following dialog with the computer, where you answer the default answer by pressing enter twice.

Simics user-install script
=========================================

This script will install a local copy of Simics from
a specified master installation. If no destination
directory is set, a directory will be created in the
current directory, with the same name as the master.

Default alternatives are enclosed in square brackets ([ ]).



Starting user installation of Simics.

Installing from: /it/kurs/compsys/simics-2.0.16
             to: /home/USER/simics

Do you want to continue ?
[yes] / no : 


What host types do you want to install support for?

1    v9-sol8-64

[all] / 1 : 

Setting up links...

Copying files...

Patching local configuration files...

Completed setup of local Simics installation directory

    /home/USER/simics/

Check installation

Now you have a local installation of simics, so let's see what has been installed.

Change directory to the Simics root directory, which we will call $SIMICS in the following discussion and for the rest of this lab (or in many cases, just ~/simics).

host$ cd ~/simics

Check what can be found in this directory. The following is an example of how it may look:

host$ ls
config/           LICENSE@          README_2.0@       src/
configure@        licenses@         README_2.0.x@     v9-sol8-64/
doc@              Makefile.in@      README.previous@  Version@
home/             master-install@   README.SOURCE@
import/           README@           scripts/

Not all these directories and files are important to this lab and the project. You should however investigate the following directories:
- doc: contains the Simics documentation. Have a look in the user's guide to learn more about Simics.
- home contains the directories for the simulated machines provided with Simics. You will be using one of the directories here when starting Simics.

Set up compsys machine model

You also need to install the machine we will be working with for the project; it is not part of the standard installation.

Copy the file /it/kurs/compsys/HT2004/compsys.tar to your $SIMICS/home directory.

host$ cd ~/simics/home
host$ cp /it/kurs/compsys/HT2004/compsys.tar .

Untar the file with the command tar xvf compsys.tar.

host$ tar xvf compsys.tar
compsys/
compsys/.simics-log
compsys/compsys-common.simics
compsys/compsys.conf
compsys/compsys.config
compsys/compsys.simics
compsys/example_timer.elf
compsys/simics
compsys/simics.bat

Check the results with an ls -lt compsys command. Note that you should have files created September 27, 2004, or later. There is an old version of compsys created in the install that you need to overwrite!

host$ ls -lt compsys
total 134
-rwxr-xr-x   1 jakob    it          1027 Oct 11 08:29 compsys-common.simics*
-rwxr-xr-x   1 jakob    it          6806 Oct 11 08:29 compsys.conf*
-rwxr-xr-x   1 jakob    it          1341 Oct 11 08:26 compsys.config*
-rwxr-xr-x   1 jakob    it           365 Oct 11 08:28 compsys.simics*
-rwxr-xr-x   1 jakob    it         53277 Sep 28 19:13 example_timer.elf*
-rwxr-xr-x   1 jakob    it            53 Mar  8  2004 simics*
-rwxr-xr-x   1 jakob    it           447 Feb 16  2004 simics.bat*

Next step is to try Simics, as detailed in the introduction lab.