README

Brahms Agent Viewer version 1.4.6 alpha 

1/12/2005
Copyright (c) 1998-2005 NASA Ames Research Center. All Rights Reserved.

Table of Contents:

I. Welcome
II. Installation Notes
III. What's New
IV. Known Problems
V. Revision History
VI. Important Notes
VII. Contacting the Brahms development team for Technical Support

I. Welcome!

Welcome to NASA's Brahms Agent Viewer 1.4.6 alpha for Windows 2000, XP, Linux and Mac OS X. Please take a few minutes to read this file, which contains the latest information regarding this release.

II. Installation Notes

The Brahms Agent Viewer is installed as part of Brahms Personal Agent as a plug-in for the Brahms Composer. In order to use the Brahms Agent Viewer you are required to install MySQL 4.x from www.mysql.org . History files generated by the Brahms virtual machine can only be parsed into a MySQL database. 

III. What's New

This new release of the Brahms Agent Viewer is a port of the previously released Agent Viewer version 1.3.1. This new Brahms Agent Viewer can now be used on a variety of platforms to include Windows 2000, XP, Linux, Sparc/Solaris and Mac OS X.

This new release has a better organization of agent information, includes the display of conceptual objects, improved zoom functionality, improved error recovery preventing the application from shutting itself down because of an error and uses a look and feel similar to that of the Brahms IDE.

This new release no longer uses Microsoft Access as the underlying database, but requires MySQL instead. Note that MySQL is not included with this software package and needs to be downloaded and installed separately.

IV. Known Problems

1. In order to zoom in on an area of the agent time line, you need to center the area to be zoomed in the time line view. The zoom function zooms in on the area in the center of the time line view. The zoom function does not yet support zooming in on a perticular area in the time line view.

V. Revision History

The revision history for the Brahms Agent Viewer can be found in  the file named Changes.

VI. Important Notes

1. This version of the Brahms Agent Viewer requires MySQL. MySQL is not included in this software package because of licensing restrictions. In order to use the Brahms Agent Viewer you first need to download and install MySQL version 4.x standard. You can download MySQL from: http://www.mysql.com
2. To keep the use of MySQL simple the Agent Viewer does not make use of a user identifier or password to maintain MySQL databases. In order to enable this functionality you need to set the appropriate privileges for the anonymous user, but only if you set a password for the root user (which is generally advised to do so, see the MySQL user manual for details).
   a. Start mysql in a terminal or command console
   -> mysql -u root mysql
   b. Execute the following command:
   mysql> use mysql;
mysql> GRANT ALL PRIVILEGES ON *.* TO ''@localhost;
mysql> FLUSH PRIVILEGES;
   This will allow the anonymous user working on the system the database is running on to create, delete databases and perform all necessary queries on all databases.
   c. Under RedHat Linux systems the localhost hostname is broken and requires localhost.localdomain to be used. To enable the privileges for that system enter:
   mysql> GRANT ALL PRIVILEGES ON *.* TO ''@'localhost.localdomain';
mysql> FLUSH PRIVILEGES;
   

VII. Contacting the Brahms project team for Technical Support

In case you have problems with the installation or questions and problems with the use of the Brahms Agent Viewer you can reach Technical Support at:

E-mail: support@agentisolutions.com
www: http://www.agentisolutions.com/support/support.htm

Thank you for trying the Brahms Agent Viewer version 1.4.6 alpha. We hope you find it useful in your modeling and agent development efforts. 

Sincerely,

The Brahms Development Team