Radar

File Release Notes and Changelog

Release Name: 0.9-beta1

Notes:
Radar Release Notes 
-------------------

Author  : Leong Mun Wai <munwai@cyberway.com.sg>
Date    : 20010104
Version : 0.9 beta 1


Requirements
------------

* Tomcat 3.2.x (http://jakarta.apache.org/builds/tomcat/release/v3.2/bin)
* JDOM Beta 5 (http://www.jdom.org)
* Java 2 SDK 1.3
* Xerces 1.2.1 for Java (http://xml.apache.org/dist/xerces-j)


Installation
------------

1. Make sure the JDOM and Xerces jars are in your CLASSPATH. Placing the jars
   in $TOMCAT_HOME/lib will also work for UNIX users.
   
2. Set the environment variable TOMCAT_HOME to point to the Tomcat installation
   in which Radar will be used.
   
3. Copy radar.war into $TOMCAT_HOME/webapps/.

4. (NEW) Comment or delete the tag <xmlmapper:debug level="0"/> in 
   $TOMCAT_HOME/conf/server.xml. Refer to 'Known Issues' below for more details.
   
5. (NEW) Setting up radar for Tomcat 3.2:

   Tomcat 3.2 introduces some additional security features, so here's how
   to get Radar working with it.

   i. Add a Context tag to $TOMCAT_HOME/conf/server.xml
   
        <Server>
            <!-- Other tags ... -->
           
            <ContextManager debug="0" workDir="work" showDebugInfo="true">
                <!- Other tags... -->
               
                <!-- Add this -->
                <Context path="/radar" 
                      docBase="webapps/radar" 
                      crossContext="true"
                      debug="0" 
                      reloadable="true" 
                      trusted="true" > 
                </Context>
            </ContextManager>
        </Server>

   ii. Add a user tag to $TOMCAT_HOME/conf/tomcat-users.xml
   
        <tomcat-users>
            <!-- Other user tags... ->
            
            <!-- Add this -->
            <user name="admin" password="admin" roles="admin" />
        </tomcat-users>

       You can change the 'name' and 'password' attributes to your
       preference.
       
       Radar is placed in the 'admin' realm by default. You can change
       this in $TOMCAT_HOME/webapps/radar/WEB-INF/web.xml.
       
6. Start (or restart) Tomcat.

7. Point your browser to http://your.tomcat.host:port/radar/

8. Authenticate with the name and password set in step 5.

9. The Radar admin page should appear, with a list of available
   contexts.

      
Known Issues (IMPORTANT!)
-------------------------

1. Radar reads $TOMCAT_HOME/conf/server.xml, the Tomcat server config file.
   However, there is an undeclared namespace, xmlmapper that causes 
   JDOM/Xerces to throw an exception. As a work around, comment out the
   <xmlmapper:debug level="0" /> element at the top of server.xml.

License
-------

Radar is distributed under the GNU General Public License. Refer to GPL
for details. 


Changes:
Radar Changelog
---------------

Version: 0.5 beta 1    Date: 20001019
-------------------------------------
* Initial release

Version: 0.5 beta 2    Date: 20001114
-------------------------------------
* File path separators changed to use File.separator. Radar should work under
  Windows now.

* Set XMLOutputter for pretty printing. XML config files will no longer
  appear as a single line.

* Reduced size of screen fonts.

* Fixed bug where empty icon and description tags were added under servlet
  tags.
  
Version: 0.5 beta 3    Date: 20001115
-------------------------------------
* Fixed a bug in server.jsp which prevented the webserver port from being
  updated.

Version: 0.5 beta 4    Date: 20001119
-------------------------------------
* Fixed a bug in reading of docbase under Windows

* Added creation of sample index.jsp during the addition of a new context

* Removed support link. Support information is now on the new Radar website.

Version: 0.9 beta 1    Date: 20010104
-------------------------------------
* Tomcat 3.2 compatibility.