Installation and Configuration of Sonic Workbench and Openedge Architect
Total Page:16
File Type:pdf, Size:1020Kb
Combining OpenEdge Architect and Sonic Workbench to Enable ABL Drag and Drop in OpenEdge 10.2B OpenEdge® Architect and Sonic® Workbench are both developed on the Eclipse platform. OpenEdge Architect 10.2B is released on Eclipse 3.4.2; Sonic Workbench 7.5 and 7.6 are released on Eclipse 3.2.2. OpenEdge Architect and Sonic Workbench can be configured to share a common Eclipse platform, however, because the two products are based on different Eclipse platforms, you must use the files and directions in the following sections to successfully combine the two products: • Introduction • Required products and downloads • Installation and configuration of Sonic Workbench and OpenEdge Architect • Third party acknowledgements The information contained in this web paper supplements two books: OpenEdge Getting Started: Installation and Configuration and OpenEdge Development: Messaging and ESB. © 2009 Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved. These materials and all Progress® software products are copyrighted and all rights are reserved by Progress Software Corporation. The information in these materials is subject to change without notice, and Progress Software Corporation assumes no responsibility for any errors that may appear therein. The references in these materials to specific platforms supported are subject to change. Actional, Apama, Apama (and Design), Artix, Business Empowerment, DataDirect (and design), DataDirect Connect, DataDirect Connect64, DataDirect Technologies, DataDirect XML Converters, DataDirect XQuery, DataXtend, Dynamic Routing Architecture, EdgeXtend, Empowerment Center, Fathom, IntelliStream, IONA, IONA (and design), Making Software Work Together, Mindreef, ObjectStore, OpenEdge, Orbix, PeerDirect, POSSENET, Powered by Progress, PowerTier, Progress, Progress DataXtend, Progress Dynamics, Progress Business Empowerment, Progress Empowerment Center, Progress Empowerment Program, Progress OpenEdge, Progress Profiles, Progress Results, Progress Software Developers Network, Progress Sonic, ProVision, PS Select, SequeLink, Shadow, SOAPscope, SOAPStation, Sonic, Sonic ESB, SonicMQ, Sonic Orchestration Server, SonicSynergy, SpeedScript, Stylus Studio, Technical Empowerment, WebSpeed, Xcalia (and design), and Your Software, Our Technology–Experience the Connection are registered trademarks of Progress Software Corporation or one of its affiliates or subsidiaries in the U.S. and/or other countries. AccelEvent, Apama Dashboard Studio, Apama Event Manager, Apama Event Modeler, Apama Event Store, Apama Risk Firewall, AppsAlive, AppServer, ASPen, ASP-in-a-Box, BusinessEdge, Business Making Progress, Cache-Forward, DataDirect Spy, DataDirect SupportLink, Fuse, Fuse Mediation Router, Fuse Message Broker, Fuse Services Framework, Future Proof, GVAC, High Performance Integration, ObjectStore Inspector, ObjectStore Performance Expert, OpenAccess, Orbacus, Pantero, POSSE, ProDataSet, Progress ESP Event Manager, Progress ESP Event Modeler, Progress Event Engine, Progress RFID, Progress Software Business Making Progress, PSE Pro, SectorAlliance, SeeThinkAct, Shadow z/Services, Shadow z/Direct, Shadow z/Events, Shadow z/Presentation, Shadow Studio, SmartBrowser, SmartComponent, SmartDataBrowser, SmartDataObjects, SmartDataView, SmartDialog, SmartFolder, SmartFrame, SmartObjects, SmartPanel, SmartQuery, SmartViewer, SmartWindow, Sonic Business Integration Suite, Sonic Process Manager, Sonic Collaboration Server, Sonic Continuous Availability Architecture, Sonic Database Service, Sonic Workbench, Sonic XML Server, StormGlass, The Brains Behind BAM, WebClient, Who Makes Progress, and Your World. Your SOA. are trademarks or service marks of Progress Software Corporation or one of its affiliates or subsidiaries in the U.S. and other countries. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Any other trademarks contained herein are the property of their respective owners. Third party acknowledgements — See the“Third party acknowledgements” section on page 8. December 2009 Last updated with new content: Release 10.2B Product Code: 4496; R10.2B For the latest documentation updates see the OpenEdge Product Documentation on PSDN (http://communities.progress.com/pcom/docs/DOC-16074). Introduction Introduction Developing ESB Business Processes with the ABL drag and drop capabilities of the Native Invocation Methodology, requires that you have OpenEdge Architect and Sonic Workbench integrated into one Eclipse environment. OpenEdge Architect 10.2B is based on the Eclipse 3.4.2 platform. Prior versions of OpenEdge Architect and Sonic Workbench versions 7.5 and 7.6 are based on the Eclipse 3.2.2 platform. Because of the difference in the Eclipse platforms, installing OpenEdge Architect 10.2B plug-ins into Sonic Workbench 7.5 or 7.6 is not a supported configuration. However, Sonic Workbench version 7.6.2 plug-ins can be installed into OpenEdge Architect, with the instructions contained in this web paper. You can continue using Sonic Workbench 7.5 and 7.6 in separate Eclipse environments and develop your ESB processes with ESBOE Invocation Files. Required products and downloads To combine OpenEdge Architect 10.2B and Sonic Workbench 7.6.2, you must have the following products and download files on your system: • Products – OpenEdge Architect Release 10.2B – Sonic Workbench Version 7.6 – Sonic Service pack 7.6 service pack (most recent version; at least 7.6.2) Note: You must have the valid licenses for your software. • Download files – Eclipse Graphical Editing Framework — GEF342.zip – Eclipse Modeling Framework — EMF242.zip – Eclipse Web Tools Platform — WTP304.zip – Eclipse Java Development Tools — JDT342.zip – Eclipse Plug-in Development Environment — PDE342.zip – Miscellaneous Eclipse dependencies — misc_plugins.zip – Combining OpenEdge Architect and Sonic Workbench to Enable ABL Drag and Drop (this web paper) — CombiningArchitectandSonic.pdf The download files are available from the Progress Download Center, http://www.progress.com/esd. This Web site requires a valid account with Progress Software Corporation to access OpenEdge products and updates. Once you have logged on to the Download Center, from the Software Product List choose Progress® Deployment Components, and then choose Eclipse Components for OpenEdge/Sonic Development Integration to access the files. 3 Installation and configuration of Sonic Workbench and OpenEdge Architect Use the procedures detailed in the following sections to install and configure Sonic Workbench and OpenEdge Architect: • Install and configure Sonic Workbench • Install and configure OpenEdge Architect Install and configure Sonic Workbench To combine your Sonic Workbench and OpenEdge Architect environments, you must first install and configure Sonic Workbench. To install: 1. Install Sonic Workbench 7.6. For help installing Sonic, see your Sonic documentation. Caution: The Sonic installation gives you the option of specifying an existing Eclipse target. Do not utilize this feature. 2. Install the Sonic Service Pack (at least 7.6.2). To configure: 1. Modify the %SONICHOMEMQ%\7.6\bin\setenv.bat file to use a Java 1.5 JVM. The Sonic installation specifies an IBM 1.4 JVM for use with the Domain Manager. The Domain Manager is responsible for starting up the development containers in the Workbench environment and uses the JVM that it is started with. OpenEdge 10.2B requires a Java 1.5 JVM, therefore the dev_OpenEdgeTest container will not start properly without making this change. Open up the setenv.bat file in a text editor and look for the following lines near the top of the file: rem Path to Java executables set SONICMQ_JRE=C:\Progress\Sonic7.6\MQ7.6\ibmjre14-win32\bin\java.exe set SONICMQ_JREW=C:\Progress\Sonic7.6\MQ7.6\ibmjre14-win32\bin\javaw.exe set MGMTCONSOLE_JRE=C:\Progress\Sonic7.6\MQ7.6\jre15-win32\bin\java.exe 4 Installation and configuration of Sonic Workbench and OpenEdge Architect Observe that the environment variable MGMTCONSOLE_JRE points to a Java 1.5 JVM that was specified at installation time. Modify the SONICMQ_JRE and SONICMQ_JREW environment variables to use this same JVM, as shown: rem Path to Java executables set SONICMQ_JRE=C:\Progress\Sonic7.6\MQ7.6\jre15-win32\bin\java.exe set SONICMQ_JREW=C:\Progress\Sonic7.6\MQ7.6\jre15-win32\bin\javaw.exe set MGMTCONSOLE_JRE=C:\Progress\Sonic7.6\MQ7.6\jre15-win32\bin\java.exe 2. Start the Sonic Domain Manager to allow online tailoring when installing OpenEdge, and confirm in the console that you are using Java 1.5. You should see a message similar to the following: Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_11-b03) Sun Microsystems Inc. (home C:\Progress\Sonic7.6\MQ7.6\jre15-win32, version1.5.0_11) Java HotSpot(TM) Server VM (build 1.5.0_11-b03, mixed mode) Install and configure OpenEdge Architect After installing and configuring Sonic Workbench, including starting the Sonic Domain Manager, proceed to installing and configuring OpenEdge Architect. To install: 1. Install OpenEdge Architect 10.2B. – Do not skip the optional installation of the OpenEdge Adapter for Sonic ESB. Be sure to correctly specify the path to your Sonic ESB home folder in your Sonic installation. – Do not select the option to enter additional Eclipse workbench install targets. Sonic 7.5 and 7.6 are not a valid install targets for OpenEdge Architect 10.2B. – See OpenEdge Getting Started: Installation and Configuration, or the online help,