WebSphere

 

Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

 

Work with the Portal Scripting Interface

Learn more about the different modes that you can use with the Portal Scripting Interface.

You can use the Portal Scripting Interface in any of the following ways:

 

Prerequisite information

The Portal Scripting Interface provided by IBM® WebSphere® Portal Express is based on the wsadmin scripting tool that is provided by IBM WebSphere Application Server. Therefore, before you use the Portal Scripting Interface, familiarize yourself with how to use the WebSphere Application Server wsadmin tool. Refer to the information in the WebSphere Application Server Version 6.0.2 information center. Select the following topic: Administering applications and their environment > Using the administrative clients > Using scripting (wsadmin) > Getting started with scripting >Starting the wsadmin scripting client.

You find the WebSphere Application Server information center on the following Web site: http://www.ibm.com/software/webservers/appserv/was/library/.

 

Interactive mode

Use the interactive mode if you want to interact directly and dynamically with the portal to perform simple administrative tasks that should only be executed once. For example, the administrator wants to modify the permissions of a page for a certain principal, or the administrator wants to add a portlet to a page. Use the interactive mode if you do not intend to repeat the operation.

Before initiating a session in interactive mode, make sure that WebSphere Portal Express is running. The portal script client is located in the WebSphere Portal Express installation directory:

You can invoke the portal script client using the following commands:

The following procedures provide examples:

  1. If WebSphere Application Server security is disabled, use one of the following commands:

    • Linux:

      ./wpscript.sh -port port_number

    • i5/OS:

      wpscript.sh -port port_number

    • Windows:

      wpscript.bat -port port_number

    If WebSphere Application Server security is enabled, specify a user ID and password during login as shown in the following example:

    • Linux:

      ./wpscript.sh -port port_number -user admin_userid -password admin_password

    • i5/OS:

      wpscript.sh -port port_number -user admin_userid -password admin_password

    • Windows:

      wpscript.bat -port port_number -user admin_userid -password admin_password

    The most basic parameters are explained briefly in the following table. For more detailed information refer to the WebSphere Application Server documentation as listed under Prerequisite information.

    Parameter Description
    -conntype The type of connection that should be established between scripting. Valid connection types include:

    • SOAP

    • RMI

    • NONE

    The default value is SOAP. This parameter is optional. Use the -conntype NONE option to run in local mode. The result is that the scripting client is not connected to a running server. If the connection type NONE is selected, the scripting beans are inactive and cannot be used for administration, with the exception of the help command.

    -port The name of the connection port. The default port is 10033. This parameter is optional.

    Notes:

    1. The port_number depends on values chosen during installation. You can verify the value that is set for the WpsSoapPort in the /config/wpconfig.properties file found in the appropriate directory below:

    2. If you are running wpscript on a machine that is part of a cell managed by a deployment manager, use -port 8879 instead of -port 10033 .
    -user The user ID under which you establish the connection. This parameter can be mandatory, depending on your security configuration.
    -password The password for the user ID under which you establish the connection.

  2. Log on to the portal using the following script command: $Portal login wpsadmin wpsadmin

  3. Issue portal script commands as required. For more information about available beans, see Command reference for Portal Scripting Interface.

  4. After you have completed all tasks by the portal scripting interface, close and exit the script processor. All changes that you committed are applied to the portal configuration.

For a detailed syntax and description of the scripting commands, refer to the Command reference for Portal Scripting Interface. For a description about using the Portal Scripting client in a clustered environment, go to the Working with the Portal Scripting Interface in a cluster section.

 

Script mode

Use the script mode to apply predefined changes to the configuration of a portal.

The wpscript tool executes a JACL script that contains the administrative operations. The scripting client inherits the JACL processor from wsadmin, so an administrator can exploit the JACL scripting language, in order to write re-usable, extendable administration scripts. This mode is typically preferred if reproducible administration tasks are created: For example, the administrator can write a JACL script that produces a complete page subtree, and adds individual page layouts and portlets on each page.

Users who have access permission to perform XML configuration interface requests can change configurations of all resources. The Portal Scripting Interface is mostly consistent with the administration model that is exposed by the Portal user interface.

Before using script mode, make sure that WebSphere Portal Express is running and a portal script file is available. Use the following procedure.

  1. Update the script file with the appropriate credentials, if required.

  2. Use the following command to launch the script processor tool: 

    wpscript.sh -port port_number -f script_file_name.jacl
    This initializes the interactive script environment of the portal script processor.

  3. Check the output from the script processor to ensure that no errors occurred during the execution of the script.

