Script Libraries in WebSphere Application Server V7

Transcription

1 Script Libraries in WebSphere Application Server V7 Ganesan Karuppaiah & Vikram Thommandru WebSphere Application Server L2 Support 17 February 2011

2 Agenda Overview WebSphere Administration Overview of wsadmin Scripting Library RAD and Scripting Library Troubleshooting Questions and Answers 2 of 37

3 Overview WebSphere Administration 3 of 37

4 WebSphere Administration General tool sets that are available with most editions of the product Command-line tools Administrative Console Scripting tool Java programming APIs Command-Line Tools Simple programs that you run from a command prompt to perform specific tasks. Ex:startServer, addnode 4 of 37

5 WebSphere Administration Administrative Console The Administrative Console is a graphical interface that provides many administration features. Scripting tool wsadmin, is a powerful, non-graphical tool that lets you execute administrative operations interactively or from a script file (jython & jacl) Java programming APIs Using the administrative programming API, you can write your own custom administration client to perform specific administration functions WebSphere Application Server public APIs and limitations 5 of 37

6 Overview wsadmin 6 of 37

7 wsadmin The wsadmin tool operates on configurations and running objects through set of management objects. AdminConfig, AdminControl, AdminApp, AdminTask and Help. These low level JMX objects can be complicated. To help the administrator WebSphere provides multiple options. Information Center Samples Administrative console command assistance Interactive Mode AdminTask Jython Scripting library 7 of 37

8 wsadmin challenges 8 of 37

9 wsadmin challenges Create a JDBC Provider 1. Identify the parent ID and assign it to the node variable. node = AdminConfig.getid('/Cell:mycell/Node:mynode/') print node Example output: mynode(cells/mycell/nodes/mynode node.xml#node_1) 4. Create a new JDBC provider using node as the parent: AdminConfig.create('JDBCProvider', node, jdbcattrs) Example output: JDBC1(cells/mycell/nodes/mynode resources.xml#jdbcprovider_1) es 2. Identify the required attributes: print AdminConfig.required('JDBCProvider') Example output: Attribute name Type String 5.Save the changes implementationclassname String AdminConfig.save() 3. Set up the required attributes and assign it to the jdbcattrs variable. n1 = ['name', 'JDBC1'] implcn = ['implementationclassname', 'myclass'] jdbcattrs = [n1, implcn] print jdbcattrs Example output: [['name', 'JDBC1'], ['implementationclassname', 'myclass']] 9 of 37

10 wsadmin challenges AdminTask is another easy way to complete the particular wsadmin task without going thru multiple steps. Using interactive command makes scripting experience very easy. The administrative (AdminTask) commands do not replace any existing configuration commands or running object management commands but provide a way to access these commands and organize the inputs. Ex: AdminTask.createDatasource('-interactive') 10 of 37

11 wsadmin challenges Random search using.ex: wsadmin JDBC create 11 of 37

12 wsadmin challenges Direct menu view Network Deployment Scripting the application serving environment (wsadmin) Scripting for Data access resources Problem: You may not find the exact samples in the information center. 12 of 37

13 wsadmin challenges Enabling console command Assistance 13 of 37

14 wsadmin challenges The table lists the components and the actions in the administrative console that have command assistance for a particular component. version=compass&product=was-nd-dist&topic=rconcommandassist 14 of 37

15 Jython Scripting library 15 of 37

16 Jython Scripting library Scripting using low level JMX objects like AdminConfig and AdminTask can be complicated. WebSphere also provides a high level set of Jython objects (not JMX MBeans) that wrap the low level objects and simplify the scripting. Internally these Jython objects use the same JMX objects like AdminApp, AdminConfig and AdminControl. 16 of 37

17 Jython Scripting library The Jython script library provides a set of procedures to automate the most common WebSphere Application Server V7.0 administration functions. For example, you can use the script library to easily configure servers, applications, mail settings, resources, nodes, business-level applications, clusters, authorization groups, and more. You can run each script procedure individually, or combine several procedures to quickly develop new scripts. 17 of 37

18 RAD and Scripting Library 18 of 37

19 Scripting in RAD Rational Application Developer (RAD) adds some functions related to scripting. There is a special type of project in RAD for Jython code. You can create and maintain resources for Jython scripts in Jython projects. Scripts can be run against a specified WebSphere installation and profile in the workbench. 19 of 37

20 RAD- Creating Jython Projects 1. In the menu bar, select File > New > Project. The New Project wizard opens. 2. Expand the Jython folder and select Jython Project. Click Next. The New Jython Project wizard opens. 3. In the Project name, type a name for the new Jython project. 4. Click Finish. 20 of 37

21 RAD- Creating Jython Projects Related tasks 21 of 37

22 RAD- Creating Jython script files 1. In the menu bar, select File > New > Other. The New wizard opens. 2. Expand the Jython folder and select Jython Script File. Click Next. 3. In the Parent folder field, specify the path of an existing project folder in the current workspace where you want to store the new Jython script file. You must specify a project folder that already exists in the workspace. 4. In the File name field, type a name for your new Jython script file. The file extension must be.py or.jy. 5. Click Finish to create the Jython script file. 22 of 37

23 RAD- Creating Jython Projects Related tasks 23 of 37

24 RAD- Enabling Jython script library You can enable 'Jython script library' in RAD. This makes existing Jython Objects from script library available for RAD Jython project. If you are writing scripts that will run against a WebSphere Application Server v7.0, you can take advantage of the Jython script library newly added for Version 7.0 release of WebSphere Application Server. Restrictions If you are writing scripts against a WebSphere Application Server v6.1 or earlier, you cannot use the Jython script library. The scripts in the Jython script library are only supported for WebSphere Application Server v of 37

25 RAD- Enabling Jython script library To display the Jython script library as content assists or tips in the Jython editor: 1. Select from the toolbar Windows > Preferences > Jython. The Jython preference page opens. 2. Select and enable the Enable content assist for WebSphere Application V7 script libraries check box. 25 of 37

26 RAD- Jython script library In Navigator view, expand the Jython project that contains the Jython script file you want to use content assists or tips. Right-click the Jython script file. In the pop-up menu, select Open With > Jython Editor. 26 of 37

27 RAD- Jython script library Place your cursor in a partially entered string of code in the Jython editor: Start content assists, by pressing Ctrl+Space Start content tips, by pressing Ctrl+Shift+Space If the Jython editor finds valid candidates for this position, a list of possible completions is shown in a floating window. 27 of 37

28 Examples using Scripting Libraries. createjdbcprovider This script creates a JDBC provider in your environment. The script returns the configuration ID of the new JDBC provider. To run the script, specify the node name, server name, JDBC provider, and implementation class arguments. You can optionally specify attributes. 28 of 37

29 Scripting Libraries Command usage AdminJDBC.createJDBCProvider(nodeName, servername, jdbcprovider, implementationclass, attributes) The following example command contains required attributes only: C:\WAS7\AppServer\profiles\dmgr01\bin>wsadmin -lang jython WASX7209I: Connected to process "dmgr" on node vikramnode using SOAP connector; The type of process is: DeploymentManager WASX7031I: For help, enter: "print Help.help() wsadmin> wsadmin>adminjdbc.createjdbcprovider( MyNode01", "server1", "myjdbcprovider", "com.ibm.db2.jcc.db2connectionpooldatasource") 29 of 37

