ELK ALCES 20060509 (build 337) Alces is a device/worker test tool, inspired by Heidelberg Kiel's JMFTransmitter. QUICK START GUIDE First, make sure you have J2SE 1.4.2 SDK (http://java.sun.com) or later installed and that the enviroment variable JAVA_HOME is set correclty. INTERACTIVE TESTING (GUI) 1. Start Alces Windows: Double-click alces.bat Mac OS X: Double-click Alces or run alces.sh from the Terminal 2. Enter a device URL and click the Connect button. 3. Buttons representing all messages the devices support are displayed. Click a button to send a message. 4. Click 'Send File...' to send a file containing an JMF message, for example one of the files in the 'testdata' directory. AUTOMATED TESTING 1. Open a command-line prompt and go to the 'bin' directory 2. Start Alces Windows: Run auto-alces.bat to display the command-line options. Demo: auto-alces.bat http://elk.itn.liu.se/elk/jmf ..\testdata Mac OS X: Run auto-alces.sh to display the command-line options. Demo: auto-alces.sh http://elk.itn.liu.se/elk/jmf ../testdata 3. When Alces has finished running open the test report file in an XSLT-capable web browser such as Safari, Firefox or Explorer. CHANGES 2006-05-09 - Moved start scripts for Interactive Alces to top directory. Automated Alces scripts are still in 'bin' directory. [ALCES-78] - Upgraded to JDFLib-J 2.1.3 build 32. [ALCES-74] - Upgraded 'test/schema' and 'testdata/schema' to JDF Schema 1.3 20060329. [ALCES-74] - Alces can be run from paths containing spaces. [ALCES-45] - Preference dialog dynamically loads incoming and outgoing tests. [ALCES-77] - It is possible to send messages to device's that do not respond to 'KnownMessages' queries. [ALCES-76] - Alces now responds with a JMF Response to incoming JMF Command/Query/Signal/Acknowledge messages. [ALCES-21] - Refactored CheckJDFWrapper to configure CheckJDF programmatically, not through command line. - CheckJDF no longer prints to the command line. - Removed dependency on Commons VFS. CHANGES 2005-12-21 - Interactive Alces: - The responsiveness of the user interface is greatly improved. [ALCES-32] - The test tree no longer needs to be manually refreshed. [ALCES-20] - The SubmitQueueEntry... file dialog now remembers the last used directory. [ALCES-66] - Fixed a queue view redraw bug. [ALCES-54] - Test reports are now longer overwritten. A new directory named "output "+timestamp is now created. The output directories are written to ./ instead of the previous ./bin/. [ALCES-63] - Alces can now send and receive all types of files, not just JMF and JDF. [ALCES-62][ALCES-64][ALCES-65] - Alces now properly processes and logs received messages that have the incorrect content-type, for example messages that are JMF but have the content-type "text/xml". [ALCES-64][ALCES-65] - All message processing is now done in the background. [ALCES-32] CHANGES 2005-11-26 - Interactive Alces - Added queue view with buttons for manipulating the queue - Added context menus to Send JMF File... and SubmitQueueEntry... buttons - Added preferences dialog box for configuring tests and context menus - Displays messages pretty-printed - Shows test message type in test session tree - Saves a test report and all messages before quitting - Messages logged during a test session are now saved with file extensions that match their content-type - Both Interactive Alces and Automated Alces now use the same test engine - Upgraded to be 2.1.3 build 26 - Fixed bug that caused StopPersChannel button to generate invalid messages - Fixed bug that caused KnownDevices button to generate invalid messages - Fixed bug that caused Status button to generate invalid messages - Fixed bug that prevented messages with unknown content-types from being received CHANGES 2005-08-05 - Fixed bug in content-type tests that prevented outgoing messages from passing - SenderID is now set for all outgoing message. SenderID can be configured in 'conf/alces.properties'. - JDF/JMF validation is now done by CheckJDF. The following command line options are used: -q -c -x -v -L ../testdata/schema/JDF.xsd - Imporved formatting of test log in HTML test report - HTML test report prints shows XML report from CheckJDF. In a future release this will be replaced by a link to the XML report file. - Renamed folder "test-cases" to "testdata" - Removed charset from Content-type HTTP header. - Reorganized the sequence of the test-cases. - Added test that fetches and validates the JDF instances referenced by a ReturnQueueEntry JMF message. However, validation is not completely implemented yet. - Updated build script so that source code is now included with distribution. CHANGES 2005-06-02 - Added some new JMF test messages to folder 'test-cases' - Renamed "Send File..." to "Send JMF File...". - If the worker supports the SubmitQueueEntry command the SubmitQueueEntry button allows the user to select a JDF job ticket to submit. - Added keyboard shortcut to SubmitQueueEntry button. CHANGES 2005-05-25 - Renamed automated Alces start scripts from 'alces-text.*' to 'auto-alces.*' - Renamed interactive/GUI Acles start scripts from 'alces-swing.*' to 'alces.*' - The SubmitQueueEntry test-cases now submit a JDF located at http://elk.itn.liu.se/jdf/Approval.jdf. - Fixed incorrect property names in 'conf/alces.properties' that prevented some properties from being set. - Tests are now configurable using the properties alces.incoming.tests and alces.outgoing.test in 'conf/alces.properties'. - The IP address of the host is now the default used to build URLs used in outgoing messages, for example ReturnJMF. - Interactive Alces now uses 'conf/alces.properties'. - Interactive Alces now quits properly. - Added keyboard shortcuts to interactive Alces. CHANGES 2005-05-20 - Fixed the path to suite-html.xsl in suite.xml so that it should work correctly on Windows in all web browsers. CHANGES 2005-05-18 - Renumbered test messages in 'test-cases' - Added a last test message that unregisters all subscriptions. - Added icons to test report 'suite.xml' for clarity - Added source code to distribution - Added software licences KNOWN ISSUES See Alces issue tracking database: http://elk.itn.liu.se/jira/browse/ALCES FOR MORE INFO http://elk.itn.liu.se/alces Claes Buckwalter (clabu@itn.liu.se)