IBM zSeries Scholars Program WAS for z/OS V5: WAS Operations and Administration Copyright IBM Corporation 2005 Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 3.3.1 Unit Objectives IBM zSeries After completing this unit, you should be able to: Describe the admin options available for WebSphere Manage the WAS runtime with: MVS commands UNIX line commands Scripting commands Use the WSADMIN scripting language to:
Install or uninstall applications Modify an existing application Start or stop servers Initiate node synchronization Create new servers, clusters, virtual hosts, and so on Copyright IBM Corporation 2005 2 System Management: Basic Topology IBM zSeries Cell-wide configuration
repository Extract / Update Node B Deployment Mgr Node A Node Agent Node Agent Server A Server B (App Server)
(App Server) Server A Server B (JMS Server) (App Server) Copyright IBM Corporation 2005 3 System Management: Multi-Node, Distributed Admin IBM zSeries Cell-wide
configuration repository Extract / update Deployment Mgr Cell cfg Server D cfg Config Sync Config Sync Node Agent Server D Cell cfg Node A cfg Node Agent
Server A cfg NodeB cfg Server C cfg Server C (App Server) Server B cfg (App Server) Node B Server A Server B Commands
(JMS Server) (App Server) Configuration Node A Copyright IBM Corporation 2005 4 File Transfer Service IBM zSeries Deployment Mgr Process FileTransfer Servlet FileTransfer Client Node Agent Process
Central Cell configuration repository files Node specific configuration repository files Copyright IBM Corporation 2005 5 Config Sync IBM zSeries Deployment Mgr Process (3) CellSync (1) NodeSync (2) Node Agent Process (4)
Central Cell configuration repository files (1) NodeSync initiates sync operation. (2) CellSync reads master config repository and compares to node copy info. (3) CellSync returns update information and files. (4) NodeSync writes updates to local config files. Node specific configuration repository files Copyright IBM Corporation 2005 6 Names - Defaults and Special Rules IBM zSeries
Cell/Node - Customization Dialog Only base server cell long/short name default to system name base server node long/short name default to system name deployment manager cell long/short names defaults to Network/ deployment manager node long/short names defaults to Manager/ Server - Customization Dialog and AdminConsole/Scripting
Server short name defaults to BBOSnnn, where nnn is unique number in cell Server servant name (server region) defaults to BBOSnnnS Special Servers - result of AddNode operation nodeagent - BBONnnn JMSServer - BBOJnnn Clusters Servers unclustered by default Unclustered servers have special property to hold 'cluster short name' ClusterTransitionName ClusterTransitionName becomes cluster short name when server is promoted to cluster Cluster names in form: BBOCnnn Copyright IBM Corporation 2005 7 Where Names Are Used IBM zSeries START/STOP/CANCEL/FORCE commands Start for app server control process (aka control region):
START BBO5ACR,JOBNAME=, ENV=.. Start (WLM) for app server servant process (aka server region) START BBO5ASR,JOBNAME=S, ENV=.. Stop/CancelForce STOP CANCEL FORCE Proc names for deployment manager are: BBO5DCR/BBO5DSR WLM - cluster short name is APPLENV ARM - registration name is + RACF CBIND - CB..CBIND SERVER - CB..SERVER Copyright IBM Corporation 2005 8 Operating a Base Application Server
IBM zSeries Operating a Base Application Server Copyright IBM Corporation 2005 9 How to Control a Base Application Server IBM zSeries The WebSphere Admin Way Console Command loca line tools ASCB START
STOP MODIFY CANCEL Applicatio n server l USS wsadmin $AdminControl shel l Program JMX API The z/OS Way Address Space
program API MBean JMX JMX MBean server z/OS Commands Basic AppServer Scenarios Starting Servers Stopping Servers Displaying status Copyright IBM Corporation 2005 10 System Management: V5.0 Admin Tools
IBM zSeries Command Line Tools Single node utilities to start server, perform simple functions Located in /bin directory Admin Console Web application - runs in some application server Browser is the client environment (connects to app server) Wsadmin Scripting program Non-graphic admin client 3 modes - interactive, batch, command line Java Admin APIs Allows custom admin programs to be written in Java Public classes and methods documented in the product javadoc, InfoCenter Copyright IBM Corporation 2005 11
UNIX System Services (telnet) Commands IBM zSeries Copyright IBM Corporation 2005 12 Starting up a Base AppServer IBM zSeries Copyright IBM Corporation 2005 13 Start up Base Application Server from z/OS IBM zSeries Start command format START , JOBNAME= , ENV= . .
Operator issues 'start server' command S WSBASEC,JOBNAME=WSBASE,ENV=CB.NB.WSBASE Daemon is started automatically with command; S WSDEMBC,JOBNAME=WSDEMBJ,ENV=CB.CB.WSDEMBJ Servant regions started by WLM with command: S WSBASES,JOBNAME=WSBASES,ENV=CB.NB.WSBASE Results in 3 address spaces running: SDSF DA panel: JOBNAME WSBASE WSDEMBJ WSBASES ProcStep BBOCTL BBODAEMN BBOSR
33.49 Administration tool does not work - why? Copyright IBM Corporation 2005 14 Stopping Base Application Servers IBM zSeries Stopping the Application Server(s) MVS command: "STOP " Admin Console: Servers >> Appl. servers >> (select server) >>"Stop" button MVS commands issued by AppServer running Admin Console application MVS command "STOP " stops them all Recycling servers
Controller regions: Stop & Start server (MVS command or AdminConsole) Servant regions: Use MVS command "CANCEL " WLM will restart them Regular recycling - set custom property server_region_recycle_count Copyright IBM Corporation 2005 15 Operations and Availability Monitoring (SDSF or (E)JES) IBM zSeries Copyright IBM Corporation 2005 16 Starting up an ND Configuration IBM zSeries
Copyright IBM Corporation 2005 17 Multi-System ND Configuration Example IBM zSeries Copyright IBM Corporation 2005 18 Editing the Commands Issued by the AdminConsole IBM zSeries Copyright IBM Corporation 2005 19 Starting Servers - 4 Ways to Do It (at Least)... (Once the Deployment Manager & Node Agents Are Started)
IBM zSeries Copyright IBM Corporation 2005 20 WebSphere Traces IBM zSeries Copyright IBM Corporation 2005 21 Displaying Server Status from z/OS Console IBM zSeries MODIFY Command MODIFY , DISPLAY, SERVERS SERVANTS TRACE
(name, system name, code level of servers) (list of ASIDs of SRs attached to server) (list active trace options for server) SRS, ALL, JAVA JVMHEAP (displays JVM heap info for servers) SRS, ALL SESSIONS (active session information for server) LISTENERS, SERVER F WSBASE,DISPLAY BBOO0173I SERVER WSBASE/WSBASE ACTIVE ON W41 AT LEVEL W510000.
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY F WSBASE,DISPLAY,SERVERS BBOO0182I SERVER ASID BBOO0183I CB /WSDEMBJ 3Ex BBOO0183I WSBASE /WSBASE 3Fx BBOO0188I END OF OUTPUT FOR COMMAND SYSTEM LEVEL W41 W510000 W41 W510000 DISPLAY,SERVERS Copyright IBM Corporation 2005
22 Modify Command: DISPLAY IBM zSeries MODIFY V5T1SV1,DISPLAY,HELP Displays a list of available DISPLAY Options. Modify commands can also be entered using F instead of MODIFY. F V5T1SV1,DISPLAY,HELP Documented in WebSphere Application Server for z/OS V5 Operations and Administration BBOU0772I THE COMMAND DISPLAY, MAY BE FOLLOWED BY ONE OF THE FOLLOWING KEYWORDS: BBOU0773I SERVERS - DISPLAY ACTIVE CONTROL REGIONS BBOU0773I TRACE - DISPLAY INFORMATION ABOUT TRACE SETTINGS BBOU0782I END OF OUTPUT FOR COMMAND DISPLAY,HELP Copyright IBM Corporation 2005
23 Display Work Commands IBM zSeries
f ,display,work, where the can be one of the following: HELP - show these DISPLAY,WORK parameters EJB - EJB requests driven by IIOP: total, current, dispatched & timed out EJB,SRS - EJB requests driven by IIOP by servant region SERVLET - Servlet requests driven by HTTM: total, current, dispatched & timed out SERVLET,SRS - Servlet requests by each servant region MDB - MDB requests driven by JMS: total, current, dispatched & timed out MDB,SRS - MDB requests broken down by servant region ALL - Combines the above for EJBs, servlets, and MDBs ALL,SRS - EJBs, servlets, and MDBs by servant region SUMMARY - total requests, current in progress, and in dispatch for all types SUMMARY,SRS - total received by each SR, current in dispatch in each SR for all types Example: f azsr01a,display,work,servlet
BBOO0255I TIME OF LAST WORK DISPLAY Wed Dec 3 19:17:54 2003 BBOO0256I TOTAL SERVLET REQUESTS 150670 (DELTA 1654) BBOO0257I CURRENT SERVLET REQUESTS 1 BBOO0258I SERVLET REQUESTS IN DISPATCH 0 BBOO0267I TOTAL SERVLET TIMEOUTS 0 (DELTA 0) BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,SERVLET Copyright IBM Corporation 2005 24 Display JVM Heap IBM zSeries Full Syntax: MODIFY BBOASR4,DISPLAY,JVMHEAP MODIFY BBOASR4,DISPLAY,JVMHEAP,SRS MODIFY BBOASR4,DISPLAY,JVMHEAP,ALL Without modifies displays heap information for Control Region With SRS modifier displays heap information for all SRS one at a time
With ALL modifier displays heap information for Control Region and all SRs one at a time. Copyright IBM Corporation 2005 25 Other Handy MVS Commands IBM zSeries
Switch to new SMF parms set smf=99 Change OMVS parms setomvs = value Refresh TCP/IP Profile parms v tcpip,,o,sys1.tcpparms(profilex) Copyright IBM Corporation 2005 26 Tools IBM zSeries Tools n Toys (viascii): http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html jad (decompile java class files): http://kpdus.tripod.com/jad.html Tera Term: ftp://riksun.riken.go.jp/pub/pc/misc/terminal/teraterm/ PFE Editor:
http://www.lancs.ac.uk/people/cpaap/pfe WS_FTP: http://www.ipswitch.com MXI - "MVS sysprog browser": http://www.secltd.co.uk NEDIT: http://www.nedit.org Jinsight profiling & visualization: http://www.alphaworks.ibm.com Copyright IBM Corporation 2005 27 InfoCenter Views: Contents and Search Results IBM zSeries
Copyright IBM Corporation 2005 28 Documentation - WebSphere V5.1 IBM zSeries InfoCenter (basis for the PDF books) http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp Books (PDFs) from WebSphere for z/OS home page http://www.ibm.com/software/webservers/appserv/zos_os390/library/
1. Getting Started 2. Servers & Environment 3. Applications 4. Resources 5. Security 6. System Administration 7. Performance Monitoring & Tuning 8. Problem Determination 9. Program directory 10. Messages & Codes Administrative Console Help Techdocs http://www.ibm.com/support/techdocs
Redbooks http://www.redbooks.ibm.com/ Copyright IBM Corporation 2005 29 IBM zSeries WSADMIN and Scripting Copyright IBM Corporation 2005 30 Java Management Extensions (JMX) Structure IBM zSeries Manage
r Level proprietary management tool web browser protocol adapters MBean Server Agent Level MBean MBean Managem ent
service Instrumentatio n Level MBean Manage d object MBean Manage d object Copyright IBM Corporation 2005 JMX Agent 31
JMX Support in WebSphere for z/OS IBM zSeries Application Server Admin tool Console HTTP Admin tool web application JMX Connectors and Adapters XML/HTTP (SOAP) JMX Connector RMI JMX Connector
USS Shell SOA P JMX wsadmin (script) admin JM client program X API Command line tools WebSphere MBeans RMI JMX
IBM Corporation 2005 all MBeans defined by XML MBeanDescriptor 32 wsadmin - How Does It Work? IBM zSeries wsadmin script SOAP or RMI Connection Appl. Server AdminApp MBean
AdminConfig MBean AdminControl MBean Help MBean Four different scripting objects perform different operations The wsadmin shell script: /usr/lpp/zWebSphere/V5R1M0/bin/wsadmin.sh Important command options: source of script commands Imbedded in command Input from file Interactive
Conifers BIOL 1407 Seed Plants Vascular Tissue Produce seeds Dispersal of offspring Produce pollen Sperm transfer without water Seed Plants Sporophyte dominant Gametophytes Greatly reduced in size Dependent on sporophyte Seed Plants Heterosporous Megaspore Grows into female gametophyte eggs Microspore...
You know the angle formed by the ground range and the airplane's altitude is 90 degrees. You want to use an elevation angle of 37 degrees (formed by the ground range and slant range). ... Family of ISAR Triangles Last...
7. Immediately, Party Express helium quality balloons were affixed to the rims of the flasks. 8. Flasks were gently swirled to suspend the yeast. 9. The flasks were transferred to a 30 °C water bath and incubated for one hour....
Activity - Item Specifications. Create an equation that has a sum of 1012 and use a number line to justify your result Create an equation that has a sum of 1012 , then place those numbers on a number line...
Dhyana mantras are chanted to enter a deep state of meditation. Dhyani - A person in meditation. JNANA. In general - Knowledge or Wisdom or Intellect. ... Adharma: Antonym . KARMA. Action or Deed . There is no proper equivalent...
Website. Goal: optimize presentation of military-relevant activities and services at Cornell. ... Lieutenant Colonel Dan McKeegan, USA. Lieutenant Colonel Bill Sitzabee, USAF. ... Led by Jesse Reising and Chris Howell. Goals and operation of the project. Orient veterans for college...
Ready to download the document? Go ahead and hit continue!