Introduction
Gruff is a graph visualization and graphical query builder designed to work with AllegroGraph. It is available as a standalone application (see the Gruff page on the AllegroGraph website) and it will run in a browser.
To start Gruff in a browser, open AGWebView by specifying the scheme, host, and port in a browser:
http[s]://host:NNNNN
host can be localhost
if the browser is run on the host or if local forwarding is set up. NNNNN
is the port number, specified when AllegroGraph was installed. The scheme is http
or https
.
Linking to Gruff from AGWebView is described in the Gruff in a Browser section in the AGWebView document.
There are links to Gruff on the Catalog Page (see the Catalog Page in the AGWebView document) and on the Repository Page (see the Repository Overview Page in the AGWebView document).
Gruff-related configuration directives
The following configuration directives affect Gruff in AllegroGraph. Configuration directives are listed in the Server Configuration and Control document.
DisableGruff. If true (the default is false) disables Gruff in AllegroGraph.
MaxGruffProcesses limits the number of Gruff processes that may be started.
Managing Gruff in AllegroGraph with agtool
agtool is a command-line utility for performing a variety of operations on an AllegroGraph server or repository. Its gruff commands allow users to install and uninstall Gruff versions, to check for new versions available for installation, and to make a specific version the active one (that is, the one that comes up when initiated from AGWebView).
agtool gruff cannot be used to start Gruff in a browser. That must be done from AGWebView (see the Gruff in a Browser page in the AGWebView document).
Execute
agtool gruff --help
for information on using agtool gruff.
Gruff versions can be:
Available: released and available for download.
Installed: downloaded to your AllegroGraph installation.
Active: the version that will be used when Gruff is invoked from AGWebView.
The command
agtool gruff list [available | installed]
lists available or installed versions (according to which argument is supplied). The list of installed version indicates which is active.
New versions of Gruff can be integrated with AllegroGraph as they are released. There is no need to wait for a new version of AllegroGraph.