release_3.11.005beta.html from SmartFrog at Krugle

Show release_3.11.005beta.html syntax highlighted

<h1>SmartFrog 3.11.005beta</h1>

<p>
This is a new release of SmartFrog, the Java-based, LPGL-licensed distributed
deployment framework developed by HP Laboratories. SmartFrog enables
applications to be deployed across multiple machines, configuring different
aspects of the system so that they are all consistently configured, and managing
the life-cycle of the application as a whole. The project's home page is
<a href="http://smartfrog.org/">http://smartfrog.org/</a>
</p>
<p>
The release artifacts are available at
<a
href="http://sourceforge.net/project/showfiles.php?group_id=87384&amp;package_id=176308">
http://sourceforge.net/project/showfiles.php?group_id=87384&amp;package_id=176308</a>
</p>
<p>
This release is 3.11.005beta; built from revision 4827
of the SVN repository. This release has an extended language
with the ability to tag attributes, and includes the following items:
</p>
<ul>

<li> Core smartfrog daemon, including services to manage files, start and stop
  Java and native programs.
</li><li> Example components and applications.  
</li><li> Ant support: ant tasks to deploy and terminate applications from a build.
</li><li> Ant components: the ability to execute ant tasks in a deployment.
</li><li> Anubis: a partition aware tuple-space that can be used to implement fault 
  tolerant systems.
</li><li> JMX: the ability to configure and manage JMX components, and to manage
  SmartFrog components over JMX.
</li><li> Logging: integration with Apache commons-logging and Log4J
</li><li> Networking: email, FTP, SSH, DNS support.
</li><li> Quartz: scheduled operations using Quartz libraries.
</li><li> Scripting: support for BSF-hosted scripting languages
</li><li> WWW: deployment of WAR and EAR files to application servers. deploy-by-copy
  is provided for all application servers that support, and a tomcat-specific
  component can communicate with Apache Tomcat. The Jetty component can
  configure and deploy individual servlets, eliminating much of the need for WAR
  files themselves.
</li></ul>  
<p>
For Java 1.5 systems, there are some extra components:
</p>
<ul>
<li> Database: components to issue database commands, and deploy HSLDB and MySQL.
</li><li> Testing: Distributed JUnit and component testing with SFUnit.
</li><li> XML: XML support with XOM.
</li><li> XMPP: Presence and messaging over Jabber.
</li>
</ul>

<h3>Packaging</h3>

<p>
This release is available as:
</p>
<ol>
<li> RPM files inside a .tar.gz file.
</li><li> a JAR installer.
</li><li>the original core smartfrog distribution as .zip and .tar.gz (deprecated)
</li></ol>
<p>

The RPM installation is for RPM-based Linux systems. It comprises three RPM
files, smartfrog, smartfrog-daemon and smartfrog-demo:
</p>

<table>
<tr><td>smartfrog:</td><td>        the core SmartFrog distribution.</td></tr>
<tr><td>smartfrog-daemon:</td><td> the shell scripts to add the smartfrog distribution to the
                  path, and to run the daemon on start-up.</td></tr>
<tr><td>smartfrog-demo:</td><td>   example code and documentation.</td></tr>
</table>
<p>
All the JAR files are also published to a repository that is compatible with
Apache Maven and Ivy. Add 
<a
href="http://smartfrog.sourceforge.net/repository">http://smartfrog.sourceforge.net/repository</a>
to your repository list to pull SmartFrog artifacts into your Ivy- or Maven- based build.
</p>
<p>
There are also SmartFrog components to retrieve artifacts from such a repository
(the Library components under /org/smartfrog/services/os/java/library.sf ),
which can be used for dynamic download of SmartFrog and other artifacts.
</p>

<h3>Security warning</h3>
<p>

Unless SmartFrog is configured with security, a running daemon
will listen on its configured port for incoming deployment requests, and deploy
the applications with the rights of the user running the daemon. When the
smartfrog-daemon RPM is installed, that means that a process running as root
will be listening on an open port for incoming deployment requests. Do not
deploy SmartFrog this way on any untrusted network, not without turning security
on and, ideally, recreating the RPMs with signed JAR files. 
</p>

<h3>Building SmartFrog</h3>

<p>
SmartFrog requires Java 1.4 and Ant 1.7 to build. For a complete release,
Java1.5 or later is required.
</p>

<p>

The distribution does not include a source tree adequate to build the entire
system. Please follow the instructions at 
  <a href="http://sourceforge.net/svn/?group_id=87384">http://sourceforge.net/svn/?group_id=87384
  </a>
and check out smartfrog/trunk/core from our repository.
</p>

<p>
This release was built with revision 4827 of the repository, which
is available under the SVN branch
<a
href="https://smartfrog.svn.sourceforge.net/svnroot/smartfrog/tags/release3.11.005beta">
https://smartfrog.svn.sourceforge.net/svnroot/smartfrog/tags/release3.11.005beta
</a>

</p>

