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
The release artifacts are available at
This release is 3.12.040; built from revision 6740
of the SVN repository. This release has an extended language
with the ability to tag attributes, and includes the following items:
- Core smartfrog daemon, including services to manage files, start and stop
Java and native programs.
- Example components and applications.
- Ant support: ant tasks to deploy and terminate applications from a build.
- Ant components: the ability to execute ant tasks in a deployment.
- Anubis: a partition aware tuple-space that can be used to implement fault
- Database: components to issue database commands, and deploy HSLDB and MySQL.
- JMX: the ability to configure and manage JMX components, and to manage
SmartFrog components over JMX.
- Logging: integration with Apache commons-logging and Log4J
- Networking: email, FTP, SSH, DNS support.
- Quartz: scheduled operations using Quartz libraries.
- Scripting: support for BSF-hosted scripting languages
- Testing: Distributed JUnit and component testing with SFUnit.
Velocity: generation/transformation of text files during deployment
- 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
- XML: XML support with XOM.
- XMPP: Presence and messaging over Jabber.
This release is available as:
RPM files inside a .tar.gz file.
A JAR installer.
A .tar.gz file containing everything needed to create a private set of RPM files
containing JAR files signed by a private Certification Authority.
The original smartfrog distribution as .zip and .tar.gz (deprecated)
The RPM installation is for RPM-based Linux systems. It comprises the following RPMs:
|The core SmartFrog distribution.
|The shell scripts to add the smartfrog distribution to the
path, and to run the daemon on start-up.
|javadocs for the project
|Ant task and build file execution
|Distributed partition-aware tuple space
|CSV file support
|JMX integration though MX4J
|Junit 3.8.2 test execution
|Logging through Log4J and commons-logging
|SSH, SCP, FTP and email
|Web support: Deployment and liveness pages
|Distributed testing and reporting
All the JAR files are also published to a repository that is compatible with
Apache Maven and Ivy. Add
to your repository list to pull SmartFrog artifacts into your Ivy- or Maven- based build.
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.
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.
There is a special distribution .tar.gz file that can be used to generate
a private set of secure RPM files.
SmartFrog requires Java 1.5 and Ant 1.7 to build.
The distribution does not include a source tree adequate to build the entire
system. Please follow the instructions at
and check out smartfrog/trunk/core from our repository.
This release was built with revision 6740
of the repository, which
is available under the SVN branch
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
Please file all bug reports at http://jira.smartfrog.org/
The SmartFrog Team
Changes since last release
Release Notes - SmartFrog - Version 3.12.040
- [SFOS-516] - some tests raise a non-serializable exception in the server, when it tries to publish the events
- [SFOS-841] - Remove commons-logging.properties from the source tree where it is found
- [SFOS-860] - Get automated releases working again by adding support for SourceForge's new file upload process
- [SFOS-862] - sfDaemon not coming up under Ubuntu
- [SFOS-865] - Setting the default port from Ant tasks doesn't appear to work
- [SFOS-870] - Ant starttests have been commented out for some time
- [SFOS-887] - IDE is complaining about SFSystem
- [SFOS-888] - A Network test is commented out
- [SFOS-889] - TestCompoundsTest.testFailureWrongMessageNested() is failing and commented out
- [SFOS-894] - Properties Test is failing on Hudson and (sometimes) Steve's desktop
- [SFOS-898] - setSfDefaultProperties has the wrong line endings if a release is made from windows
- [SFOS-902] - emailer tests are failing
- [SFOS-903] - clean up email code and tests
- [SFOS-843] - propagate exception received in a lifecycle event to the AssertionFailed error in Junit, hence better stack trace output
- [SFOS-863] - add more env variable diagnostics to sfDiag
- [SFOS-874] - change FileExists.ATTR_MAXSIZE to FileExists.ATTR_MAX_SIZE
- [SFOS-877] - move JavaPackage tests to TestCompound
- [SFOS-895] - fix spelling error in method names in org.smartfrog.services.shellscript.Cmd
- [SFOS-811] - Create Velocity component -using sfInstaller as a template
- [SFOS-833] - Add IsPropertyTrue condition to test for a property being set and == "true"
- [SFOS-836] - add method to FileSystem to convert a vector of paths or FileIntf interfaces into a vector of absolute paths
- [SFOS-857] - add ability to specify a diagnostics message when LoadClass fails to load a class
- [SFOS-873] - Add diagnostics attribute to SF tasks, so that we can dump internal state
- [SFOS-897] - add a new Executable interface, like Runnable but with the ability to throw Exceptions
- [SFOS-670] - Add new sfinterface submit API to support secure deployment
- [SFOS-827] - Upgrade IVY to 2.0 Beta 2
- [SFOS-882] - Release SmartFrog 3.12.040
- [SFOS-885] - Walk through all the test cases, looking for commented out tests that arent logged
- [SFOS-896] - test component to check ability to obtain key and initialise MACData objects