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:
- Beehive Binary Distribution (download: http://cvs.apache.org/dist/incubator/beehive/v1.0-alpha/bin/)
- Ant 1.6.2 (download: http://ant.apache.org/bindownload.cgi)
- J2SE5 (download: http://java.sun.com/j2se/1.5.0/download.jsp)
(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:
- Beehive Sample: Petstore
- Beehive Web Service Sample: Petstore Dashboard
- Beehive AddressBookWS and EmployeeWS Samples
- Database Control Sample
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:
- GNU tar 1.14 (http://www.gnu.org/software/tar/manual/html_mono/tar.html)
- WinZip 8.0
- Ant's <untar> task (http://ant.apache.org/manual/CoreTasks/unzip.html)