Getting Started: KUSP Software and Kernel

This section provides and overview of sections designed to teach a user how to obtain, build and use the KUSP kernel, KUSP software, and a range of examples and experiments. The KUSP software is moderately complex and a user with no prior knowledge would be well advised to follow the initial setup and initial learning sequences specified here to gain the basic knowledge of the system components required to start a new project or to extend an existing project. Note, that the “next” link at the top and bottom of this and all other page will take you to the topics in the specified order.

The rest of this document gives a brief description of each topic you will go through. At the bottom of each section, is a “Read This Document” link which gives you direct access to each topic for more convenient reference in the future if you wish to review a specific topic.

Initial Environment Setup

The KUSP environment consists of a copy of the kernel source tree and a copy the KUSP application code tree, checked out of the Subversion repository for use. Establishing this environment begins with a number of procedural details, including: (1) making sure you have an ITTC account, (2) are in the right Linux user groups, (3) have Subversion and Wiki write permissions, etc. Much of this procedural information is only required if you will be working on KUSP using ITTC resources. Some of it is required if you will be using the KUSP Subversion repository to contribute to the software or edit the Wiki pages. Anonymous Subversion access is possible if preferred and it is possible to use the KUSP kernel and software on your own computers without using ITTC resources.

This document then leads the reader through the steps of checking out and building a KUSP kernel and checking out and building the KUSP software. Next, the new KUSP user should follow the Initial Datatstream Sequence and then the Initial Group Scheduling and Task Alias Sequence.

Subversion Advice

How to check out the KUSP kernel and the KUSP user code. How to gain anonymous SVN access to check out the KUSP source files. This page also includes more general advice about using SVN for those unfamiliar with it.

Building the Kernel

Building a KUSP kernel is easy, but choosing which to build and configuring the kernel you choose can be more subtle.

Building and Installing KUSP

The KUSP user-level code contains a range of tools, demonstration programs, and experiments that in some cases demonstrate basic KUSP capabilities and sub-systems for new users and in other cases investigate various uses of the system or are used as part of developing new capabilities.

Initial Datastream Sequence

This sequence of tutorial examples shows the new user how to use Datastreams at the user and kernel levels to gather data about performance of the system and to analyze that data using the Datastreams Post-processing Framework.

  • Read This Document

Initial Group Scheduling and CCSM Sequence

This sequence of tutorial examples shows the new user how to specify Group Scheduling hierarchies and place a set of computation components under its control.