ibm.com /redbooks © copyright ibm corp. 2004. all rights reserved. wp07 itso iseries technical...

ibm.com/redbooks© Copyright IBM Corp. 2004. All rights reserved.

WP07

ITSO iSeries Technical Forum

WebSphere Portal Express– Installation, Configuration and Maintenance on iSeries (2 of 2)

Daniel Hill


Objectives

•Explain the WebSphere Portal Version 5 configuration process

•Discuss the importance of several properties files

•Discuss the mechanics of using configuration scripts

•Discuss the use of configuration templates

•Discuss a typical Portal configuration tasks

•Discuss the Portal configuration wizard in the IBM Web Administration for iSeries tool

•Explain the configuration scenarios configured by the Portal configuration wizard


Configuration Options

• Install and Configure

• Portal configuration wizard in Web Administration for iSeries

• Ant Configuration Scripts– WPSconfig.sh script– wpconfig.properties file


WP 5 Installation and Configuration - Split Process

Installation

Configuration

• Configuration separate from installation

• Helpful for:– Changing parameters without

reinstall– OEM Support and custom

configuration situations

• Able to configure without reinstalling Portal

• Handled by Ant tasks


Configuration without Reinstall

• Modify Portal security mode

• Modify LDAP properties

• Configure an external HTTP server

• Configure Lotus Collaborative Components

• Deploy Document Management portlets

• Change runtime properties– Change Home page– Change Context root


Configuring WebSphere Portal V5

• All configuration done via configuration scripts – Invoke using scripting interface provided by the

WebSphere Portal v5– Use common properties file for use by the different

tasks (wpconfig.properties)– Validation of properties done prior to execution of task– Some post-task validation done as well– Consists of Scenarios, Tasks, and Actions

• Scenarios are large sets of operations (e.g. basic Portal configuration)

• Tasks are individual operations that are documented for use

• Actions are lower level (often atomic) operations that are not documented and are invoked from tasks


WP 5 Configuration - Scenarios

Scenario – tasks and actions grouped together to configure a Portal to a known specification.

• Example:– Basic-configuration for install

Scenario - Example

   <!-- <target name="basic-config" depends="init" > <antcall target="action-check-portal-admin-pwd"/> <antcall target="action-check-virtualhost-is-present"/> <antcall target="start-admin-server" /> <antcall target="action-check-before-init-database" /> <antcall target="action-init-database-wps" /> <antcall target="action-init-database-wmm-dev" /> <antcall target="setup-was" /> <antcall target="action-config-portal-dev" /> <antcall target="setup-transcoding" /> <antcall target="setup-productivity-components" /> <antcall target="wpcpconfigure" /> </target>


WP 5 Configuration - Tasks

• Task – group of actions, that contains a complete configuration step

• Examples:– Security configuration– Task1 = Action1 + Action2 + Action4– Task2 = Action2 + Action3 + Action5 + Action6

• Tasks always perform a pre- and post-condition check

• An administrator will execute tasks


These sets of actions and tasks

comprise

the task.

Task Example - enable-security-ldap • # ################################################################################## • # Name: enable-security-ldap • # • # Description: Task to set WebSphere AppServer security to use the LDAP directory• # • # Usage: Invoked as part of the WPSconfig script file. • # • # Syntax: • # WPSconfig.{bat | sh} enable-security-ldap • # • # Inputs: None • # • # Assumptions/Prerequisites: WebSphere AppServer must be running and • # the WPS50 and WMM databases must be created and initialized. • # Error conditions: • # WebSphere AppServer is not running or a connection to the databases can not be• # established • ###################################################################################

• -->• <target name="enable-security-ldap" depends="init, Stop-portal-server,start-admin-server"> • <antcall target="validate-ldap"/> • <antcall target="action-secure-portal-ldap"/> • <antcall target="action-cfg-was-security-ldap"/> • <antcall target="stop-portal-server"/> • <antcall target="action-create-deployment-credentials"/> • </target>


WP 5 Configuration - Actions

• Action - single configuration step

• Examples:– Create WMM database– Create Portal database– Enable WAS global security– Set context root

• Include the configuration logic– Execute sh files– Execute wsadmin/sql scripts

• Actions are never run directly by the administartor– Only the combination of actions result in a valid configuration


Action Example - action-secure-portal-ldap