<p>
We strongly encourage anyone interested in building or extending smartfrog to
get involved in the smartfrog developer mailing list, which can be found from
the sourceforge project page 
<a href="http://sourceforge.net/projects/smartfrog/">
http://sourceforge.net/projects/smartfrog/</a>
</p>


<h3>Reporting Bugs</h3>

<p>
Please file all bug reports at <a
href="http://jira.smartfrog.org/">http://jira.smartfrog.org/</a>
</p>
<p>
The SmartFrog Team      
</p>


<h3>Changes since last release</h3>

<p>
Since the release 3.11.003beta, the primary changes have been in RPM
packaging and distribution.
<ul>
<li> The smartfrog-install JAR is the cross-platform installer JAR,
  recommended for all systems except where RPM installation is desired.

</li><li> There are now RPM packages for Anubis and logging services (the latter
  includes Apache Log4J and commons-logging)
  
</li><li> Uninstalling smartfrog-daemon RPM shuts down the /etc/init.d/smartfrogd
  daemon

</li><li> Uninstalling smartfrog RPM triggers an attempt to shut down any
  running SmartFrog process
  </li></ul>
<p>  
Removing component JARs, such as smartfrog-anubis or smartfrog-logging
does not shut down SmartFrog; this is still something being considered.
Please test and report on any problems with RPM install/uninstall, as
this is an area we are actively trying to stabilise. All RPMs are tested
by installing and removing them from an RHEL5 system, as part of the
build process; behaviour on other RPM-based distributions is still
something we are interested in.
</p>
<p>
There have been improvements in how tests are run, but these do not
involve significant changes to the core other than in test-related
components.
</p>

    
<ul>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-48'>SFOS-48</a>] -         TestCompound, when set up to terminate gracefully (sfShouldTerminate=true) terminates abnormally if the actions threw an exception, even if they were expected
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-272'>SFOS-272</a>] -         Anubis Ping Heartbeat protocol not setting bits in heartbeats
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-308'>SFOS-308</a>] -         smartfrog rpm should shut down sfDaemon in %preun pahse
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-310'>SFOS-310</a>] -         the new installer JAR is  not uploading
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-316'>SFOS-316</a>] -         daemon rpm doesnt stop the daemon; raises an error
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-333'>SFOS-333</a>] -         TestCompound should retain termination record text when converting from an abnormal to a normal termination
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-337'>SFOS-337</a>] -         ConditionalTest is failing
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-338'>SFOS-338</a>] -         SequenceTest is failing
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-340'>SFOS-340</a>] -         error when uninstalling the daemons
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-341'>SFOS-341</a>] -         org.smartfrog.test.system.functions.FunctionsSystemTest failing in cruise control: race condition?
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-343'>SFOS-343</a>] -         rpms aren't deleted in a remote-upload
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-344'>SFOS-344</a>] -         redistributables are logging at debug
</li>
</ul>
        
<h4>        Improvement
</h4>
<ul>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-237'>SFOS-237</a>] -         Automate creation of PDF files from .sxw templates
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-311'>SFOS-311</a>] -         Automate upload of maven artifacts
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-315'>SFOS-315</a>] -         add an IsPropertySet condition to look for a system property
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-327'>SFOS-327</a>] -         allow &lt;sf-parse&gt; task to take a parsertargets.txt file containing the target list
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-328'>SFOS-328</a>] -         Improve bulk loading of parsertargets
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-334'>SFOS-334</a>] -         make testblock deployable out the box
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-342'>SFOS-342</a>] -         Move TextFile output logic to FileSystem
</li>
</ul>
    
<h4>        New Feature
</h4>
<ul>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-330'>SFOS-330</a>] -         add a links directory with unversioned symlinks to the JARs
</li>
</ul>
        
<h4>        Task
</h4>
<ul>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-275'>SFOS-275</a>] -         Copy up new maven artifacts to sourceforge
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-277'>SFOS-277</a>] -         Automate creation of template release annoucement
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-313'>SFOS-313</a>] -         move OptionSet parsing from a switch on characters to string comparision
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-314'>SFOS-314</a>] -         add a -quietexit option to SfSystem
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-331'>SFOS-331</a>] -         add anubis RPM
</li>
</ul>
    
<h4>        Sub-task
</h4>
<ul>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-318'>SFOS-318</a>] -         make org.smartfrog.test.system.workflow.conditional.ConditionalTest async
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-319'>SFOS-319</a>] -         migrate org.smartfrog.test.system.workflow.conditional.RunningForTest to async tests
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-320'>SFOS-320</a>] -         migrate org.smartfrog.test.system.workflow.parallel.ParallelAsyncTest
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-321'>SFOS-321</a>] -         migrate org.smartfrog.test.system.workflow.parallel.ParallelTest
</li>
<li>[<a href='http://jira.smartfrog.org/jira/browse/SFOS-336'>SFOS-336</a>] -         add logging rpm
</li>
</ul>
See more files for this project here