While you are developing your EGL project, you can run it using the Preview tab and using the debugging tools. You can even try out services that you have written or ones from third parties. Testing your application this way saves a lot of time and effort over other development tools that require you to deploy to confirm any changes behave as you expect.
When you are satisfied with your application, you can deploy it to a Web application server such as Apache Tomcat version 6
To create your target Web project, open the deployment descriptor file (.egldd) located in the EGLSource directory of your EGL project. The deployment descriptor specifies where
to deploy - the target Web project (including the target runtime server), and what
to deploy - the Rich UI handlers and services.
In the deployment descriptor editor, click New
next to the Target name field to open the New Dynamic Web project wizard. Enter the name of your Web project. Select Apache Tomcat v6.0 as the target runtime. If you haven't created a server, you can click New
next to the Target runtime field, which opens the New Server Runtime Environment wizard. Select Apache Tomcat v6.0 from the list of servers and click Next. If you have Tomcat installed, you can browse to the installation directory. If you don't have Tomcat installed, you can click Download and Install
, accept the license agreement, and click OK
. (Note: watch the lower right-hand corner of the workbench for progress. If for some reason you get an error, I recommend going to the Apache site and downloading and installing Tomcat then just point to it.)
After you enter the target Web project, you can specify what to deploy. By default, all Rich UI handlers are listed to deploy, meaning each handler generates an HTML file for each locale specified. If you don't want an HTML endpoint created for a particular handler, since you might not want users to be able to go directly to that URL, click the Rich UI Deployment tab and select which handlers you want to deploy. If you have EGL services that you want to expose as Web services, add them under the Services Deployment tab. We have more on services in a later blog post.
When you finish editing the deployment descriptor, save it. To deploy to the target Web project, click the Deploy the EGL descriptor
icon on the top right of the editor window or right-click on the .egldd file and select Deploy EGL descriptor
from the menu.
, and select Tomcat 6. The server will start and the file should open running on localhost (or the hostname you specified).
Deployment descriptors let you customize the deployment of your EGL applications. You can create more than one deployment descriptor for each EGL project. For instance, you may want to specify a Web project to deploy your Rich UI handlers and a second one to deploy your services. Each descriptor can be deployed individually (using the Deploy EGL descriptor
option) or all at once by right-clicking on the EGL project name and selecting Deploy EGL project
We hope this helps you understand some of the basics of deploying EGL projects to the Web. We would love to see your EGL applications out there!