• -->• <target name="action-secure-portal-ldap"> • <antcall target="action-init-database-wmm-lookaside" /> • <antcall target="action-update-database-wps-ldap"/> • <antcall target="action-config-portal-ldap"/> • <antcall target="action-secure-configservice"/> • <antcall target="action-update-java-policy"/> • </target>

These are all Actions.


Putting It All Together

WPSconfig.sh

wpconfig.properties•WAS Configuration Properties•Portal Configuration Properties•LDAP Configuration Properties

wpconfig.xml•Targets loaded•Tasks available

External targets•/config/action/validate.xml•And other xml files

Validate-ldap•Task loaded into wpconfig.xml

1

2

3

45


Portal Configuration Invocation

WPSconfig.sh task_name [task_name …]

[–Dproperty=value ...]

[–Dproperty=value ]• Task name is a documented task (e.g. database-transfer-export)

• If no task name given, basic usage description is displayed

• Properties specified on command line (with –D flag) supercede those with same name in Portal configuration properties file

• Certain properties apply to many tasks and are typically put on command line:–parentProperties–childProperties –language–logfile–tracefile–DBSafeMode–CheckVersions–validate–help


-D flag

• Value only persists while the task is running

• Value supercedes that in wpconfig.properties -- temporarily

• Value in the wpconfig.properties file is not overwritten


Portal Configuration Templates

• Templates are a special use of properties files

• Included with WebSphere Portal– Located in /qibm/proddata/portalserver5/config/helpers/

• Provides only the properties needed for a particular task

• Can be customized for a specific resource type (example: only for a DB2 database)

• Administrator can create customized templates

• Examples:

– Template to configure Portal to use WebSphere Application Server security with Domino as its LDAP directory

– Template to configure Portal to use WebSphere Application Server security with IBM Directory Server as its LDAP directory

– Template to configure HTTP server


Using Portal Configuration Templates

• Edit or create a configuration template for your environment

• Run the configuration program (WPSConfig.sh)

• Specify the configuration template as a parent properties file

Example:

WPSconfig.sh -DparentProperties=config/helpers/config_http.properties-DSaveParentProperties=true


Configuration Properties File: Precedence

-D flag on command line

Parent properties file on command line

Values from wpconfig.properties file

Properties in Configuration File (build.xml)

Order of precedence

1

2

3

4


Portal configuration wizard scenarios

DB2 UDB for OS/400

WebSphere Portal

IBM HTTP Server

WebSphere Application Server

iSeries Server

Remote Database Scenario

DB2 UDB for OS/400

WebSphere Portal

IBM HTTP Server


iSeries Server iSeries Server

Quick Install Scenario



DB2 UDB for OS/400

WebSphere Portal

IBM HTTP Server


iSeries Server

Authentication Using LDAP Directory Scenario

LDAP



DB2 UDB for OS/400

WebSphere Portal

IBM HTTP Server


iSeries Server

Domino LDAP

Domino Server

Sametime Server

QuickPlace Server

iSeries Server

WebSphere Portal with Lotus Collaboration Options


IBM WebSphere Portal v5.0 Education OfferingsSW531 / PW551G -

IBM WebSphere Portal Version 5.0 Application Development

WP600 / PW561G – Creating Custom

Portlets Using Lotus Collaborative Components

SW530 / PW311GIBM WebSphere Portal Version 5.0

Installation and Deployment

SW535 / AS751IBM WebSphere Portal – Express V5.0.2

Implementation on iSeries

WP500 [Distance Learning] Creating Portlets with

IBM Portlet Builder for Domino


Administration


Security


Rapid Portlet Programming

SW741 – IBM WebSphere Portal Version 5.0 Fundamentals

[Distance Learning]

http://www-306.ibm.com/software/info/education/http://www-106.ibm.com/developerworks/websphere/library/tutorials/dl/sw741/http://www-3.ibm.com/software/genservers/portal/education/

New


Summary

•Provided an overview of the WebSphere Portal Version 5 configuration process

•Discussed the configuration steps to configure Portal authentication using WebSphere Global Security and an LDAP server

•Discussed the importance of several properties files

•Discussed the mechanics of using configuration scripts

•Discussed the use of configuration templates

•Discussed several configuration examples

•Discussed Portal configuration wizard in IBM Web Administration for iSeries

ibm.com /redbooks © copyright ibm corp. 2004. all rights reserved. wp07 itso iseries technical...

Documents