All changes committed by the script are immediately applied to the portal configuration.

For detailed syntax and description of the script commands, see Command reference for Portal Scripting Interface.

Here is an example of a portal script file called "testme.jacl": 

# Scripting bean example: create a simple page (multi-column Layout)           
#                                                                              

# Procedure: create a multi-column page below the page that is currently       
# selected, and place the given portlets into the layout.                      
#                                                                              
# parameters:                                                                  
#   name              The name of the page                                     
#   portlet_names     A list of portlet names.                                 
# returns:
#   oid               The id of the page that has been created                 
proc create_multi_col_page { name portlet_names } {                            
  global Content Layout Portlet                                                
    set thePage [$Content create page $name html]                              
    $Content select $thePage                                                   
    set lyt0 [$Layout create container horizontal select]                      
    foreach pn $portlet_names {                                                
      set pid [$Portlet find portlet cn $pn]                                   
      $Layout create control $pid                                              
    }                                                                          
  return $thePage                                                              
}                                                                              
                                                                               
# main code starts here                                                        
                                                                               
# set User ID/ pwd for portal Login command                                    
# Hint: User ID and passwords should normally not be placed inside a           
# configuration script; better use property files or command line arguments    
set user portaladmin                                                           
set pwd  adminpwd                                                              
$Portal login $user $pwd                                                       
                                                                               
# determine and select the parent of the page to be created.                   
# In this example, This is the "Home" label.                              
$Content select [$Content find all uniquename "ibm.portal.Home"]                 
                                                                               
# Invoke the page creation procedure. The label of the page is "My test page", 
# portlets to be added are the workd clock portlet, and the welcome portlet.   
set newbie [create_multi_col_page "A Page" { "World_Clock" "Welcome_to_WebSphere_Portal" } ]
                                                                               
puts "ok, we are done."

This script creates a new page with the title "A page". This page resides below the "Home " label. The page contains two portlets, which are arranged horizontally.

The scripts can receive parametric information externally, by using one of the JACL feature listed below:

A JACL script can access command line arguments with the JACL scripting variables argc (that holds the number of command line arguments) and argv (that holds the command line arguments themselves).

Example: In the testme.jacl portal script file shown above, delete the following statements: 

set user portaladmin                                                           
set pwd  adminpwd

and replace it with the following code: 

if { $argc != 2 }  {
    puts "invocation syntax: wpscript testme.jacl <user> <pwd>"
	  exit   }
  set user [lindex $argv 0]
  set pwd [lindex $argv 1]

The security-sensitive user name and password are removed from the JACL script. The modified code expects the user ID and password to be specified as command line arguments, for example: 

wpscript.sh -port port_number -f testme.jacl portaladmin adminpwd

 

Run scripting commands in a profile

A profile is a script that runs before the main script, or before entering interactive mode. Profiles can be used to set up environment specific behavior or user specific data. Profiles are specified when invoking wpscript, using the -profile parameter. For example, the login command can be placed in a profile. The following example of a profile, which can be named mylogin.jacl, would look like this: 

# scripting profile 
  # contains log-in procedure on portal with disabled security   if { $argc != 2 }  {
    puts "invocation syntax: wpscript -f testme.jacl -profile mylogin.jacl <user> <pwd>"
	  exit   }
  set user [lindex $argv 0]
  set pwd [lindex $argv 1]
  $Portal login $user $pwd

Remove or comment out the following statements in the testme.jacl script file: 

# scripting profile 
  # contains log-in procedure on portal with disabled security   if { $argc != 2 }  {
    puts "invocation syntax: wpscript testme.jacl <user> <pwd>"
    exitoy   }
  set user [lindex $argv 0]
  set pwd [lindex $argv 1]
  $Portal login $user $pwd

Then, invoke the mylogin.jacl script, for example, as follows: 

wpscript.sh -port port_number -profile mylogin.jacl -f testme.jacl portaladmin adminpwd

The benefit of this change is that the environment-specific login procedure is removed from the administration script. For systems with enabled WebSphere Application Server security, it is as follows: 

  # scripting profile 
  # contains log-in procedure on portal with enabled security   $Portal login

 

Related information

 

Parent topic:

Portal Scripting Interface