Installation and User Guide - IBM

1 IBM Tivoli Composite Application Manager for WebSphereApplication Server support for WebSphere ApplicationServer and user GuideGC23-9701-01 IBM Tivoli Composite Application Manager for WebSphereApplication Server support for WebSphere ApplicationServer and user GuideGC23-9701-01 NoteBefore using this information and the product it supports, IBM Tivoli Composite Application Manager for WebSphereApplication Server, read the information in Notices on page edition applies to Version of IBM Tivoli Composite Application Manager for WebSphere Application Serverand to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2008, Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM this guideThis Guide provides instructions for installing, configuring, using, andtroubleshooting IBM Tivoli Composite Application Manager for WebSphere Application Server (ITCAM for WebSphere Application Server).

2 Intended audienceThis publication is for administrators or users who want to install and use ITCAMfor WebSphere Application Server. The publication assumes that readers arefamiliar with maintaining operating systems, administering IBM WebSphereApplication Server, maintaining databases, and general information technology (IT)procedures. Specifically, readers of this publication must have some knowledge ofthe following topics:vOperating systems on which you intend to install product componentsvIBM WebSphere Application ServervInternet protocols such as HTTP, HTTPS, TCP/IP, Secure Sockets Layer (SSL),and Transport Layer Security (TLS)vDigital certificates for secure communicationITCAM for WebSphere Application Server publicationsThe following is a list of the publications in the ITCAM for WebSphere ApplicationServer library:vIBM Tivoli Composite Application Manager for WebSphere Application Server: Installation and user GuideProvides instructions for installing, configuring, using, and troubleshootingITCAM for WebSphere Application publicationsThe following documentation also provide useful information.

3 VIBM WebSphere Application Server Information Tivoli Composite Application Manager for Application DiagnosticsInformation Support terminology onlineThe IBM Terminology website consolidates the terminology from IBM productlibraries in one convenient location. You can access the Terminology website Copyright IBM Corp. 2008, 2012iiiAccessing publications onlineIBM posts publications for this and all other Tivoli products, as they becomeavailable and whenever they are updated, to the Tivoli Information Center websiteat ITCAM for WebSphere Application Server Installation and user Guide isavailable here: :If you print PDF documents on other than letter-sized paper, set the optionin theFile Printwindow that allows Adobe Reader to print letter-sized pages onyour local publicationsAbout this taskThere are several ways to order IBM publications:vYou can order many IBM publications online at the following website: can order by telephone by calling one of these numbers: In the United States: 800-879-2755 In Canada: 800-426-4968vIn other countries, contact your software account representative to order IBMpublications.

4 To locate the telephone number of your local representative,perform the following to the following website: your country from the list and this sitein the main window to see an information page thatincludes the telephone number of your local features help users with a physical disability, such as restrictedmobility or limited vision, to use software products successfully. With this product,you can use assistive technologies to hear and navigate the interface. You can alsouse the keyboard instead of the mouse to operate all features of the graphical additional information, see Appendix F, Accessibility, on page technical trainingFor Tivoli technical training information, refer to the following IBM TivoliEducation website: informationIf you have a problem with your IBM software, IBM provides the following waysfor you to obtain the support you need:vGo to the IBM Software Support website: for WebSphere Application Server: Installation and user GuidevIBM Support Assistant:IBM Support Assistant (ISA) is a free local software serviceability workbenchthat helps you resolve questions and problems with IBM software products.

