README

Brahms Agent Viewer version 1.10 

8/12/2011
Copyright (c) 1998-2011 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.10 for Windows XP, Vista, 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 the Brahms Agent Environment as a plug-in for the Brahms Composer. In order to use the Brahms Agent Viewer you are required to install MySQL 5.0.51 or better http://dev.mysql.com/downloads/mysql/5.0.html#downloads  (MySQL 4.1.x is also still supported and can be downloaded from http://downloads.mysql.com/archives.php?p=mysql-4.1). We recommend the use of MySQL 5.0. History files generated by the Brahms virtual machine can only be parsed into a MySQL database. 

III. What's New

This release allows for the workframe and activity elements in the time line view to display a custom tooltip text by encoding the tool tip text in the display text field for the workframe or activity. The tooll tip text is encoded in the display text field as '{ tool tip text }', i.e. the tool tip text must be enclosed by curly braces. The modeler must ensure that the display text itself for that element is still included outside of the curly braces or else no display value is displayed in the time line view.

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 particular area in the time line view.
  2. If a large number of communications are present within a time window in the timeline view and the communication views are enabled view updates may be sluggish. To resolve this disable the communication view updates (Options->Toggle Communication View Updates).
  3. The new statements supported in the body for a workframe related to Java object integration are not yet displayed in the agent viewer. When viewing the details for a workframe you will therefore not see local variable declarations, constructor invocations, or method invocations.

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 5.0.51 Community Server or better. You can download MySQL from: http://www.mysql.com
  2. The Agent Viewer is setup by default to access the MySQL server using the username of 'brahms' and user password of 'brahms'. If you wish to use these defaults you must create this user in MySQL and assign it the appropriate privileges.
    a. Start mysql in a terminal or command console
    -> mysql -u root -p
    -> Enter password: <enter your root password>
    b. Execute the following commands:
    mysql> use mysql;
    mysql> GRANT ALL PRIVILEGES ON *.* TO 'brahms'@'localhost' IDENTIFIED BY 'brahms';
    This will allow the brahms user working on the system on which the database is running to create databases, 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 'brahms'@'localhost.localdomain' IDENTIFIED BY 'brahms';
  3. If you setup a different username/password for MySQL you can either start Composer and go to File->Agent Viewer->Database Settings..., then change the username and password in the opened dialog, make sure 'Remember' is checked and press ok. This will store the new credentials encrypted in the agentviewer.cfg file. If you wish to modify the agentviewer.cfg file directory, make sure to use the encpwd tool located in AgentEnvironment/bin to encrypt and encode your username and password and to store the encrypted results in the configuration file.

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. We hope you find it useful in your modeling and agent development efforts. 

Sincerely,

The Brahms Development Team