IBM Workplace Collaboration Services : Release 2.5 Deployment Guide

by Monson, Philip

• ISBN13: 9780738493695
• ISBN10: 0738493694
• Format: Paperback
• Copyright: 2005-10-30
• Publisher: Vervante

Table of Contents

Notices	xiii
Trademarks	xiv
Preface	xv
The team that wrote this redbook	xv
Become a published author	xviii
Comments welcome	xviii
Introduction to IBM Workplace Collaboration Services, Release 2.5	1	(20)
Overview of IBM Workplace Collaboration Services	2	(9)
Team Collaboration services	3	(1)
Document services	3	(1)
Messaging services	4	(1)
Web Content Management services	4	(1)
Learning services	5	(1)
Common collaborative environment	5	(1)
Feature overview	6	(1)
Benefits overview	7	(4)
Architectural overview	11	(2)
Overview of the installation process	13	(1)
Foundation products overview	14	(3)
Structure of this IBM Redbook	17	(4)
Planning	21	(20)
System requirements	22	(7)
Hardware requirements	22	(1)
Network connectivity requirements	22	(1)
Software requirements	23	(3)
Workplace Managed Client hardware and software requirements	26	(1)
Client software and operating system requirements	27	(2)
Skill requirements	29	(1)
Deployment scenarios	30	(3)
Product licensing	33	(1)
Installation work sheets	34	(4)
Successful deployment considerations	38	(3)
Configuring LDAP for Workplace Collaboration Services	41	(94)
Introduction	42	(2)
WebSphere Member Manager	44	(3)
General overview of WebSphere Member Manager	44	(2)
Workplace Collaboration Services use of Member Manager	46	(1)
Overview of Lightweight Directory Access Protocol	47	(9)
Advantages of using an LDAP-compliant directory	48	(1)
LDAP terminology overview	49	(4)
Organizing an LDAP directory	53	(3)
LDAP Data Interchange Format (LDIF) file	56	(9)
LDAP tools	65	(7)
IBM and IBM Lotus command line search utilities	65	(3)
LDAP URL search	68	(2)
LDAP browsers	70	(2)
IBM Software included with Workplace Collaboration Services	72	(4)
IBM Tivoli Directory Server	72	(1)
IBM Tivoli Directory Integrator	73	(3)
Selecting a LDAP-compliant user directory for your deployment	76	(3)
Supported directories	76	(1)
Multiple LDAP directories	77	(1)
Common LDAP scenarios	78	(1)
LDAP requirements for IBM Workplace Collaboration Services	79	(3)
Groups and users for Workplace Collaboration Services authentication directory	79	(2)
Workplace Collaboration Services account checklist	81	(1)
LDAP directory validation	82	(5)
Connection information	83	(1)
Verifying IP-level connectivity	84	(1)
Verifying the LDAP schema	85	(2)
Configuring IBM Tivoli Directory Server	87	(10)
Creating user accounts for IBM Tivoli Directory Server	88	(9)
Indexing the IBM Tivoli Directory Server LDAP database	97	(1)
Configuring IBM Lotus Domino Directory	97	(19)
Adding dominoUNID to the Domino Directory schema	98	(5)
Creating a Domino agent to populate existing documents with dominoUNID	103	(4)
Creating required entries in the Domino Directory	107	(4)
Configuring e-mail addresses for Domino Directory groups	111	(1)
(Optional) Configuring write access to the Domino Directory	112	(3)
Creating a full-text index on the Domino Directory	115	(1)
(Optional) Configuring directory assistance	115	(1)
Configuring Microsoft Active Directory server	116	(19)
Adding required attributes to the Active Directory schema	116	(1)
Modifying the Active Directory schema	117	(9)
Adding users and groups to Microsoft Active Directory	126	(6)
Indexing attributes for Microsoft Active Directory	132	(3)
Deploying IBM Workplace Collaboration Services (Microsoft Windows)	135	(134)
Installing IBM Workplace Collaboration Services	137	(12)
Installation overview	137	(1)
Preparing the Workplace Collaboration Services installation	138	(1)
Installing the Workplace Collaboration Services software	139	(6)
Verifying the Workplace Collaboration Services installation	145	(4)
Configuring Workplace Collaboration Services security	149	(48)
LDAP security overview	150	(1)
Configuration Wizard: Disabling WebSphere Member Manager CUR security	150	(5)
Required user accounts for enabling Workplace Collaboration Services external LDAP security	155	(1)
Editing the security helper files	156	(23)
Enabling external LDAP security	179	(13)
Verifying the security configuration	192	(4)
(Optional) Configuring read-only LDAP access for Tivoli Directory Server and Domino	196	(1)
Configuring the Workplace Collaboration Services data store	197	(54)
Overview: The Workplace Collaboration Services data store	197	(2)
What you need	199	(2)
Installing the DB2 Administration Client software	201	(2)
Installing Fix Pack 7a for the DB2 Administration Client	203	(2)
Installing DB2 UDB Enterprise Server Edition on a remote server	205	(14)
Creating and configuring the Workplace Collaboration Services database	219	(14)
Details: DB2 database creation and configuration	233	(3)
Transferring WebSphere Portal data from Cloudscape to DB2	236	(8)
Migrating Workplace Collaboration Services data to DB2	244	(5)
Running reorgchk for performance	249	(1)
Verifying Workplace Collaboration Services deployment status after data store configuration	249	(2)
Running Workplace Collaboration Services configuration script to connect to external HTTP server	251	(17)
Installing IBM HTTP Server	252	(4)
Configuring IBM HTTP Server	256	(1)
Connecting Workplace Collaboration Services to the external HTTP server	256	(3)
Updating the WebSphere Application Server plug-in	259	(1)
Configuring Collaborative Learning for external HTTP	260	(7)
Verifying the Workplace Collaboration Services deployment with remote HTTP	267	(1)
Next steps	268	(1)
Installing Workplace Collaboration Services on Linux using console mode	269	(52)
Prerequisites	270	(3)
Required installation files	270	(2)
Linux-specific requirements	272	(1)
Network requirements	272	(1)
Technologies used for this environment	273	(1)
Installation sequence	273	(1)
Installing Workplace Collaboration Services	273	(5)
Connecting to Microsoft Active Directory	278	(8)
Disabling security	279	(2)
Enabling security	281	(5)
Transferring the database to Oracle	286	(8)
Prerequisites	286	(1)
Adding WebSphere Portal users to the Oracle database	287	(1)
Setting up the Oracle database	288	(2)
Transferring the WebSphere Portal data to Oracle	290	(2)
Transferring Workplace data to Oracle	292	(2)
Connecting to an external HTTP server	294	(5)
Installing IBM HTTP Server	294	(1)
Installing the WebSphere Application Server plug-in	295	(1)
Downloading the WebSphere Application Server fix for remote HTTP servers	296	(1)
Configuring the HTTP server	296	(1)
Connecting the Workplace server to an external HTTP server	296	(2)
Updating Collaborative Learning URLs for external HTTP server	298	(1)
Installing the provisioning server	299	(5)
Enabling SSL between clients and HTTP servers	304	(8)
Creating the HTTP server key file database	304	(1)
Creating a self-signed server certificate for external Web server	305	(1)
Configuring IBM HTTP Server to use a certificate	306	(1)
Creating a public key for the HTTP server	306	(1)
Importing a certificate in the IBM WebSphere Application Server trust stores	307	(1)
Configuring WebSphere Application Server plug-in to use SSL	308	(1)
Editing the plugin-cfg.xml file	309	(1)
Configuring WebSphere Portal server to listen on SSL port	309	(1)
Editing the web.xml files	309	(1)
Configuring JSP to use SSL	310	(1)
Modifying URLs	311	(1)
Enabling SSL: HTTP server and WebSphere Application Server	312	(5)
Creating the WebSphere Application Server key database	313	(1)
Creating self-signed certificate for the embedded HTTP server	314	(1)
Creating a public key for WebSphere Application Server embedded Web server	315	(1)
Copying certificates	315	(1)
Importing the WebSphere Application Server certificate to the HTTP server	316	(1)
Importing the HTTP server certificate to WebSphere Application Server	316	(1)
Modifying the Web container to use SSL	316	(1)
Additional steps for Workplace Managed Client	317	(1)
Additional SSL settings for Collaborative Learning	317	(2)
Changing the login and application method	317	(1)
Updating the Collaborative Learning URL	318	(1)
Enabling LDAP SSL	319	(2)
Acquiring the certificate from the Active Directory server	319	(1)
Importing the certificate into WebSphere	320	(1)
Clustered deployment: Workplace Collaboration Services	321	(110)
Overview	322	(1)
Architecture and infrastructure overview	322	(2)
Installation overview	324	(1)
Setting up network shares for Workplace Collaboration Services	324	(1)
Installing and configuring a remote HTTP server	325	(4)
Installing a Java runtime environment	325	(1)
Installing the HTTP server	325	(2)
Installing the WebSphere Application Sever plug-in for remote HTTP servers	327	(1)
Configuring IBM HTTP Server	328	(1)
Installing Workplace Collaboration Services on node 1	329	(47)
Installing DB2 Administration Client on node 1	329	(2)
Installing Workplace Collaboration Services with archive installer	331	(4)
Enabling security on node 1	335	(10)
Node 1: Migrating the WebSphere Portal databases to DB2	345	(14)
Installing the provisioning server software	359	(11)
Applying fixes on node 1	370	(2)
Connecting to an external HTTP server	372	(4)
Installing the deployment manager	376	(19)
Installing DB2 Administration Client on deployment manager	377	(1)
Installing the deployment manager software	378	(9)
Enabling security on the deployment manager	387	(4)
Installing Workplace Collaboration Services products on the deployment manager	391	(4)
Installing Workplace data on node 2	395	(9)
Steps for transferring to DB2	395	(7)
Applying fixes on node 2	402	(2)
Federating nodes and creating the clusters	404	(12)
Federating node 1 and subsequent nodes	405	(3)
Remove Portal administrative console application from node 1	408	(1)
Add virtualhost aliases for node 1 and subsequent nodes	408	(1)
Optimizing settings on the DB2 server	409	(1)
Creating the cluster	409	(3)
Updating the deployment manager server configuration	412	(4)
Completing the cluster deployment configuration	416	(11)
Enabling dynamic caching	416	(5)
Enabling Search in the cluster	421	(1)
Enabling Messaging in the cluster	422	(3)
Editing WebSphere settings for Network Deployment	425	(1)
Updating the WebSphere Application Server HTTP plug-in	425	(1)
Updating Workplace settings on node 2 and subsequent nodes	426	(1)
Starting IBM Workplace Collaboration Services	427	(4)
Post-deployment configuration	431	(32)
Post-deployment overview	432	(1)
Applying required fixes	432	(4)
Applying fixes in a single-server (two-tier) environment	432	(2)
Applying fixes in a clustered deployment	434	(2)
Collaborative Learning	436	(11)
Updating the Learning settings in the dbbuild.properties file	437	(3)
Granting Learning access to WebSphere Portal administrator	440	(2)
Setting up access control for Collaborative Learning portlets	442	(4)
Configuring help for the Workplace Collaborative Learning administrator interface	446	(1)
Verifying the unique ID mapping for Collaborative Learning	446	(1)
Workplace Messaging	447	(6)
Configuring mail cell-wide settings	448	(4)
Disabling other mail systems	452	(1)
Configuring Workplace e-mail notification support	453	(1)
Configuring logging for Team Collaboration and Documents	454	(1)
(Optional) Updating default policy to use Workplace Managed Client	455	(4)
Post-deployment verification tasks	459	(4)
Configuring IBM Workplace Collaboration Services network security (SSL)	463	(66)
Security overview	464	(2)
Configuring SSL with Workplace Collaboration Services	466	(42)
Configuring SSL for secure HTTP client communication	467	(7)
Configuring WebSphere Application Server, Portal, and Workplace Collaboration Services for secure HTTP communication	474	(17)
Configuring SSL between the external HTTP server and the WebSphere Application Server internal HTTP server	491	(7)
Configuring Workplace Messaging protocols for SSL	498	(4)
Configuring Workplace Collaborative Learning for SSL	502	(6)
Configuring SSL for LDAP access	508	(21)
Configuring SSL with Tivoli Directory Server	508	(12)
Configuring Workplace Collaboration Services with Domino LDAP over SSL	520	(9)
Large-scale implementations	529	(42)
DB2 high-availability options	530	(1)
LDAP high-availability options	531	(4)
General replication concepts for Tivoli Directory Server	531	(2)
General replication and clustering concepts for Domino LDAP	533	(2)
Third-party authentication featuring IBM Tivoli Access Manager	535	(7)
Overview of WebSphere Edge Server	542	(4)
Adding an Edge Server Network Dispatcher to a Workplace Collaboration Services cluster	546	(25)
Overview	546	(1)
Infrastructure and architectural overview	546	(2)
Requirements for IBM WebSphere Edge Server components	548	(2)
Installing IBM WebSphere Edge Server components	550	(1)
Adding a second HTTP server to the cluster	551	(4)
Configuring the Edge Server Network Dispatcher component	555	(6)
Installing the loopback adapter on balanced servers	561	(2)
Configuring Workplace Collaboration Services	563	(3)
Reconfiguring Workplace Collaborative Learning	566	(2)
Configuring the Workplace Managed Client to work with the Edge Server	568	(1)
Testing the configuration	569	(2)
Integration	571	(20)
Workplace Collaboration Services integration with existing WebSphere Portal deployments	572	(6)
Installing into an existing WebSphere Portal infrastructure	572	(1)
Deploying Workplace Collaboration Services using an existing WebSphere Portal configuration	573	(1)
Portlet interoperability	574	(1)
Interoperability with WebSphere Portal Express	575	(1)
Instant messaging, presence, and Web conferences	576	(1)
Interoperability of administration tasks	577	(1)
Search interoperability	577	(1)
Document Management interoperability	578	(1)
Personalization interoperability	578	(1)
Workplace Builder interoperability	578	(1)
Workplace Collaboration Services integration with Lotus Sametime	578	(3)
Overview	578	(1)
Lotus Instant Messaging Gateway	579	(2)
Workplace Collaboration Services integration with Domino	581	(10)
Overview	581	(1)
Integration of Domino Mail and Workplace Collaboration Services Messaging	582	(3)
Domino applications	585	(6)
Tips and troubleshooting	591	(24)
Workplace Collaboration Services troubleshooting	592	(15)
Troubleshooting methodology (problem isolation)	593	(1)
Install and system logs	593	(1)
Trace settings	594	(1)
DB2 logs and traces	595	(1)
Installation and configuration issues	595	(5)
Product troubleshooting	600	(3)
Troubleshooting Workplace Collaboration Services deployment on Linux	603	(4)
Backup and restore	607	(1)
Workplace Collaboration Services tips	607	(8)
Renaming the Configuration Wizard logs	607	(1)
Enabling gzip compression on the HTTP server	608	(1)
Creating Windows services for the Workplace Collaboration Services components	609	(6)
Appendix A. Abbreviated Workplace Collaboration Services Deployment (Windows)	615	(52)
Installing IBM Workplace Collaboration Services	617	(3)
Preparing the Workplace Collaboration Services installation	617	(1)
Installing the Workplace Collaboration Services software	618	(1)
Verifying the Workplace Collaboration Services installation	619	(1)
Configuring Workplace Collaboration Services security	620	(13)
Configuration Wizard: Disabling WebSphere Member Manager custom user registry security	620	(2)
Required user accounts for enabling Workplace Collaboration Services external LDAP security	622	(1)
Editing the security helper files	623	(5)
Enabling external LDAP security	628	(3)
Verifying the security configuration	631	(1)
(Optional) Configuring read-only LDAP access for Tivoli Directory Server and Domino	632	(1)
Configuring the Workplace Collaboration Services data store	633	(23)
What you need	633	(2)
Installing the DB2 Administration Client software	635	(1)
Installing Fix Pack 7a for the DB2 Administration Client	636	(1)
Installing DB2 UDB Enterprise Server Edition on a remote server	637	(5)
Creating and configuring the IBM Workplace Collaboration Services database	642	(7)
Transferring WebSphere Portal data from Cloudscape to DB2	649	(4)
Migrating Workplace Collaboration Services data to DB2	653	(2)
Running reorgchk for performance	655	(1)
Verifying Workplace Collaboration Services deployment status after data store configuration	656	(1)
Running a Workplace Collaboration Services configuration script to connect to an external HTTP server	656	(11)
Installing IBM HTTP Server	657	(2)
Configuring IBM HTTP Server	659	(1)
Connecting Workplace Collaboration Services to an external HTTP server	660	(2)
Updating the WebSphere Application Server plug-in	662	(1)
Configuring Collaborative Learning for external HTTP	662	(2)
Verifying Workplace Collaboration Services deployment with remote HTTP	664	(3)
Appendix B. Useful commands	667	(4)
Appendix C. Adding IBM Workplace Managed Client to an existing clustered deployment	671	(6)
Removing a cluster from the deployment manager	672	(3)
Removing the nodes from the cluster	672	(1)
Unfederating the nodes	673	(1)
Removing applications from the cluster	673	(2)
Deleting the cluster	675	(1)
Installing the provisioning server on node 1 and the HTTP server	675	(1)
Refederating nodes into a clustered deployment	676	(1)
Updating the user policies for the use of Workplace Managed Client	676	(1)
Appendix D. Installing Oracle Client 9.2.0.4 on Linux	677	(8)
Preparing the system for the Oracle Client	678	(3)
SUSE Linux Enterprise Server 8 configuration	678	(1)
Red Hat Linux AS 2.1 configuration	679	(2)
Starting the GUI installer	681	(4)
Related publications	685	(1)
IBM Redbooks	685	(1)
Other publications	686	(1)
Online resources	686	(1)
How to get IBM Redbooks	687	(1)
Help from IBM	687	(2)
Index	689