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.

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.

   Element	Description
   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.

   Following are examples of how to create the shared library using either Jacl or Jython.

   • Using Jacl:

     

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

     

     $AdminConfig create Library $serv {{name mySharedLibrary} {classPath /mySharedLibraryClasspath}}

     

     $AdminConfig create Library $serv {{name mySharedLibrary} {classPath 
     /home/myProfile/mySharedLibraryClasspath}}

   • Using Jython:

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath',  
     'c:/mySharedLibraryClasspath']])
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath',  
     '/mySharedLibraryClasspath']])
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath',  
     'home/myProfile/mySharedLibraryClasspath']])
     

   Avoid trouble:

   • If you are using Jython, and the classpath does not contain any spaces, you can use a semicolon (;) or a space as a separator. For example:

     AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'],              
     ['classPath','test1.jar;test2.jar;test3.jar']]) 

     or

     AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'],              
     ['classPath','test1.jar test2.jar test3.jar']])   

   • If you are using Jacl, and the classpath contains one or more spaces, you must add additional braces or quotation marks around the classpath. For example:

     $AdminConfig create Library $serv {{name mySharedLibrary} {classPath {c:/Program Files/JDBC Driver/test.jar}}}

     or

     $AdminConfig create Library $serv {{name mySharedLibrary} {classPath "c:/Program Files/JDBC Driver/test.jar"}}

   • If you are using Jython, and the classpath contains one or more spaces, you must use a semicolon (;) as a separator. For example:

     AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'],              
     ['classPath','c:/Program Files/JDBC Driver/test.jar;a.jar']])  

     or if there is only one path:

     AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'],              
     ['classPath','test1.jar test2.jar test3.jar']])   

   • If you are using Jython, and the classpath contains one or more spaces, you must add additional brackets or quotation marks around the classpath. For example:

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], [['classPath',  
     'c:/Program Files/JDBC Driver/test.jar']]])
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], [['classPath',  
     '/Program Files/JDBC Driver/test.jar']]])
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], [['classPath',  
     'home/myProfile/Program Files/JDBC Driver/test.jar']]])
     

     or

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath',  
     "'c:/Program Files/JDBC Driver/test.jar'"]])
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath',  
     "'/Program Files/JDBC Driver/test.jar'"]])
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath',  
     "'home/myProfile/Program Files/JDBC Driver/test.jar'"]])
     

   • Using Jython, if the classpath contains more than one path, you can use either list syntax, or string syntax delimited by a semicolon to specify the multiple classpaths.

     Using list syntax :

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], [classPath [test1.jar test2.jar test3.jar]]]')
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath [test1.jar test2.jar test3.jar]]]')
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath [test1.jar test2.jar test3.jar]]]')
     

     Using string syntax delimited by a semicolon:

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], [classPath,'test1.jar;test2.jar;test3.jar']])
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], [classPath,'test1.jar;test2.jar;test3.jar']])
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], [classPath,'test1.jar;test2.jar;test3.jar']])
     

   • Using Jython, if the classpath contains more than one path, and one of those classpaths contain one or more spaces, enclose the path string that contains the spaces with quotation marks. For example:

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], [classPath [test1.jar "C:/Program Files/JDBC Driver/test.jar" test3.jar]]]')
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath [test1.jar "C:/Program Files/JDBC Driver/test.jar" test3.jar]]]')
     

     

     print AdminConfig.create('Library', serv, [['name', 'mySharedLibrary'], ['classPath [test1.jar "C:/Program Files/JDBC Driver/test.jar" test3.jar]]]')
     

   Table 2. create Library command elements . The following table describes each element of the create Library command.

   Element	Description
   $	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.

   Element	Description
   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.

     Element	Description
     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.

   Element	Description
   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.

   Element	Description
   $	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()

8. Synchronize the node.
   Use the syncActiveNode or syncNode scripts in the AdminNodeManagement script library to propagate the configuration changes to node or nodes.

   • Use the syncActiveNodes script to propagate the changes to each node in the cell, as the following example demonstrates:

     AdminNodeManagement.syncActiveNodes()

   • Use the syncNode script to propagate the changes to a specific node, as the following example demonstrates:

     AdminNodeManagement.syncNode("myNode")