30 Examples using Scripting Libraries. Output of the command : AdminJDBC: createjdbcprovider Scope: node MyNode01 server server1 JDBC provider: name implclassname myjdbcprovider com.ibm.db2.jcc.db2connectionpooldatasource Optional attributes: otherattributeslist Usage: AdminJDBC.createJDBCProvider("CNameNode06", "server1", "myjdbcprovider", "com.ibm.db2.jcc.db2connectionpooldatasource") 'myjdbcprovider(cells/vikramcell/nodes/cnamenode06/servers/server1 resources.xml#jdbcprovider_ ) wsadmin> 30 of 37

31 Examples using Scripting Libraries. Modifying class loader modes for applications Using wsadmin scripting libraries : Syntax: AdminApplication.configureClassLoaderLoadingModeForAnApplication (appname, classloadermode) Example usage AdminApplication.configureClassLoaderLoadingModeForAnApplication ( ivtapp", "PARENT_LAST") Lets compare this with regular (direct) AdminConfig object : Step 1: Retrieve the configuration ID of the object that you want to modify and set it to the dep variable. For example: dep = AdminConfig.getid('/Deployment:ivtApp/') Step 2: Identify the deployed object and set it to the depobject variable. For example: depobject = AdminConfig.showAttribute(dep, 'deployedobject') Step 3: Identify the class loader and set it to the classldr variable. For example: classldr = AdminConfig.showAttribute(depObject, 'classloader') 31 of 37

32 Examples using Scripting Libraries. Step 4: Show the current attribute values of the configuration object with the showall command, for example: print AdminConfig.showall(classldr) Example output: [libraries []] [mode PARENT_FIRST] Step 5: Modify the attributes of the configuration object with the modify command, for example: AdminConfig.modify(classldr, [['mode', 'PARENT_LAST']]) Step 6: Save the configuration changes. Use the following command example to save your configuration changes: AdminConfig.save() Step 7: Verify the changes that you made to the attribute value with the showall command, for example: AdminConfig.showall(classldr) Example output: [libraries []] [mode PARENT_LAST] 32 of 37

33 Troubleshooting & References 33 of 37

34 Problem Troubleshooting & References MustGather: wsadmin problems in WebSphere Application Server InfoCenter -Jython script library topic=/com.ibm.websphere.nd.doc/info/ae/ae/welc_ref_adm_jython.html RedBook: WebSphere Application Server V7:Administration with Scripting 34 of 37

35 Additional WebSphere Product Resources Learn about upcoming WebSphere Support Technical Exchange webcasts, and access previously recorded presentations at: Discover the latest trends in WebSphere Technology and implementation, participate in technically-focused briefings, webcasts and podcasts at: Join the Global WebSphere Community: Access key product show-me demos and tutorials by visiting IBM Education Assistant: View a webcast replay with step-by-step instructions for using the Service Request (SR) tool for submitting problems electronically: Sign up to receive weekly technical My Notifications s: 35 of 37

36 We Want to Hear From You! Tell us about what you want to learn Suggestions for future topics Improvements and comments about our webcasts We want to hear everything you have to say! Please send your suggestions and comments to: 36 of 37

37 Questions and Answers 37 of 37