Incubator > Beehive
 

Beehive Installation and Setup

This topic explains how to install a Beehive distribution on your machine. The instructions below are divided into (1) basic setup steps and (2) tutorial-specific steps.

Once you have completed the basic setup steps, you can begin developing Beehive applications. You only need to complete the tutorial-specific steps if you intend to run the Beehive tutorials and samples.

Basic Installation

(1) The following software is required for developing Beehive applications:

(2) Make sure that the following environmental variables are set in your shell.

  • BEEHIVE_HOME
  • ANT_HOME
  • JAVA_HOME

Typical values for these variables would be as follows.

BEEHIVE_HOME = C:\apache\apache-beehive-incubating-svn-snapshot

ANT_HOME = C:\apache\apache-ant-1.6.2

JAVA_HOME = C:\jdk1.5.0

(3) Finally, ensure that JAVA_HOME/bin and ANT_HOME/bin are on your PATH.

That's it! That's all you need to begin developing Beehive applications. The remaining steps are only necessary if you intend to run the Beehive tutorials and samples.

Optional Installation Steps

The following steps are only necessary if you intend to run the Beehive tutorials (Control Tutorial, Page Flow Tutorial, and Web Service Tutorial).

(1) Install the latest Tomcat 5.0.xx distribution file. Download: http://jakarta.apache.org/site/binindex.cgi#tomcat

(2) Ensure that the CATALINA_HOME environmental variable is set in your shell.

(3) Edit the file CATALINA_HOME/conf/tomcat-users.xml so it appears as follows. Elements to add are shown in bold type.

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <role rolename="manager"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="role1" password="tomcat" roles="role1"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="manager" password="manager" roles="manager"/>
</tomcat-users>

What Now?

You are now ready to begin developing Beehive applications. The following tutorials introduce the basic development cycle:

You can also begin running the following samples:

The following application templates will help you get a project started:

Troubleshooting

I Can't Decompress the .tar.gz File

Note: The .tar.gz distribution files are created using Ant's <tar> task (http://ant.apache.org/manual/CoreTasks/tar.html). This generates .tar files that can only be decompressed using a compatible tar utility.

Known compatible utilities include: