Configuring a shared library using scripting

You can use scripting to configure a shared library for application servers. Shared libraries are files used by multiple applications. Create a shared library to reduce the number of duplicate library files on your system.

Before you begin

There are two ways to complete this task. The example in this topic uses the AdminConfig object to create and configure a shared library. Alternatively, you can use the createSharedLibrary script in the AdminResources script library to configure shared libraries.

The scripting library provides a set of procedures to automate the most common administration functions. You can run each script procedure individually, or combine several procedures to quickly develop new scripts.

Procedure

  1. Start the wsadmin scripting tool.
  2. Identify the server and assign it to the server variable. For example:
    • Using Jacl:

      set serv [$AdminConfig getid /Cell:mycell/Node:mynode/Server:server1/]
    • Using Jython:
      serv = AdminConfig.getid('/Cell:mycell/Node:mynode/Server:server1/')
      print serv
    Table 1. getid command elements. The following table describes each element of the getid command.
    set is a Jacl command
    serv is a variable name
    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object that represents the WebSphere® Application Server configuration
    getid is an AdminConfig command
    Cell is an attribute
    mycell is the value of the attribute
    Node is an attribute
    mynode is the value of the attribute
    Server is an attribute
    server1 is the value of the attribute
    Example output:
    server1(cells/mycell/nodes/mynode/servers/server1|server.xml#Server_1)
  3. Create the shared library in the server. For example:
    • Using Jacl:

      $AdminConfig create Library $serv {{name mySharedLibrary} {classPath c:/mySharedLibraryClasspath}}
    • Using Jython:

      print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath',  
      'c:/mySharedLibraryClasspath']])
      
    Table 2. create Library command elements. The following table describes each element of the create Library command.
    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object that represents the WebSphere Application Server configuration
    create is an AdminConfig command
    Library is an attribute
    serv evaluates the ID of the server that is specified in step number 1
    name is an attribute
    mySharedLibrary is a value of the name attribute
    classPath is an attribute
    /mySharedLibraryClasspath is the value of the classpath attribute
    print is a Jython command
    Example output:
    MysharedLibrary(cells/mycell/nodes/mynode/servers/server1|libraries.xml#Library_1)
  4. Identify the application server from the server and assign it to the appServer variable. For example:
    • Using Jacl:

      set appServer [$AdminConfig list ApplicationServer $serv]
    • Using Jython:
      appServer = AdminConfig.list('ApplicationServer', serv)
      print appServer
    Table 3. list command elements. The following table describes each element of the create list command.
    set is a Jacl command
    appServer is a variable name
    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object that represents the WebSphere Application Server configuration
    list is an AdminConfig command
    ApplicationServer is an attribute
    serv evaluates the ID of the server that is specified in step number 1
    print is a Jython command
    Example output:
    server1(cells/mycell/nodes/mynode/servers/server1|server.xml#ApplicationServer_1
  5. Identify the class loader in the application server and assign it to the classLoader variable. For example:
    • To use the existing class loader that is associated with the server, the following commands use the first class loader:
      • Using Jacl:

        set classLoad [$AdminConfig showAttribute $appServer classloaders]
        set classLoader1 [lindex $classLoad 0]
      • Using Jython:
        classLoad = AdminConfig.showAttribute(appServer, 'classloaders')
        cleanClassLoaders = classLoad[1:len(classLoad)-1]
        classLoader1 = cleanClassLoaders.split(' ')[0]
      Table 4. showAttribute command elements. The following table describes each element of the showAttribute command.
      set is a Jacl command
      classLoad, classLoader1 is a variable name
      $ is a Jacl operator for substituting a variable name with its value
      AdminConfig is an object that represents the WebSphere Application Server configuration
      showAttribute is an AdminConfig command
      appServer evaluates the ID of the application server that is specified in step number 3
      classloaders is an attribute
      print is a Jython command
    • To create a new class loader, issue the following command:
      • Using Jacl:

        set classLoader1 [$AdminConfig create Classloader $appServer {{mode PARENT_FIRST}}]
      • Using Jython:
        classLoader1 = AdminConfig.create('Classloader', appServer, [['mode',  'PARENT_FIRST']])
    Table 5. create Classloader command elements. The following table describes each element of the create Classloader command.
    set is a Jacl command
    classLoader1 is a variable name
    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object that represents the WebSphere Application Server configuration
    create is an AdminConfig command
    Classloader is an attribute
    appServer evaluates the ID of the application server that is specified in step number 3
    mode is an attribute
    PARENT_FIRST is the value of the attribute
    print is a Jython command
    Example output:
    (cells/mycell/nodes/mynode/servers/server1|server.xml#Classloader_1)
  6. Associate the shared library that you created with the application server through the class loader. For example:
    • Using Jacl:

      $AdminConfig create LibraryRef $classLoader1 {{libraryName MyshareLibrary}}
    • Using Jython:
      print AdminConfig.create('LibraryRef', classLoader1, [['libraryName', 'MyshareLibrary']])
    Table 6. create LibraryRef command elements. The following table describes each element of the create LibraryRef command.
    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object that represents the WebSphere Application Server configuration
    create is an AdminConfig command
    LibraryRef is an attribute
    classLoader1 evaluates the ID of the class loader that is specified in step number 4
    libraryName is an attribute
    MyshareLibrary is the value of the attribute
    print is a Jython command
    Example output:
    (cells/mycell/nodes/mynode/servers/server1|server.xml#LibraryRef_1)
  7. Save the configuration changes.
    Use the following command example to save your configuration changes:
    AdminConfig.save()



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 6:15:55 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-express-dist&topic=txml_library
File name: txml_library.html