Copyright 2005-2006 Sun Microsystems, Inc.  All rights reserved.
Use is subject to license terms.

Ident : $Revision: 1680 $ SMI

Cacao tarball distribution
==========================

The Cacao tarball distribution supports the Cacao daemon running as an
arbitrary user with or without root privilege.

The tarball must be untarred and configured by the user who will
execute the cacao daemon. It may then only be administered by this user.

The layout of the tarball distribution is identical to that of a
package distribution installed with the BASEDIR set to a local
directory with the cacao name and version in it, e.g. cacao_2.2.

Please run the 'configure' script before starting cacao:

On Solaris:
	./configure
	usr/sbin/cacaoadm start

On Linux | HP-UX:
	./configure
	cacao/bin/cacaoadm start


Specifying cacao configuration for clients
------------------------------------------

Just like in any other relocated Cacao installation, the configuration
for a cacao instance installed from the tarball is typically not in
the default location. As such, it is important that client APIs
specify the necessary configuration in order to be able to contact the
daemon, such as port number and trust-store to use.

A client may either specify where the local configuration directory is
placed in the filesystem for the daemon instance, via system
properties or a connection environment property, or may specify all
the necessary key/value pairs in the connection environment to
establish the connection (port number, trust-store, etc.).

Please see the javadoc for JmxClient for more information on this.


Port numbers
------------

Please be aware that the port numbers used by the default instance of
a tarball-installed Cacao daemon will collide with the port numbers
from a default instance installed elsewhere (from package, or another
tarball). The user is responsible for reconfiguring the port numbers
to avoid collision.