5 ISAprovides quick access to support-related information and serviceability tools forproblem conventionsThis publication uses the following typeface conventions:BoldvLowercase commands and mixed case commands that are otherwisedifficult to distinguish from surrounding textvInterface controls (check boxes, push buttons, radio buttons, spinbuttons, fields, folders, icons, list boxes, items inside list boxes,multicolumn lists, containers, menu choices, menu names, tabs, propertysheets), labels (such asTip:andOperating system considerations)vKeywords and parameters in textItalicvCitations (titles of publications, diskettes, and CDs)vWords defined in text (such as "a nonswitched line is called apoint-to-point line.")vEmphasis of words and letters: words as words (such as "Use the wordthatto introduce a restrictive clause.)

6 " letters as letters (such as "The LUNaddress must start with the letterL.")vNew terms in text, except in a definition list, (such as "aviewis a framein a workspace that contains data.")vVariables and values you must provide (such as " ")MonospacevExamples and code examplesvFile names, programming keywords, and other elements that are difficultto distinguish from surrounding textvMessage text and prompts addressed to the uservText that the user must typevValues for arguments or command optionsTivoli command syntaxThe following special characters define Tivoli command syntax:[]Identifies elements that are optional. Required elements do not havebrackets around that you can specify multiple values for the previous multiple values by a space, unless otherwise directed bycommand the ellipsis for an element follows a closing bracket, use the syntaxwithin the brackets to specify multiple values.

7 For example, to specify twoadministrators for the option [ aadmin].., use a admin1 a this guidevIf the ellipsis for an element is within the brackets, use the syntax of thelast element to specify multiple values. For example, to specify two hostsfor the option [ ], use h host1 host2.|Indicates mutually exclusive information. You can use the element oneither the left or right of the vertical bar.{}Delimits a set of mutually exclusive elements when a command requiresone of them. Brackets ([ ]) are around elements that are addition to the special characters, Tivoli command syntax uses the typefaceconventions described in Typeface conventions on page v. The followingexamples illustrate the typeface conventions used in Tivoli command syntax:vwcrtpr[ aadmin].. [ sregion][ mresource]..nameThenameargument is the only required element for thewcrtprcommand.

8 Thebrackets around the options indicate they are optional. The ellipses after the aadmin resourceoption means that you can specify multiple administratorsmultiple times. The ellipses after the mresourceoption means that you canspecify multiple resources multiple [ ooutfile][ u][ x]{ finfile| i| }The f, i, andobjectelements are mutually exclusive. Braces that surroundelements indicate that you are including a required element. If you specify theobjectargument, you can specify more than one for directoriesThis Guide refers to the following variables:vDC_home: the directory where the ITCAM Data Collector for WebSphere isinstalled. The following are the default locations:Table 1. Default locations for DC_homeUNIXorLinux/opt/ibm/itcam_ :\itcam_install\ iDC_homeIBMz/OS /u/WAS80vAppserver_home: the directory where the application server core product files areinstalled.

9 The following table shows the default locations:Table 2. Default locations for appserver_homeUNIXorLinux/opt/IBM/WebSph ere/AppServerWindowsC:\Program Files\IBM\WebSphere\AppServerIBMz/OS/u/w as8500 IBM i/QIBM/ProdData/WebSphere/AppServerNote: If there are multiple application server installations in the same directorypath, the path will end in a directory named after the particular applicationserver Installation . For example,AppServer_homewill beIBM_home/WebSphere/WAS8 : IBM z/OS, This is the ITCAM for WebSphere Application Serverconfiguration home directory. The default is/ for WebSphere Application Server: Installation and user GuideContentsAbout this for WebSphere Application terminology publications technical command for 1. Monitor performance withIBM Tivoli Composite ApplicationManager for WebSphere 2.

10 Getting Started with ITCAMfor WebSphere Application Server .. 3 Start ITCAM for WebSphere Application Server,enable counters, and view of counters displayed in the TivoliPerformance ITCAM for WebSphere Application Server 6 Disabling ITCAM for WebSphere Application ITCAM for WebSphere Application Server 7 Customizing ITCAM for WebSphere ApplicationServer 3. Installing and configuringITCAM for WebSphere ApplicationServer on Windows the Data ITCAM for WebSphere in a profile where there are no otherITCAM products configured in the sameWebSphere the ITCAM Data Collector the ITCAM Data Collector forWebSphere in silent the ITCAM Data Collector data collectors to the ITCAM DataCollector for the ITCAM Data Collector forWebSphere in silent ITCAM for SOA version datacollector to the ITCAM Data Collector ITCAM for SOA version to theITCAM Data Collector for WebSphere in the ITCAM Data Collector the ITCAM Data Collector forWebSphere in silent 4.