This document describes the steps needed to configure Visual COBOL for Eclipse to work with the JVM servlet APIs and common Java Enterprise Edition (JEE) application servers. It will include the steps needed to configure both the IDE and the server. It will include the steps needed to make the Micro Focus JVM COBOL runtime environment available to deployed web applications. Finally it will include appropriate setup steps for various third party APIs and frameworks that can be used with JVM COBOL. Contents 1 Setting up the Servlet Container 1.1 Setting up Tomcat 1.2 Setting up JBoss 2 Setup of the Server Runtime for Eclipse Web Projects 2.1 Setting up the Tomcat Runtime 2.2 Setting up the JBoss Runtime 3 Installing Eclipse Web Tools Platform Adapters 3.1 Installing the WASDev adapter for WebSphere 3.2 Installing the Oracle Enterprise Pack for Eclipse 4 Additional Configuration Details 4.1 Installing the Eclipse Marketplace Setting up the Servlet Container The servlet container can be either part of a full Java Enterprise Edition (JEE) server (such as JBoss) or an independent server that runs only the container (such as Tomcat). The container manages the deployment, execution and lifetime of servlets and JSPs. It will also manage the privileges a servlet has via the security manager policy set in the configuration of the container. This document will outline how to install several common containers and JEE servers. Setting up Tomcat To first set up Tomcat you need to acquire the container from the Tomcat website . Navigate to Binary Distributions and download the zip or tar.gz distributions of this server. For Windows you should download the Windows zip specifically. On all platforms you need to unzip the distribution to a desired direction. On UNIX/Linux platforms this is enough. On Windows you may also need to register the service. Open up an administrator command prompt and change to the bin directory of your Tomcat install. Now execute the command service.bat install . Setting Up JBoss 6.1 JBOSS 6.1 is found on http://www.jboss.org/jbossas/downloads/. Scroll down to JBoss AS 6.1.0.Final and click on Download. Save the jboss-as-distribution-6.1.0.Final.zip file and unzip into a directory on your computer. The same zip is used for Windows and UNIX. JBossAs Tools needs to be installed into Visual COBOL for Eclipse: This allows Eclipse to managed JBoss Application Server. In Eclipse select Windows Preferences. Select Server Runtime Environments . In the Server Runtime Environments view click Add which brings up a New Server Run Time Environment dialogue. Click on Download additional server adapters which brings up a Install New Extension dialogue. Find and click on JBossAS Tools (by Red Hat) then Next. Accept the license agreement and then click Finish. Click OK on any security warnings. A confirmation dialogue will pop up, click Yes. This will download the plug-in and offer the option to restart Eclipse. Setup of the Server Runtime for Eclipse Web Projects This section deals with setting up the server runtime so that Eclipse can run and debug a web application on your specified server. The steps can vary from platform to platform. Setting up the Tomcat Runtime To set up the Tomcat runtime you need to know the version of the runtime you are setting up. By default Micro Focus supports version 7 of Tomcat but version 6 works similarly. From the appropriate new web project dialog select New Runtime . In the Apache group select the version you support and click Next . Choose the location you have installed Tomcat to by clicking Browse . Select an appropriate JRE (usually the same one as the project) and click Finish . Setting Up the JBoss Runtime These steps are needed when configuring a dynamic web project. From the New Dynamic Web dialogue: Click on New Runtime . In the New Server Runtime Environment type in JBoss 6 into the text box. This will show JBoss 6.x Runtime (under JBoss Community). Select this and click Next . A New Server Runtime Environment dialogue is now displayed. The home folder needs to be set. Click on Browse and navigate to the root folder to where JBoss has been installed. If this is correct, the text warning message at the top of the dialogue will disappear and new information will appear in the Configuration section. Make sure the folder is server and default is selected. Click Finish to return to the main Dynamic Web Project dialogue. Installing Eclipse Web Tools Platform Adapters By default the Eclipse Web Tools Platform has support for a limited number of deployment targets. You need to install a platform specific adapter plugin for every non-default platform. This section deals with the install of server adapters for the supported platforms. Installing the WASDev adapter for WebSphere The first step that needs to be taken to install wasdev is to install the Eclipse Marketplace in your instance of Micro Focus Visual COBOL for Eclipse. Then complete the following steps: Open the marketplace dialog by clicking Help - Eclipse Marketplace... In the Find box enter "wasdev" and hit the enter key on your keyboard. A list of WebSphere adapters will be presented. Find the one titled IBM WebSphere Application Server v8.5 Developer and click Install . Once it finishes loading, deselect the option that reads Dojo Toolkit . This overrides the default WTP project options and will interfere with any tutorial provided by Micro Focus on JVM web services. Click Next . When it finishes downloading the plugin accept the license and click Finish . A security warning will pop up about unsigned content. Click OK to dismiss it. Once the software is installed click Restart Now to ensure Eclipse has installed it properly. You should now have the option of creating a Dynamic Web Project which links to a WebSphere server instance. Installing the Oracle Enterprise Pack for Eclipse The first step that needs to be taken to install the enterprise pack is to download the Eclipse plugin from their website: Navigate to the Oracle Enterprise Pack for Eclipse download page. Check the option to accept the license agreement. Download the OEPE Plugins only item for the Eclipse 3.8 (Juno) release. This will download a zip file called oepe-juno-repository.zip . This file is a repository for the adapter needed to make Eclipse interact with WebLogic. To install it follow the steps below: Open the Install New Software dialogue by clicking on Help - Install New Software... Click Add in the Available Software dialog. In the opened dialogue click Archive... Navigate to and select the downloaded zip file to select that respository for your Eclipse install. Enter "WebLogic Adapter" as the repository name and click OK . In the opened respository, expand the Oracle Enterprise Pack for Eclipse option. Check the box marked Oracle WebLogic Server Tools and click Next . Click Next on the dialog showing you the list of packages that will be installed. Accept the license and click Finish . Once the software is installed click Restart Now to ensure Eclipse has installed it properly. You should now have the option of creating a Dynamic Web Project which links to a WebLogic server instance. If not check the Show All Wizards box in the new project window. Some project options can be disabled by the install but can be re-enabled this way. Additional Configuration Details This section deals with miscellaneous tasks which are in support of JVM COBOL web services but aren't directly about them. Installing the Eclipse Marketplace The Eclipse Marketplace is a service by which third party vendors can register plugins for Eclipse. It is necessary to install some components recommended for working with JVM COBOL web services. Start up your Eclipse instance and perform the following: Open the Install New Software dialogue by clicking on Help - Install New Software... Click Add in the Available Software dialog. In the opened dialogue enter "Eclipse Juno" in the Name field. Enter "http://download.eclipse.org/releases/juno" in the Location field. Click OK . When the list of components from the Eclipse Juno repository have loaded expand the General Purpose Tools entry in the list. Check the box marked Marketplace Client and click Next . Click Next on the dialog showing you the list of packages that will be installed. Accept the license and click Finish . Once the software is installed click Restart Now to ensure Eclipse has installed it properly.
↧