savvion bpm installation guide

8/16/2019 Savvion BPM Installation Guide

1/152

Progress Savvion BusinessManager 7.6.4:Installation Guide


2/152


3/152

Notices

For details, see the following topics:

• Documentation copyright notice

• Third-party acknowledgments

Documentation copyright notice

© 2012 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 reservedby Progress Software Corporation. The information in these materials is subject to change withoutnotice, and Progress Software Corporation assumes no responsibility for any errors that mayappear therein. The references in these materials to specific platforms supported are subject tochange.

3Savvion BusinessManager: Installation Guide: Version 7.6.4


4/152

Actional, Apama, Artix, Business Empowerment, Business Making Progress, Corticon, Corticon(and design), DataDirect (and design), DataDirect Connect, DataDirect Connect64, DataDirectTechnologies, DataDirect XML Converters, DataDirect XQuery, DataXtend, Dynamic RoutingArchitecture, Empowerment Center, Fathom, Fuse Mediation Router, Fuse Message Broker, FuseServices Framework, IONA, Making Software Work Together, Mindreef, ObjectStore, OpenEdge,Orbix, PeerDirect, Powered by Progress, PowerTier, Progress, Progress DataXtend, ProgressDynamics, Progress Business Empowerment, Progress Empowerment Center, ProgressEmpowerment Program, Progress OpenEdge, Progress Profiles, Progress Results, ProgressSoftware Business Making Progress, Progress Software Developers Network, Progress Sonic,ProVision, PS Select, RulesCloud, RulesWorld, Savvion, SequeLink, Shadow, SOAPscope,SOAPStation, Sonic, Sonic ESB, SonicMQ, Sonic Orchestration Server, SpeedScript, Stylus Studio,Technical Empowerment, WebSpeed, Xcalia (and design), and Your Software, OurTechnology–Experience the Connection are registered trademarks of Progress Software Corporationor one of its affiliates or subsidiaries in the U.S. and/or other countries. AccelEvent, ApamaDashboard Studio, Apama Event Manager, Apama Event Modeler, Apama Event Store, ApamaRisk Firewall, AppsAlive, AppServer, ASPen, ASP-in-a-Box, BusinessEdge, Cache-Forward,CloudEdge, DataDirect Spy, DataDirect SupportLink, Fuse, FuseSource, Future Proof, GVAC,High Performance Integration, Integration Everywhere, ObjectStore Inspector, ObjectStorePerformance Expert, OpenAccess, Orbacus, Pantero, POSSE, ProDataSet, Progress Arcade,Progress CloudEdge, Progress Cloudware, Progress Control Tower, Progress ESP Event Manager,

Progress ESP Event Modeler, Progress Event Engine, Progress RFID, Progress RPM, ProgressResponsive Cloud, Progress Responsive Process Management, Progress Software, PSE Pro,SectorAlliance, SeeThinkAct, Shadow z/Services, Shadow z/Direct, Shadow z/Events, Shadowz/Presentation, Shadow Studio, SmartBrowser, SmartComponent, SmartDataBrowser,SmartDataObjects, SmartDataView, SmartDialog, SmartFolder, SmartFrame, SmartObjects,SmartPanel, SmartQuery, SmartViewer, SmartWindow, Sonic Business Integration Suite, SonicProcess Manager, Sonic Collaboration Server, Sonic Continuous Availability Architecture, SonicDatabase Service, Sonic Workbench, Sonic XML Server, The Brains Behind BAM, WebClient,and Who Makes Progress are trademarks or service marks of Progress Software Corporationand/or its subsidiaries or affiliates in the U.S. and other countries. Java is a registered trademarkof Oracle and/or its affiliates. Any other marks contained herein may be trademarks of theirrespective owners.

Savvion BusinessManager: Installation Guide: Version 7.6.44

Notices


5/152

Third-party acknowledgments

Progress Savvion v7.6.4 incorporates Apache Avalon 2002/08/06, Apache Jakarta Commonsv1.0.2, Apache Batik v1.1, Apache Jakarta POI v1.1, Apache POI 2003/05/14, Apache JasperRegexp v1.2, xmltask 1.15.1, from The Apache Software Foundation. Such technologies are subjectto the following terms and conditions: The Apache Software License, Version 1.1 Copyright (c)2000 The Apache Software Foundation. All rights reserved. Redistribution and use in source andbinary forms, with or without modification, are permitted provided that the following conditions aremet: 1. Redistributions of source code must retain the above copyright notice, this list of conditionsand the following disclaimer. 2. Redistributions in binary form must reproduce the above copyrightnotice, this list of conditions and the following disclaimer in the documentation and/or other materialsprovided with the distribution. 3.The end-user documentation included with the redistribution, ifany, must include the following acknowledgment: "This product includes software developed bythe Apache Software Foundation (http://www.apache.org/)." Alternately, this acknowledgment mayappear in the software itself, if and wherever such third-party acknowledgments normally appear.4.The names "Apache" and "Apache Software Foundation" must not be used to endorse or promoteproducts derived from this software without prior written permission. For written permission, please

contact [email protected]. 5. Products derived from this software may not be called "Apache",nor may "Apache" appear in their name, without prior written permission of the Apache SoftwareFoundation. THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. INNO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BELIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, ORCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OFSUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER INCONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THEPOSSIBILITY OF SUCH DAMAGE. This software consists of voluntary contributions made by

