Progress FUSE HQ 4.3 User Manual

Fuse HQ
Installing Fuse HQ
Version 4.3
November 2010
The experts in open source integration and messaging

Installing Fuse HQ

Version 4.3
November 2010
Installing Fuse HQ
Version 4.3
Publication date 18 Nov 2010 Copyright © 2001-2010 Progress Software Corporation and/or its subsidiaries or affiliates.
Legal Notices
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, Fuse Mediation Router, Fuse Message Broker, Fuse Services Framework, 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, Savvion, 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, 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, The Brains Behind BAM, WebClient, and Who Makes Progress are trademarks or service marks of Progress Software Corporation and/or its subsidiaries or affiliates 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 Acknowledgments
Fuse ESB 4.3 incorporates ANTLR, Another Tool for Language Recognition v2.7.7 from Terrence Parr. Such technology is subject to the following terms and conditions: SOFTWARE RIGHTS ANTLR 1989-2006 Developed by Terence Parr Partially supported by University of San Francisco & jGuru.com. We reserve no legal rights to the ANTLR--it is fully in the public domain. An individual or company may do whatever they wish with source code distributed with ANTLR or the code generated by ANTLR, including the incorporation of ANTLR, or its output, into commercial software. We encourage users to develop software with ANTLR. However, we do ask that credit is given to us for developing ANTLR. By "credit", we mean that if you use ANTLR or incorporate any source code into one of your programs (commercial product, research project, or otherwise) that you acknowledge this fact somewhere in the documentation, research report, etc... If you like ANTLR and have developed a nice tool with the output, please mention that you developed it using ANTLR. In addition, we ask that the headers remain intact in our source code. As long as
these guidelines are kept, we expect to continue enhancing this system and expect to make other tools available as they are completed. The primary ANTLR guy: Terence Parr parrt@cs.usfca.edu parrt@antlr.org.
Fuse ESB 4.3 incorporates ANTLR, Another Tool for Language Recognition v3.0.1 from Terence Parr. Such technology is subject to the following terms and conditions: [The "BSD licence"] Copyright 2003-2006 Terence Parr 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 code must 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 conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS 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 THE AUTHOR 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 OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Fuse ESB 4.3 incorporates Apache ORO v2.0.8 from the Apache Foundation. Such technology is subject to the following terms and conditions: Apache Software License Version 1.1 Copyright 2000 The Apache Software Foundation. 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 code must 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 conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. The end-user documentation 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, if and wherever such third-party acknowledgments normally appear. 4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact apache@apache.org. 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 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE 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 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY 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 Apache Software Foundation, please see http://www.apache.org/. Portions of this software are based upon public domain software originally written at the National Center for Supercomputing Applications, University of Illinois, Urbana-Champaign.
Fuse ESB 4.3 GA incorporates ASM v1.5.3 from INRIA, France Telecom. Such technology is subject to the following terms and conditions: ASM: a very small and fast Java byte code manipulation framework Copyright 2000, 2002, 2003 INRIA, France Telecom 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 code must 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 conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS 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 THE COPYRIGHT OWNER 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 OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Fuse ESB 4.3 GA incorporates JDOM v1.1 from Jason Hunter& Brett McLaughlin. Such technology is subject to the following terms and conditions: jdom License - Copyright 2000-2004 Jason Hunter & Brett McLaughlin. 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 code must 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 conditions, and the disclaimer that follows these conditions in the documentation and/or other materials provided with the distribution. 3. The name "JDOM" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact {request_AT_jdom_DOT_org}. 4. Products derived from this software may not be called "JDOM", nor may "JDOM" appear in their name, without prior written permission from the JDOM Project Management {request_AT_jdom_DOT_org}. In addition, we request (but do not require) that you include in the end-user documentation provided with the redistribution and/or in the software itself an acknowledgement equivalent to the following: "This product includes software developed by the JDOM Project (http://www.jdom.org/)." Alternatively, the acknowledgment may be graphical using the logos available at http://www.jdom.org/images/logos. THIS 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 THE JDOM AUTHORS OR THE PROJECT 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 OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Fuse ESB 4.3 incorporates OSCore – opensymphony v2.2.4, OSWorkflow v2.7.0, PropertySet – opensymphony v1.3. Such technologies are subject to the following terms and conditions: The OpenSymphony Software License, Version 1.1 (this license is derived and fully compatible with the Apache Software License - see http://www.apache.org/LICENSE.txt) Copyright 2001-2004 The OpenSymphony Group. All 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 must retain the above copyright notice, this list of conditions and the following disclaimer. 1. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
2. The end-user documentation included with the redistribution, if any, must include the following acknowledgment: "This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/)." Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear. 3. The names "OpenSymphony" and "The OpenSymphony Group" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact license@opensymphony.com. 4. Products derived from this software may not be called "OpenSymphony" or "OSCache", nor may "OpenSymphony" or "OSCache" appear in their name, without prior written permission of the OpenSymphony Group. THIS 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 THE APACHE 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 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Fuse ESB 4.3 incorporates Saxon XSLT and XQuery Processor – saxon v9.1.0.1. The contents of this file are subject to the Mozilla Public License Version 1.1 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://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 the specific language governing rights and limitations under the License. The Original Code is all Saxon modules labeled with a notice referring to this license. The Initial Developer of the Original Code is Michael Kay, except where otherwise specified in an individual module. Portions created by other named contributors are copyright as identified in the relevant module. All Rights Reserved. Contributor(s) are listed in the documentation: see notices/contributors.
Fuse ESB 4.3 incorporates Rhino: JavaScript for Java v1.7R1. The contents of this file are subject to the Mozilla Public License Version 1.1 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://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 the specific language governing rights and limitations under the License. The Original Code is Rhino code, released May 6, 1999. The Initial Developer of the Original Code is Netscape Communications Corporation. Portions created by the Initial Developer are Copyright 1997-1999 the Initial Developer. All Rights Reserved. Contributor(s).

