Home

TIBCO ActiveMatrix Service Bus Installation

1. param3 param4 In the next example the command requires two parameters The first parameter can be either param1 or param2 and the second can be either param3 or param4 MyCommand paraml param2 param3 param4 In the next example the command can accept either two or three parameters The first parameter must be param1 You can optionally include param2 as the second parameter And the last parameter is either param3 or param4 MyCommand paraml param2 param3 param4 TIBCO ActiveMatrix Service Bus Installation Preface xi How to Contact TIBCO Support For comments or problems with this manual or the software it addresses please contact TIBCO Support as follows e For an overview of TIBCO Support and information about getting started with TIBCO Support visit this site http www tibco com services support e If you already have a valid maintenance or support contract visit this site https support tibco com Entry to this site requires a username and password If you do not have a username you can request one TIBCO ActiveMatrix Service Bus Installation xii How to Contact TIBCO Support TIBCO ActiveMatrix Service Bus Installation Chapter 1 Topics Installing TIBCO ActiveMatrix Service Bus This guide explains how to install TIBCO ActiveMatrix Service Bus on all supported platforms e Installation Overview page 2 e Software Requirements page 6 e Installing Hibernate page 10 e I
2. Use the GAC tool gacutil http msdn microsoft com en us library ex0ss12c VS 80 aspx Enterprise Message Service 5 x Install the Runtime feature which automatically installs the C client DLL in the GAC UNIX Adapter Binding Containers If you want to run TIBCO ActiveMatrix Adapter containers on UNIX systems set the following environment variables Set PATH to include RV_HOME bin and RV_HOME 1ib Set LD_LIBRARY_PATH to include RV_HOME 1ib On 64 bit platforms set LD_LIBRARY_PATH or SHLIB_PATH to include RV_HOME 1ib 64 Edit the following paths in AMX_HOME 2 3 server bin server tra which is the template for all the nodes created on a machine tibco env PATH RV_HOME bin PSP RV_HOME lib tibco flattener lib rary path PSP PATH tibco env LD_LIBRARY_PATH RV_HOME lib PSP tibco flattener libra ry path PSP LD_LIBRARY_PATH tibco env SHLIB_PATH RV_HOME lib PSP tibco flattener library pa th PSP SHLIB_PATH tibco env LIBPATH RV_HOME lib PSP tibco flattener library path PSP LIBPATH TIBCO ActiveMatrix Service Bus Installation Post Installation Procedures 27 Linux Installation Steps on IBM zSeriesPost Installation Procedures The LD_LIBRARY_PATH variable cannot be set to reflect the location of the bundled JRE in your profile until the installation is complete To complete post install tasks do the following 1 Prepend the location of the JRE bundled in your product AMX_HOME tibcojre64 1 5 0 b
3. DIRECTLY OR INDIRECTLY BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND READ ME FILES Copyright 2005 2010 TIBCO Software Inc ALL RIGHTS RESERVED TIBCO Software Inc Confidential Information Q Contents PESTACO coria o ADEE A AAA RRA OR A A RE AA v Related Doumea Me rio a AREA REI die a aan vi TIBCO Activellathx cane ii A BLADE AAA vi Third Party Documentation sv dario is REA A o Rei vi Typographical Conventions cas pride Ra bo Pear We Saul errieta he Save nese hess viii how le Comat TIBOO Suppor oss 4 lr AA e rtada odeti xi Chapter 1 Installing TIBCO ActiveMatrix Service Bus eee eee 1 salar PAR RIPETO TITO TI 2 isfalistion Modes oe nice ead ee edd de eee a a aaa a a e aa die 2 na E co rau pave ise ERO CEE RIE TORE E CORTESI ee aoa ti oaot pra TITTI 2 Supporied HOSIAMES i is cir iii IERI RI rare 3 Supported Padoa ohio oe ee LARE et 3 metaller AIRONE ie iii ee ede eee oe enedeted od added econ eedee E E E 4 ster ol ao id INTE CRI OTT TT FITTO n 4 SYS MISMO 2 coca se hieotoeect eeegatdewsdeenatadesseaserdssuleeebosavbeseureasibeaasd 5 RES PRIORI PIERO ETTI III TTT TTT 5 Sotware REQUIIEMENTE isti pEr 6 E A E EEN ES A EE ES a ENE AN E RAISI eas see eee et 6 Pr od ct COMPAIONO ES oir eRe A AA 6 VIB SONI st ce POTITO IT IO TTT 6 DEMS CUATE terorii aeter ieir ie eed dearth db eae Oder Peel bee Lira 7 JOB Dt dad ois bos Sd Sig IA AAA AA d 7 Mi
4. Visual Studio 2005 9 WwW web browser 8 TIBCO ActiveMatrix Service Bus Installation
5. and JMS Bindings with IBM WebSphere JMS LL 30 Uiimstaling Ne SONAE aos ct case shack AI a Shee ee a Ske ee andere 32 Frequently Asked GuUGSHONG perio air kp dhe pda kei 34 O 6 wea bee ts iw eis ee pa ie Se bee RAI 37 TIBCO ActiveMatrix Service Bus Installation Preface This software may be available on multiple operating systems However not all operating system platforms for a specific software version are released at the same time Please see the readme txt file for the availability of this software version on a specific operating system platform Topics e Related Documentation page vi e Typographical Conventions page viii e How to Contact TIBCO Support page xi TIBCO ActiveMatrix Service Bus Installation vi Related Documentation Related Documentation This section lists documentation resources you may find useful TIBCO ActiveMatrix Documentation The following documents form the ActiveMatrix documentation set TIBCO ActiveMatrix Service Bus Installation Read this manual for instructions on site preparation and installation TIBCO ActiveMatrix Concepts Read this manual before reading any other manual in the documentation set This manual describes terminology and concepts of the ActiveMatrix platform The other manuals in the documentation set assume you are familiar with the information in this manual TIBCO ActiveMatrix Administration Read this manual to learn how to manage the ActiveMatrix runtime
6. appears Verify the list of products selected for install and then click Install Click Yes to All to close any popup windows that display during installation To install the Management Daemon as a Windows service check the Create Windows service for Management Daemon checkbox and then click Next If you have selected the Administrator component for installation the TIBCO ActiveMatrix Administrator screen appears Two checkboxes are available Launch Administrator Server Creation Wizard runs Administrator server creation wizard in GUI mode as part of installation The wizard is independent of the installer and can be used before installer completes Start Default HSOLDB Database starts the HSOLDB database The Administrator server creation wizard allows you to create the first ActiveMatrix Administrator server and ActiveMatrix node See Creating the First ActiveMatrix Administrator Server in TIBCO ActiveMatrix Administration for details about the Administrator server creation wizard configuration fields While running the Administrator server creation wizard you select a database which must be running before you start the wizard If you are using HSQLDB database check the Start Default HSOLDB Database checkbox If you are using another database start the server before running the wizard If you are using Sybase or Oracle thin drivers do not run the wizard because configuration of these drivers can only be performed when you run
7. are used in this manual Table 1 General Typographical Conventions Convention Use TIBCO_HOME Many TIBCO products are installed within the same home directory This ENV NAME directory is referenced in documentation as TIBCO_HOME The value of TIBCO_HOME depends on the operating system For example on Windows ENV_HOME systems the default value is C tibco AMX_HOME Other TIBCO products are installed into an installation environment A AMX ADMIN HOME product installed into an installation environment does not access 7 7 components in other installation environments Incompatible products and multiple instances of the same product must be installed into different installation environments An installation environment consists of the following properties e Name Identifies the installation environment The name is appended to the name of Windows services created by the installer and is used in the path to the product in the Windows Start gt All Programs menu This directory is referenced in documentation as ENV_NAME e Description Provides information about what the environment contains or is used for e Path The directory into which the product is installed This directory is referenced in documentation as ENV_HOME The value of ENV_HOME depends on the operating system For example on Windows systems the default value is C tibco TIBCO ActiveMatrix installs into a directory inside ENV_HOME This directory is referenced in documentati
8. ccd dees edbee des Ce Riolo od ede ee die ended erideeedeegedeesbis 8 MEU DIONE sue PRA CIRROSI TITO FIST ee wens 8 Adone Flash and Higher eo bag cathe ee AR RA 8 UDDIRGG SMES 2 6646 Me edie Goi ctw ed gue aeuet seeds eee A ae 8 Merosot SOI yori oe ood de nbd eee tds 9 al RS etka ee eee Rake VE RIA Saeed a SAA badd eA Mal VAL bee bh eee Sd 10 e anita A 10 ae Ps aa a eee ee eee kere Tee ee See Te eee eee is ae 10 installing TIBCO ActiveNiatti S Wice BUS coman na REECE REE ERE a a 14 installing OU Made 330000 ERRORE E MEARE ERA A e LIL 14 installing Console SOS ieri drid eee ata 17 installing Wi SIRENS RR AA EE A A ARA AoE weed ARIE 18 Poststistaislon Procedures es cicci priest 20 TIBCO ActiveMatrix Service Bus Installation iv Contents Migrating ActiveMatrix Components From 2 0 x 2 1 0 2 2 X TO 2 3 20 AcliveMatrix Administrator SEVEN oros AA 20 Packaging and Installing Native Database Divers iii RA uris dari rE E AA 20 Oracle OC Driver Support scia ee EERE Red RETE EN LORIA 24 hapagement DA MOM RR O 25 Windows NET EXENSIONS ici RR A e tba 25 Windows TIBCO Enterprise Message Service CH Client 25 UNIX Adapter Binding Contaimers iii eee ke de eed Ree ba PER ET PP EE E RR 26 Linux Installation Steps on IBM zSeriesPost Installation Procedures 0 0 0 0 c eee eee 27 Installing and Enabling Sonic 6 1 Of 7 5 RETE A 27 Using SOAP JMS and JMS Bindings with WebLogic JMS 6 5 iii 28 Using SOAP JMS
9. the wizard in silent mode TIBCO ActiveMatrix Service Bus Installation 16 Chapter 1 Installing TIBCO ActiveMatrix Service Bus 14 15 While running the Administrator server creation wizard you select an authentication realm If you are using one of the following realms for authentication the realm server must be running before you start the wizard TIBCO Administrator realm Database realm LDAP realm Click Next after making your selections If you are installing on top of an existing ActiveMatrix 2 1 product installation three dialogs display asking whether to replace existing files Dismiss the dialogs for each file as follows ENV_HOME tools scripts addfeature xml Yes ENV_HOME tools scripts eclipseupgrader xml Yes AMX_ADMIN_HOME data bootstrap js No If you are installing on Windows 2008 at some point a Microsoft error dialog displays gt Microsoft Windows P TIBCO Java Launcher has stopped working Windows can check online for a solution to the problem Check online for a solution and close the program Close the program al Hide problem details Problem signature Problem Event Name APPCRASH Application Name flattener exe Application Version 1 12 0 5 Application Timestamp 4963b90a Fault Module Name ntdil dil Fault Module Version 6 0 6001 18000 Fault Module Timestamp 4791a7a6 Exception Code c0000005 TIBCO ActiveMatrix Service Bus Installation Insta
10. 3 on a machine on which you have installed and are running previous versions of TIBCO ActiveMatrix Service Bus However before installing TIBCO ActiveMatrix Service Bus 2 3 shut down the Management Daemon process ActiveMatrix Administrator servers and ActiveMatrix nodes running on the machine After the installation you may want to upgrade the existing Management Daemon ActiveMatrix Administrator server and nodes from the previous version to TIBCO ActiveMatrix 2 3 following the procedures described in the Migration section of the release notes for your product Install TIBCO ActiveMatrix Service Bus using one of the modes described in the sections e Installing in GUI Mode on page 14 e Installing in Console Mode on page 17 e Installing in Silent Mode on page 18 When installing in GUI mode with the Administrator component selected the installer provides the option of starting the database server and invoking the administrator server creation utility to create the first ActiveMatrix Administrator server and ActiveMatrix node The administrator server creation utility cannot be invoked during installation when console or silent mode is used run the utility after installation completes See Chapter 3 ActiveMatrix Administrator Server in TIBCO ActiveMatrix Administration for details about how to start the administrator server creation utility and for information about the fields Installing in GUI Mode To install TIBCO ActiveMatrix S
11. ActiveMatrix Registry is a UDDI registry for discovering and registering services during service development and deployment You can browse the registry from TIBCO Business Studio and import WSDL files for use in developing services TIBCO ActiveMatrix Administrator is integrated with TIBCO ActiveMatrix Registry TIBCO ActiveMatrix Runtime UDDI Server 1 1 0 Optional TIBCO ActiveMatrix Runtime UDDI Server is a lightweight UDDI registry for discovering and registering services during service execution TIBCO ActiveMatrix Service Bus Installation Software Requirements 9 Microsoft Software Required if you are developing NET C and Visual Basic component implementations e NET Framework 3 0 Required for running services in the NET container e Visual Studio 2005 or 2008 Required for developing services for the NET container TIBCO ActiveMatrix Service Bus Installation 10 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Installing Hibernate Disk Space Disk Space Before Installation Before installing Hibernate you must extract the contents of the installation archive to a temporary directory The installer files consume up to 60 MB of disk space Temporary Disk Space Required by the Installer See Temporary Disk Space Required by the Installer on page 5 Disk Space After Installation Hibernate consumes 170 MB of free space under ENV_HOME Install Modes Install Hibernate using one of the modes described
12. Initializing InstallShield Wizard Preparing Java tm Virtual Machine Set the DISPLAY variable to the IP address or name of the computer on which the installer graphics window is to be displayed followed by a screen address which can be 0 0 For example Bourne shell DISPLAY ip_address 0 0 export DISPLAY Korn shell export DISPLAY ip_address 0 0 C shell setenv DISPLAY ip_address 0 0 For example consider a scenario where you need to install TIBCO ActiveMatrix Service Bus on a remote Solaris machine named itaska Because you have a Solaris 5 6 machine named alaska that has a video card and monitor installed you can run an X window application on it So you decide to telnet to itaska from alaska When you telnet to itaska you will not get access to itaska s monitor and will be unable to display an X window application That is why you must set the DISPLAY variable which instructs the X server to redirect all windows to the computer set in the variable Before doing so the computer specified in the DISPLAY variable must give permissions to share its monitor alaska gt xhost give permission for all to its share monitor alaska gt telnet itaska Welcome to HPUX itaska 11 00 User Password itaska gt export DISPLAY alaska 0 0 set display on alaska itaska gt tar xvf TIB_tra suite_5 0 0_h7_11 tar TIBCO ActiveMatrix Service Bus Installation Frequently Asked Questions 35 What is uninst2 director
13. NET containers HSQLDB database TIBCO Management Daemon and TIBCO Policy Agent Documentation TIBCO ActiveMatrix Concepts TIBCO ActiveMatrix Composite Editor User s Guide TIBCO ActiveMatrix Administration TIBCO ActiveMatrix Service Bus Installation TIBCO ActiveMatrix Service Bus Getting Started TIBCO ActiveMatrix Service Bus Mediation Design Guide and TIBCO ActiveMatrix Service Grid Component Developer s Guide TIBCO ActiveMatrix Service Bus Installation Installation Overview 3 Supported Hostnames A The host on which you install TIBCO ActiveMatrix Service Bus cannot have an amp underscore _ in its name If the hostname has an underscore installation will i fail Supported Platforms The Design component is supported only on Windows 32 bit only and Linux platforms UNIX AIX 5 3 POWER 64 bit HP UX 11i v3 11 31 on IA 64 Itanium Solaris 9 on SPARC 32 and 64 bit Solaris 10 on SPARC 32 bit and 64 bit Solaris 10 x86 x86 64 bit Linux Red Hat Enterprise Linux 4 x AS ES GTK on x86 and x86 64 Red Hat Enterprise Linux 5 x AS ES GTK on x86 and x86 64 OpenSuse 10 x GTK on x86 x86 64 and zSeries Windows Windows XP Professional SP2 on x86 Windows Server 2003 on x86 and x86 64 Windows Server 2008 on x86 and x86 64 TIBCO ActiveMatrix Service Bus Installation 4 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Installer Account Microsoft Windows You must have administrator privileges for th
14. TIBCO ActiveMatrix Service Bus Installation Software Release 2 3 February 2010 D TIBCO The Power of Now Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY OR PROVIDE LIMITED ADD ON FUNCTIONALITY OF THE LICENSED TIBCO SOFTWARE THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT OR IF THERE IS NO SUCH SEPARATE AGREEMENT THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE AND WHICH IS DUPLICATED IN LICENSE PDF OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT THE LICENSE S LOCATED IN THE LICENSE FILE S OF THE SOFTWARE USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME This document contains confidential information that is subject to U S and international copyright laws and treaties No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc TIB TIBCO TIBCO Software TIBCO Adapter TIBCO ActiveMatrix TIBCO Adm
15. aemon Run the uninstaller a Navigate to ENV_HOME _uninstall and run universal_uninstall b The wizard provides uninstall options for all the installed ActiveMatrix products Deselect the checkboxes for products you do not want to uninstall and then click Uninstall When uninstalling popup windows appear warning that an updated file needs to be deleted Click Yes to All to remove the file and subsequent files in the assembly Because popup windows are generated for each installed assembly you may see multiple popup windows c The summary screen appears Click Finish to exit the uninstall wizard After uninstalling the software the uninstaller may prompt you to reboot your computer TIBCO ActiveMatrix Service Bus Installation Uninstalling the Software Clean up directories After running the uninstaller manually delete the following directories under ENV_HOME amx amxadministrator BusinessStudio log managementdaemon tools TIBCO ActiveMatrix Service Bus Installation 33 34 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Frequently Asked Questions Why and how should set the DISPLAY variable on Solaris for GUI mode The installer on Solaris opens an additional window generally for graphics It uses the DISPLAY environment variable to tell it on which computer to open the window If the environment variable is not set the installer will either wait or abort after displaying InstallShield Wizard
16. and deploy and manage ActiveMatrix services TIBCO ActiveMatrix Composite Editor User s Guide Read this manual to learn how to develop debug and package ActiveMatrix composites TIBCO ActiveMatrix Service Bus Getting Started Read this manual for a quick introduction to the product that walks you through a brief tutorial TIBCO ActiveMatrix Service Bus Mediation Design Guide Read this manual to learn how to develop mediation flows using the Mediation Editor TIBCO ActiveMatrix Service Bus Release Notes Read the release notes for a list of new and changed features This document also contains lists of known issues and closed issues for this release Third Party Documentation TIBCO ActiveMatrix software supports the following standards Service Component Architecture http www osoa org display Main Service Component Architecture Sp ecifications TIBCO ActiveMatrix Service Bus Installation Preface vii World Wide Web Consortium web services activity http www w3 0rg 2002 ws Simple Object Access Protocol SOAP 1 1 W3C Note http www w3 0rg TR 2000 NOTE SOAP 20000508 WSDL 1 1 W3C Note http www w3 0rg TR wsdl OASIS http www oasis open org committees tc_cat php cat ws UDDI Version 2 OASIS Standard http www oasis open org specs index php uddiv2 TIBCO ActiveMatrix Service Bus Installation viii Typographical Conventions Typographical Conventions The following typographical conventions
17. e machine on which TIBCO ActiveMatrix Service Bus is installed If you do not have administrator privileges the installer exits Log out of the system and log in as a user with the required privileges or request your system administrator to assign the privileges to your account If you intend to install the product on a network drive ensure that the account used for installation has permission to access the network drive On Microsoft Windows 2003 before you start the installation ensure that the files vpd properties and vpd properties tibco hostname are available in the USER_HOME Windows folder If not copy these files from C Windows to the USER_HOME Windows directory UNIX TIBCO ActiveMatrix Service Bus can be installed by any type of user regular non root user and super user root While installing the product on UNIX platforms ensure that the same installer account is used to install all TIBCO ActiveMatrix products If the whoami command is not available to the user running the installer the installer reports an error The error can be ignored A graphic environment such as CDE or XWindows is required to run the installer in GUI mode Installer Log File The installer log file tibco_universal_installer timestamp username_install log is written to the TIBCO folder of the user s home directory The installer log file captures the following information e Installation environment details such as user that i
18. equired only if the TIBCO Administrator authentication realm is used by TIBCO ActiveMatrix Administrator for authentication You can install TIBCO Runtime Agent and TIBCO Administrator any time before running the TIBCO ActiveMatrix Administrator server creation utility TIBCO Runtime Agent 5 6 bundles TIBCO Rendezvous 8 1 1 TIBCO Rendezvous 8 1 1 Required for TIBCO ActiveMatrix Adapter containers You can install TIBCO Rendezvous any time before running TIBCO ActiveMatrix Adapter containers TIBCO ActiveMatrix Service Bus Installation DBMS Software JDBC Drivers Software Requirements 7 Required The database stores TIBCO ActiveMatrix administration information You can install the database any time before running TIBCO ActiveMatrix Administrator server creation utility Different DBMS software is supported for prototyping and production For prototyping the following DBMS software is supported e HSQLDB 1 8 0 Installed by TIBCO ActiveMatrix Service Bus e Oracle Express For production the following DBMS software is supported e Oracle 9i Release 2 9 2 e Oracle 10g Release 1 10 1 with RAC e Oracle 10g Release 2 10 2 with RAC e Oracle 11g Enterprise Edition Release 11 1 0 6 0 with RAC e Microsoft SOL Server 2005 and 2008 e Sybase 15 0 2 JDBC drivers are used by TIBCO ActiveMatrix Administrator and nodes to access the TIBCO ActiveMatrix database and by services to access JDBC resources The following JDBC drivers a
19. ervice Bus in GUI mode 1 Open the physical media or download the TIBCO ActiveMatrix Service Bus package 2 Extract the TIBCO ActiveMatrix Service Bus archive file to a temporary directory Navigate to the temporary directory 4 Run TIBCOUniversalInstaller 5 The Welcome screen appears Click Next TIBCO ActiveMatrix Service Bus Installation Specify installation environment Select installation type 10 11 12 13 Installing TIBCO ActiveMatrix Service Bus 15 The License Agreement screen appears After reading through the license text click I accept the terms of the license agreement and then click Next The Important Notice screen appears Read through the information and click Next The Installation Environment screen appears In the Environment drop down list select the same installation environment you used when you installed Hibernate in Installing Hibernate on page 10 Click Next Select Typical to install all the available features or Custom to choose the features to install Click Next If you selected Typical proceed to step 11 If you selected Custom the Product Features screen appears listing the components available for installation By default all the components are selected Uncheck the checkboxes next to the components you don t want installed See Installation Types on page 2 for information about the components listed under each product Click Next The Pre Install summary screen
20. g Containers on page 26 Linux Installation Steps on IBM zSeriesPost Installation Procedures on page 27 Installing and Enabling SonicMQ 6 1 or 7 5 on page 27 Using SOAP JMS and JMS Bindings with WebLogic JMS on page 28 Using SOAP JMS and JMS Bindings with IBM WebSphere JMS on page 30 Migrating ActiveMatrix Components From 2 0 x 2 1 0 2 2 x To 2 3 See the Migration section of the release notes for the procedures for migrating ActiveMatrix 2 0 x 2 1 0 2 2 x components to ActiveMatrix 2 3 ActiveMatrix Administrator Server If you did not create the ActiveMatrix Administrator server during installation create the server following the instructions in Chapter 3 ActiveMatrix Administrator Server in TIBCO ActiveMatrix Administration Packaging and Installing Native Database Drivers To enable access to a database through native database drivers you package the drivers in a feature and install the feature on each machine that will run ActiveMatrix Administrator servers and ActiveMatrix nodes To package and install native database drivers 1 Run TIBCO Business Studio TIBCO ActiveMatrix Service Bus Installation Create fragment project Import and configure drivers Post Installation Procedures 21 Windows From the Start menu follow the path All Programs gt TIBCO gt ENV_NAME gt TIBCO Business Studio From the command line run ENV_HOME BusinessStudio TIBCOBusinessStudio exe UNIX Run ENV_HOME BusinessStudio TIBCOBusine
21. hat the WSDL file is a third party WSDL file Destination Queue name in ActiveMatrix Service Bus Reference The destination queue name in the ActiveMatrix Service Bus reference that is the one pointing to the WebLogic queue should be the local WebLogic JMS queue name and should use the following naming format JMS_SERVER_NAME JMS_MODULE_NAME DESTINATION_NAME For example examplesJMSServer examples jms helloWorldFaultQueue TIBCO ActiveMatrix Service Bus Installation 30 Chapter 1 Installing TIBCO ActiveMatrix Service Bus The destination queue name should include server name followed by a module name exclamation symbol and then the destination queue name The queue should have a sub deployment chosen during the creation of the queue and a JNDI name ActiveMatrix Service Bus inbound requests on WebLogic topics are not yet supported Use WebLogic topic to queue messaging bridge to accomplish this Refer to the WebLogic help for creating messaging bridge section gt Creating messaging bridge instances Using SOAP JMS and JMS Bindings with IBM WebSphere JMS Packaging and Installing WebSphere Client JARs Follow the steps in Packaging and Installing Native Database Drivers on page 20 1 In step 4 a replace com tibco tpcl jdbc drivers with com tibco neo resource adapter jms 2 Instep 5 import following WebSphere client JARs com ibm mq jar com ibm mq jmgi jar com ibm mq soap jar com
22. have the following options If the Sonic 6 x client works with 7 x server continue to use an installed Sonic 6 x feature Use the installed Sonic 6 x feature as is and put the 7 x client JARs in AMX_HOME components eclipse plugins com tibco jms sonicclient _6 1 0 001 Create a 7 x plug in and feature similar to 6 x feature to contain the 7 x client JARs following the procedure in Packaging and Installing Native Database Drivers on page 20 Add the following line to the plug in manifest Fragment Host com tibco neo resource adapter jms Install the feature Using SOAP JMS and JMS Bindings with WebLogic JMS Creating wlfullclient jar 1 From the WebLogic installation go to the directory WL_HOME server lib For example C bea weblogic_10 3 wlserver_10 3 server lib Create wlfullclient jar using the command java jar wljarbuilder jar Thewlfullclient jar will be created in the WL_HOME server 1ib directory Packaging and Installing wifullclient jar Follow the steps Packaging and Installing Native Database Drivers on page 20 and package wlfullclient jar as a feature In step 4 a replace com tibco tpcl jdbc drivers with com tibco neo resource adapter jms In step 5 import and configure drivers import the above created wlfullclient jar Just import the jar no need to unzip the jar Follow the steps in Configuring Existing ActiveMatrix Administrator Servers and ActiveMatrix Nodes on page 23 for installing wlf
23. ibm mqjms jar connectorjar dhbcore jar fscontext jar jtajar ldap jar providerutil jar 3 In step 6a after exporting packages import the following package with a version range 1 0 1 and 2 0 0 javax transaction Follow the steps in Configuring Existing ActiveMatrix Administrator Servers and ActiveMatrix Nodes on page 23 for installing the WebSphere client JAR for existing Administrator server and nodes Creating the JMSUserExit Plug in for SOAP JMS Interoperability of ActiveMatrix Service Grid TIBCO ActiveMatrix Service Bus Installation Post Installation Procedures 31 with IBM WebSphere JMS Follow the steps in Appendix A SOAP JMS Interoperability in TIBCO ActiveMatrix Composite Editor User s Guide A sample extension for WebLogic is available at AMX_HOME 2 3 samples amx SOAP Interop To interoperate with WebSphere modify the implementation of SoapJmsExtension onRequest method as follows public void onRequest Port port String operationName Map lt String String gt messageProperties messageProperties put targetService lt name of the service gt Configuring WebSphere MQ JMS Variables in JMS and JNDI Shared Resources INDI lookup is supported only for connection factories and not for the destinations JNDI Shared Resource Configuration e File based lookup JNDI Context Factory com sun jndi fscontext RefFSContextFactory JNDI Context URL file C IBM_Bindings path f
24. iles and if the required disk space is thereby reduced the installer may fail and will then give a failure message While performing installation avoid running other processes that consume disk space in product home location Disk Space After Installation TIBCO ActiveMatrix Service Bus can consume 630 MB of free space under ENV_HOME TIBCO ActiveMatrix Service Bus Installation 6 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Software Requirements Hibernate 3 2 5 This section lists required and optional software products Required The Hibernate product must be installed before installing TIBCO ActiveMatrix Service Bus See Installing Hibernate on page 10 for details Product Compatibility TIBCO ActiveMatrix Service Bus 2 3 is not compatible with TIBCO Business Studio 3 0 TIBCO Software The following TIBCO software products need not be installed on the machine on which TIBCO ActiveMatrix Service Bus is installed TIBCO Enterprise Message Service 4 3 0 4 4 x or 5 1 x Required TIBCO Enterprise Message Service is the messaging backbone for TIBCO ActiveMatrix Service Bus You can install TIBCO Enterprise Message Service any time before running a TIBCO ActiveMatrix node Enterprise Message Service is also used by the SOAP and JMS containers These two containers support only Enterprise Message Service for JMS transport TIBCO Runtime Agent 5 4 or higher and TIBCO Administrator 5 4 or higher Optional R
25. in to the LD_LIBRARY_PATH variable in your user profile script 2 Change to the ENV_HOME managementdaemon 2 0 bin directory and run managementscript 3 Change to the ENV_HOME managementdaemon 2 0 daemonlets com tibco matrix dae monlet directory and run amxdaemonletscript Installing and Enabling SonicMQ 6 1 or 7 5 If you plan to use SonicMQ 6 1 as a JMS provider for the JMS binding type follow these instructions to install and enable it 1 Copy these JAR files from the SonicMQ 6 1 installation to AMX_HOME components eclipse plugins com tibco jms sonicclient _6 1 0 001 mfcontext jar sonic_ASPI jar sonic_Client jar sonic_SF jar sonic_Selector jar sonic_XMessage jar sonic_Channel jar sonic_Crypto jar sonic_SSL jar sonic_XA jar sonic_mgmt_client jar 2 Change directory to AMX_HOME tools bin 3 Install the Sonic feature TIBCO ActiveMatrix Service Bus Installation 28 Chapter 1 Installing TIBCO ActiveMatrix Service Bus tibcommander Dfeature name com tibco jms sonicclient feature file scripts addfeature xml D To install the Sonic feature in a node that existed before you copied the Sonic JARs D 1 2 from the Sonic installation and enabled the Sonic feature in step 3 Change to the AMX_HOME tools bin directory Run tibcommander f AMX_HOME amx 2 3 server bin nodeupgrader xml Dnodes env name node name If you want to use a Sonic 7 5 server you
26. in the sections e Installing in GUI Mode on page 10 e Installing in Console Mode on page 12 e Installing in Silent Mode on page 13 Installing in GUI Mode To install Hibernate in GUI mode 1 Open the physical media or download the Hibernate package 2 Extract the Hibernate archive file to a temporary directory 3 Navigate to the temporary directory 4 Run TIBCOUniversalInstaller 5 The Welcome screen appears Click Next TIBCO ActiveMatrix Service Bus Installation Installing Hibernate 11 6 The License Agreement screen appears After reading through the license text click I accept the terms of the license agreement and then click Next The Installation Environment screen appears installation Environment ATI B g 0 Please choose a TIBCO installation environment to use for this session from the list below The Power of Now Environment E reate a new installation environment isolated home for one or more TIBCO products example user acceptance or procurement department Description Path sspecify new path Specify An installation environment isolates product installations a product installed installation into an installation environment does not access components in other environment installation environments An installation environment consists of a name description and path You can choose a new environment or an existing environment TIBCO Act
27. ine shows less than 2048 add the following line to the file etc security limits conf hard nofile 2048 5 Log out and log back in again 6 Install the ActiveMatrix product in console mode using the installation procedures in the Installation manual Since the installer does not bundle the JRE required for the installer to start up start the installer as follows TIBCOUniversalInstaller lnx s390x is javahome lt IBM JRE JDK HOME gt console Installing in Silent Mode In silent mode the universal installer does not prompt for any inputs during installation Instead the inputs are read from a response file that can be provided as a command line parameter If no value is specified the installer uses the default TIBCOUniversalInstaller silent file The TIBCOUniversalInstaller silent file is packaged in the directory that contains the universal installer Edit the file with information for your environment before launching the silent installation The file includes comments that describe the installation properties you can set While you can use the TIBCOUniversalInstaller silent file it s good practice to copy the file to a different name and use that file for the silent install TIBCO ActiveMatrix Service Bus Installation Installing TIBCO ActiveMatrix Service Bus 19 The following procedure explains how to install a TIBCO ActiveMatrix Service Bus in silent mode If errors occur during installation they will be listed i
28. inistrator TIBCO Enterprise Message Service Predictive Business Information Bus The Power of Now and TIBCO Rendezvous are either registered trademarks or trademarks of TIBCO Software Inc in the United States and or other countries EJB J2EE and all Java based trademarks and logos are trademarks or registered trademarks of Sun Microsystems Inc in the U S and other countries All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS HOWEVER NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME PLEASE SEE THE README TXT FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM THIS DOCUMENT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS HANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT TIBCO SOFTWARE INC MAY MAKE IMPROVEMENTS AND OR CHANGES IN THE PRODUCT S AND OR THE PROGRAM S DESCRIBED IN THIS DOCUMENT AT ANY TIME THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND OR QUALIFIED
29. ion 22 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Create feature Create deployable archive 8 10 11 12 13 14 In the MANIFEST MF file editor a Click the Runtime tab In the Classpath area add the drivers In the Exported Packages area export the packages Click the Save button H to save the fragment project Create a feature project Select File gt New Project gt Plug in Development gt Feature Project For information on how to configure a Fragment project see Help gt Help Contents gt Plug in Development Environment Guide gt Tools gt Feature Project In the Project name field type an appropriate name for the project In the Referenced Plug ins and Fragments screen select the fragment you created in step 4 Click Finish The feature xml file is opened in a feature editor In the Overview tab note the Feature ID in the General Information area This ID is used when you install the feature in step 15 Click the Plug ins tab Ensure that the fragment is selected in the Plug ins and Fragments list a Click the Versions button In the Synchronization Options area click the Copy versions from plug in and fragment manifests radio button and click Finish b Inthe Plug in Details area check the Unpack the plug in archive after the installation checkbox Click the Save button H to save the feature project In the Package Explorer right click the feature and se
30. iveMatrix Service Bus Installation 12 Chapter 1 Installing TIBCO ActiveMatrix Service Bus A Choose installation type 7 New Environment To install the product into a new installation environment specify the following properties Name Identifies the installation environment The name cannot contain special characters such as 2 gt lt 1 Z or quotes The name is appended to the name of Windows services created by the installer and is a component of the path to the product in the Windows Start gt All Programs menu Description Optional information about the products the environment contains or is used for Path The directory into which the product is installed Type a path or click Browse to specify the path or accept the default location The path cannot contain special characters such as gt lt amp or The path cannot be the same as the path of an existing environment Existing Environment To install the product into an existing installation environment select the environment from the Environment drop down list The Name Description and Path fields are populated automatically and cannot be edited When installing multiple products into an existing environment ensure that the products are compatible If they are not compatible the product installations may be corrupted See Product Compatibility on page 6 Click Next The I
31. l Hibernate 3 2 5 in console mode using the installation procedures in the Installation manual Since the installer does not bundle the JRE required for the installer to start up start the installer as follows TIBCOUniversalInstaller lnx s390x is javahome lt IBM JRE JDK HOME gt console Typically the IBM JRE JDK HOME would be a location such as opt ibm java2 s390x 50 TIBCO ActiveMatrix Service Bus Installation 18 Chapter 1 Installing TIBCO ActiveMatrix Service Bus 3 The installer requires a large number of files open concurrently so increase the file handle limit for the user performing the installation For example set ulimit n 2048 If a nonroot user is installing the product you must ensure that the maximum number of open files hard limit is set to at least 2048 This can be checked from bash with the following command ulimit aH Look for the open files line to see what the hard limit is set to For example ulimit aH core file size data seg size blocks c unlimited kbytes d unlimited file size blocks f unlimited pending signals C i 16384 max locked memory kbytes 1 32 max memory size kbytes m unlimited open files n 2048 pipe size 512 bytes p 8 POSIX message queues bytes q 819200 stack size kbytes s unlimited cpu time seconds t unlimited max user processes u 16384 virtual memory kbytes v unlimited file locks x unlimited 4 Ifthe open files l
32. lect Export Select Plug in Development gt Deployable features b Click Next c Inthe Available Features area ensure that the checkbox next to the feature is checked d In the Destination tab click the Archive file radio button Click Browse and browse to a directory e Enter a file name and click Save f Click Finish TIBCO ActiveMatrix Service Bus Installation Post Installation Procedures 23 Install feature 15 On all machines running ActiveMatrix Administrator servers and ActiveMatrix nodes a Extract the contents of the zip file you created in step 14 into the directory ENV_HOME components eclipse b Open a command window Change to the ENV_HOME tools bin directory d Run the command tibcommander Dfeature name featureID f ENV_HOME tools scripts addfeature xml where featureID is the Feature ID displayed in step 11 Configuring Existing ActiveMatrix Administrator Servers and ActiveMatrix Nodes To use the database as a JDBC shared resource on your existing ActiveMatrix Administrator and runtime nodes 1 Install the native drivers 2 For ActiveMatrix Administrator servers follow these steps on all machines running the ActiveMatrix Administrator servers Open a command window b Change to the ENV_HOME too1s bin directory c Run the command flattener file AMX_ADMIN_HOME data clusternanme servername bin clusternanme_ser vername tra 3 For ActiveMatrix runtime nodes follow the
33. ll the Visual Studio extensions 1 Navigate to AMX_HOME 2 3 containers NET bin designtime 2 Run TIBCOActiveMatrixVSExtensionsSetup msi 3 The TIBCO ActiveMatrix Setup wizard appears Complete the screens in the wizard to add the extensions to Visual Studio Windows TIBCO Enterprise Message Service C Client Before running NET containers on TIBCO ActiveMatrix Service Grid nodes install a VC 8 compiled CH client DLL TIBCO EMS d11 distributed with TIBCO Enterprise Message Service version 4 4 3 or higher into the Windows Global Assembly Cache GAC VC 8 compiled binaries are identified by a terminal ves component in the name of the distribution package For example TIB_ems_5 1 0_win_x86_vc8 zip The way in which you install the C client DLL depends on the version of Enterprise Message Service you are using Enterprise Message Service 4 4 3 1 Perform a Custom installation and select C Client from the list of features that can be installed Performing a Typical installation will also install the C client 2 Install the C client in the GAC using one of the following methods Drag and drop do not copy the TIBCO EMS d11 file from the EMSInstallDir clients cs folder to the C WINDOWS assembly folder TIBCO ActiveMatrix Service Bus Installation 25 26 Chapter 1 Installing TIBCO ActiveMatrix Service Bus The assembly folder is a special folder where the INET Framework stores assemblies for the GAC
34. lling TIBCO ActiveMatrix Service Bus 17 This is a spurious error the flattener command completes successfully Click the Close the program button to dismiss the dialog 16 The Post Install Summary screen appears This screen summarizes the installation process Click Finish to complete the installation process and close the installer window Installing in Console Mode To install the software in console mode 1 nT a O Open the physical media or download the TIBCO ActiveMatrix Service Bus package Extract the TIBCO ActiveMatrix Service Bus archive file to a temporary directory Using a console window navigate to the temporary directory Run TIBCOUniversalInstaller console Complete the installation by responding to the console window prompts After the installation completes create the ActiveMatrix Administrator server following the instructions in Chapter 3 ActiveMatrix Administrator Server in TIBCO ActiveMatrix Administration Linux Installation Steps on IBM zSeries To install on Linux running on IBM zSeries 1 Install IBM Java 5 on your system IBM Java distributions are available here http www ibm com developerworks java jdk linux download html Download the 64 bit zSeries S 390 distribution https www14 software ibm com webapp iwm web preLogin do source sdk5 amp S_PKG zseries645sr8 amp S_TACT 105AGX05 amp S_CMP JDK We recommend you download and install the rpm version of the JRE or JDK Instal
35. n the installation log file contained in User_Home TIBCO directory 1 Open the physical media or download the TIBCO ActiveMatrix Service Bus package Extract the contents of the package to a temporary directory Using a console window navigate to the temporary directory Make a copy of the TIBCOUniversalInstaller silent file and rename the file Using a text editor open the copied file and update the install location and features to install Run the following Windows TIBCOUniversalInstaller cmd silent V responseFile myfilename silent UNIX TIBCOUniversalInstaller silent V responseFile myfilename silent When installation completes a line similar to the following is written to the installer log file Install com tibco installer util TIBCOInstaller dbg Debug The installation has completed Please check the log file for additional information TIBCO ActiveMatrix Service Bus Installation 20 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Post Installation Procedures This section describes post installation procedures Migrating ActiveMatrix Components From 2 0 x 2 1 0 2 2 x To 2 3 on page 20 ActiveMatrix Administrator Server on page 20 Packaging and Installing Native Database Drivers on page 20 Oracle OCI Driver Support on page 24 Management Daemon on page 25 Windows NET Extensions on page 25 Windows TIBCO Enterprise Message Service C Client on page 25 UNIX Adapter Bindin
36. nstallation Type screen appears Choose the Typical installation type Click Next The Pre Install Summary screen appears listing your choices Verify the list of products selected for install and then click Install Click Yes to All to close any popup windows that display during installation The Post Install Summary screen appears This screen summarizes the installation process Click Finish to complete the installation process and close the installer window Installing in Console Mode To install Hibernate in console mode 1 2 Open the physical media or download the Hibernate package Extract the Hibernate archive file to a temporary directory TIBCO ActiveMatrix Service Bus Installation Installing Hibernate 13 3 Using a console window navigate to the temporary directory that contains the universal installer 4 Run TIBCOUniversalInstaller console 5 Complete the installation by responding to the console window prompts Installing in Silent Mode In silent mode the universal installer does not prompt for any inputs during installation Instead the inputs are read from a response file that can be provided as a command line parameter If no value is specified the installer uses the default TIBCOUniversalInstaller silent file The TIBCOUniversalInstaller silent file is packaged in the directory that contains the universal installer Edit the file with information for your environment before launching the silen
37. nstalling TIBCO ActiveMatrix Service Bus page 14 e Post Installation Procedures page 20 e Uninstalling the Software page 32 e Frequently Asked Questions page 34 TIBCO ActiveMatrix Service Bus Installation 2 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Installation Overview This manual explains how to install TIBCO ActiveMatrix Service Bus Installation Modes Three installation modes are available GUI console and silent In GUI mode only you can create the first ActiveMatrix Administrator server and ActiveMatrix node as part of the installation process Installation Types Two installation types are available typical or custom The typical installation type installs all component in the package on the specified platform the custom installation type allows you to select components The following component selections are available Administrator Includes TIBCO ActiveMatrix Administrator HSQLDB database and TIBCO Management Daemon When the Administrator component is selected the installer provides the option of invoking the administrator server creation wizard to create the first ActiveMatrix Administrator server and ActiveMatrix node Design Includes TIBCO Business Studio Composite Editor and Mediation Flow Editor and binding and implementation type editors If you select this component the Runtime component is also installed Runtime SOAP JMS TIBCO Adapter Mediation containers and the Java and
38. nvoked the installer hostname Java home in the environment operating system details and so on e List of assemblies installed TIBCO ActiveMatrix Service Bus Installation Installation Overview 5 System Memory Disk Space A minimum of 2 GB of physical memory is required Disk Space Before Installation Before installing TIBCO ActiveMatrix Service Bus extract the contents of the installation archive to a temporary directory The installer files consume up to 560 MB of disk space Temporary Disk Space Required by the Installer The installer requires at least 70 MB of free space in the temporary directory On Microsoft Windows the temporary directory location is SystemDrive Documents and Settings user_name Local Settings Temp If your system does not have sufficient free disk space in the default temporary directory you can run the installer with a different temporary directory by using the following option when starting the installer For example TIBCOUniversalInstaller is tempdir new_tmp where new_tmp has sufficient free disk space The installer calculates the disk space required in product home location for the selected components The calculation is done before the actual installation copying of files to system begins The installer will proceed only if sufficient free disk space is available in product home location However if disk space is consumed by another process while the installer is copying the f
39. on as AMX_HOME The value of AMX_HOME depends on the operating system For example on Windows systems the default value is C tibco amx TIBCO ActiveMatrix Administrator installs into a directory inside ENV_HOME This directory is referenced in documentation as AMX_ADMIN_HOME The value of AMX_ADMIN_HOME depends on the operating system For example on Windows systems the default value is C tibco amxadministrator code font Code font identifies commands code examples filenames pathnames and output displayed in a command window For example Use MyCommand to start the foo process TIBCO ActiveMatrix Service Bus Installation Preface ix Table 1 General Typographical Conventions Cont d Convention Use bold code font Bold code font is used in the following ways In procedures to indicate what a user types For example Type admin In large code samples to indicate the parts of the sample that are of particular interest In command syntax to indicate the default parameter for a command For example if no parameter is specified MyCommand is enabled MyCommand enable disable italic font Italic font is used in the following ways To indicate a document title For example See TIBCO ActiveMatrix BusinessWorks Concepts To introduce new terms For example A portal page may contain several portlets Portlets are mini applications that run in a portal To indicate a variable in a command or code syntax tha
40. or the Bindings Directory LDAP based lookup JNDI Context Factory com sun jndi fscontext RefFSContextFactory JNDI Context URL ldap host port distinguished name JNDI Username and Password as per your installation JMS Shared Resource Configuration e File based lookup ConnectionFactory QueueConnectionFactory as per your installation e LDAP based lookup ConnectionFactory cn QueueConnectionFactory as per your installation JMS Username and Password as per your installation TIBCO ActiveMatrix Service Bus Installation 32 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Uninstalling the Software To uninstall the software 1 Moy GT oe In ActiveMatrix Administrator remap service units and then relocate service assemblies a Remap all service units mapped to nodes running on the machine to nodes running on different machines b Relocate the service assemblies that contain the remapped service units Stop and delete each node running on the machine Stop and delete each ActiveMatrix Administrator server running on the machine Stop the server b Delete the server from the cluster in ActiveMatrix Administrator c On Windows delete the ActiveMatrix Administrator Windows service by following the procedure in Deleting the ActiveMatrix Administrator Windows Service in TIBCO ActiveMatrix Administration Stop TIBCO Business Studio Stop the HSQLDB server Stop TIBCO Management D
41. re supported and included with TIBCO ActiveMatrix Service Bus HSQLDB org hsqldb jdbcDriver e Microsoft SQL tibcosoftwareinc jdbc sqlserver SQLServerDriver e Oracle tibcosoftwareinc jdbc oracleOracleDriver TIBCO ActiveMatrix also supports Microsoft SOL Oracle and Sybase native JDBC drivers However to use SQL Oracle and Sybase JDBC drivers which you manually package using TIBCO Business Studio and install In order to package native drivers install a Design component on the machine on which you plan to package the drivers For instructions on how to package and install native drivers see Packaging and Installing Native Database Drivers on page 20 TIBCO ActiveMatrix Service Bus Installation 8 Chapter 1 Installing TIBCO ActiveMatrix Service Bus LDAP Servers Web Browsers Optional Required only if the LDAP authentication realm is used by TIBCO ActiveMatrix Administrator for authentication The following LDAP servers are supported e OpenLDAP 2 3 e Microsoft ActiveDirectory 2003 e Sun ONE Directory Server 6 3 Required to run the TIBCO ActiveMatrix Administrator GUI The following web browsers are supported e Microsoft Internet Explorer 7 0 e Microsoft Internet Explorer 6 0 SP2 e Mozilla Firefox 2 0 e Mozilla Firefox 1 5 Adobe Flash 8 and Higher Required to view the Monitor amp Manage perspective in TIBCO ActiveMatrix Administrator GUI UDDI Registries TIBCO ActiveMatrix Registry 2 0 Optional TIBCO
42. se steps on all machines running ActiveMatrix nodes Open a command window b Change to the ENV_HOME too1s bin directory c Run the command tibcommander f AMX_HOME 2 3 server bin nodeupgrader xml Dnodes environment1 nodel environmentN nodeN 1 nodeupgrader log where environment1 nodel environmentN nodeN refer to your environment names and node names in those environments TIBCO ActiveMatrix Service Bus Installation 24 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Oracle OCI Driver Support The Oracle OCI driver is supported OCI driver support is available only in silent mode which means that you can create a cluster with the OCI driver only with the silent option of the createadminserver utility To create a cluster with the Oracle OCI driver 1 i y Follow the instructions in Packaging and Installing Native Database Drivers on page 20 to package and install the driver as a feature and plug in Edit tra files to update environment variables These are the tra files you need to update AMX_ADMIN_HOME 2 3 bin createadminserver tra AMX_ADMIN_HOME 2 3 bin deleteadminserver tra AMX_ADMIN_HOME 2 3 bin dbscriptgenerator tra AMX_ADMIN_HOME 2 3 bin startadminserver template tra TIBCO_HOME managementdaemon 2 0 bin managementdaemon tra For each tra file liste append the ORA_HOME bin ORA_HOME 1ib for UNIX that contains the native libraries for the driver to these en
43. ssStudio sh Create a fragment project Select File gt New Project gt Plug in Development gt Fragment Project For information on how to configure a Fragment project see Help gt Help Contents gt Plug in Development Environment Guide gt Tools gt Fragment Project In the Fragment Project screen a In the Project name field type an appropriate name for the project b Retain all other default settings and click Next In the Host Plug in area of the Fragment Content screen click the Browse button next to the Plug in ID field a Select the com tibco tpcl jdbc drivers 1 0 0 009 plug in and click OK b In the Maximum Version field enter 2 0 0 Click Finish Click Yes when TIBCO Business Studio asks to open the Plug in Development perspective The perspective switches and the MANIFEST MP file is opened in a manifest editor e Click the MANIFEST MF tab The following entry should appear in the file a 0 Fragment Host com tibco tpcl jdbc drivers bundle version 1 0 0 2 0 0 Import the JARs containing the native drivers into the project These JARs are not shipped with TIBCO ActiveMatrix Service Bus Database Path JARs Oracle 11 ORACLE_HOME jdbc lib ojdbc5 jar Oracle 10 ORACLE_HOME jdbc lib classes12 jaror ojdbc14 jar Microsoft SOL See the Microsoft SOL Server documentation Server Sybase SYBASE_HOME jConnect 6_0 cl jconn3 jar asses jTDS3 jar TIBCO ActiveMatrix Service Bus Installat
44. t installation The file includes comments that describe the installation properties you can set While you can use the TIBCOUniversalInstaller silent file it s good practice to copy the file to a different name and use that file for the silent install The following procedure explains how to install the product in silent mode If errors occur during installation they will be listed in the installation log file contained in User_Home TIBCO directory 1 Open the physical media or download the Hibernate package 2 Extract the Hibernate archive file to a temporary directory 3 Using a console window navigate to the temporary directory 4 Copy the TIBCOUniversalInstaller silent file and name the file 5 Using a text editor open the copied file and update the install location and features to install 6 Run the following Windows TIBCOUniversalInstaller cmd silent V responseFile myfilename silent UNIX TIBCOUniversalInstaller silent V responseFile muyfilename silent When installation completes a line similar to the following is written to the installer log file Install com tibco installer util TIBCOInstaller dbg Debug The installation has completed Please check the log file for additional information TIBCO ActiveMatrix Service Bus Installation 14 Chapter 1 Installing TIBCO ActiveMatrix Service Bus Installing TIBCO ActiveMatrix Service Bus A You can install TIBCO ActiveMatrix Service Bus 2
45. t you must replace For example MyCommand pathname Key combinations Key name separated by a plus sign indicate keys pressed simultaneously For example Ctrl C Key names separated by a comma and space indicate keys pressed one after the other For example Esc Ctrl Q The note icon indicates information that is of special interest or importance for example an additional action required only in certain circumstances The tip icon indicates an idea that could be useful for example a way to apply the information provided in the current section to achieve a specific result The warning icon indicates the potential for a damaging situation for A example data loss or corruption if certain steps are taken or not taken TIBCO ActiveMatrix Service Bus Installation x Typographical Conventions Table 2 Syntax Typographical Conventions Convention Use An optional item in a command or code syntax For example MyCommand optional_parameter required_parameter A logical OR that separates multiple items of which only one may be chosen For example you can select only one of the following parameters MyCommand paral param2 param3 A logical group of items in a command Other syntax notations may appear within each logical group For example the following command requires two parameters which can be either the pair param1 and param2 or the pair param3 and param4 MyCommand paraml param2
46. ullclient jar for existing Administrator server and nodes TIBCO ActiveMatrix Service Bus Installation Post Installation Procedures 29 Creating the JMSUserExit Plug in for SOAP JMS Interoperability of ActiveMatrix Service Grid with WebLogic Follow the steps in Appendix A SOAP JMS Interoperability in TIBCO ActiveMatrix Composite Editor User s Guide Configuring WebLogic JMS Variables in JMS and JNDI Shared Resources JNDI lookup is supported only for Connection Factories and not for the destinations e JNDI shared resource configuration JNDI Context Factory weblogic jndi WLInitialContextFactory JNDI Context URL t3 lt weblogichost gt 7001 i e t3 WEBLOGIC_HOST WEBLOGIC_PORT JNDI Username weblogic JNDI Password weblogic By default the JNDI Username password is weblogic e JMS shared resource configuration JMS Username JMS Password By default JMS Username password is empty Connection Factory weblogic examples jms QueueConnectionFactory weblogic examples jms QueueConnectionFactory is an existing QueueConnectionFactory obtained from the WebLogic UI wl_server gt Services gt Messaging gt JMS Modules gt examples jms You can follow this and create a different QueueConnectionFactory and use it Creating an ActiveMatrix Service Bus Client for the WebLogic Service Get a WSDL file from the WebLogic service and use it to create a SOAP JMS reference ActiveMatrix Service Bus will detect t
47. vironment variables Windows tibco env PATH Linux and Solaris tibco env LD_LIBRARY_PATH HPUX tibco env SHLIB_PATH AIX tibco env LIBPATH Refer to Oracle s documentation for the exact path to the native libraries that are required by the OCI driver 3 Enable the property cluster application db dialect in the file AMX_ADMIN_HOME 2 3 bin createadminserver properties in the Application database properties section Enable this property in the Realm database section as well for a database realm based cluster If you want to pre create a schema locate the Oracle properties and set the value of the property hibernate dialect to com tibco matrix persistence core TibcoOracleDialect TIBCO ActiveMatrix Service Bus Installation Post Installation Procedures Management Daemon On Windows the Management Daemon process is optionally installed as a Windows service named TIBCO Management Daemon 2 0 Its startup type is Automatic which means that Management Daemon starts when Windows starts If you do not want Management Daemon process to start automatically change the startup type to Manual Windows NET Extensions If you have installed TIBCO ActiveMatrix Service Bus and are developing NET component implementations install the Visual Studio extensions that are included in the installation package Visual Studio must be installed before running the TIBCO ActiveMatrix Setup wizard which is used to install the extensions To insta
48. y If the original uninstall directory is in use at uninstall time it cannot be removed by the installer program The installer then creates a second uninstall directory for the second installation To remove the second installation run the uninstall program from the second uninstall directory The original uninstall directory can also be manually removed if empty TIBCO ActiveMatrix Service Bus Installation 36 Chapter 1 Installing TIBCO ActiveMatrix Service Bus TIBCO ActiveMatrix Service Bus Installation Index Symbols NET extensions 25 NET Framework 9 Cc custom installation 2 customer support xi D disk space 5 5 DISPLAY variable 34 F Frequently Asked Questions 34 H HSQLDB 1 8 0 7 install TIBCO ActiveMatrix 14 installer account 4 installer log file 4 Index 37 J JDBC drivers 7 L log file 4 Microsoft ActiveDirectory 2003 8 Microsoft Internet Explorer 8 Microsoft SQL Server 2005 7 Mozilla Firefox 8 O OpenLDAP 2 3 8 Oracle 10g 7 Oracle 9i 7 Oracle Express 7 R required and optional software 6 S support contacting xi TIBCO ActiveMatrix Service Bus Installation 38 Index supported platforms 3 system memory 4 I technical support xi temporary disk space 5 TIBCO Administrator 6 TIBCO Enterprise Message Service 6 TIBCO Rendezvous 6 typical installation 2 U UDDI registry 8 uninst2 directory 35 uninstalling the software 32 V Visual Studio 25

TIBCO ActiveMatrix Service Bus Installation

Contents

Download Pdf Manuals

Related Search

Related Contents