.

Chapter 4. User guide

Table of Contents

4.1. Command line interface
4.1.1. Commands
4.1.2. Command jims-client
4.1.3. Help
4.2. GUI
4.2.1. JIMS JMX Manager

4.1. Command line interface

4.1.1. Commands

There are following commands available: jims-agent, jims-client, and jims-manager.

4.1.2. Command jims-client

Command jims-client can be use to verify JIMS configuration as well as to display the list of available nodes discovered by the JIMS agent running on particular node.

$ jims-client 
JIMS CLI v. 3.0.0, type "help" for help 
JIMS>proxy 149.156.9.73
Proxy configured for: 149.156.9.73
JIMS>connect 10.0.128.9
Connection prepared for: 10.0.128.9
JIMS>list
[01] 10.0.128.1
[02] 10.0.128.2
[03] 10.0.128.3
[04] 10.0.128.4
[05] 10.0.128.5
[06] 10.0.128.6
[07] 10.0.128.7
[08] 10.0.128.8
[09] 10.0.128.9
JIMS>cpu
TIME/CPU0,1,... USER NICE IDLE SYSTEM [hs/s]:
[01] 10.0.128.1: 1[ 0 1] 0[ 0 0] 2054[1029 1025] 3[ 0 3]
[02] 10.0.128.2: 0[ 0 0] 0[ 0 0] 2040[1028 1012] 3[ 0 3]
[03] 10.0.128.3: 0[ 0 0] 0[ 0 0] 2055[1029 1026] 3[ 0 3]
[04] 10.0.128.4: 1[ 0 1] 0[ 0 0] 2052[1028 1024] 3[ 0 3]
[05] 10.0.128.5: 2[ 0 2] 0[ 0 0] 2053[1029 1024] 3[ 0 3]
[06] 10.0.128.6: 1[ 0 1] 0[ 0 0] 2056[1030 1026] 3[ 0 3]
[07] 10.0.128.7: 1[ 0 1] 0[ 0 0] 2056[1030 1026] 3[ 0 3]
[08] 10.0.128.8: 0[ 0 0] 0[ 0 0] 2055[1029 1026] 3[ 0 3]
[09] 10.0.128.9: 0[ 0 0] 0[ 0 0]  200[ 100  100] 0[ 0 0]
JIMS>quit

We can simply verify operation of the pathload module using this JIMS command line client.

$ jims-client 
JIMS CLI v. 3.0.0, type "help" for help 
JIMS>connect 149.156.9.87
Connection prepared for: 149.156.9.87
JIMS>list
[01] 149.156.9.87
JIMS>domain Pathload
Domain set to: Pathload
JIMS>type type
Type set to: type
JIMS>module Repository
Module set to: Repository
JIMS>get ReportString
[Pathload:type=Repository] [ReportString]:
[01] 149.156.9.87: 149.156.97.159, 94.600, 94.600, 518, OK
JIMS>quit

What we can see is the 'slave agent' with IP 149.156.97.159, and the available bandwidth: minimum and maximum in Mbit/s, time from the last measurement and the status of measurement. The gap between measurements can be obtained from Ticker module.
$ jims-client 
JIMS CLI v. 3.0.0, type "help" for help 
JIMS>domain Pathload
Domain set to: Pathload
JIMS>type type
Type set to: type
JIMS>module Ticker
Module set to: Ticker
JIMS>get MeasureGap
[Pathload:type=Ticker] [MeasureGap]:
[01] 149.156.9.87: 600
JIMS>quit

4.1.3. Help

Help for jims-agent, jims-client, and jims-manager is available via man pages:

$ man jims-agent -M $JIMS_HOME/share/man
$ man jims-client -M $JIME_HOME/share/man
$ man jims-manager -M $JIME_HOME/share/man

4.2. GUI

4.2.1. JIMS JMX Manager

JIMS JMX Manager is used for visualization of monitored parameters. There are following visualizations available: lines, bar-graphs, pie-charts.

How to start JIMS JMX Manager:

$ jims-jmxmanager 

Main application of JIMS system in Int.eu.grid is the pathload module and its ability to constantly measure the available bandwidth. The algorithm for measurements is based on the method of pairs of packets and packet trains http://www.cs.cmu.edu/~hnn/papers/igi-tr.pdf In order to measure available bandwidth, we have to connect to JIMS system, and choose one agent from the set of running agents to be the master agent. The master agent connects periodically to the slave agents and performs tests. In order to configure master agent to operate properly and start measuring available bandwidht we have to set the attribute SlavesString in the Pathload/Repository module to the value that is the list of all slave nodes. The list is simply a comma separated list of slaves' IPs. Example pathload statistics obtained between example master 149.156.9.87 and example slave 149.156.97.159 node are shown below: