IBM Systems - iSeries Connecting to iSeries iSeries Access for Web Version 5 Release 4 IBM Systems - iSeries Connecting to iSeries iSeries Access for Web Version 5 Release 4 Note Before using this information and the product it supports, read the information in “Notices,” on page 155. Third Edition (February 2006) This edition applies to version 5, release 4, modification 0 of IBM eServer iSeries Access for Web (5722–XH2) and to all subsequent releases and modifications until otherwise indicated in new editions. This version does not run on all reduced instruction set computer (RISC) models nor does it run on CISC models. © Copyright International Business Machines Corporation 2004, 2006. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents iSeries Access for Web . .1 | Configuring the Apache Software What’s new for V5R4 . .1 | Foundation (ASF) Tomcat Web serving Printable PDF . .4 | environment . .66 License information for iSeries Access for Web . .4 Examples for configuring an existing Web Planning for iSeries Access for Web . .5 application server environment . .70 || iSeries Access for Web offerings . .5 | Configuring WebSphere Application Server || Web application . .6 | V6.1 for i5/OS . .70 || Portal application . .6 | Configuring WebSphere Application Server Security considerations . .7 | Network Deployment V6.1 for i5/OS . .72 Single sign-on considerations . .9 | Configuring WebSphere Application Server Configuring Enterprise Identity Mapping 11 | - Express V6.1 for i5/OS . .74 || Checklist: Planning, installing, and configuring 13 | Configuring WebSphere Application Server Prerequisites for installing iSeries Access for Web 14 | V6.0 for OS/400 . .76 iSeries hardware requirements . .14 Configuring WebSphere Application Server Performance tuning . .15 Network Deployment V6.0 for OS/400 . .77 iSeries software requirements . .15 Configuring WebSphere Application Server SSL usage notes . .17 - Express for iSeries V5.1 . .78 || PTF requirements . .17 | Configuring WebSphere Application Server Web browser requirements . .18 | V5.1 for iSeries . .79 Browser considerations . .18 Configuring WebSphere Application Server Deleting the beta release . .19 - Express for iSeries V5.0 . .80 || Upgrade considerations . .20 Configuring WebSphere Application Server Installing iSeries Access for Web on the iSeries V5.0 for iSeries . .81 server . .22 Configuring ASF Tomcat . .83 Installing iSeries Access for Web . .22 New Web application server considerations. .84 || Installing iSeries Access for Web PTFs . .23 Customizing iSeries Access for Web in a Web iSeries Access for Web in a Web application server application server environment . .85 environment . .24 Policies . .85 Configuring iSeries Access for Web in a Web Default page content . .85 application server environment . .24 Home page . .86 Examples for configuring a new Web Main page. .90 application server environment . .25 Page template . .91 | Configuring integrated Web application | Login template . .95 || server . .26 Using iSeries Access for Web in a Web | Configuring WebSphere Application Server application server environment . .99 || V6.1 for i5/OS . .27 iSeries Access for Web functions . .99 | Configuring WebSphere Application Server 5250 . .99 || Network Deployment V6.1 for i5/OS . .31 Command . 100 | Configuring WebSphere Application Server Customize . 101 || - Express V6.1 for i5/OS . .35 Database . 102 | Configuring WebSphere Application Server Download . 109 || V6.0 for OS/400 . .39 File . .110 | Configuring WebSphere Application Server Jobs . .113 || V6.0 for OS/400 with Single sign-on . .43 Mail . .114 Configuring WebSphere Application Server Messages . .114 Network Deployment V6.0 for OS/400 . .48 My folder . .115 | Configuring WebSphere Application Server My home page . .116 || - Express for iSeries V5.1 . .52 Other . .117 | Configuring WebSphere Application Server Print . .117 || V5.1 for iSeries . .55 iSeries Access for Web URL interfaces . .119 | Configuring WebSphere Application Server NLS considerations . 120 || - Express for iSeries V5.0 . .59 Saving and restoring iSeries Access for Web in a | Configuring WebSphere Application Server Web application server environment. 121 || V5.0 for iSeries . .63 iSeries Access for Web in a portal environment . 122 Portal concepts . 122 Cooperative portlets . 123 © Copyright IBM Corp. 2004, 2006 iii Cross-site scripting . 123 Portal roles . 143 | Configuring iSeries Access for Web in a portal Using iSeries Access for Web in a portal || environment . 124 environment . 144 | Examples for configuring a new portal iSeries Access for Web functions . 144 || environment. 125 | 5250 . 144 | Configuring Workplace Services Express | Command . 144 || V2.6 . 125 | Database . 145 | Configuring WebSphere Portal - Express | Files . 146 || for Multiplatforms V5.0.2 (iSeries) . 128 IFrame . 149 | Configuring WebSphere Portal - Express Other . 149 | for Multiplatforms V5.0.2 (iSeries) with Print . 150 || Single sign-on . 132 NLS considerations . 150 | Examples for configuring an existing portal Saving and restoring iSeries Access for Web in a || environment. 137 portal environment . 151 || Configuring IBM WebSphere Portal V6.0 137 Deleting iSeries Access for Web . 152 | Configuring Workplace Services Express Related information . 152 || V2.6 . 139 | Configuring WebSphere Portal - Express Appendix. Notices . 155 || for Multiplatforms Version 5.0.2 (iSeries) . 141 Programming Interface Information . 156 Customizing iSeries Access for Web in a portal Trademarks . 156 environment . 142 Terms and conditions . 157 Creating pages . 142 || Customizing portlets . 143 iv IBM Systems - iSeries: Connecting to iSeries iSeries Access for Web iSeries Access for Web ™ iSeries Access for Web (5722-XH2) is a key offering in the iSeries Access Family (5722-XW1). It offers ® Web browser-based access to i5/OS resources on iSeries servers. iSeries Access for Web enables end users to leverage business information, applications, and resources across an enterprise by extending the i5/OS resources to the client desktop through a Web browser. iSeries Access for Web has the following advantages: v It is server based. ™ v It is implemented using Java servlet and portlet technology. v It uses industry standard protocols: HTTP, HTTPS, and HTML. v It is lightweight, requiring only a browser on the client. v It provides a 5250 user interface and access to i5/OS resources, such as the iSeries database, integrated file system, printers, printer output, jobs, batch commands, and messages. What’s new for V5R4 For V5R4, iSeries Access for Web contains numerous new functions. New Web application server environment support The following information describes the new support in the Web application server environment: v Supported Web application servers: The iSeries Access for Web licensed program supports the following Web application servers for logical partitions running on i5/OS V5R3, or later. For the latest ® information about this support, see the IBM iSeries Access for Web home page. ® ® | – WebSphere Application Server V6.0 for OS/400 (Base, Express, and Network Deployment | Editions) | – WebSphere Portal for iSeries V5.1.0.1 ™ | – Workplace Services Express V2.5 – WebSphere Application Server - Express for iSeries V5.1 – WebSphere Application Server V5.1 for iSeries – WebSphere Application Server - Express for iSeries V5.0 – WebSphere Application Server V5.0 for iSeries | – WebSphere Portal for iSeries V5.0.2 – ASF Tomcat v Single Sign-on: Prior to V5R4, iSeries Access for Web used HTTP basic authentication to retrieve the iSeries user profile and password from the user. This profile information could not be shared with other iSeries Web-based applications. Sometimes, this resulted in the user being prompted multiple times for the same information by different applications. In V5R4, iSeries Access for Web also supports the WebSphere security model to provide single sign-on support among WebSphere Application Server applications. This support is referred to as application server authentication in the iSeries Access for Web documentation. v Style sheets: The look of the iSeries Access for Web page content is now controlled by external style sheets. Users that have customized templates being displayed by iSeries Access for Web will need to modify their templates to include the new style information. Users can provide their own style sheets if they desire a look different than the default iSeries Access for Web look. v 5250 function: There are several enhancements to 5250 sessions support, including Bypass signon, HTML keyword support, and hotspot support. © Copyright IBM Corp. 2004, 2006 1 v Customize function: You can now transfer configuration data. This enables iSeries Access for Web administrators to transfer 5250 sessions and macros, saved commands, database requests, My Folder items, and policies from one user to another. v Database function: This function has several enhancements: – Open Office: Run SQL and Copy Data to Table now have support for the OpenDocument spreadsheet format. – WebSphere Data Sources: Customize now supports using WebSphere data source names to create database connections. Data source connections can be used with any of the iSeries Access for Web database functions. – Integrated File System Destination: Run SQL now has support for storing SQL results in the iSeries integrated file system. ® – Import Query: Import Query support allows