The tginfo TeraGrid Information Service Discovery Client
Introduction
The tginfo tool provides command line search and display of TeraGrid's
Integrated Information Service (IIS) content:
- Sites and resources/systems
- Capabilities
- Software and services
- and much more
It can run on any computer that can communicate via the internet with
http://info.teragrid.org/,
and is designed to run on any Unix, Mac, or Windows computer with a basic Perl installation.
Installing tginfo
The tginfo tool is already installed in the default user environment on these TeraGrid resources:
-
TeraGrid resources with tginfo
The tginfo tool is also part of the TeraGrid Client Toolkit version 0.4.0 or newer:
-
http://vdt.cs.wisc.edu/teragrid/
To use tginfo everywhere else, such as your laptop, desktop, or on any computer where you have shell access, download it from here:
-
http://info.teragrid.org/tginfo/tginfo
TeraGrid resource providers can install the CTSS packaged tginfo as explained here:
-
http://software.teragrid.org/pacman/ctss4/tginfo/README.install
Using tginfo
This documentation augments information in the command
"tginfo help"
and was last revised for Version 1.1.0 Release r1.
Basic command
The basic tginfo command syntax is:
-
tginfo <information_type> [<match_string>] [options]
Use "tginfo help" to see some "information_type" and "match_string" examples. Various "options" follow.
Selecting resources
The "on <match_string>" command line option limits kit, software and service
information discovery by resource:
-
tginfo gridftp on bigred
tginfo gridftp on dtf
The "at <match_string>" command line option limits kit, software and service
information discovery by site (ncsa in this example):
tginfo gridftp at ncsa
The "local" command line option limits kit, software, and service discovery to the
local resource.
Local is determined by first looking into the ~/.tginfo file for an
"on <match_string>" string,
or otherwise by running the tgwhereami tool
installed on all TeraGrid resources.
tginfo local gridftp
The "global" command line option discovers information about all resources, overriding
any resource selection that may appear in the ~/.tginfo file.
tginfo global gridftp
The ~/.tginfo default options file
Users can set their default tginfo options by placing them in their ~/.tginfo file:
- "local" : restricts discovery to the local tgwhereami resource
- "on <match_string>" : restricts discovery to resources that match match_string