This is the mail archive of the systemtap@sourceware.org mailing list for the systemtap project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

SystemTapGui v1.0-rc1 is available


A new version of SystemTapGui is available.
http://sourceforge.net/project/showfiles.php?group_id=169234&package_id=193079
Details regarding the SystemTapGui project can be found at http://stapgui.sourceforge.net/


Attaching the README file for your reference.


SystemTap GUI

Table of Contents
-----------------

1. Introduction
2. Requirements
3. Installation
4. Known Bugs
5. Future Plans
6. FAQ 


1. Introduction
----------------

Systemtap GUI is a tool being developed to assist in writing SystemTap
scripts and viewing kernel performance. It is both an Integrated
Development Environment for the SystemTap scripting language, as well as
a data visualization and analysis tool.

The GUI is targetted at System Administrators who want to get
information out of their system using SystemTap, as well as Developers
who wish to write new SystemTap scripts. It is an Eclipse-based
application.


2. Requirements
----------------

Hardware Requirements:
    * x86, x86_64, ppc64

Software Requirements:
    * Linux kernel v2.6.14 or newer
    * Java Virtual Machine (Java 1.5 compatible)
    * SystemTap v0.7 or newer


3. Installation
---------------

SystemTap GUI is packaged as a stand-alone Eclipse application. You may
download and build the source yourself or download a prebuilt version.
NOTE: Installation assumes you already have both Java and SystemTap
installed.

A. From Source

 Client
 --------
   1. Download Eclipse (Recommended v3.3)
      	http://www.eclipse.org/downloads/
   2. Download the source tarball
      	http://sourceforge.net/projects/stapgui/
   3. Untar Eclipse
      	tar -xzvf eclipse-SDK-3.3.1.1-linux-gtk.tar.gz
   4. Import the project into Eclipse
      	Select File->Import
      	Select 'Archive' Click 'Next'
      	Browse to the directory you downloaded the SystemTapGUI	tarball.
        Choose a location to import to
      	Click finish 
   5. Export the project
      	Open up the com.ibm.ras.systemtap.systemtapgui plugin.
	Open the systemtapGUI.product file.
        Click on Eclipse Product Export Wizard under Overview/Exporting.
	Choose Directory for export destination.
	Make sure compiler options are set to Java 1.5 
        Click finish
   6. Run the project
	Locate the exported files and click the stapgui-client icon.
 
   Server
   ------
   1  Untar the stapgui source tarball.
   2. Change directory to the  folder stapguiserver. 
   3. Execute make;make install. This would compile and install the
SystemTapGui Server.
   4. Run the file stapgui-server that has been created. 


B. From Prebuilt Tarball

   1. Download the prebuilt tarball
      http://sourceforge.net/projects/stapgui/
   2. Untar the build
      tar -xzvf SystemTapGui-1.0-rc1.x86.tgz
   3. Run the server
      Open the stapguiserver folder and run the file stapgui-server 
   4. Run the client
      Open the stapguiclient folder and double click the stapgui-client
file 
   5. If you wish to run the client and server on different machines,
repeat steps 1 and 2 on  both machines, then Run the server / client as
required. 

C. From Binary rpm

   1. Download the Binary rpm based on the architecture
      http://sourceforge.net/projects/stapgui/
   2. Install the rpm, eg on x86
      rpm -ivf SystemTapGui-1.0-rc1.x86.rpm
   3. Run the server
      Execute stapgui-server from the command line
   4. Run the client
      Execute stapgui-client from the command line
   5. If you wish to run the client and server on different machines,
repeat steps 1 and 2 on  both machines, then Run the server / client as
required. 


4. Known Bugs
--------------

This is a list of known bugs that the developers are aware of and will
be fixed:

a.  Performance issues with large outputs

b.  Indicate terminate on self ending scripts

c.  Multiple probes can be added for the same line

d.  Time-wait between script submission and execution.


5. Future Plans
---------------- 

The next steps in development are to fix the known bugs in they system
as well as to improve system performance. 

Please post any feedback, whether it be bugs, requested features, or
general questions. Feedback can be posted directly to the projects
website (https://sourceforge.net/projects/stapgui/) or to the systemtap
mailing list. We welcome your input and hope to develop an excellent
open source tool for the community in the coming months.


6. FAQ
--------


1. Why does it freeze / do nothing when I try to run a script?
The script would take 2-3 minutes to execute. The time taken is for the
script to be transferred to and executed on the remote machine. If you
do not see a response after 3 minutes make sure SystemTap and your
kernel are set up properly on the remote machine. For information on how
to do this visit the SystemTap Wiki at
http://sourceware.org/systemtap/wiki

2. Why does it take a long time to start up the first time I open the IDE?
It is running each of the probes to gather information about the
available variables. This only has to be done once, so its recommended
that you let it complete. If you don't need this information, you can
click "Cancel" to stop this process.

END OF DOCUMENT

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]