• Setup_for_Simics_3.0.X

NOTE: The Multifacet Group uses GEMS internally with Simics 2.2.X and Simics 2.0.X. GEMS has not been exhaustively tested when running with Simics 3.0.X.

NOTE: The following steps are applicable to GEMS v2.1.1 and higher. For older versions, please see Setup_for_Simics_3.0.X(pre GEMS-2.1.1)

NOTE: For older versions of Simics, please see Setup_for_Simics_2.2.X

Setting up your GEMS environment

1. Unpack gems-release2.1.1.tar.gz into a chosen directory. For the following instructions, it will be assumed that the $GEMS environment variable is set to this root directory.

•    cd $GEMS
     tar xvzf gems-release2.1.1.tar.gz

2. Install Simics 3.0.X. You should not install to $GEMS/simics. These instructions assume the environment variable $SIMICS_INSTALL points to the Simics 3.0.X installation directory.

•    tar xvf simics-pal-3.0.11-linux.tar
     cd simics-3.0-install/
     ./install-simics.sh

  Follow the installation instructions provided by Virtutech.

3. Instantiate a Simics workspace.

•    cd $GEMS/
     mkdir simics_3_workspace
     cd $SIMICS_INSTALL/bin
     ./workspace-setup $GEMS/simics_3_workspace

4. Edit $GEMS/scripts/makesymlinks.sh to include the correct path to $SIMICS_INSTALL

•   cd $GEMS/scripts/
    vi makesymlinks.sh

  echo "Making symlink for import directory..."
  ln -s $SIMICS_INSTALL/import import

5. Run makesymlinks.sh from your Simics workspace. This will make the Simics workspace directory structure look very much like that of a Simics 2.2.X installation.

•    cd $GEMS/simics_3_workspace
     ../scripts/makesymlinks.sh

6. Link your Simics workspace to $GEMS/simics.

•    cd $GEMS/
     ln -s simics_3_workspace simics

7. Edit GEMS Makefiles:

• $GEMS/common/Makefile.common -- set the CC for your chosen compiler, update the path for SIMICS_INCLUDE_ROOT to point to your Simics 3.0 installation's include/ directory.

• $GEMS/ruby/module/Makefile -- set the runtime library path (not necessary if using native compiler).

8. Please direct any Simics related questions to [https://www.simics.net/]

9. Please direct any GEMS related questions to the GEMS users mailing list. You can sign up for the mailing list here: [https://lists.cs.wisc.edu/mailman/listinfo/gems-users].

• We also ask that you first search the mailing list to see if your question has already been answered. To search the mailing list please google the following:
  your-search-string site:https://lists.cs.wisc.edu/archive/gems-users/

Now you are ready to compile Ruby and Opal. Proceed to the ["QuickStart"] page