This is the mail archive of the
systemtap@sourceware.org
mailing list for the systemtap project.
SystemTapGui v1.0-rc1 is available
- From: anithra <anithra at linux dot vnet dot ibm dot com>
- To: systemtap <systemtap at sources dot redhat dot com>
- Date: Sat, 27 Sep 2008 03:00:49 +0530
- Subject: 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