BenchIT GUI Kernelmode

Click to find

Click on the picture to be directed to the belonging section.

Basics

What are kernels

We define a kernel as performance measuring programs, which use the BenchIT interface. Those can be mathematical kernels like Matrix Multiplication, Vector Addition or a Sinus/Cosinus-measuring program. But also they can measure IO-Speed, RAM-Access and so on.

Sourcecodefiles

The Editor will have tabs, containing the files of the kernel.Problems:All Files within the directory will be displayed! Even 100MB JPGs!!! Those files should be: COMPILE.SH - this file is used to compile the kernel, PARAMETERS - this file will contain settings for the kernel, and source-code files. If you don't want to edit the source-code, but save memory, you can disable the flag kernelsourceedit in Setup → Preferrences.

How to generate kernels

We generated a HOWTO for this, which can be found at www.benchit.org . You may also select "Duplicate" from a kernels popup-menu to duplicate this kernel and make changes.Problems:The new files will have no eXecutable-flag! You may also add /remove single files to/from a kernel.

Used packages

Here we use a syntax-highlighting by jedit.org, which is under MIT style license.
http://syntax.jedit.org
to begin

The BenchIT GUI's Kernelmode

Switching to the Kernelmode

By clicking on the "Kernel" tab or into the kernel tree area the kernelmode is activated.

The Kerneltree

On the left side of the screen, you should see a tree, which has initially the same structure like the kernel directory of BenchIT. This is the Kerneltree, where you can select the kernels you want to start or edit. Select a single Kernel by clicking a leaf, select several by clicking nodes or hold CTRL down while selecting nodes and leaves. The last selected node or leaf will be shown on the left side. While the files are loaded, you can watch the progress at the lower left corner.

The popupmenu

to begin

What to do

In the upper right corner of the GUI is a combobox, where you can select what you want to do with the kernel.
The Options are:
In the following, we suppose, you've selected "Compile and Run". If you have selected another one, mostly the procedures to start something are the same.
to begin

The Edit - Area

The Editor
Within the editor you can see the source of the file whose name is shown as tab. FORTRAN will be shown right normal, Shellscript-Files, JAVA, C and Headerfiles with syntax-highlighting. (See Kernelfiles - Sourcecodefiles)

to begin

Having selected a node

If you have selected a node, an additional combobox will appear above the sources, under the toolbar, right of the "Save Changes" Button. Here you can select the kernel, whose files you want to edit.

Kernelfiles - RUN.SH

see BenchIT - Structure - Run-Script.

Kernelfiles - COMPILE.SH

see BenchIT - Structure - Compile-Script.

Kernelfiles - PARAMETERS

see BenchIT - Structure - PARAMETERS-Script.
to begin

Starting a kernel

Starting a kernel locale

The ordinary way to start a kernel is to start it from the computer BenchIT is running on. Select the Kernels, you want to start (see The Kerneltree) and start it by using one of these Options:
You will be asked whether to shut down the GUI or not. Not shutting the GUI down will have influence on the measuring.
to begin

Remote-Folder-Execution

This one, like the locale execution, only works for UNIX!

Creating a Remote-Folder

For starting a kernel on an other system remote, you first got to define a Remote-Folder. Do this by selecting the Menu-entry "Setup-Create Remote Folder"
In the following Frame, select your Options: Afterwards you got to type your password at the console, the BenchIT GUI was started from.
Problems: If you don't want to start BenchIT GUI from a console, please be sure that you can start ssh-connections to an other computer without typing a passwort or have a SSH-X-Password-reader.

Executing in Remote-Folder

Basicly, this can be selected in the same way as a local execution. Clicking the right mouse-button on the kernel-tree or selecting the entry in the Measure-Menu. Be sure that there are valid LOCALDEFS for the selected machines on your system or in the LOCALDEF-folders on the remote machines. You will be asked at which Remote-Folders the selected kernels shall be executed and whether to check LOCALDEFS or not. Problems: It may be that the internal hostname of a system differs from the external one. Switch this option off and check manually, whether the LOCALDEFS exist. Then there are 2 password-checks for every system you selected: one for copying, one for executing. Problems: Please be aware, that all files (even existing Result-Files) within the Remote-Folder will have the execute-bit set.

Used Pacakges

Ant-tar Ganymed-SSH2
to begin