Table of Contents

1. Installation Prerequisites ..................................................................................................... 13
Planning your installation ................................................................................................. 14
Fuse HQ Server Requirements ........................................................................................... 15
Fuse HQ Agent Requirements ........................................................................................... 17
Fuse HQ Repository Requirements ..................................................................................... 18
2. Preparing the Fuse HQ Repository ......................................................................................... 19
The Built-in Repository .................................................................................................... 20
Preparing an Oracle Database ........................................................................................... 21
Preparing a PostgreSQL Database ...................................................................................... 22
Preparing a MySQL Database ............................................................................................ 26
Backing Up Your Repository ............................................................................................. 28
3. Installing the Fuse HQ Server ............................................................................................... 29
Downloading a Fuse HQ Server Installation Package ............................................................... 30
Running the Fuse HQ Server Installer .................................................................................. 31
Fuse HQ Server Configuration Settings ................................................................................ 35
Installing the Fuse HQ Server License ................................................................................. 37
4. Installing Fuse HQ Agents ................................................................................................... 39
Downloading a Fuse HQ Agent Installation Package ................................................................ 40
Fuse HQ Agent Installations .............................................................................................. 41
5. Running the Fuse HQ Server and the Fuse HQ Agent ................................................................. 43
Starting and Stopping the Fuse HQ Server ............................................................................ 44
Starting and Stopping the Fuse HQ Agent ............................................................................ 46
6. Upgrading Fuse HQ ............................................................................................................ 51
Upgrading the Fuse HQ Server .......................................................................................... 52
Upgrading the Fuse HQ Agent ........................................................................................... 54
7. Uninstalling Fuse HQ Components ......................................................................................... 57
Uninstalling the Fuse HQ Server ........................................................................................ 58
Uninstalling a Fuse HQ Agent ........................................................................................... 59
9Fuse HQ Installing Fuse HQ Version 4.3
Fuse HQ Installing Fuse HQ Version 4.310
List of Tables
3.1. Installation Mode Arguments for the setup Command ................. 31
3.2. Configuration Settings for the Fuse HQ Server ........................... 35
5.1. Configuration Settings for the Fuse HQ Agent ........................... 46
11Fuse HQ Installing Fuse HQ Version 4.3
Fuse HQ Installing Fuse HQ Version 4.312

Chapter 1. Installation Prerequisites

Before attempting to install Fuse HQ, decide where you are going to install Fuse HQ components and make sure your systems meets the minimum requirements.
Planning your installation ......................................................................................................... 14
Fuse HQ Server Requirements ................................................................................................... 15
Fuse HQ Agent Requirements ................................................................................................... 17
Fuse HQ Repository Requirements ............................................................................................. 18
13Fuse HQ Installing Fuse HQ Version 4.3
Chapter 1. Installation Prerequisites

Planning your installation

