Table of Contents

## Installation

This section details the steps required for the installation of Systemtap GUI on the user's machine.

### Requirements

Hardware Requirements:

- x86, x86_64, ppc64, s390

Sotware Requirements:

- Linux kernel v2.6.14 or newer
- Eclipse v3.4.1
- SystemTap v0.7 or newer

The Gui is a client-server application and the server and client can be installed seperately. The client is an eclipse plugin and requires eclipse to be installed. It provides an IDE to write scripts and a visualizer to view the output in graphical form. The server (stapgui-server) provides stdout/stderr data collection and process management services for processes run on a remote system. The server executes the SystemTap script, collects all output to stderr and stdout from that process, then funnels it via a socket to the client. The client and server can be installed on machines with different architectures.This allows users to monitor remote machines. You may also download and build the source yourself.
NOTE: The client and server are seperate packages and need to be installed independently. You are viewing this help on the eclipse based client.
NOTE: Installation assumes you already have both Eclipse and SystemTap installed.

### Server

1. Install the systemtapguiserver rpm.
Eg on Fedora run the command: yum install systemtapguiserver
2. Run the command 'stapgui-server'. You will get a message saying "Listening for Connections..." in a minute or so which shows that the server is up and running.

### Client

1. Install the eclipse-systemtapgui rpm.
Eg on Fedora run the command: yum install eclipse-systemtapgui
2. Launch eclipse and open the SystemTap IDE perspective to start writing scripts.