Upload
others
View
0
Download
0
Embed Size (px)
Citation preview
The authors and publisher have taken care in the preparation of this book, but make no expressed orimplied warranty of any kind and assume no responsibility for errors or omissions. No liability is assumedfor incidental or consequential damages in connection with or arising out of the use of the information orprograms contained herein.
© Copyright 2010 by International Business Machines Corporation. All rights reserved.
Note to U.S. Government Users: Documentation related to restricted right. Use, duplication, or disclosureis subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.
IBM Press Program Managers: Steven M. Stansel, Ellice Uffer
Cover design: IBM Corporation
Associate Publisher: Greg WiegandMarketing Manager: Kourtnaye SturgeonAcquisitions Editor: Katherine Bull Publicist: Heather FoxDevelopment Editor: Kendell LumsdenManaging Editor: Kristy HartDesigner: Alan ClementsProject Editor: Anne GoebelCopy Editor: Language Logistics, LLCIndexer: WordWise Publishing Services, LLCCompositor: Jake McFarlandProofreader: Water Crest PublishingManufacturing Buyer: Dan Uhrig
Published by Pearson plc
Publishing as IBM Press
IBM Press offers excellent discounts on this book when ordered in quantity for bulk purchases or specialsales, which may include electronic versions and/or custom covers and content particular to your business,training goals, marketing focus, and branding interests. For more information, please contact:
U.S. Corporate and Government [email protected].
For sales outside the U.S., please contact:
International [email protected].
The following terms are trademarks or registered trademarks of International Business MachinesCorporation in the United States, other countries, or both: IBM, the IBM logo, IBM Press, AIX,Cloudscape, DB2, developerWorks, Rational, Redbooks, WebSphere, and z/OS. Microsoft, Windows, andC# are trademarks of Microsoft Corporation in the United States, other countries, or both. Java, J2EE, EJB,JDBC, and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, othercountries, or both. UNIX is a registered trademark of The Open Group in the United States and othercountries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.Other company, product, or service names may be trademarks or service marks of others.
Library of Congress Cataloging-in-Publication Data
Gibson, Robert A., 1954–WebSphere application server administration using Jython / Robert A. Gibson, Arthur Kevin McGrath,
Noel J. Bergman.p. cm.
ISBN 978-0-13-700952-7
1. WebSphere. 2. Web servers. 3. Application software—Development. 4. Jython (Computer programlanguage) I. McGrath, Arthur Kevin. II. Bergman, Noel. III. Title.
TK5105.8885.W43.G53 2009
005.1'17—dc22
2009030406
All rights reserved. This publication is protected by copyright, and permission must be obtained from thepublisher prior to any prohibited reproduction, storage in a retrieval system, or transmission in any form orby any means, electronic, mechanical, photocopying, recording, or likewise. For information regardingpermissions, write to:
Pearson Education, Inc.Rights and Contracts Department501 Boylston Street, Suite 900Boston, MA 02116Fax (617) 671-3447
ISBN-13: 978-0137009526
ISBN-10: 0137009526
Text printed in the United States on recycled paper at R.R. Donnelley in Crawfordsville,Indiana. First printing October 2009
1
Why Is This Book Necessary?For years we have been enthusiastically pounding the table, so to speak, saying that scripting is“where it’s at!” for WebSphere® administrators. All the while, we (along with our students) havewished for a book that would enable more people to use Jython1 for their scripting needs. Wefinally got together and set out to write one, and we hope this book addresses not only our owndesires and demands but yours as well.
Websphere’s robust and versatile scripting facility differentiates the IBM® WebSphereApplication Server product from competitors in the Java™ EE server marketplace. As convenientand friendly as the Integrated Console can be, the true power for administrators is in scripting.This is probably evident to anyone who has had to configure something on multiple machines orperform the same configuration numerous times.
IBM’s support for scripting that is built into the WebSphere platform is staggering. As youdelve into it, you discover all sorts of hidden capabilities and ease-of-use features and quicklydevelop a greater understanding of how WebSphere fits together. Were we to deliver a book con-taining but a single page on each aspect of the available script objects, you’d need a forklift totake it home. Instead, we’ve hopefully provided you with a book that helps prepare you for a jour-ney of discovery. We have documented and explained the scripting concepts, the core objects, andmany of our favorite techniques, while demonstrating some new ones of our own.
C H A P T E R 1
Introduction
1 Jython is an implementation of the Python programming language that executes on a Java VirtualMachine.
2 Chapter 1 Introduction
If you will, think of WebSphere as a healthy, bio-diverse, coral reef, rich in wildlife. In thisbook, we teach you to master the core concepts necessary to explore the reef and introduce you tomany of our favorite reef denizens. Afterward you will be prepared to explore more of the reef onyour own, discovering for yourself more of the richness that IBM has built into WebSphere. Onceyou’ve mastered the core concepts, self-discovery becomes important; each new product layeredon WebSphere (for example, WebSphere Enterprise Service Bus and WebSphere Process Server)and each new version adds more and more scripting capabilities. So in the way of the ancientparable, we will not only give you some fish, but also teach you to fish.
We hope that you enjoy the book...and the journey.—Bob, Kevin, and Noel
About the WebSphere Application Server ProductThe WebSphere Application Server is a large and complex product. As such, it is function-richand can be configured and used in numerous ways. But you probably know that already. Thekind of person likely to pick up this book and consider buying it is someone who has an under-standing of what the WebSphere Application Server is and just how challenging its administra-tion can be. It is also likely that you have either tried administering the product or might bewondering how to administer it using scripting. If you’ve gone down this road on your own,you have probably had some challenging moments (alright, hours) attempting to get yourscripts to “behave.” That is what this book is all about.
This book is not for the novice WebSphere Application Server administrator. It doesn’tdefine or explain J2EE™ or an application server. Definitions and explanations of foundationaltopics are available elsewhere (see the online documentation2). This book is focused on the topicof scripting for the WebSphere Application Server environment.
In writing this book, we spent a great deal of time trying to understand this beast and whatis required to administer a WebSphere Application Server using the examples that exist in theavailable documentation. As a WebSphere Application Server technical support analyst and teamlead, and as instructors, we have also spent a great deal of time sharing our knowledge of thistopic with others. That, too, is what this book is about—sharing some of what we have learnedwith those who are interested in learning.
This Book and Its OrganizationWe tried to organize this book in an easy-to-understand manner. To begin, we discuss Jython.3
Chapters 2 through 5 describe Jython with enough detail that those unfamiliar with it should beable to readily “pick up” the language and use it effectively.
2 http://www.IBM.com/software/webservers/appserv/was/library/.
3 Python is a programming language, and Jython is an implementation of that language. We won’t worry aboutthis distinction and will continue to refer to it as the Jython programming language for simplicity’s sake.
This Book and Its Organization 3
It should be noted that this book is not meant to be an introduction to programming oreven an introduction to the Jython programming language. We could easily fill hundreds morepages on just the topic of “Programming with Jython.” There are lots of books, papers, and web-sites that discuss the syntax and semantics of Python and therefore the Jython programminglanguage.4 This book is not intended to replace nor duplicate the information available else-where. If you already feel comfortable with Jython (or more precisely Python) as a program-ming language, you might be able to skip the chapters that describe Jython and begin withChapter 6.
For those readers who might be less familiar with Jython as a programming language, thisbook attempts to present the rules, characteristics, and properties of Jython in a logical order, so as tobuild a solid foundation of information. A little is presented at time and then revisited and expandedupon, providing reinforcement through repetition. Additionally, each chapter is filled with workingexamples to help you better understand not only the Jython code, but the wsadmin scripting objectsas well. Almost all of the examples described are available from the IBM Press website for thisbook5 and are provided to minimize the need to search other sources for useful examples.
Chapter 6, “wsadmin,” explores the wsadmin command in detail and explains the com-mand and its parameters thoroughly. A number of the parameters don’t seem to get a lot of use.That may be because when you first start using wsadmin, you can quickly get to a subset of theparameters that you use “all the time.” For many tasks, this is a reasonable approach to getting thejob done. However, in so doing, you might have forgotten or not even realize that some wsadminparameter exists that might make your life easier. This chapter will help broaden your understand-ing of this command. You never know, you may even find something that you can use right away.
Chapter 7, “Introduction to Admin Objects,” is a must-read because it explains how to configure wsadmin in order to use many of the examples shown later in the book. The wsadminproperties that are shown in this chapter (specifically the changing of the profiles directive) pro-vide an environment upon which many of the later examples depend.
Chapter 8, “The AdminConfig Object,” is the beginning of the explanation of the wsadminscripting objects. Specifically, it explains the AdminConfig scripting object in great detail.Many administrative scripts deal primarily with the AppServer configuration use and dependupon this scripting object for the vast majority of these manipulations. A number of usefulexamples are provided to demonstrate just how helpful this scripting object can be.
Chapter 9, “The AdminControl Object,” describes the AdminConfig scripting object insimilar detail. This object is used by scripts that need to manipulate active AppServer objects(MBeans). So this chapter is full of useful information for those types of scripts.
4 Please note, however, that the version of Jython that is provided and supported by the wsadmin utilitydoes not include all of the features and facilities available in the “latest and greatest” version of Python. So,keep this in mind as you are writing your wsadmin scripts.
5 http://www.IBMPressBooks.com/title/9780137009527.
4 Chapter 1 Introduction
Chapter 10, “The AdminApp Object,” covers the AdminApp scripting object in detail. Thisobject is used to list, view, install, uninstall, and modify AppServer applications. As such, thischapter explains how to perform these operations using the AdminApp object methods.
Chapter 11, “The AdminTask Object—Server Management,” is where we begin thedescription of some of the AdminTask scripting object methods. The AdminTask object is enor-mous. Additionally, as is explained in this chapter, the methods included vary based upon a num-ber of factors. The scope (as in breadth and depth) of this object is huge. It includes hundreds and hundreds of methods. As such, there is no way for it to be adequately covered in a single chapter.In fact, Chapters 12 through 15 largely deal with AdminTask object methods. That’s not all theycover, but it is at the core of each of these chapters.
Chapter 12, “Scripting and Security,” deals with scripting and security. As such, itaddresses a number of security-related items. Anyone who needs to administer an enterpriseapplication server should be familiar with the topics described in this chapter.
Chapter 13, “Databases and Authorization,” covers databases and authorization. Eventhough the configuration and administration of database-related resources can seem overwhelm-ing, this chapter presents these topics in a simple fashion. You discover the easy way to configurethe database-related resources (“the plumbing,” if you will) required for interactions with a data-base. These explanations include descriptions about the properties you can control and those thatare automatically configured for you. The chapter then moves into exploring and manipulatingthe more complicated aspects and properties of database-related resources and then finishes witha detailed explanation of commonly used database and authorization AdminTask methods.
Chapter 14, “Messaging,” is all about messaging. This complicated topic is explored indetail but explained simply. The chapter starts by discussing messaging basics and then adds adiscussion of security. It ends by explaining the more commonly used messaging AdminTaskmethods in great detail.
Chapter 15, “Administering Web Services,” is all about Web services. So what exactly areWeb services? The IBM online documentation has this to say about Web services:
Web services are self-contained, modular applications that can be described, published,located, and invoked over a network. They implement a services-oriented architecture(SOA), which supports the connecting or sharing of resources and data in a very flex-ible and standardized manner. Services are described and organized to support theirdynamic, automated discovery and reuse.
This chapter describes Web services and explains how they should be managed. It also discussespolicies, policy sets, bindings and even the use of keystores for the security-related aspects ofWeb services.
Lastly, Chapter 16, “Version 7.0 Scripting Libraries,” is about the scripting object librariesthat are included in version 7 of the AppServer product. These Jython libraries demonstrate sometechniques for the management and manipulation of AppServer entities. Some people find theprogramming interface provided by some of the wsadmin scripting objects difficult to under-stand and even harder to work with. These libraries present another approach and provide meth-ods that use simpler parameter lists to some of these scripting object methods.
449
Index
addPartialAppToAnApp-WithUpdateCommand()method, 406
addPolicyType command,382
addSIBusMember method,318-320
addSIBWSInboundPortmethod, 376
addSIBWSOutboundPortmethod, 376
addUpdateSingleModuleFile-ToAnAppWithUpdate-Command() method, 405
addUserToBusConnectorRolemethod, 338
addUserToDefaultRolemethod, 338
addUserToDestinationRolemethod, 339
addUserToTopicRole method, 340
addUserToTopicSpaceRoot-Role method, 340
AdminApp command, 355AdminApp object, 199
application installationmethods, 204-208
editing, 208-210methods, 199-212updating, 208-210
AdminApp.getDeployStatus()method, 204
AdminApp.isAppReady()method, 200
AdminApp.updateInteractive() method, 208
AdminApplication objectsAdminAuthorizations
modules, 428-430AdminClusterManagemen
t modules, 430-432AdminJ2C modules,
412-414AdminJDBC modules,
414-416AdminJMS modules,
416-423
Aabs( x ) method, 77accessing
dictionaries, 14sequence elements, 12-13
addGroupToBusConnector-Role method, 338
addGroupToDefaultRolemethod, 338
addGroupToDestinationRolemethod, 338
addGroupToTopicRolemethod, 339
addGroupToTopicSpaceRoot-Role method, 340
addingcontent, 209hosts, 258libraries, 395resources to security
domains, 262addNodeGroupMember
command, 224
450 Index
AdminNodeGroupManage-ment modules, 445-446
AdminNodeManagementmodules, 446-447
AdminResources modules,423-427
AdminServerManagementmodules, 432-445
business-levelapplications, 409-412
scripting libraries, 399-409
AdminApplication.getApp-DeploymentTarget() method, 404
AdminAuthorizationsmodules, 428-430
AdminBLA scripting libraryfiles, 409-412
AdminClusterManagementmodules, 430-432
AdminConfig object, 149config ID, 150-155configuration types,
152-153containment paths, 151create/modify methods,
160-162document manipulation
methods, 164methods, 164-165overview of, 149-150show/tell methods,
155-159verification, 162-163
AdminConfig.create()method, 211
AdminConfig.getid()method, 151
AdminConfig.hasChanges()method, 162
AdminConfig.list()method, 152
AdminConfig.parents()method, 160
AdminConfig.remove()method, 162
AdminConfig.reset()method, 352
AdminConfig.save() method, 352
AdminConfig.show() method, 153
AdminConfig.showall()method, 156
AdminConfig.types()method, 160
AdminConfig.validate()method, 163
AdminControl object, 167attributes, 174-181environment information,
167-172MBean support methods,
172-173methods, 181-182methods*_imx, 183-184names, 173-174
AdminControl.startServer()method, 168
administrationobjects, 129-134
documentation,145-147
Help, 134-145security, enabling,
249-250Web services, 352
exporting WSDL, 355KeyManager
commands, 377KeySet commands,
381-382KeyStore commands,
378-381listing, 353-354
navigating, 353-355overview, 346-350policy sets, 355-365,
367-371PolicySetManagement
group, 382-390references, 373-376runtimes, 351-352SIBWebServices group,
374-377SOAP, 347topics, 371-372WebServicesAdmin
group, 390-392WS-I profiles, 346-347WSDL, 347
wsadmin program, 113-115
commands, 126-128connecting, 120defining scripting
languages, 122environment
initialization, 116-120JVM initialization, 116options, 115profile script files,
123-126tracing, 122usage information, 116
AdminJ2C modules, 412-414AdminJDBC modules,
414-416AdminJMS modules,
416-423AdminLibHelp module, 447AdminNodeGroupManage-
ment modules, 445-446AdminNodeManagement
modules, 446-447AdminReports Command
Group command, 226
Index 451
AdminResources modules,423-427
AdminServerManagementmodules, 432-445
AdminTask methods, 145databases. See databasessecurity, 264server management,
199-200command, 209-212creating clusters,
205-209examples, 201-202JVM methods,
216-217JVM properties,
218-219JVM system properties,
217-218methods, 202-205references, 223-239template-related
commands, 214-216z/OS methods,
220-223AdminTask.listPolicySets()
method, 356AdminTask.listServerTypes()
method, 203AdminTask.listWebServices-
Operations command, 354AdminTask.modifySIB*
methods, 312AdminUtilities module, 447advanced settings, databases,
284-291aliases, J2C, 242-249AllAuthenticated group, 311append( item ) method, 67applications
AdminApp object, 199application installation
methods, 204-208
editing, 208-210methods, 199-204,
210-212updating, 208-210
business-level, 409-412deploying, 407-408exporting, 406Federated registries,
260-261messaging, 301-302
creating buses, 303-308deleting buses, 308-310references, 317-327security, 310-317terminology, 303
names, 203policy sets, 356security, 241-242
configuring, 249-253enabling, 249-250J2C, 242-249Java, 253-255
servers, 2starting, 408-409stopping, 408-409updating, 404-406wsadmin program,
113-115commands, 126-128connecting, 120defining scripting
languages, 122environment
initialization, 116-120JVM initialization, 116options, 115profile script files,
123-126tracing, 122usage information, 116
applying config IDs, 153-155arbitrary function parameters,
55-58
archive files, 116arithmetic operators, 18assert statements, 35-36assignment statements, 16,
28-30augmented, 32packing/unpacking, 30-31slices, 34
attachments, policy sets, 361-371
attributesAdminControl object,
174-181MBean Help object,
138-140missing, 155policy, 360RW, 177
augmented assignmentstatements, 32
authenticationdata entry, creating, 244LDAP failover, 255-260
authorizationAdminAuthorizations
library module, 428-430buses, 313databases, 277
advanced settings, 284-291
overview of, 277-280references, 291-300troubleshooting,
280-284autoloading scriptLibraries,
395availability of objects, 133
Bbackslash (\) character, 9beanDescriptions.py, 143beanInformation.py, 144
452 Index
bindingsassignment statements, 30deleting, 365policy sets, 362-371slices, 32-33
bitwise operators, 21Boolean operators, 21break statements, 36Browser security role, 311built-in
constants, 66data types, 67exceptions, 93-94functions, 77-86
busescreating, 303, 306-308deleting, 308-310, 326messaging, 303modifying, 329security, 263, 311-314, 337viewing, 334
business-level applications,409-412
busMembers element, 305
Ccallable( object ) method, 78capabilities, 1capitalize() method, 71CellStatus.py, 171center( width ) method, 71chains, 315changeClusterShortName()
method, 220changeServerGenericShort-
Name() method, 220changeServerSpecificShort-
Name() method, 220characters, escape sequences, 9chr( i ) method, 78classes
hierarchies, 93statements, 63-66
ClassNotFoundException,282
clear() method, 69client-side policy
attachments, 368cloning security domains, 261clusters
AdminClusterManagementlibrary module, 430-432
creating, 205-209code conventions, 26commands
AdminApp, 355AdminTask.listWeb-
ServicesOperations, 354command line options, 117configureSingleSignon,
269copySecurityDomain, 271copySecurityDomainFrom
GlobalSecurity, 270create, 210createAuthDataEntry, 265createGroup, 273createSecurityDomain, 270createUser, 273deleteAuthDataEntry, 265deleteGroup, 274deleteSecurityDomain, 271deleteUser, 273dir(), 395duplicateMembershipOf-
Group, 274duplicateMembershipOf-
User, 274getActiveSecuritySettings,
266getSingleSignon, 269getUserRegistryInfo, 269IdMgrRepositoryConfig
group, 275-276isAppSecurityEnabled, 275isJACCEnabled, 275
isSingleSecurityDomain,275
JACCUtilityCommandsgroup, 275
KeyManager, 377KeySet, 381-382KeyStore, 378-381listAuthDataEntries,
265-266listInterceptors, 270listRegistryGroups, 272listSecurityDomains, 271listSecurityRealms, 273manageprofiles, 203SecurityConfiguration-
Commands group, 264-270
SecurityDomain-Commands group, 270-271
SecurityRealmInfo-Commands group, 272-273
servers, 209-216serverStatus, 172setAdminActiveSecurity-
Settings, 266-267setAppActiveSecurity-
Settings, 267-268setGlobalSecurity, 274unsetAppActiveSecurity-
Settings, 268-269WIMManagement-
Commands group, 273-274
WizardCommands group,274-275
wsadmin programs, 126-128
comments, 26, 116comparison operators, 22compile( patternString
[, flags ] ) method, 109
Index 453
compile( string, filename,kind ) method, 78
complex( real[, imag ] )method, 78
components, busesdeleting, 326modifying, 329viewing, 334
compound statements, 41for, 44-46if, 42loop, 42try, 47-48while, 42-43
config ID, 150-155configureSessionManagement
ForAnApplication() method, 408
configureSingleSignoncommand, 269
configuringAdminConfig objects,
149-150config ID, 150-155configuration types,
152-153containment paths, 151create/modify methods,
160-162document manipulation
methods, 164methods, 164-165show/tell methods, 155-
159verification, 162-163
applicationsJava 2 security,
253-255security, 249-253
databases, 277-280advanced settings,
284-291
references, 291-300troubleshooting,
280-284hosts, 258-259IdMgrRepositoryConfig
group, 275-276J2C (JAAS) aliases),
243-244JACCUtilityCommands
group, 275messaging, 301-302
creating buses, 303-308deleting buses, 308-310references, 317-327security, 310-317terminology, 303
permissions, 314policy set bindings, 365SecurityConfiguration-
Commands group, 264-270
SecurityRealmInfo-Commands group, 272-273
servers, 205-209commands, 209-212JVM methods, 216-217JVM properties,
218-219JVM system properties,
217-218references, 223-239template-related
commands, 214-216z/OS methods, 220-223
SIBs, 307strings, 74-77WIMManagement-
Commands group, 273-274
WizardCommands group,274-275
ConnectionPool, 283connections
leaks, tracing, 284messages, 121wsadmin program, 120
Connector security role, 311connectSIBWSEndpoint-
Listener method, 375constants, built-in, 66. See
also literals, 8-15constructors, finding,
142-143constructs, OOP, 63
built-in constants, 66data types, 67functions, 77-86
class statements, 63-66dictionary methods, 69-71instantiation, 66list methods, 67-68string methods, 71-77
containers, EJB, 351containment paths, 151content, adding, 209continue statements, 36control flow, 39-41conventions, code, 26convertToCluster.py, 164copy() method, 69copyBinding command, 389copying
bindings, 363slices, 32-33
copyPolicySet command, 388copySecurityDomain
command, 271copySecurityDomainFrom-
GlobalSecurity command,270
count( item ) method, 67count( substring[, start
[, end ] ] ) method, 71
454 Index
create commands, 210create() method, 160-162createApplicationServe
command, 234createApplicationServer()
method, 209createApplicationServer-
Template command, 235createApplicationServer-
Template() method, 214createAuthDataEntry
command, 265createCluster command, 226createClusterMember
command, 228createCoreGroup
command, 224createDataSource, 292createGenericServer()
method, 209createGenericServerTemplate
() method, 214createGroup command, 273createJDBCProvider, 291createKeyManager
command, 378createKeySet command, 381createKeyStore command, 379createNodeGroup
command, 224createPolicySet
command, 383createPolicySetAttachment
command, 383createProxyServer() method,
204, 209createProxyServerTemplate()
method, 214createSecurityDomain
command, 270createServerType
command, 238createServerType() method,
202-203
createSIBDestinationmethod, 320-322
createSIBEngine method,322-323
createSIBJMSActivationSpecmethod, 325-326
createSIBJMSConnection-Factory method, 323-324
createSIBJMSQueue method,324-325
createSIBJMSTopic method,325
createSIBus method, 317-318createSIBWSEndpoint-
Listener method, 375createSIBWSInboundService
method, 374createSIBWSOutbound-
Service method, 374createUser command, 273createWebServer() method,
209createWebServerTemplate()
method, 214Creator security role, 311customizing
databases, 284-291J2C (JAAS) aliases, 245references, 291-300wsadmin programs, 115
environmentinitialization, 116-120
JVM initialization, 116usage information, 116
Ddata definition language
(DDL), 406data types, 6-7
built-in, 67dictionaries, 14lists, 12numbers, 7
sequences, accessingelements, 12-13
strings, 8-11tuples, 11
databasesauthorization, 277
advanced settings, 284-291
references, 291-300troubleshooting,
280-284overview of, 277-280
DataSources, 278-280, 296-298
security, 263DCS (Distribution and
Consistency Services), 315DDL (data definition
language), 406default failure actions,
scripting libraries, 398default function parameters,
53-62defining scripting
languages, 122definitions
classes, 66functions, 49-50
del statements, 36deleteAuthDataEntry
command, 265deleteCluster command, 230deleteClusterMember
command, 230deleteCoreGroup
command, 226deleteGroup command, 274deletePartialAppToAnApp-
WithUpdateCommand()method, 406
deleteSecurityDomaincommand, 271
deleteServer command, 236
Index 455
deleteServer() method, 210deleteServerTemplate()
method, 214deleteSIBDestination
method, 328-329deleteSIBJMSActivationSpec
method, 327deleteSIBJMSConnection-
Factory method, 327deleteSIBJMSQueue
method, 327deleteSIBJMSTopic
method, 327deleteSIBus method, 327deleteSingleModuleFileTo-
AnAppWithUpdate-Command() method, 405
deleteUser command, 273deleteUserAndGroupEntries()
method, 210deleteWebServer() method,
210deleting
bindings, 365buses, 308-310, 326hosts, 259-260J2C (JAAS) aliases,
246-249servers, 207
deploying applications, 407-408
destinations, 303dictionaries, 14
methods, 69-71parameters, unpacking, 57
dir( [object] ) method, 78dir() command, 395directories
importing, 395structures, 150
disabling security, 249-250Distribution and Consistency
Services (DCS), 315divmod( a, b ) method, 78
documentsadmin objects, 145-147function strings, 61manipulation methods, 164
domainsmultiple security, 261-262security, adding resources
to, 262SecurityDomain-
Commands group, 270-271
duplicateMembershipOf-Group command, 274
duplicateMembershipOfUsercommand, 274
Eease-of-use features, 1editing AdminApp methods,
208-210EJB (Enterprise Java
Bean), 351elements
busMembers, 305sequences, accessing,
12-13email, messaging, 302. See
also messagingenabling
bus security, 311-314Java 2 security, 253-255security, 249-250transport security, 314-317
end( [group] ) method, 110endpoints, Web services, 354endswith( suffix[, start
[, end ] ] ) method, 71Enterprise Java Bean
(EJB), 351environments
AdminControl object,167-172
initialization, 116-120
errors, 92-94OOM, 86
escape sequences, 9escape( string ) method, 109eval( expression[, globals[,
locals] ] ) method, 79Everyone group, 311exceptions, 92
built-in, 93-94ClassNotFoundException,
282IndexError, 68NameError, 132scripting libraries, 399
exchangeSigners command, 380
exec statements, 38execfile( filename[, globals[,
locals ] ] ) method, 79expandtabs( [tabsize] )
method, 71export() method, 210exportAllApplicationsToDir()
method, 406exportAnAppToFile()
method, 406exportBinding command, 389exportDDL() method, 210exporting
applications, 406policy sets, 359WSDL, 355
exportPolicySet command, 387
exportServer command, 231expressions
overview of, 18regular *RegExp,
107-112statements, 27-28
extend( item ) method, 67extracting methods,
names, 135
456 Index
Ffailonerror parameters, 399failover, LDAP, 255-260Federated registries, 260-261filenames, 203, 206files
archive, 116help, 114modules, 87
errors, 92-94import statements,
88-90nested_scopes, 90-92packages, 92
profile script, 123-126script, 126-128script library, 394wsadmin.properties, 133
filter( function, sequence )method, 79
find( substring[, start[, end ] ] )method, 71
findall( pattern, string )method, 109
findall(string [, startPos [,endPos ] ] ) method, 110
finding constructors, 142-143fixFileName() method, 207float( x ) method, 79flow, control, 39-41for statements, 44-46formatting. See also
configuringdatabases, 277-280
advanced settings, 284-291
references, 291-300troubleshooting,
280-284indentation, 40J2C (JAAS) aliases,
243-244JVM properties, 218
messaging, 301-302creating buses, 303-308deleting buses, 308-310references, 317-327security, 310-317terminology, 303
servers, 205-209commands, 209-212JVM methods, 216-217JVM properties,
218-219JVM system properties,
217-218references, 223-239template-related
commands, 214-216z/OS methods,
220-223strings, 74-77
functional programming, 94functions, 49
built-in, 77-86definitions, 49-50global statements, 51-52MBattrAsDict() utility, 179namespaces, 51parameters, 52
arbitrary, 55-58default, 53-62named, 54-55
return statements, 58-59showAsDict, 154
GgenerateKeyForKeySet
command, 381generateSecConfigReport
command, 232get( key [, defaultValue ] )
method, 70getActiveSecuritySettings
command, 266
getattr( object, name[, default ] ) method, 80
getAttribute() method, 175, 179
getAttributes() method, 175getAttributes_jmx()
method, 183getBinding command, 386getDefaultBindings
command, 387getDeployStatus()
method, 204getDmgrProperties()
method, 220getid() method, 152getJavaHome() method, 220getKeyStoreInfo
command, 380getMBeanCount()
method, 172getObjectName() method, 165getopt() library routine,
100-102getPolicySet command, 385getPolicySetAttachments
command, 386getPolicyType command, 385getRequiredBindingVersion
command, 387getServerType command, 233getServerType() method, 202getSingleSignon
command, 269getters, 140getUserRegistryInfo
command, 269getWebService method, 392global security, 249, 311. See
also securityglobal statements, 51-52globals() method, 80group( [group] ) method, 110groupdict() method, 110
Index 457
groupsAdminNodeGroup
Management librarymodule, 445-446
IdMgrRepositoryConfig,275-276
JACCUtilityCommands,275
JDBCProviderManage-ment, 291-293
mapping, 251-253PolicySetManagement,
382-390SecurityConfiguration-
Commands, 264-270SecurityDomain-
Commands, 270-271SecurityRealmInfo-
Commands, 272-273ServerManagement, 209SIBWebServices, 374-377VariableConfiguration,
294-296WebServicesAdmin,
390-392WIMManagement-
Commands, 273-274WizardCommands,
274-275groups() method, 110
Hhasattr( object, name )
method, 80hash( object ) method, 80has_key( key ) method, 70help files, 114Help object, 134-144help() method, scripting
libraries, 397-399Help.constructors()
method, 142
Help.descriptions()method, 143
hex( x ) method, 80hierarchies, classes, 93hosts
adding, 258configuring, 258-259deleting, 259-260viewing, 257
Iid( object ) method, 80identifiers, 15-16identity operators, 24IdMgrRepositoryConfig
group, 275-276IEEE Standard for
Binary Floating-PointArithmetic (ANSI/IEEE Std 754-1985), 7
if statements, 42import statements, 39, 88-90importBinding command, 388importing directories, 395importPolicySet command,
387importServer command, 231*_imx methods, 183-184indentation, 40index( item ) method, 68index( substring[, start
[, end ] ] ) method, 71IndexError exceptions, 68indexing sequence
elements, 13infinite loops, 42information types, 15
expressions, 18identifiers, 15-16literals, 15statement separators, 25string operators, 19-24variables, 16-18
initializationenvironments, 116-120JVM, 116
input( [prompt] ) method, 80insert( index, item )
method, 68installing applications,
400-402installInteractive()
method, 207installResourceAdapter()
method, 165instances, AdminControl
objects, 173-174instantiation, 66int( x[, radix ] ) method, 81Integrated Solutions
Console, 251integrating SIBs, 307interactive wsadmin
sessions, 43interfaces, JNDI, 211invoke() method, 181isalnum() method, 71isalpha() method, 72isAppReady() method, 201isAppSecurityEnabled
command, 275isdigit() method, 72isFederated() method, 220isinstance( object, classinfo )
method, 81isJACCEnabled
command, 275islower() method, 72isSingleSecurityDomain
command, 275isspace() method, 72issubclass( class, classinfo )
method, 81istitle() method, 72isupper() method, 72items() method, 70
458 Index
JJ2C (J2EE Connector
Architecture), 242-249authentication aliases, 278library modules, 412-414
JAASAuthData objects, 243, 313
JACCUtilityCommandsgroup, 275
Java, 95-103roles, mapping, 250security, enabling,
253-255Java 2 Connector
Architecture. See J2CJava Messaging Service
(JMS), 307Java Naming and Directory
Interface (JNDI), 211Java Virtual Machine. See
JVMJDBC (Java Database
Connector)AdminJDBC library
modules, 414-416providers, 278
JDBCProvider,troubleshooting, 281
JDBCProviderManagementGroup methods, 291-293
JMS (Java MessagingService), 307
AdminJMS librarymodules, 416-423
JNDI (Java Naming andDirectory Interface), 211
join( sequence ) method, 72JVM (Java Virtual
Machine), 6initialization, 116methods, 216-217properties, 218-219system properties,
217-218
Jythoncoding conventions, 26comments, 26data types, 6-7
accessing sequenceelements, 12-13
dictionaries, 14lists, 12numbers, 7strings, 8-11tuples, 11
information types, 15expressions, 18identifiers, 15-16literals, 15statement separators, 25string operators, 19-24variables, 16-18
overview of, 6
KKeyManager commands, 377keys
policy sets, 362-363properties, 117
keys() method, 70KeySet commands, Web
services, 381-382KeyStore commands, Web
services, 378-381keytools, 363keywords, 16, 58
Llanguages
Jython. See Jythonscripting, defining, 122
lastgroup, 111lastindex, 111LDAP failover, 255-260LDAPUserRegistry, 256leaks, tracing connection, 284
len( s ) method, 81libraries
Java, 95-105scripting
AdminApplicationobjects, 399-409
AdminAuthorizationsmodules, 428-430
AdminClusterManage-ment modules, 430-432
AdminJ2C modules,412-414
AdminJDBC modules,414-416
AdminJMS modules,416-423
AdminNodeGroup-Managementmodules, 445-446
AdminNodeManage-ment modules, 446-447
AdminResourcesmodules, 423-427
AdminServerManage-ment modules, 432-445
business-levelapplications, 409-412
navigating, 393-397troubleshooting,
397-399list( sequence ) method, 81listAllDestinationsWithRoles
method, 341listAllForeignBusesWith-
Roles method, 341listAllRolesForGroup
method, 341listAllRolesForUser
method, 341listAllTopicsWithRoles
method, 341
Index 459
listApplicationPortscommand, 232
listAssetsAttachedToPolicy-Set command, 385
listAttachmentsForPolicySetcommand, 384
listAuthDataEntriescommand, 265-266
listDataSources, 294listGroupsInBusConnector-
Role method, 341listGroupsInDefaultRole
method, 342listGroupsInDestinationRole
method, 342listGroupsInTopicRole
method, 342listGroupsInTopicSpaceRoot
Role method, 342, 344listInterceptors command, 270listJDBCProviders, 293listKeyFileAliases
command, 380listKeyManagers
command, 377listKeyStores command, 378listKeyStoreTypes
command, 378listModules() method, 201listPolicySets command, 384listPolicyTypes
command, 384ListPorts.py, 159listRegistryGroups
command, 272lists, 12
methods, 67-68Web services, 352-354
listSecurityDomainscommand, 271
listSecurityRealmscommand, 273
listServer command, 233
listServerPorts command, 232
listServers() method, 210listServerTemplates()
method, 214listServerTypes
command, 233listServerTypes() method,
202listServices method, 392listSIBEngines method, 335listSIBJMSQueues
method, 336listSIBJMSTopics
method, 336listSIBMediations
method, 337listSIBuses method, 334listSIBusMembers
method, 334listUsersInBusConnectorRole
method, 343listUsersInDefaultRole
method, 343listUsersInDestinationRole
method, 343listUsersInTopicRole
method, 343listWebServiceEndpoints
method, 391listWebServiceOperations
method, 391listWebServices method, 391literals, 8-15ljust( width ) method, 73local mode, 120local precedence, 51locals() method, 81long strings, 8long( x[, radix ] ) method, 81loop statements, 42lower() method, 73lstrip() method, 73
Mmanagement. See also
administrationAdminClusterManagement
library module, 430-432
AdminNodeGroupManage-ment library module,445-446
AdminNodeManagementlibrary module, 446-447
AdminServerManagementlibrary module, 432-445
databases, 277-280advanced settings,
284-291references, 291-300troubleshooting,
280-284servers, 199-200
commands, 209-212creating clusters,
205-209examples, 201-202JVM methods, 216-217JVM properties,
218-219JVM system properties,
217-218methods, 202-205references, 223-239template-related
commands, 214-216z/OS methods, 220-223
Web services, 352exporting WSDL, 355KeyManager
commands, 377KeySet commands,
381-382KeyStore commands,
378-381listing, 353-354
460 Index
navigating, 353-355overview, 346-350policy sets, 355-371PolicySetManagement
group, 382-390references, 373-376runtimes, 351-352SIBWebServices group,
374-377SOAP, 347topics, 371-372WebServicesAdmin
group, 390-392WS-I profiles, 346-347WSDL, 347
wsadmin program, 113-115
commands, 126-128connecting, 120defining scripting
languages, 122environment
initialization, 116-120JVM initialization, 116options, 115profile script files,
123-126tracing, 122usage information, 116
manageprofiles command, 203map( function, sequence, ... )
method, 82mapping
Java EE roles, 250reviewing, 251users, 251-253
match( pattern, string [, flags ] ) method, 109
match( string [, startPos [,endPos ] ] method, 110
max( sequence ) method, 82MBattrAsDict() utility
function, 179
MBeans, 296AdminControl object
support methods, 172-173
DataSource, 296-298Help object, 136-144TraceService, 298-300
MDBs (Message-DrivenBeans), 352
members, bus, 303membership operators, 24memory, OOM errors, 86Message-Driven Beans
(MDBs), 352messaging
busescreating, 303-308deleting, 308-310
connections, 121Help object, 145overview, 301-302references, 317-344security, 310-317terminology, 303
methodsaddGroupToBusConnector
Role, 338addGroupToDefaultRole,
338addGroupToDestination-
Role, 338addGroupToTopicRole,
339addGroupToTopicSpace-
RootRole, 340addUserToBusConnector-
Role, 338addUserToDefaultRole,
338addUserToDestination-
Role, 339addUserToTopicRole, 340addUserToTopicSpace-
RootRole, 340
AdminApp object, 200-212
application installationmethods, 204-208
editing, 208-210updating, 208-210
AdminApp.getDeploy-Status(), 204
AdminApp.isAppReady(),200
AdminApp.updateInter-active(), 208
AdminApplication.getAppDeploymentTarget(), 404
AdminConfig object, 164-165
AdminConfig.create(), 211AdminConfig.getid(), 151AdminConfig.list(), 152AdminConfig.parents(),
160AdminConfig.remove(),
162AdminConfig.reset(), 352AdminConfig.save(), 352AdminConfig.show, 153AdminConfig.showall(),
156AdminConfig.types(), 160AdminConfig.validate(),
163AdminControl objects,
181-182*_imx, 183-184MBean, 172-173
AdminControl.start-Server(), 168
AdminTask, 264AdminTask.listPolicy-
Sets(), 356create(), 160-162createSIBDestination,
320-322createSIBEngine, 322-323
Index 461
createSIBJMSActivation-Spec, 325-326
createSIBJMSConnectionFactory, 323-324
createSIBJMSQueue,324-325
createSIBJMSTopic, 325createSIBus, 317-318deleteSIBDestination,
328-329deleteSIBJMSActivation-
Spec, 327deleteSIBJMSConnection
Factory, 327deleteSIBJMSQueue, 327deleteSIBJMSTopic, 327deleteSIBus, 327deleteUserAndGroup-
Entries(), 210dictionary, 69-71export(), 210exportDDL(), 210fixFileName(), 207getAttribute(), 175-179getAttributes(), 175getAttributes_jmx(), 183getDeployStatus(), 204getid(), 152getMBeanCount(), 172getObjectName(), 165Help object, 136help(), scripting libraries,
397-399Help.constructors(), 142Help.descriptions(), 143installInteractive(), 207installResourceAdapter(),
165invoke(), 181isAppReady(), 201JDBCProviderManage-
ment Group, 291-293JVM, 216-217
listAllDestinationsWith-Roles, 341
listAllForeignBusesWith-Roles, 341
listAllRolesForGroup, 341listAllRolesForUser, 341listAllTopicsWithRoles,
341listGroupsInBusConnector
Role, 341listGroupsInDefaultRole,
342listGroupsInDestination-
Role, 342listGroupsInTopicRole,
342listGroupsInTopicSpace-
RootRole, 342-344listModules(), 201lists, 67-68listSIBEngines, 335listSIBJMSQueues, 336listSIBJMSTopics, 336listSIBMediations, 337listSIBuses, 334listSIBusMembers, 334listUsersInBusConnector-
Role, 343listUsersInDefaultRole,
343listUsersInDestination-
Role, 343listUsersInTopicRole, 343modify(), 160-162modifySIBDestination,
330-331modifySIBEngine, 330modifySIBJMSQueue, 332modifySIBJMSTopic, 333modifySIBus, 329names, extracting, 135options(), 203publishWSDL(), 211
queryNames(), 174removeDefaultRoles, 337removeGroupFromAll-
Roles, 337removeSIBusMember, 328removeUserFromAllRoles,
337removeVariable, 296restart(), 182searchJNDIReferences(),
211servers, 202-205setAttributes(), 179-180setAttributes_jmx(), 184setVariable, 295show(), 155-159showAsDict(), 157showSIBEngine, 336showSIBJMSConnection-
Factory, 336showSIBJMSQueue, 336showSIBJMSTopic, 336showSIBMediation, 337showSIBus, 334showSIBusMember, 335showVariables, 294startServer(), 169stopServer(), 169strings, 71-77tell(), 155-159uninstall(), 208uninstallResource-
Adapter(), 165updateAccessIDs(), 212updateInteractive(), 209VariableConfiguration
Group, 294-296view(), 203z/OS, 220-223
min( sequence ) method, 82missing attributes, 155modes, local, 120modify() method, 160-162
462 Index
modifyingAdminControl objects,
167-172buses, 329configuration, 150J2C (JAAS) aliases, 245runtime behavior, 283security domains, 261
modifyKeySet command, 382modifySIBDestination
method, 330-331modifySIBEngine method,
330modifySIBJMSQueue
method, 332modifySIBJMSTopic
method, 333modifySIBus method, 329modules
AdminApplication scriptlibrary, 399-409
AdminAuthorizations,428-430
AdminClusterManage-ment, 430-432
AdminJ2C, 412-414AdminJDBC, 414-416AdminJMS, 416-423AdminLibHelp, 447AdminNodeGroupManage-
ment, 445-446AdminNodeManagement,
446-447AdminResources, 423-427AdminServerManagement
, 432-445AdminUtilities, 447errors, 92-94import statements, 88-90names, 203namespaces, 124nested_scopes, 90-92overview, 87
packages, 92simple, 129sys, 98-99
moduleTest.py, 131moveClusterToCoreGroup
command, 225moveServerToCoreGroup
command, 225multiple security domains,
261-262
Nnamed function parameters,
54-55NameError exception, 132names
AdminControl object,173-174
applications, 203filenames, 203JNDI, 211methods, extracting, 135modules, 203variables, 15-16
namespaces, 51modules, 124wsadmin, 123
navigatingJ2C (JAAS) aliases,
244-245LDAPUserRegistry, 256scripting libraries,
393-397Web services, 353-355
negative indexes, 13nested_scopes, 90-92nodes
AdminNodeGroupManage-ment library module,445-446
AdminNodeManagementlibrary module, 446-447
numbers, 7
Oobject-oriented programming.
See OOPobjects
AdminApp, 199application installation
methods, 204-208editing, 208-210methods, 199-212updating, 208-210
AdminApplication,399-409
AdminConfig, 149config ID, 150-155configuration types,
152-153containment paths, 151create/modify methods,
160-162document manipulation
methods, 164methods, 164-165overview of, 149-150show/tell methods, 155-
159verification, 162-163
AdminControl, 167attributes, 174-181environment
information, 167-172*_imx methods,
183-184MBean support
methods, 172-173methods, 181-182names, 173-174
administration, 129-134documentation,
145-147Help, 134-145
availability, 133dictionary, 69-71instantiation, 66
Index 463
Java, 95-105lists, 67-68modules, 87
errors, 92-94import statements,
88-90nested_scopes, 90-92packages, 92
Security, 278strings, 71-77target, 210
OOM (out of memory) errors, 86
OOP (object-orientedprogramming), 63
built-inconstants, 66data types, 67functions, 77-86
class statements, 63-66dictionary methods, 69-71instantiation, 66list methods, 67-68string methods, 71-77
open( filename[, mode[,bufsize ] ] ) method, 82
operationsAdminApp object, 199
application installationmethods, 204-208
editing, 208-210methods, 199-212updating, 208-210
AdminConfig object, 149-150
config ID, 150-155configuration types,
152-153containment paths, 151create/modify methods,
160-162document manipulation
methods, 164
methods, 164-165show/tell methods, 155-
159verification, 162-163
filenames, 203MBean Help objects,
140-141Web services, 355
operatorsarithmetic, 18augmented assignment
statements, 32bitwise, 21Boolean, 21comparison, 22identity, 24membership, 24relationships, 22strings, 19-24unary, 21
optionscommand line, 117,
284-294wsadmin program, 115
environmentinitialization, 116-120
JVM initialization, 116usage information, 116
options() method, 203ord( c ) method, 82out of memory (OOM)
errors, 86
Ppackages, 92packing assignment
statements, 30-31parameters
failon error, 399functions, 52
arbitrary, 55-58default, 53-62named, 54-55
scripts, 127sequences, unpacking, 56
ParentTypes.py, 161parmTest() method, 103-104parseOpt() method, 104-106pass statements, 39passing filenames to
scripts, 206paths, containment, 151period (.), 63permissions, configuring, 314ping, 348-350PingServiceJAXRPCApplica-
tion, 353POJO (Plain Old Java
Object), 351policy sets, Web services,
355-365, 367-371PolicySetManagement group,
382-390pop( [ index ] ) method, 68pos, 111pow( x, y[, z ] ) method, 82precedence
local, 51operators, 20, 24
print statement, 27-28processing command line
options, 100-102profiles
script files, 123-126WS-I, 346-347
programmingfunctional, 94Jython
accessing sequenceelements, 12-13
coding conventions, 26comments, 26data types, 6-7dictionaries, 14expressions, 18identifiers, 15-16
464 Index
information types, 15lists, 12literals, 15numbers, 7operators, 19-24overview of, 6statement separators, 25strings, 8-11tuples, 11variables, 16-18
OOP, 63built-in constants, 66built-in data types, 67built-in functions,
77-86class statements, 63-66dictionary methods,
69-71instantiation, 66list methods, 67-68string methods, 71-77
programswsadmin, 113-115
commands, 126-128connecting, 120defining scripting
languages, 122environment
initialization, 116-120JVM initialization, 116options, 115profile script files,
123-126tracing, 122usage information, 116
properties, 121JVM, 217-223keys, 117
propfileToDict() method, 95publishSIBWSInboundSer-
vice method, 377publishWSDL() method, 211
QQOS (Qualities of
Service), 355query application
configurations, 403-404queryNames() method, 174queues, messaging
creating buses, 303-308deleting buses, 308-310security, 310-317
RRAD (Rational Application
Developer) tool, 361raise statements, 39range( [start,] stop[, step ] )
method, 82Rational Application
Developer (RAD) tool, 361raw strings, 11raw_input( [prompt] )
method, 83re (regular repression)
function, 111Receiver security role, 311reduce( function, sequence[,
initialValue ] ) method, 83references
databases, 291-300messaging, 317-344servers, 223-239Web services, 373-376
registries, Federated, 260-261regular expressions (RegExp),
107-112, 135, 157relationship operators, 22reload( module ) method, 84remove( index ) method, 68removeDefaultRoles
method, 337
removeGroupFromAllRolesmethod, 337
removeNodeGroup command, 225
removeNodeGroupMembercommand, 224
removeSIBusMembermethod, 328
removeUserFromAllRolesmethod, 337
removeVariable method, 296replace( old, new[, count ] )
method, 73reportConfigInconsistencies
command, 226ReportConfiguredPorts
command, 226repr( object ) method, 84resources, AdminResources
library module, 423-427restart() method, 182return statement, 58-59reverse() method, 68reviewing mappings, 251rfind( substring[,start [,end ] ]
) method, 73rindex( substring[, start[, end
] ] ) method, 73rjust( width ) method, 73RMI/IIOP connections, 121roles
Java, 250mapping, 251-253security, 311
round( x[, digits ] ) method,84
rstrip() method, 73runtimes
behavior, modifying, 283Web services, 351-352
RW attributes, 177
Index 465
Sscope, nested_scopes, 90-92scripting
administration objects,129-134
documentation,145-147
Help, 134-145functional programming,
94languages, defining, 122libraries
AdminApplicationobjects, 399-409
AdminAuthorizationsmodules, 428-430
AdminClusterManage-ment modules, 430-432
AdminJ2C modules,412-414
AdminJDBC modules,414-416
AdminJMS modules,416-423
AdminNodeGroup-Managementmodules, 445-446
AdminNodeManage-ment modules, 446-447
AdminResourcesmodules, 423-427
AdminServerManage-ment modules, 432-445
business-levelapplications, 409-412
navigating, 393-397troubleshooting,
397-399profile script files, 123-126
support for, 1troubleshooting, 92-94wsadmin program
commands, 126-128scripts
filenames, passing, 206Jython, 6. See also Jython
search( pattern, string [, flags ] ) method, 109
search( string [, startPos [,endPos ] ] ) method, 110
searching chains, 315searchJNDIReferences()
method, 211SecureConversation policy
set, 357security
AdminTasks methods, 264applications, configuring,
249-253bus, 263buses, 337datasources, 263Federated registries,
260-261J2C, 242-249Java, enabling, 253-255LDAP failover, 255-260messaging, 310-317
multiple domains, 261-262overview of, 241-242Web services, 264
Security object, 278SecurityConfiguration-
Commands group, 264-270SecurityDomainCommands
group, 270-271SecurityRealmInfo-
Commands group, 272-273Sender security role, 311separator statements, 25
sequenceselements, accessing, 12-13escape, 9parameters, unpacking, 56slices, 32-33tuples, 11unpacking, 31
server-side policyattachments, 368
ServerManagement group, 209servers
AdminServerManagementlibrary module, 432-445
applications, 2deleting, 207LDAP failover, 255-260management
commands, 209-212creating clusters,
205-209examples, 201-202JVM methods, 216-217JVM properties,
218-219JVM system properties,
217-218methods, 202-205references, 223-239template-related
commands, 214-216z/OS methods, 220-223
management, 199-200security, 241-242
applications, 249-253J2C, 242-249Java, 253-255
serverStatus command, 172ServerTypes methods,
202-205service integration buses
(SIBs), 307services, Web. See Web
services
466 Index
sessions, wsadmin programs, 128
setAdminActiveSecuritySet-tings command, 266-267
setAppActiveSecuritySettingscommand, 267-268
setattr( object, name, value )method, 85
setAttributes() method, 179-180
setAttributes_jmx() method, 184
setBinding command, 390setdefault( key [,
defaultValue ] ) method, 70setGlobalSecurity
command, 274setJVMProperties
command, 236setJVMProperties()
method, 219setJVMSystemProperties
command, 237setProcessDefinition
command, 237setProcessDefinition()
method, 220-222setServerInstance()
method, 220setters, 140setTraceSpecification()
method, 220setVariable method, 295show() method, 155-159showAsDict function, 154showAsDict() method, 157showJVMProperties()
method, 219showProcessDefinition()
method, 220-222showServerInfo
command, 234showServerInfo() method, 210
showServerInstance() method, 210
showServerTypeInfocommand, 234
showServerTypeInfo()method, 202
showSIBEngine method, 336showSIBJMSConnection-
Factory method, 336showSIBJMSQueue
method, 336showSIBJMSTopic
method, 336showSIBMediation
method, 337showSIBus method, 334showSIBusMember
method, 335showTemplateInfo() method,
214-215showVariables method, 294SIBs (service integration
buses), 307SIBWebServices group,
374-377simple modules, 129simple statements, 35
assert, 35-36break, 36continue, 36control flow, 39-41del, 36exec, 38import, 39pass, 39raise, 39return, 58-59
SmartCellStop.py, 170SOAP, 121, 347span( [group] ) method, 111specifying multiple
commands, 126split( pattern, string [,
maxsplit ] ) method, 109
split( string [, maxsplit ] )method, 110
split( [ separator [,maxsplit ] ] )method, 73
splitlines( [keepends] )method, 73
square brackets ([ ]), 153, 157start( [group] ) method, 110startApplicationOnSingle-
Server() method, 408starting applications, 408-409startServer() method, 169startswith( prefix[, start[,
end ] ] ) method, 73Stateless Session Beans, 352statements
assignment, 16, 28-30augmented, 32packing/unpacking,
30-31slices, 34
class, 63-66comments, 116compound, 41
for, 44-46if, 42loop, 42try, 47-48while, 42-43
expressions, 27-28global, 51-52import, 88-90return, 58-59separators, 25simple, 35
assert, 35-36break, 36continue, 36control flow, 39-41del, 36exec, 38import, 39pass, 39raise, 39
Index 467
StopCell.py, 170stopping applications,
408-409stopServer() method, 169__str__() method, 93str ( object ) method, 85strings, 8-11
functions, 111long, 8methods, 71-77operators, 19-24raw, 11triple-quoted, 8
strip() method, 74sub( pattern, replacement,
string [, count ] ) method,110
sub( replacement, string [,count ] ) method, 110
subn( pattern, replacement,string [, count ] ) method,110
subn( replacement, string [, count ] ) method, 110
swapcase() method, 74syntax errors, 92-94sys module, 98-99
dictionary, 131sys.path variable, 394
Ttarget objects, 210tell() method, 155-159TemplateInfo.py, 215template servers, 214-216testing, 169title() method, 74tools
keytools, 363RAD, 361
topics, policy, 371-372TraceService, MBeans,
298-300
tracingconnection leaks, 284wsadmin programs, 122
transport security, enabling,314-317
triple-quoted strings, 8troubleshooting, 92-94
databases, 280-284OOM errors, 86scripting libraries,
397-399try statements, 47-48tuples, 11, 31type( object ) method, 85types
configuration, 152-153data, 6-7
accessing sequenceelements, 12-13
dictionaries, 14lists, 12numbers, 7strings, 8-11tuples, 11
information, 15expressions, 18identifiers, 15-16literals, 15statement separators, 25string operators, 19-24variables, 16-18
policy, 359
Uunary operators, 21unichr( i ) method, 85unicode( object[, encoding
[, errors ] ] ) method, 85uninstall() method, 208uninstalling applications,
400-402uninstallResourceAdapter()
method, 165
unpackingassignment statements, 30-
31sequence parameters, 56
unsetAppActiveSecurity-Settings command, 268-269
update( dict ) method, 71updateAccessIDs()
method, 212updateEntireAppToAnApp-
WithUpdateCommand()method, 406
updateInteractive() method, 209
updatingAdminApp methods,
208-210applications, 404-406
upper() method, 74usage information, wsadmin
programs, 116usage() method, 102-103users, mappings, 251-253
VvalidatePolicySet
command, 388validation, configuring,
162-163values, 59values() method, 71van Rossum, Guido, 61VariableConfiguration
command group, 282VariableConfiguration Group
methods, 294-296variables
names, 15-16overview of, 16-18slices, 32-33sys.path, 394
VariableSubstitutionEntry,281
468 Index
vars( [object] ) method, 86verifying configurations,
162-163view() method, 203viewing
buses, 334hosts, 257J2C (JAAS) aliases,
244-245
WWAuJ.py, 133Web services
KeyManager commands,377
KeySet commands, 381-382
KeyStore commands, 378-381
listing, 353-354managing, 352navigating, 353-355overview, 346-350policy sets, 355-371PolicySetManagement
group, 382-390references, 373-376runtimes, 351-352security, 264SIBWebServices group,
374-377SOAP, 347topics, 371-372WebServicesAdmin group,
390-392WS-I profiles, 346-347WSDL, 347, 355
Web Services DefinitionLanguage. See WSDL
WebServicesAdmin group,390-392
Websphere ApplicationServer, overview of, 2
WebSphere Control Program(WSCP), 6
while statements, 42-43WIMManagementCommands
group, 273-274WizardCommands group,
274-275WS-I profiles, 346-347wsadmin program, 113-115.
See also administrationcommands, 126-128connecting, 120options, 115
environmentinitialization, 116-120
JVM initialization, 116usage information, 116
profile script files, 123-126
scripting language, 122sessions, 43tracing, 122
wsadmin.properties file, 133WSASobjects.py, 131-132WSCP (WebSphere Control
Program), 6WSDL (Web Services
Definition Language), 211, 347
exporting, 355WSSecurity policy set, 358
X–Zxrange( [start,] stop[, step] )
method, 86
z/OS methods, 220-223zfill ( width ) method, 74