many individuals on behalf of the Apache Software Foundation. For more information on the ApacheSoftware Foundation, please see (http://www.apache.org/). Portions of this software are basedupon public domain software originally written at the National Center for SupercomputingApplications, University of Illinois, Urbana-Champaign.


Notices


6/152

Progress Savvion v7.6.4 incorporates Apache JAXP v1.3.04 from The Apache Software Foundation.Such technology is subject to the following terms and conditions: The Apache Software License,Version 1.1 Copyright (c) 1999-2003 The Apache Software Foundation. All rights reserved.Redistribution and use in source and binary forms, with or without modification, are permittedprovided that the following conditions are met: 1. Redistributions of source code must retain theabove copyright notice, this list of conditions and the following disclaimer. 2. Redistributions inbinary form must reproduce the above copyright notice, this list of conditions and the followingdisclaimer in the documentation and/or other materials provided with the distribution. 3.The end-userdocumentation included with the redistribution, if any, must include the following acknowledgment:"This product includes software developed by the Apache Software Foundation(http://www.apache.org/)." Alternately, this acknowledgment may appear in the software itself, ifand wherever such third-party acknowledgments normally appear. 4. The names "Xalan" and"Apache Software Foundation" must not be used to endorse or promote products derived fromthis software without prior written permission. For written permission, please [email protected]. 5. Products derived from this software may not be called "Apache", nor may"Apache" appear in their name, without prior written permission of the Apache Software Foundation.THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITYAND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THEAPACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,

INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSEDAND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OFTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This softwareconsists of voluntary contributions made by many individuals on behalf of the Apache SoftwareFoundation and was originally based on software copyright (c) 1999, Lotus DevelopmentCorporation., http://www.lotus.com. For more information on the Apache Software Foundation,please see http://www.apache.org/.


Notices


7/152

Progress Savvion v7.6.4 incorporates Apache LogKit v1.2 from The Apache Software Foundation.Such technologies are subject to the following terms and conditions: The Apache Software License,Version 1.1 -- Copyright (C) 1997-2003 The Apache Software Foundation. All rights reserved.Redistribution and use in source and binary forms, with or without modification, are permittedprovided that the following conditions are met: 1. Redistributions of source code must retain theabove copyright notice, this list of conditions and the following disclaimer. 2. Redistributions inbinary form must reproduce the above copyright notice, this list of conditions and the followingdisclaimer in the documentation and/or other materials provided with the distribution. 3.The end-userdocumentation included with the redistribution, if any, must include the following acknowledgment:"This product includes software developed by the Apache Software Foundation(http://www.apache.org/)." Alternately, this acknowledgment may appear in the software itself, ifand wherever such third-party acknowledgments normally appear. 4.The names "LogKit", "Jakarta"and "Apache Software Foundation" must not be used to endorse or promote products derived fromthis software without prior written permission. For written permission, please [email protected]. 5. Products derived from this software may not be called "Apache", nor may"Apache" appear in their name, without prior written permission of the Apache Software Foundation.THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITYAND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THEAPACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,

INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING,BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSEDAND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OFTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This softwareconsists of voluntary contributions made by many individuals on behalf of the Apache SoftwareFoundation. For more information on the Apache Software Foundation, please see(http://www.apache.org/).

Progress Savvion v7.6.4 incorporates jfor v0.7.2 from jfor. Such technology is subject to the followingterms and conditions: jfor Apache- Style Software License. Copyright (c) 2002 by the jfor project.All rights reserved. Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met: 1. Redistributions of source codemust retain the above copyright notice, this list of conditions and the following disclaimer. 2.Redistributions in binary form must reproduce the above copyright notice, this list of conditionsand the following disclaimer in the documentation and/or other materials provided with thedistribution. 3.The end-user documentation included with the redistribution, if any, must includethe following acknowledgment: "This product includes software developed by the jfor project(http://www.jfor.org)." Alternately, this acknowledgment may appear in the software itself, if andwherever such third-party acknowledgments normally appear. 4.The name "jfor" must not be usedto endorse or promote products derived from this software without prior written permission. Forwritten permission, please contact [email protected]. 5. Products derived from this software may notbe called "jfor", nor may "jfor" appear in their name, without prior written permission of [email protected] SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY

AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THEJFOR PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANYTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


Notices


8/152

Progress Savvion v7.6.4 incorporates ANTLR Runtime v3.1.1 from antlr.org. Such technology issubject to the following terms and conditions: SOFTWARE RIGHTS $Id: //depot/code/org.antlr/main/main/RIGHTS#3 $ ANTLR 1989-2000 Developed by jGuru.com(MageLang Institute), http://www.ANTLR.org and http://www.jGuru.com.

Progress Savvion v7.6.4 incorporates DOM4J v1.6.1 from MetaStuff, Ltd. Such technology issubject to the following terms and conditions: Copyright 2001-2005 (C) MetaStuff, Ltd. All RightsReserved. Redistribution and use of this software and associated documentation ("Software"),

with or without modification, are permitted provided that the following conditions are met: 1.Redistributions of source code must retain copyright statements and notices. Redistributions mustalso contain a copy of this document. 2. Redistributions in binary form must reproduce the abovecopyright notice, this list of conditions and the following disclaimer in the documentation and/orother materials provided with the distribution. 3.The name "DOM4J" must not be used to endorseor promote products derived from this Software without prior written permission of MetaStuff, Ltd.For written permission, please contact [email protected]. 4. Products derived from thisSoftware may not be called "DOM4J" nor may "DOM4J" appear in their names without prior writtenpermission of MetaStuff, Ltd. DOM4J is a registered trademark of MetaStuff, Ltd. 5. Due creditshould be given to the DOM4J Project - http://www.dom4j.org THIS SOFTWARE IS PROVIDEDBY METASTUFF, LTD. AND CONTRIBUTORS "AS IS" AND ANY EXPRESSED OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN

NO EVENT SHALL METASTUFF, LTD. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSEDAND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OFTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Progress Savvion v7.6.4 incorporates java.net args4j v2.0.12 from Kohsuke Kawaguchi. Suchtechnology is subject to the following terms and conditions: Copyright (c) 2003, Kohsuke KawaguchiAll rights reserved. Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met: *Redistributions of source code mustretain the above copyright notice, this list of conditions and the following disclaimer. *Redistributions

in binary form must reproduce the above copyright notice, this list of conditions and the followingdisclaimer in the documentation and/or other materials provided with the distribution.THISSOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,THEIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BELIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, ORCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OFSUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER INCONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THEPOSSIBILITY OF SUCH DAMAGE.


Notices


9/152

Progress Savvion v7.6.4 incorporates Castor 0.9.3 from castor.org. Such technology is subject tothe following terms and conditions: Original Intalio license - Copyright 1999-2004 (C) Intalio Inc.,and others. All Rights Reserved. Redistribution and use of this software and associateddocumentation ("Software"), with or without modification, are permitted provided that the followingconditions are met: 1. Redistributions of source code must retain copyright statements and notices.Redistributions must also contain a copy of this document. 2. Redistributions in binary form mustreproduce the above copyright notice, this list of conditions and the following disclaimer in thedocumentation and/or other materials provided with the distribution. 3.The name "ExoLab" mustnot be used to endorse or promote products derived from this Software without prior writtenpermission of Intalio Inc. For written permission, please contact [email protected]. 4. Productsderived from this Software may not be called "Castor" nor may "Castor" appear in their nameswithout prior written permission of Intalio Inc. Exolab, Castor and Intalio are trademarks of IntalioInc. 5. Due credit should be given to the ExoLab Project (http://www.exolab.org/).THIS SOFTWAREIS PROVIDED BY INTALIO AND CONTRIBUTORS "AS IS" AND ANY EXPRESSED OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. INNO EVENT SHALL INTALIO OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Progress Savvion v7.6.4 incorporates Gwt Ext User Extension v0.3 from GWT-Ext. Such technologyis subject to the following terms and conditions: Copyright(c) 2007-2008, GWT-Ext All rightsreserved. Redistribution and use in source and binary forms, with or without modification, arepermitted provided that the following conditions are met: * Redistributions of source code mustretain the above copyright notice, this list of conditions and the following disclaimer. * Redistributionsin binary form must reproduce the above copyright notice, this list of conditions and the followingdisclaimer in the documentation and/or other materials provided with the distribution. * Neither thename of the GWT-Ext nor the names of its contributors may be used to endorse or promote productsderived from this software without specific prior written permission.THIS SOFTWARE IS PROVIDEDBY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS ORIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. INNO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANYDIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSEDAND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OFTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


Notices


10/152

Progress Savvion v7.6.4 incorporates Jaxen v1.1-beta-3 from jaxen.org. Such technology is subjectto the following terms and conditions: Project License $Id: LICENSE.txt 1128 2006-02-05 21:49:04Zelharo $ Copyright 2003-2006 The Werken Company. All Rights Reserved. Redistribution and usein source and binary forms, with or without modification, are permitted provided that the followingconditions are met: * Redistributions of source code must retain the above copyright notice, thislist of conditions and the following disclaimer. * Redistributions in binary form must reproduce theabove copyright notice, this list of conditions and the following disclaimer in the documentationand/or other materials provided with the distribution. * Neither the name of the Jaxen Project northe names of its contributors may be used to endorse or promote products derived from this softwarewithout specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHTHOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITYAND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THECOPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANYTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Progress Savvion v7.6.4 incorporates Looks v2.1.2 from JGoodies. Such technology is subject tothe following terms and conditions: The BSD License for the JGoodies Looks - Copyright (c)2001-2007 JGoodies Karsten Lentzsch. All rights reserved. Redistribution and use in source andbinary forms, with or without modification, are permitted provided that the following conditions aremet: o Redistributions of source code must retain the above copyright notice, this list of conditionsand the following disclaimer. Redistributions in binary form must reproduce the above copyrightnotice, this list of conditions and the following disclaimer in the documentation and/or other materialsprovided with the distribution. Neither the name of JGoodies Karsten Lentzsch nor the names ofits contributors may be used to endorse or promote products derived from this software withoutspecific prior written permission.THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERSAND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESSFOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHTOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Progress Savvion v7.6.4 incorporates slf4j v1.5.6 from sfl4j.org. Such technology is subject to thefollowing terms and conditions: Copyright (c) 2004-2007 QOS.ch All rights reserved. Permissionis hereby granted, free of charge, to any person obtaining a copy of this software and associateddocumentation files (the "Software"), to deal in the Software without restriction, including withoutlimitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies

of the Software, and to permit persons to whom the Software is furnished to do so, subject to thefollowing conditions: The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUTWARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THEWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE ANDNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BELIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OFCONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITHTHE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Notices


11/152

Progress Savvion v7.6.4 incorporates XStream v1.3.1 from XStream. Such technology is subjectto the following terms and conditions: Copyright (c) 2003-2006, Joe Walnes Copyright (c) 2006-2007,XStream Committers All rights reserved. Redistribution and use in source and binary forms, withor without modification, are permitted provided that the following conditions are met: Redistributionsof source code must retain the above copyright notice, this list of conditions and the followingdisclaimer. Redistributions in binary form must reproduce the above copyright notice, this list ofconditions and the following disclaimer in the documentation and/or other materials provided withthe distribution. Neither the name of XStream nor the names of its contributors may be used toendorse or promote products derived from this software without specific prior written permission.THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "ASIS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THEIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BELIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, ORCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OFSUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER INCONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THEPOSSIBILITY OF SUCH DAMAGE.

Progress Savvion v7.6.4 incorporates Xpp3 v1.1.3.4 from Indiana University. Such technology issubject to the following terms and conditions: Indiana University Extreme! Lab Software LicenseVersion 1.1.1 Copyright (c) 2002 Extreme! Lab, Indiana University. All rights reserved. Redistributionand use in source and binary forms, with or without modification, are permitted provided that thefollowing conditions are met: 1. Redistributions of source code must retain the above copyrightnotice, this list of conditions and the following disclaimer. 2. Redistributions in binary form mustreproduce the above copyright notice, this list of conditions and the following disclaimer in thedocumentation and/or other materials provided with the distribution. 3.The end-user documentationincluded with the redistribution, if any, must include the following acknowledgment: "This productincludes software developed by the Indiana University Extreme! Lab(http://www.extreme.indiana.edu/)." Alternately, this acknowledgment may appear in the softwareitself, if and wherever such third-party acknowledgments normally appear. 4. The names "IndianaUniversity" and "Indiana University Extreme! Lab" must not be used to endorse or promote productsderived from this software without prior written permission. For written permission, please contacthttp://www.extreme.indiana.edu/. 5. Products derived from this software may not use "IndianaUniversity" name nor may "Indiana University" appear in their name, without prior written permissionof the Indiana University. THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED ORIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. INNO EVENT SHALL THE AUTHORS, COPYRIGHT HOLDERS OR ITS CONTRIBUTORS BELIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, ORCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OFSUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER INCONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THEPOSSIBILITY OF SUCH DAMAGE.


Notices


12/152

Progress Savvion v7.6.4 incorporates Sun’s Jmaki framework v1.0, Sun’s Jmaki framework v1.0.3,and Sun's Jmaki framework v1.8.0 from Sun Microsystems, Inc. Such technology is subject to thefollowing terms and conditions: Copyright 1994-2006 Sun Microsystems, Inc. All Rights Reserved.Redistribution and use in source and binary forms, with or without modification, are permittedprovided that the following conditions are met: * Redistribution of source code must retain theabove copyright notice, this list of conditions and the following disclaimer. * Redistribution in binaryform must reproduce the above copyright notice, this list of conditions and the following disclaimerin the documentation and/or other materials provided with the distribution. Neither the name ofSun Microsystems, Inc. or the names of contributors may be used to endorse or promote productsderived from this software without specific prior written permission. This software is provided "ASIS," without a warranty of any kind. ALL EXPRESS OR IMPLIED CONDITIONS,REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,ARE HEREBY EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALLNOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING,MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILLSUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FORDIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OFTHE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED

OF THE POSSIBILITY OF SUCH DAMAGES.You acknowledge that this software is not designed,licensed or intended for use in the design, construction, operation or maintenance of any nuclearfacility.

Progress Savvion v7.6.4 incorporates Mozilla Rhino v1.6 R1 and Saxon-B v8.9. Such technologyis subject to the following terms and conditions: The contents of this file are subject to the MozillaPublic License Version 1.1 (the "License") provided below; you may not use this file except incompliance with the License. You may also obtain a copy of the License athttp://www.mozilla.org/MPL/. Software distributed under the License is distributed on an "AS IS"basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for thespecific language governing rights and limitations under the License.The Original Code is Rhinocode, released - May 6, 1999. - The Initial Developer of the Original Code is NetscapeCommunications Corporation. Portions created by Netscape are Copyright (C) 1997-1999 NetscapeCommunications Corporation. All Rights Reserved. Contributor(s): Norris Boyd, Igor Bukanov,Roger Lawrence, Mike McCabe. (for Mozilla Rhino v1.6 R1) The Original Code is: All this file.TheInitial Developer of the Original Code is Michael H. Kay. Contributor(s): none. (for Saxon-B v8.9).

Progress Savvion v7.6.4 incorporates BeanShell v1.2b8. Sun Public License Notice: The contentsof this file are subject to the Sun Public License Version 1.0 (the "License"); you may not use thisfile except in compliance with the License. A copy of the License is available at http://www.sun.com.The Original Code is BeanShell.The Initial Developer of the Original Code is Pat Niemeyer. Portionscreated by Pat Niemeyer are Copyright (C) 2000. All Rights Reserved. GNU Public License Notice:Alternatively, the contents of this file may be used under the terms of the GNU Lesser GeneralPublic License (the "LGPL"), in which case the provisions of LGPL are applicable instead of thoseabove. If you wish to allow use of your version of this file only under the terms of the LGPL andnot to allow others to use your version of this file under the SPL, indicate your decision by deletingthe provisions above and replace them with the notice and other provisions required by the LGPL.

If you do not delete the provisions above, a recipient may use your version of this file under eitherthe SPL or the LGPL.


Notices


13/152

Progress Savvion v7.6.4 incorporates LALR Parser Generator in Java v0.10k. Such technology issubject to the following terms and conditions: CUP Parser Generator Copyright Notice, License,and Disclaimer – Copyright 1996-1999 by Scott Hudson, Frank Flannery, C. Scott Ananian -Permission to use, copy, modify, and distribute this software and its documentation for any purposeand without fee is hereby granted, provided that the above copyright notice appear in all copiesand that both the copyright notice and this permission notice and warranty disclaimer appear insupporting documentation, and that the names of the authors or their employers not be used inadvertising or publicity pertaining to distribution of the software without specific, written priorpermission. The authors and their employers disclaim all warranties with regard to this software,including all implied warranties of merchantability and fitness. In no event shall the authors or theiremployers be liable for any special, indirect or consequential damages or any damages whatsoeverresulting from loss of use, data or profits, whether in an action of contract, negligence or othertortious action, arising out of or in connection with the use or performance of this software.


Notices


14/152


Notices


15/152

Table of Contents

Preface...........................................................................................................19

About this documentation......................................................................................................................19

User types.............................................................................................................................................19

Information on documentation...............................................................................................................20

Conventions used in this manual...........................................................................................................21

Product Support contact information.....................................................................................................22

Chapter 1: Savvion BusinessManager overview.......................................23

BusinessManager components.............................................................................................................25

How BusinessManager works...............................................................................................................27

BusinessManager user types................................................................................................................28

Chapter 2: Introduction to installation........................................................31

Evaluation license..................................................................................................................................32

Terminology used..................................................................................................................................32

Chapter 3: Before installing BusinessManager.........................................35

Verifying system requirements..............................................................................................................35

Understanding the product information files..........................................................................................37

Preparing your database.......................................................................................................................37

Oracle 10g/11g enterprise edition, Oracle Express 10g, Oracle 11g/10g (RAC).......................38

Modifying maximum number of connections for Oracle Express edition....................................38

MS SQL server 2005, MS SQL server 2008..............................................................................38

IBM DB2.....................................................................................................................................39

OpenEdge 10.2B........................................................................................................................39

Organizing your system information......................................................................................................39

Chapter 4: Installing BusinessManager 7.6.4............................................43

Prerequisites for installation..................................................................................................................44Installing BusinessManager using the installer.....................................................................................44

Specifying directory location.......................................................................................................45

Specifying local machine details.................................................................................................45

Specifying admin credentials .....................................................................................................46

Specifying processor type..........................................................................................................47

Selecting application server........................................................................................................47

Configuring BusinessManager security settings.........................................................................48



16/152

Specifying application server details..........................................................................................49

Specifying BusinessManager Portal URL...................................................................................55

Configuring email properties......................................................................................................56

Specifying User Management Realm details..............................................................................57

Specifying database details........................................................................................................59

Specifying JDK location..............................................................................................................64

Specifying shortcut for Windows operating system....................................................................66Using the silent installation utility...........................................................................................................66

Recording the BusinessManager installation.............................................................................67

Installing with the silent installation utility...................................................................................67

Verifying the installation.........................................................................................................................68

Chapter 5: After installing BusinessManager 7.6.4...................................69

Configuring SBM for Oracle RAC..........................................................................................................70

Modifying SBM configuration files...............................................................................................70

Modifying Oracle sequence for BizEvent table...........................................................................71

Modifying WebLogic 10.3.0 data sources...................................................................................71

Modifying JBoss datasources.....................................................................................................72

Creating profile, servers and resources for WebSphere........................................................................74

Enabling MS SQL server for JDBC distributed transactions..................................................................75

Enabling XA transactions on Windows 7....................................................................................76

Setting up temporary table space for DB2.............................................................................................78

Initializing BusinessManager database repository................................................................................78

Creating BusinessManager database........................................................................................78

Additional steps for OpenEdge..............................................................................................................80

Starting servers.....................................................................................................................................81

Starting EJB and Portal servers.................................................................................................81

Starting BizLogic and BizPulse servers......................................................................................81

Verifying BusinessManager installation.................................................................................................82

Stopping servers...................................................................................................................................83

Chapter 6: Installing BusinessManager service pack 7.6.4......................85

Prerequisites.........................................................................................................................................85

Installing service pack 7.6.4..................................................................................................................86

After installing service pack 7.6.4..........................................................................................................87

Silent installation for service pack 7.6.4................................................................................................88Enabling ApacheDS for SBM................................................................................................................88

Chapter 7: Setting up BusinessManager as service ................................91

Installing BusinessManager as a Windows service...............................................................................91

Install SBM Pramati services......................................................................................................92

Install SBM WebLogic services..................................................................................................92

Install SBM JBoss services........................................................................................................93



17/152

Removing Windows services......................................................................................................93

Monitor or Control SBM services................................................................................................94

Running BusinessManager as a Daemon in Linux ...............................................................................95

BusinessManager as a Daemon on JBoss.................................................................................95

Chapter 8: Uninstalling BusinessManager.................................................97Before uninstalling.................................................................................................................................98Using the Uninstaller.............................................................................................................................98

Using the silent uninstallation utility.....................................................................................................100

Recording the BusinessManager uninstallation.......................................................................100

Uninstalling with the silent uninstallation utility.........................................................................100

After uninstalling..................................................................................................................................101

Appendix A: Supported platforms and configurations...........................103

BusinessManager supported platforms...............................................................................................103

BusinessManager supported configurations.......................................................................................105

BusinessManager supported databases.............................................................................................108

Appendix B: Sample scripts for creating your database........................113

Sample scripts for Oracle 10g/11g enterprise edition, Oracle Express 10g, Oracle 11g/10g (RAC)...113

Sample scripts forMS SQL Server 2005, MS SQL Server 2008.........................................................114

Sample scripts for IBM DB2................................................................................................................115

Sample scripts for OpenEdge 10.2B...................................................................................................116

Appendix C: Customizing temporary directory and log level for installer.119Customizing temporary directory.........................................................................................................119

Customizing log levels.........................................................................................................................120

Appendix D: Using BusinessManager command line utilities...............121

Initializing BusinessManager repository..............................................................................................121

Initializing specific BusinessManager components..................................................................121

Starting and stopping application servers...........................................................................................122

Pramati application server........................................................................................................122

WebLogic application server.....................................................................................................123

WebSphere application server..................................................................................................123

JBoss application server...........................................................................................................124

Starting and Stopping BusinessManager servers...............................................................................125

Starting BusinessManager servers...........................................................................................125

Stopping BusinessManager servers.........................................................................................125



18/152

Appendix E: Re-initializing BusinessManager database........................127

Re-initializing BusinessManager database.........................................................................................127

Appendix F: BizLogic and BizPulse auto-startup....................................129

BizLogic auto-startup...........................................................................................................................129

Disabling BizLogic auto-startup................................................................................................129

BizPulse auto-startup..........................................................................................................................130

Disabling BizPulse auto-startup................................................................................................130

Appendix G: Locating BusinessManager log files..................................131

Application server log files...................................................................................................................131

BusinessManager log files..................................................................................................................132

Appendix H:Setting up JBoss server to use SonicMQ as the JMS provider.133

Deploying the Sonic JCA adapter to JBoss.........................................................................................133

Testing the Sonic JCA deployment......................................................................................................134

Prerequisites for modifying Savvion to use Sonic JMS.......................................................................136

Modifying files in ........................................................................................................136

Appendix I: Configuring JBoss ports.......................................................141

For embedded JBoss..........................................................................................................................141

For JBoss enterprise edition 5.0.1.......................................................................................................142

Glossary......................................................................................................145

Index............................................................................................................151



19/152

Preface


• About this documentation

• User types

• Information on documentation

• Conventions used in this manual

• Product Support contact information

About this documentation

This guide is part of the documentation set for Progress Savvion BusinessManager, version 7.6.4.

User types

Progress Savvion BusinessManager is a business process management system that can be used

by the following types of users:



20/152

ResponsibilitiesUser type

Responsible for carrying out specific business tasks usingBusinessManager applications. Examples include:

• An office administrator submitting an online purchase request.

• HR personnel scheduling interviews for a potential hire.

• A sales representative responding to a customer request.

• An engineer reviewing a trouble ticket reported by a customer.

Application User

Responsible for automating business processes in a particular businessdomain. BPM Portal’s Management module serves as the primaryinterface to BusinessManager for the Manager, enabling the managerto monitor, analyze, and control business processes. Also uses theProcess Modeler for modeling and simulation.

Manager

Responsible for creating customized applications for implementingbusiness processes and developing interfaces associated with tasks.Application developers may work closely with Managers to define the

requirements of an application, and determine the business processes.

Application Developer

Responsible for configuring BusinessManager components, managinguser/group profiles, maintaining the SBM environment, setting up andmanaging cluster and administering BusinessManager utilities.

BusinessManagerAdministrator

Information on documentation

This documentation contains information for the entire range of Progress Savvion BusinessManager

users. In the following table, we recommend the guides that are most relevant to each type of user.Read the …If you are the …

BPM Portal User’s Guide

First Steps Guide

Terminology Guide

Tutorial Guide

Application User

BPM Portal Manager’s Guide


Terminology Guide

Tutorial Guide

Manager


Preface


21/152

Read the …If you are the …

Application Developer’s Guide

BizLogic Developer’s Guide

BizPulse User’s Guide



BPM Studio User’s Guide

Customization Guide

Managed Adapters Guide

First Steps Guide

Terminology Guide

Server Administrator’s Guide

Tutorial Guide

Web services Developer’s Guide Javadocs

Application Developer

BizPulse User’s Guide

BPM Portal Administrator’s Guide



Installation Guide

Managed Adapters Guide

Clustering Guide Terminology Guide

Server Administrator’s Guide

Troubleshooting Guide for Administrators

BusinessManager Administrator

Conventions used in this manual

This document uses the following conventions and terminology notations.

PurposeConvention

Indicates titles of command buttons, checkboxes, options, lists, dialogboxes, and portal page names.

bold

Indicates folder paths and filenames.file path

Indicates book titles.italic

Represents code segments or examples.monospace


Preface


22/152


23/152

1

Savvion BusinessManager overview

Progress Software Corporation is a leading global provider of automated business processmanagement solutions. The company’s product, Progress Savvion BusinessManager (henceforthreferred to as Savvion BusinessManager, BusinessManager or SBM), is a comprehensive businessprocess management platform, which enables companies to quickly transform their businessprocesses into flexible and manageable Web applications, distributed over intranets, extranets,and the Internet.



24/152

BusinessManager addresses every stage in the business life cycle: define, integrate, deploy,monitor, analyze, improve, and control. By adopting an end-to-end approach, BusinessManagerincorporates all the key elements required to meet the ever-changing demands of e-business whileensuring e-business success. By providing integrated management tools, BusinessManager letsyou monitor operations proactively, modifying automated processes dynamically based on changingexternal operations online. An overview of a typical automated business process managementsolutions is shown in Figure 1 on page 24.

Figure 1: BusinessManager overview


Chapter 1: Savvion BusinessManager overview


25/152


• BusinessManager components

• How BusinessManager works

• BusinessManager user types

BusinessManager components

BusinessManager is a suite of integrated components that enables you to easily build intranet,extranet, and Internet applications and manage your e-business. BusinessManager consists ofthe following components as in Figure 2 on page 25:

Figure 2: BusinessManager components

Table 2: BusinessManager components

DescriptionComponent

The Home module of BPM Portal is the primary interface for applicationusers, enabling them to interact with BusinessManager applications.Users can complete entries to various tasks and applications, and linkto the support infrastructure required to complete these tasks.

BPM Portal Home

The Management module enables managers to query, report on, andcontrol processes and resources, visible only to the managers.

BPM PortalManagement


BusinessManager components


26/152

DescriptionComponent

The Administration module enables BusinessManager Administrators tomodify configuration parameters, manage user or group access control,and install or uninstall BusinessManager applications.

BPM PortalAdministration

This component allows application developers to: a) publish theirapplications as Web services, and b) find and convert other available

Web services on the Internet into BusinessManager applications.

Web services

This component provides a framework for developing and implementingWeb-enabled workflow applications.

BizSolo

This is the primary application development tool for BusinessManager,which provides an Eclipse-based integrated development environmentin which users can create BPM projects, processes, Web applications,and rule files.

BPM Studio

This tool is used to design templates for basic business processes, andto run simulations of processes and individual worksteps. Users can alsosave or retrieve processes from the process repository.

Process Modeler

This is a flexible, lightweight, scalable workflow process engine forintranets, extranets, and the Internet.

BizLogic

This open, event-driven rule engine is used to formulate and enforcepolicies in business applications.

BizPulse




27/152

How BusinessManager works

Figure 3 on page 27 provides an overview of the interaction between BusinessManager components.

Figure 3: How BusinessManager works

The following explanations correspond to the labels shown in Figure 3 on page 27, and describehow the components operate.

1. BPM Studio and Process Modeler provide an integrated development environment (IDE) forBusinessManager, where you can design and deploy business processes. The applicationdeveloper designs a process template (with the *.spt or *.swt extension) in the IDE that reflectsthe business flow and other business process requirements. Business rules for the processtemplate can be defined using the Rule Editor, a BizPulse component that is launched withBPM Studio.

2. The Web Container specifies a runtime environment for servlet-based portals that include BPMPortal, BizSolo, and Web services. BPM Portal provides user interfaces for the Home,Management, and Administration modules.

3. Once the process template is defined, BusinessManager Administrators use the Administrationmodule to install the business process on the BizLogic server. Administrators can also configure

BusinessManager components, manage user or group access control, and publishBusinessManager applications as Web services. Once installed, users access applicationsthrough servlets that pass the requests over an RMI/IIOP connection to the BizLogic serverwithin an EJB Container.

4. The EJB Container provides a runtime environment that executes and manages Java-basedprogram components that run on the server side of a client/server network.Within the EJBContainer are the BizLogic server and BizPulse server.

5. The BizLogic server writes events to event tables in the database. Each BPM process usesJDBC to connect to database server as well as store events in the database.Within the BizLogic


How BusinessManager works


28/152

server, BizStore uses JDBC to connect to the database server process and retrieve the eventsdeposited by the BizLogic process. BizStore interprets the events and populates the processtables. These populated tables are used by BPM Portal modules.

6. Once the process template is installed as a BusinessManager application, application userscan use the Home module to do the following:

• Access applications

• Obtain information to perform their tasks

• Launch the application to start process instances from the BizLogic server

7. Once the process template is installed as an BusinessManager application, managers can usethe Management module (if they have access privileges) to monitor execution of processinstances and create reports. Servlets receive requests from managers and pass them ontothe BizLogic server over an RMI/IIOP connection. Managers use the Report Builder to definemanagement reports that retrieve information through JDBC to the database server.

8. BizPulse is a rule-based event or message processing server that loads application rules andexecutes them against the BizLogic and/or external events or messages.This server persistsdata in the database for recovery and with the help of JDBC connects to the database.

9. Managed Adapters exchange information between BusinessManager applications and externalapplications by converting BusinessManager-specific protocol to the protocol of an externalsystem such as a database or ERP system. When users add a Managed Adapter to a workstep,they can define complex mapping between BusinessManager dataslots and adapter inputs oroutputs of the external application. At runtime when the workstep is executed, the ManagedAdapter sets the adapter inputs and configuration, and maps the outputs to the appropriateoutput dataslots.

10. BizSolo is a run-time component that executes the presentation flows.This component providesa Model, View, Controller (MVC) paradigm for developing presentation flow-based applicationsand executing them in a Web container.

11. BusinessManager’s Web services component allows BizLogic applications to be published as

Web services.12. The relational database management system serves as a persistent store for all

BusinessManager data storage needs. BPM Portal and the servers connect to DBMS usingthe JDBC driver.

BusinessManager user types

There are four user types within BusinessManager, Application users, Managers, Applicationdevelopers, BusinessManager administrators.

User types

Each BusinessManager user type is defined below:

• Application users — Application Users use BusinessManager applications to coordinatespecific business tasks with another department within their company, with another companywithin their organization, and/or with a business partner in another organization.The Home




29/152

module in BPM Portal serves as the primary interface in which Application Users runBusinessManager applications.

• Managers — Managers are typically experts in a particular business domain, such as qualityassurance or human resources. They might need to work with managers from other groups inautomating some of the business procedures that these groups share.The Management modulein BPM Portal serves as the primary BusinessManager interface for business managers tocoordinate and integrate business processes, enabling them to exchange information with one

other, and to share functionality over such standard communication channels as the Internetor e-mail.

• Application developers — Application developers are responsible for analyzing businessprocesses and developing interfaces associated with creating tasks or processes. Applicationdevelopers are often not domain experts themselves, but work closely with Managers to definebusiness processes and determine the requirements of an application. Application developersuse BPM Studio or Process Modeler to define the business process; the resulting processtemplate file is tested, simulated, deployed, and run as a BusinessManager application.

• BusinessManager administrators — BusinessManager administrators are responsible forconfiguring BusinessManager components, managing user or group profiles and access control,and installing or uninstalling BusinessManager applications.The Administration module in BPMPortal serves as the primary interface for BusinessManager Administrators to administer

applications.

All BusinessManager user types can communicate by using one or more BusinessManagerapplications. They can also communicate with external applications.

Examples include:

• A QA department manager requesting the human resources department to approve the hiringof a QA engineer.

• HR personnel coordinating interview scheduling with a regional office in another state.

• Engineers collaborating with a business partner’s engineering department to developspecifications for an application.


BusinessManager user types


30/152




31/152

2

Introduction to installation

BusinessManager is delivered in a ZIP file or on a CD-ROM with the content listed in Table 3 onpage 31.

Table 3: BusinessManager installation contents

ContentsDirectory/File

For Windows ( Server 2003, and XP), Redhat Linux 5.5 and

SUSE Linux Enterprise Server 11, IBM AIX 6.1 TL6 SP3, andSun Solaris 10 installations.

Installer

Install.cmd for Windows installation and Install.sh for

UNIX installation2

Install.cmd and

Install.sh

The BusinessManager documentation set contains the following:

• api folder containing Javadocs.

• pdf folder containing all user guides in PDF format.

These documents explain how to use BusinessManager. For acomplete listing, see BusinessManager Documentation in the

Preface.

docs

The images folder contains images for the Release Notes file.images, releasenotes.htm

This file contains the license agreement for end user.license.htm

This file also contains the license agreement for end user in anxml format. This file is used by the Installer wizard.

license.xml

2UNIX installation procedures apply to Solaris, AIX, and Linux operating system.



32/152

ContentsDirectory/File

This file contains Product version, Build number, and relateddata.

buildInfo

This is a readme file that provides information about thebuildinfo file, the installation log file, and Installer command

line options.

readme.txt

The installer by default includes Pramati and JBoss Community edition application servers.BusinessManager can be installed on any one of these application servers or on any other supportedapplication server.

For supported platforms, and supported configurations, see Supported platforms and configurationson page 103.


• Evaluation license

• Terminology used

Evaluation license

The evaluation license file is installed automatically by BusinessManager. The evaluation versionexpires after 90 days. Contact Progress to upgrade to a full license.You may obtain the expirationdate from the expiration date attributes in the license file. The BusinessManager license fileis in XML format and is stored as license.xml in /conf directory.

A license file based on the sales contract or an extended evaluation license file may be obtainedfrom a Progress sales representative, once the evaluation license file has expired. AtBusinessManager start up, the license file validity and expiration are checked. If your license file

has expired or damaged, then you cannot use Progress Savvion BusinessManager.If you are using an evaluation version of BusinessManager, then you are licensed for 15 concurrentHome sessions and 15 concurrent Management sessions. All other modules receive unlimitedsessions. A user logged in is considered a single session and uses a single license. A user loggedin multiple times with the same user name uses the corresponding number of sessions.The licenseremains in use until the user logs out. After a period of inactivity (the length of time depends onthe application server), the session expires, requiring the user to login again. If the session expires,then the license becomes available for use by another user.

Terminology usedSome of the terms used in this guide are listed below:

• : The directory where BusinessManager installer is extracted.

• : BusinessManager Installation directory.

• : The location of WebLogic domain for BusinessManager.For example, C:\bea\user_projects\sbm75

• : The directory where WebSphere application server is installed.


Chapter 2: Introduction to installation


33/152

• : The directory where JBoss server is installed.

• : The directory where WebSphere Proxy server plug-in is installed.

• : The directory where WebSphere HTTP server is installed.

• : The directory where Apache HTTP server is installed.


Terminology used


34/152


Chapter 2: Introduction to installation


35/152

3

Before installing BusinessManager

This chapter describes the tasks you need to perform before you begin the BusinessManagerinstallation.They include:

• Verifying System Requirements

• Understanding the Product Information Files

• Preparing your Database

• Organizing your System Information


• Verifying system requirements

• Understanding the product information files

• Preparing your database

• Organizing your system information

Verifying system requirements

Table 4 on page 36 describes the minimum and recommended requirements for installing andrunning BusinessManager 7.6.1 on Windows and UNIX (Procedures described under the UNIXheading apply to the Solaris, AIX, and Linux operating system).



36/152

Table 4: System requirements

RecommendedMinimumEquipment

Dual CPU Pentium IV 1GHz & up orDual CPUUltraSPARC-III 900 MHz and up

Pentium IV 1GHz orUltraSPARC-III 900 MHz

Processor

2 GB of RAM2 GB RAMMemory3

2 GB and above. Depending on the applicationserver you are using, you may need additionalfree disk space.

2GBFree disk space4

CD-ROMCD-ROMPeripherals

Table 5 on page 36 lists the software that must be installed on your system before you installBusinessManager 7.6.1. If the required software is not already installed on your system, then installthem in the order listed.

Table 5: Software requirements

NotesSoftware

Pramati 6.0 SP4 (embedded in BusinessManager)

WebLogic 10.3.0

WebSphere 6.1.0.31 or WebSphere 7.0.0.13

JBoss Community Edition 5.1 (embedded in BusinessManager)and JBoss Enterprise Application Platform 5.0.1

Application server

Microsoft Internet Explorer is only supported on Windows.Youneed to disable MS JVM. Both browsers require Java plugin (JRE1.5.0).

Mozilla FireFox is supported on both, Windows and Solaris.Requires Java plugin (JRE 1.5.0).

Microsoft Internet Explorer7.0/8.0 or Mozilla FireFox 3.6

Before you install BusinessManager, have the database up andrunning.If you are running an OCI driver, then you must installthe Oracle client on the machine where BusinessManager isinstalled. For the thin driver, the Oracle client is not required.

Use MS Windows Server 2003 Standard/Enterprise R2. Bothcase-sensitive and case-insensitive instances are supported.

Use MS Windows Server 2008 Standard/Enterprise R2. Bothcase-sensitive and case-insensitive instances are supported.

Use MS Windows Server 2003 Standard/Enterprise R2 or AIX5.2/5.3

Oracle 10g, Oracle 10gExpress Edition, and Oracle11g

or

Microsoft SQL Server 2005

or

Microsoft SQL Server 2008

or

IBM DB2 9.5

3Set your virtual memory setting to at least twice the recommended memory setting.You must restart yourmachine to set the virtual memory. If you require more assistance in setting virtual memory then check withyour System administrator.

4For installing BusinessManager on a FAT partition, it is recommended to have at least 2000MB of free diskspace. On NTFS or FAT 32, it is recommended to have at least 1000MB of free disk space.


Chapter 3: Before installing BusinessManager


37/152

NotesSoftware

JDK 1.5/1.6 and J2EE 1.3/1.4.Java Development Kit

Microsoft Active directory, on Windows Server 2003Standard/Enterprise

Sun Java System Directory Server 5.2, on Windows Server 2003

Standard/Enterprise, and Solaris 10

User Management

Important: You may encounter problems with BusinessManager archiving utilities when usingold JDBC drivers.

Understanding the product information files

Before starting the BusinessManager installation, ensure that the following items are available.

• BusinessManager installer extracted from the ZIP file

• BusinessManager license

The BusinessManager installer contains the readme.txt and releasenotes.htm files.

The releasenotes.htm file contains:

• Supported Platforms

• System Limitations

• Information about the BusinessManager user guides

The readme.txt file contains:

• The buildInfo file

• The installation log file

• Installer command line options

Read the above files before proceeding with the installation.

Preparing your database

The following sections guide you to prepare your BusinessManager database.

Important: Certain database configuration changes may be required to ensure optimal performancefor the expected volume of data for specific installations. Consult the database administrator anddatabase documentation for optimizing your BusinessManager database configuration.

If you are planning to set any other language other than English as the default language, then setthe same in your database. Refer your database documentation for more information.


Understanding the product information files


38/152

Oracle 10g/11g enterprise edition, Oracle Express 10g,Oracle 11g/10g (RAC)

To prepare your database:

1. Create a tablespace for BusinessManager.

2. Create a database user using the above tablespace.

3. Grant the following privileges to the user: create session, create table, create sequence, createview.

4. Allocate unlimited quota on tablespace to the user.

5. BusinessManager with Oracle 10g, Oracle 10g Express Edition, and Oracle 11g needs at least50 open cursors. Set this parameter in init.ora or the initorcl.ora file available within

the oracle home.

See Sample scripts for creating your database on page 113 for command syntax and samplescript.

Modifying maximum number of connections for Oracle

Express edition

Perform the following steps to modify maximum number of connections for Oracle Express

Edition database:

1. Log on to the oracle express edition database as system administrator. (In SQL Plus enter:"connect / as sysdba")

2. Set the number of processes to 150. (In SQL Plus run "alter system set processes=150

scope=spfile")

3. Set the number of sessions to 150. (In SQL Plus run "alter system set sessions= 150scope=spfile")

4. Shutdown the database, (In SQL Plus run "shutdown immediate") and then startup the

database (In SQL Plus run "startup").

5. Verify the changes reflected. (In SQL Plus run "show parameter sessions" and "show

parameter processes" ) The processes and sessions are reset to based on the new value

provided in steps 2 and 3.

6. After completing the above steps, restart oracle express edition database.

MS SQL server 2005, MS SQL server 2008


1. Create case sensitive or case insensitive database for BusinessManager as per yourrequirement.

Note: Applications developed with case insensitive databases in earlier releases should beused with case insensitive databases in this release.

2. Create a database user and grant database owner privileges to the user.




39/152

3. Set the ANSI null default option of the database to ON. By doing this, the CREATE TABLE follows the ISO rules to determine whether a column allows null values.

4. Configure MS SQL server to handle distributed transactions (XA transactions). Refer MS SQL2005/2008 online documentation for more information.


IBM DB2


1. Create BusinessManager database.

2. Create a user in the operating system which will be used as the BusinessManager databaseuser.

3. Connect to BusinessManager database and grant database owner privileges to the createduser.

4. Create bufferpool for BusinessManager data and temporary data.

5. Create tablespace for BusinessManager data and temporary data.6. Grant these tablespaces to the database user.


OpenEdge 10.2B

To prepare your database, perform the following:

1. Set environment variables based on your operating system for Open Edge in thesetenv.cmd/sh file.

For Windows:/dbscripts/openedge/preparedatabase/windows/setenv.cmd

For Unix: /dbscripts/openedge/preparedatabase/unix/setenv.sh

2. Create BusinessManager database.

3. Start the database to interact with it.

4. Create a DBA user and grant database admin privileges to the user.

5. Create a database user to be used as the BusinessManager database user.

See Sample scripts for creating your database on page 113 for command syntax and sample script.

Organizing your system information

When the Installer wizard guides you through the installation, you need to enter system informationas summarized in Table 6 on page 40.




40/152

Table 6: BusinessManager system information

NotesInformation

The host name and domain name of the machine on whichBusinessManager is being installed is required to configureBusinessManager server URLs, using which BusinessManagercan be accessed.

Machine Host Name andDomain name

By default, the installer uses C:\SBM76SP1. Ensure the drive isnot a network drive.

BusinessManager destinationfolder

BusinessManager uses email to notify the administrator andusers when certain events occur.

Mail server address format: MyMailServer.MyDomain

Example: mail.company.com

Incoming and outgoing mail servers should be running andaccessible via the network to the BusinessManager host machine.

Mail server address

An email address in the following format:

[email protected]. This person is responsible formanaging BusinessManager.

System administrator's email

address

BusinessManager maintains a special user account for use byBizLogic engine through email, that is, a company can send anotification to an employee about a task to be performed inBusinessManager through email.BizLogic email address format:[email protected]

BizLogic email address

Decide the user management realm you plan to use for yourinstallation:

For LDAP-Sun Java System Directory Server or LDAP-MS ActiveDirectory Realm, the following details are required:

LDAP Server Name : The name of the LDAP server.

LDAP Port: The number of the LDAP port.

LDAP DIT Information: Directory Information Tree (DIT)

information.

LDAP Login Information: Directory-specific login information.

In the case of LDAP realm, ensure that the machine on whichrealm is installed is accessible via the network toBusinessManager host machine.

User Management

Identify the port numbers that you want to use for EJB and Portalservers in case you want to customize the port numbers used

by BusinessManager. Ensure that these ports are unused andunique.

EJB and Portal Server PortNumber

By default, Pramati is the application server.

You also have the option of installing BEA WebLogic Server, IBMWebSphere or JBoss as your application server.

In case the application server is not embedded withBusinessManager, ensure that the application server is installedand is able to run without errors.

Application Server




41/152

NotesInformation

Consult with your local database administrator to get all thedatabase details required depending on the database with whichyou are installing BusinessMananger.

For Example: The database URL, database name, the portnumber on which the database is running, the System Identifierfor the database (for Oracle), database username and password.

Database should be running. If the database is on a remotemachine, then ensure that the database machine is accessiblethrough the network to BusinessManager host machine.

Database

The default name is SBM 7.6.1.BusinessManager programfolder (Windows)

Note: All details during the installation procedure are logged in install.log file within

location. The default log level set for BusinessManager installation is INFO.To

customize the log level for installation procedure, see Customizing temporary directory and loglevel for installer on page 119.




42/152




43/152

4

Installing BusinessManager 7.6.4

This chapter guides you to install BusinessManager.

Note: To install BusinessManager, you need administrator privileges on your machine.

Depending on the existing BusinessManager version, you can choose the installer type:

Table 7: BusinessManager 7.6.4 Installer

then ...If you are ...

Install using the full installer. Refer to:A new SBM user

An existing SBM user with version 7.6 or earlier • Installing BusinessManager using theinstaller on page 44 or

• Using the silent installation utility on page 66

Install using the incremental installer. Refer toInstalling BusinessManager service pack 7.6.4on page 85.

An existing SBM user with version 7.6.1, 7.6.2,or 7.6.3



44/152


• Prerequisites for installation

• Installing BusinessManager using the installer

• Using the silent installation utility

• Verifying the installation

Prerequisites for installation

Before installing BusinessManager:

1. Install and configure the application server properly.

2. Install the firewall, if required. Ensure that you have permissions to manage the firewa

savvion bpm installation guide

Documents