Setting up your Build Environment

Setting up your Build Environment

For the tutorial applications, we rely on Ant as a build tool and Tomcat as the container to run the application. A build.xml file has been provided that can build and deploy the application to Tomcat for you. The build file relies on build.properties for system specific information that it needs to successfully build and deploy the application.

Edit the build.properties file to suit your environment. Modify the Tomcat host and port entries to match your environment. You will also need to modify the username and password to correspond to some existing username and password in the Tomcat tomcat-users.xml file or add a user with the manager role to the file if one is not already present.

Note: For security, the default Tomcat configuration does NOT include a username with the manager role. So if you have just downloaded and installed Tomcat, you'll need to add a manager role in order to deploy to Tomcat using the ant install task. An example tomcat-users.xml file is included in the tutorial directory as a reference. You can also look at Tomcat's documentation for more information.

To deploy the application using the build file

1. Ensure that you have an account that will let you deploy using the remote deployment mechanism.

2. Ensure that Tomcat is running.

3. When your environment is ready, navigate to the following directory:
<icefaces-install-dir>/tutorial/tabbedpane-myFaces/ 
 
4. To compile the source code, generate a .war file with all the required resources, and deploy it to the running Tomcat server, from the command line, type:
ant install
 