What is Fuse HQ Fuse HQ is a tool for monitoring and managing the Fuse infrastructure. With
Fuse HQ you can:
• Inventory resources on your network
• Monitor resources
• Send alerts when problems occur
• Control resources
Fuse HQ Components Before you begin installation of Fuse HQ, you must decide where you will
install the following Fuse HQ functional components:
DescriptionComponent
Fuse HQ Server
Fuse HQ Agent
Fuse HQ Repository
The central component that controls agents, manages data, and provides a browser-based GUI
The component that finds resources, gathers data, controls software, and communicates with the server.
Agents are installed on the systems in a network that you want to monitor or control. See "Fuse HQ Agent
Requirements" on page 17 Note that agents cannot
function remotely; they can only monitor resources on the system where they are installed.
A database, managed by the Server. It stores Fuse HQ data and is responsible for ensuring data integrity and access.
See "Fuse HQ Repository Requirements" on page 18
Fuse HQ Installing Fuse HQ Version 4.314

Fuse HQ Server Requirements

Fuse HQ Server Requirements
Check this section before you install HQ Server on the machine that will be the central control and management system for Fuse HQ.
Hardware • 1 GHz or higher Pentium 4, or equivalent (2 × 2.4GHz Pentium Xeon or
equivalent recommended)
• 1 GB RAM (4 GB or more recommended)
• 1-5 GB Free Disk Space
Operating systems • Linux
• Windows 2003 Server
• Solaris 10 or higher
• Max OS X (Intel x86)
Note
Although HQ Server is not supported under Windows XP in production environments, the configuration works; you can run small evaluation deployments under Windows XP.
Web browsers Fuse HQ supports the following Web browsers:
• Firefox 1.5.x and 2.0.x
• Safari
• Internet Explorer 6 and 7
• Internet Explorer 8, except on Windows 2008
Firefox is the recommended browser.
Java The Fuse HQ Server is bundled with a JRE and its use is recommended.
However, if you prefer to use a JRE (or JDK) that may already be installed
15Fuse HQ Installing Fuse HQ Version 4.3
Chapter 1. Installation Prerequisites
on the system, the JRE or JDK should be version 1.5 or 1.6. We recommend Java 1.5.
IP address The system where you install the Fuse HQ Server must have a static IP
address. A dynamic IP address may disable communication with the Fuse HQ Agent. Check with your system administrator to determine if you need to implement a static IP address on the system where you want to install the Fuse HQ Server.
X windows On UNIX platforms, Fuse HQ Server requires some of the X libraries to create
charts and other graphics in the user interface. Specifically libXp.so.6 must be installed on the system.
The symptoms of missing X libraries are broken graphics and error messages similar to the following:
java.lang.NoClassDefFoundError at net.hyperic.hq.ui.taglib.NavMapTag._getResourceTree(NavMapTag.java:252) at net.hyperic.hq.ui.taglib.NavMapTag.doStartTag(NavMapTag.java:160) etc . . .
Fuse HQ Installing Fuse HQ Version 4.316

Fuse HQ Agent Requirements

Check this section before you install the Fuse HQ Agent on the systems that you want to monitor.
Hardware • 500 MHz Celeron or higher, or equivalent
• 256 MB RAM
• 500 MB Free Disk Space
• Supported Operating System
Operating systems • Linux
• Windows XP, 2003 Server, or 2008 SE
• Windows 7
• Solaris 8 or higher
Fuse HQ Agent Requirements
• Mac OS X
• HP-UX 11.11 or higher
• AIX 5.2 or higher
Java The Fuse HQ is bundled with a JRE and its use is recommended. However,
if you prefer to use a JRE (or JDK) that may already be installed on the system, the JRE or JDK should be version 1.5 or 1.6. We recommend Java 1.5.
IP address The system where you install the Fuse HQ Agent must have a static IP address.
A dynamic IP address may disable communication with the Fuse HQ Server. Check with your system administrator to determine if you need to implement a static IP address on the system where you want to install the Fuse HQ Agent.
17Fuse HQ Installing Fuse HQ Version 4.3
Chapter 1. Installation Prerequisites

Fuse HQ Repository Requirements

For evaluation and testing purposes, the Fuse HQ Server installation includes a default, built-in database that you can install on the local host. However, for actual deployment of Fuse HQ (particularly in large installations), you should install and configure one of the following databases on a remote host:
• Oracle 10g or 11g
• PostgreSQL 8.3 or higher (not supported on Windows in production environments)
• MySQL 5.0.45 or higher (5.1.x is recommended)
See "Preparing the Fuse HQ Repository" on page 19 for more information.
Fuse HQ Installing Fuse HQ Version 4.318
Loading...
+ 42 hidden pages