Front cover WebSphere Portaltal on z/OS Portal architecture and installation Portlet deployment Installation tips and problem determination Tamas Vilaghy Marlon Ebert Lothar Goeggelmann Ashok Iyengar Boris Khalkhal Henry Orton Theresa Tai ibm.com/redbooks International Technical Support Organization WebSphere Portal on z/OS November 2003 SG24-6992-00 Note: Before using this information and the product it supports, read the information in “Notices” on page ix. First Edition (November 2003) This edition applies to Version 4.1 of WebSphere Portal for z/OS. © Copyright International Business Machines Corporation 2003. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Notices . ix Trademarks . x Preface . xi The team that wrote this redbook. xi Become a published author . xiv Comments welcome. xiv Chapter 1. WebSphere Portal architectures . 1 1.1 WebSphere Portal . 2 1.2 WebSphere Portal Enable. 2 1.2.1 WebSphere Portal for z/OS and OS/390 packages . 2 1.2.2 WebSphere Personalization Server . 3 1.2.3 WebSphere Portal Content Publishing . 3 1.2.4 WebSphere Transcoding Publisher . 3 1.2.5 WebSphere Studio Application Developer and the Portal Toolkit . 3 1.2.6 Summary. 4 1.3 Logical tiers . 4 1.4 Logical architectures . 5 1.4.1 Two-tier logical architecture . 5 1.4.2 Three-tier logical architecture . 6 1.5 Physical architectures . 7 1.5.1 Two-tier physical architecture . 8 1.5.2 Three-tier physical architecture. 9 1.6 Our architecture. 10 1.6.1 Our initial architecture . 10 1.6.2 Our preferred architecture. 12 1.6.3 Our overall environment . 13 1.7 Benefits of having WebSphere Portal on z/OS . 16 Chapter 2. Portal installation . 19 2.1 System prerequisites. 20 2.1.1 Hardware prerequisites . 20 2.1.2 Software prerequisites . 20 2.1.3 Our environment . 20 2.2 What is in the box . 21 2.2.1 SMP/E tape for install on z/OS . 21 2.2.2 CD-ROMs for distributed platform. 21 2.3 Preparing to install. 22 © Copyright IBM Corp. 2003. All rights reserved. iii 2.4 SMP/E installation . 22 2.4.1 WebSphere Portal Server Enable offering for z/OS . 23 2.4.2 Prerequisites . 24 2.4.3 UNICODE support. 27 2.4.4 Performing the SMP/E installation . 28 2.4.5 Post SMP/E installation. 31 2.5 Configure and install WebSphere Portal Server . 32 2.5.1 Step one: Read the package contents . 32 2.5.2 Step two: Unpack the product files . 33 2.5.3 Step three: Save the log files . 36 2.5.4 Step four: Edit the setup file . 37 2.5.5 Step five: Set up WLM . 38 2.5.6 Step six: Set up RACF . 39 2.5.7 Step seven: Configure LDAP server . 40 2.5.8 Step eight: Configure DB2 for portal . 51 2.5.9 Step nine: Install Portal on WebSphere Application Server . 55 2.5.10 Step ten: Set up multiple location names (optional) . 57 2.5.11 Step eleven: Start WebSphere Portal . 57 2.5.12 Step twelve: Deploy the base portlets. 58 2.6 WebSphere Transcoding Publisher PTF2. 63 2.7 WebSphere Portal Content Publishing PTF2 . 64 2.8 Configuring the HTTP plug-in . 72 2.8.1 Edit HTTP Server httpd.conf file . 73 2.8.2 Create a plugin-cfg.xml file . 74 2.8.3 Modify WebSphere Web container settings . 75 2.8.4 Update Portal redirection mechanism . 75 2.8.5 Test the login redirection. 76 2.9 Installation worksheet . 78 Chapter 3. Development environment installation. 93 3.1 Software provided on CD-ROM. 94 3.2 Portlet development and debugging . 97 3.2.1 Installing the Portal Toolkit with Application Developer. 98 3.3 WebSphere Portal Content Publishing . 105 3.3.1 Installing the WPCP authoring environment . 106 3.3.2 Installing the WPCP development environment . 117 Chapter 4. Portal administration . 121 4.1 Administrative privileges . 122 4.1.1 Delegating administration . 123 4.2 Portal customization . 125 4.2.1 Changing themes . 128 4.3 Adding a new portlet skin . 129 iv WebSphere Portal on z/OS 4.3.1 Create the new skin directory . 130 4.3.2 Add the skin to WebSphere Portal . 130 4.4 Adding a new portal theme . 133 4.4.1 Create the new theme directory . 133 4.4.2 Add the theme to WebSphere Portal . 134 4.5 Log Files . 136 4.6 Device support . 137 4.7 Managing Portlets in z/OS. 141 4.7.1 Updating portlets . 142 4.7.2 Installed but not deployed portlets . 142 4.8 Managing the portal environment . 142 Chapter 5. WebSphere Portal in a Sysplex . 147 5.1 Configuring WebSphere Portal in a Sysplex . 148 5.2 Setting up the infrastructure . 148 5.2.1 Sysplex distributor. 148 5.2.2 Cluster addresses . 149 5.2.3 XCF addresses . ..