Successfully reported this slideshow.
IBM Workplace Services Express 2.5 :-  Installation and Configuration David Scouller [email_address]
Agenda <ul><li>Sizing </li></ul><ul><li>Deployment </li></ul><ul><li>LDAP </li></ul><ul><li>Databases </li></ul><ul><li>Co...
Sizing <ul><li>Customer Questions  </li></ul><ul><ul><li>What hardware do I need for WSE? </li></ul></ul><ul><ul><li>What ...
Sizing – Key Considerations <ul><li>The tests and results in this presentation were based on specific parameters, chosen t...
Sizing – Usage (Concurrent Users) <ul><li>Frequent Users </li></ul><ul><ul><li>Components utilized </li></ul></ul><ul><ul>...
Sizing – Example scenario <ul><li>1000 Registered users </li></ul><ul><ul><li>50% concurrent users (500 users) </li></ul><...
Sizing Help <ul><li>Americas </li></ul><ul><ul><li>Partners  should engage Techline through their IBM contact based on a v...
Hardware – Intel Base <ul><li>Processor:  </li></ul><ul><ul><li>CPU speeds of late-model, mid-range to high-end servers ar...
Hardware – IBM i5/OS <ul><li>The following are the minimum server processor and memory requirements for new IBM eServer™ i...
Supported Operating Systems <ul><li>Supported Operating systems </li></ul><ul><ul><li>Microsoft Windows 2000 SP4 </li></ul...
Introduction to Deployment <ul><li>Install very simple, four questions, and summary </li></ul><ul><li>Install is based on ...
Deployment Scenarios <ul><li>Single Server Install </li></ul><ul><ul><li>Out of the box installation, all components on on...
Installation Steps <ul><li>Prepare the server </li></ul><ul><ul><li>Permissions </li></ul></ul><ul><ul><li>File Systems </...
Installation Steps <ul><li>Prepare the media or installation kit </li></ul><ul><li>Install IBM Workplace Services Express ...
Installation Issues <ul><li>Defective media </li></ul><ul><li>Permissions </li></ul><ul><li>Incorrectly filenames  </li></...
Installation Issues <ul><li>Defective Media </li></ul><ul><ul><li>If the DVD is damaged then the installer can fail report...
Media & Filenames <ul><ul><li>http://publib.boulder.ibm.com/pvc/wse/250/en/release_notes.html </li></ul></ul>
Media & Filenames
Domain & Host name <ul><li>Your server must have a fully qualified host name </li></ul><ul><li>Your server must have a dom...
Unable to logon <ul><li>Enter user name and password, but get returned to logon screen, with no error </li></ul><ul><ul><l...
Unable to logon – Example 4 Solution <ul><li>Open the admin console  http://hostname.domain.co.uk:9091/admin </li></ul><ul...
Ports
Ports - continued <ul><li>netstat –ab (Win2003) netstat –pan (Linux) </li></ul>
Configuration Wizard <ul><li>Java based configuration program </li></ul><ul><li>Can be used for all platforms </li></ul><u...
I5/OS HTTP Administration Service
LDAP <ul><li>Supported </li></ul><ul><ul><li>Microsoft Active Directory 2000 & 2003 </li></ul></ul><ul><ul><li>Lotus Domin...
LDAP – Transferring to LDAP <ul><li>Two Stage process </li></ul><ul><ul><li>Disable Security </li></ul></ul><ul><ul><li>Tr...
LDAP – Preparing the Directory
LDAP – Preparing the Directory <ul><li>Domino </li></ul><ul><ul><li>Create accounts and group </li></ul></ul><ul><ul><li>A...
LDAP – Preparing the Directory <ul><li>Active Directory </li></ul><ul><ul><li>Create accounts and group </li></ul></ul><ul...
LDAP - Typical Issues <ul><li>Incorrect user DN </li></ul><ul><li>Passwords </li></ul><ul><li>Base Suffix </li></ul><ul><l...
LDAP Example Active Directory
LDAP - Active Directory <ul><li>PortalAdmin; WasUserID;LDAPAdminUid  </li></ul><ul><ul><li>cn=wseadmin,ou=Itadmins,ou=igs,...
LDAP - Domino <ul><li>dominoUNID </li></ul><ul><ul><li>Below version 6.5.4  </li></ul></ul><ul><li>Wpsadmins group locatio...
LDAP – Domino <ul><li>Unable to use the sign-up link or create users/groups through the Administration interface </li></ul...
LDAP – Domino <ul><li>Navigate to <wse_install>PortalServersharedappwmm and edit wmm.xml file using a suitable editor on y...
LDAP – Disable Security <ul><li>During the disable of global security you may encounter this error </li></ul><ul><ul><li>a...
Databases <ul><li>Cloudscape </li></ul><ul><ul><li>Supplied out of the box with the product </li></ul></ul><ul><li>IBM DB2...
Databases - Transferring to… <ul><li>Configuration Wizard </li></ul><ul><li>Three stage process </li></ul><ul><ul><li>Set-...
Databases - Transfer to DB2 process <ul><li>Ensure DB2 Express 8.2 installed </li></ul><ul><li>Start Cloudscape Network Se...
Databases - Transfer to DB2 process <ul><li>Select the database location </li></ul><ul><ul><li>Utilising a separate disk w...
Database - Transfer to MS SQL Server <ul><li>Install MS SQL Server 2000 </li></ul><ul><li>Install MS SQL Server SP3 or SP3...
Database - Transfer to MS SQL Server <ul><li>Enable SQL authenication </li></ul><ul><li>Configure the XA Stored Procedures...
Common Issues <ul><li>Instant Messaging does not work </li></ul><ul><ul><li>Port Conflict </li></ul></ul><ul><ul><li>Login...
Common Issues <ul><li>Blank List Portlet </li></ul><ul><ul><li>ConcurrentModificationException  ListPortlet.doView.viewVie...
Common Issues <ul><li>Single Sign-on with Domino not working </li></ul><ul><ul><li>Time issues </li></ul></ul><ul><ul><li>...
Common Issues <ul><li>Document Editors not working </li></ul><ul><ul><li>Error 500: Portlet Couldn’t be contacted </li></u...
Portlets <ul><li>You cannot deploy the following portlets to pages outside of Workplace applications or templates: </li></...
Portlets <ul><li>Domino Web Access </li></ul><ul><li>Domino Application Portlet </li></ul><ul><li>Exchange </li></ul><ul><...
Domino Web Access <ul><li>Secure WSE to Domino LDAP </li></ul><ul><li>Setup Single Sign On (SSO) between WebSphere and Dom...
Domino Application Portlet <ul><li>Renders web-enabled Domino applications within the Portal interface. </li></ul><ul><ul>...
Domino Application Portlet <ul><li>Demo </li></ul>
POP3/IMAP
Exchange
Other Examples <ul><li>IBM RSS Portlet </li></ul><ul><ul><li>Used for News feeds, can be downloaded from the Workplace & P...
Tuning <ul><li>Heap Sizes </li></ul><ul><ul><li>Take your physical memory size, look at your memory consumption prior to r...
Tuning <ul><li>Connections </li></ul><ul><ul><li>You can increase the maximum connections in the connection pools for the ...
Tuning <ul><li>Database </li></ul><ul><ul><li>For Microsoft SQL Server refer to the product documentation </li></ul></ul><...
Red Hat Promotion <ul><li>Get a 90-day evaluation copy of IBM Workplace Services Express and Red Hat Enterprise Linux -- a...
Useful Links <ul><li>Documentation Page </li></ul><ul><ul><li>http://www.lotus.com/products/product5.nsf/wdocs/productdoc#...
Questions
Upcoming SlideShare
Loading in …5
×

IBM Workplace Services Express - Configuration v20

2,480 views

Published on

Published in: Business, Technology
  • Be the first to comment

IBM Workplace Services Express - Configuration v20

  1. 1. IBM Workplace Services Express 2.5 :- Installation and Configuration David Scouller [email_address]
  2. 2. Agenda <ul><li>Sizing </li></ul><ul><li>Deployment </li></ul><ul><li>LDAP </li></ul><ul><li>Databases </li></ul><ul><li>Common Issues </li></ul><ul><li>Portlet Integration </li></ul><ul><li>Tuning </li></ul><ul><li>RedHat Promotion </li></ul>
  3. 3. Sizing <ul><li>Customer Questions </li></ul><ul><ul><li>What hardware do I need for WSE? </li></ul></ul><ul><ul><li>What is the Architecture of WSE? </li></ul></ul><ul><ul><li>What are the secondary components, do I need a directory? </li></ul></ul><ul><li>IBM/BP Questions </li></ul><ul><ul><li>How many registered users? </li></ul></ul><ul><ul><li>What is the level of concurrency? </li></ul></ul><ul><ul><li>What are the usage patterns? </li></ul></ul>
  4. 4. Sizing – Key Considerations <ul><li>The tests and results in this presentation were based on specific parameters, chosen to represent a typical, average WSE deployment scenario. Common sense dictates a case-by-case examination of each customer’s requirements and environment. Actual performance may be different based on specific customers load and any figures provided are only an estimate. </li></ul><ul><li>Concurrent versus Registered Users </li></ul><ul><ul><li>Concurrent = Logged on to WSE </li></ul></ul><ul><ul><li>Registered = Have user id for WSE </li></ul></ul><ul><li>Support for customers expected concurrent users </li></ul><ul><ul><li>In test environments concurrent user levels show rates ranging from 150 – 580 users (Dual Processor server with processor affinity) </li></ul></ul><ul><li>Maximizing Concurrency </li></ul><ul><ul><li>The concurrency levels above achieved with DB2 Express, if you have Microsoft SQL server this can be utilised as the data store. When using MS SQL server we expect around 20% lower concurrency. </li></ul></ul><ul><li>IBM i5/OS information is not available </li></ul><ul><ul><li>The IBM i5/OS platform is currently being tested and results will be made available as soon as they are available. </li></ul></ul><ul><ul><li>i5/OS includes DB2 for iSeries which is utilised by WSE </li></ul></ul>
  5. 5. Sizing – Usage (Concurrent Users) <ul><li>Frequent Users </li></ul><ul><ul><li>Components utilized </li></ul></ul><ul><ul><ul><li>Team Spaces, Announcements, FAQs, Team Calendar, Team Task List, Document Manager, Discussion Forum, Search, Chat Room, Presence Awareness </li></ul></ul></ul><ul><ul><li>Read and write operations utilizing the components. </li></ul></ul><ul><li>Occasional Users </li></ul><ul><ul><li>Logged on and chats with users every 25 minutes. </li></ul></ul>
  6. 6. Sizing – Example scenario <ul><li>1000 Registered users </li></ul><ul><ul><li>50% concurrent users (500 users) </li></ul></ul><ul><ul><ul><li>7 – 10% of these users are classed as frequent users (100) </li></ul></ul></ul><ul><ul><ul><li>30 – 40% of these users are classed as occasional users (400) </li></ul></ul></ul><ul><ul><li>DB2 Express will provide Storage </li></ul></ul><ul><ul><li>Response Time 5 seconds or less </li></ul></ul><ul><li>Suggested Hardware </li></ul><ul><ul><li>Dual Processor (Using Processor Affinity) </li></ul></ul><ul><ul><li>4GB Memory </li></ul></ul><ul><ul><li>Tuned system </li></ul></ul>
  7. 7. Sizing Help <ul><li>Americas </li></ul><ul><ul><li>Partners should engage Techline through their IBM contact based on a validated customer opportunity (in Siebel with opportunity #, Customer etc). The IBMer will be the interface to Techline and return the response to the business partner upon completion. WSE sizing requests submitted with a completed questionnaire will take 2-3 business days depending upon the complexity of the request. The Techline team will provide an estimated turnaround time upon receiving a questionnaire with complete responses </li></ul></ul><ul><li>EMEA: </li></ul><ul><ul><li>Techline details can be found on w3-5.ibm.com/support/emea/techline/index.shtml, here is the link to the Techline Request Generator w3- 5.ibm.com/support/emea/techline/form.shtml </li></ul></ul><ul><li>Asia Pacific: </li></ul><ul><ul><li>w3-6.ibm.com/support/ap/ap_techline.html </li></ul></ul><ul><ul><li>A/NZ [email_address] </li></ul></ul><ul><ul><li>SEAN: http://w3-6.ibm.com/support/ap/asean/techline/reach_us/reach_us.htm </li></ul></ul><ul><ul><li>GCG(China) Partnerline 8008101818-5073 </li></ul></ul><ul><ul><li>GCG(Hong Kong) 28257000 </li></ul></ul><ul><ul><li>GCG(Taiwan) Partnerline 0800-000006 </li></ul></ul><ul><ul><li>Japan Partner Information www-6.ibm.com/jp/software/partnerworld/inquiry.html </li></ul></ul><ul><ul><li>Korea [email_address] </li></ul></ul>
  8. 8. Hardware – Intel Base <ul><li>Processor: </li></ul><ul><ul><li>CPU speeds of late-model, mid-range to high-end servers are recommended. Pentium 4 processor at 2.5GHz or equivalent at a minimum. Recommend Intel Xeon 3GHz or above </li></ul></ul><ul><li>Physical memory per processor: </li></ul><ul><ul><li>2 GB at a minimum. We recommend 4 GB </li></ul></ul><ul><li>Disk space: </li></ul><ul><ul><li>10 GB at a minimum. We recommend 17 GB </li></ul></ul><ul><li>Virtual memory/swap space: </li></ul><ul><ul><li>This value should be equal to double your physical memory. At a minimum, this should be at least equal to your physical memory. </li></ul></ul><ul><li>File system: </li></ul><ul><ul><li>Linux Intel systems: The Linux ext2 file system, which is used by default, does not allow you to change the file system size. Therefore, you should carefully plan in advance for the size of your file system to avoid related problems. </li></ul></ul><ul><ul><li>Microsoft Windows: NTFS file system is recommended . </li></ul></ul>
  9. 9. Hardware – IBM i5/OS <ul><li>The following are the minimum server processor and memory requirements for new IBM eServer™ i5™ systems. </li></ul><ul><ul><li>IBM eServer i5 520 1-way (2400 CPW - Commercial Processing Workload) with L3 cache. </li></ul></ul><ul><ul><li>4 GB main storage </li></ul></ul><ul><ul><li>15 GB of disk space for installation of IBM Workplace Services Express and WebSphere® Application Server V5.0.2 Enterprise Enablement </li></ul></ul><ul><ul><li>4 GB of disk space for each WebSphere Application Server instance configured for use with IBM Workplace Services Express </li></ul></ul><ul><ul><li>10 disk arms </li></ul></ul>
  10. 10. Supported Operating Systems <ul><li>Supported Operating systems </li></ul><ul><ul><li>Microsoft Windows 2000 SP4 </li></ul></ul><ul><ul><ul><li>Server or Advanced Server Editions </li></ul></ul></ul><ul><ul><li>Microsoft Windows 2003 Server </li></ul></ul><ul><ul><ul><li>Standard or Enterprise Editions </li></ul></ul></ul><ul><ul><li>RedHat Enterprise Linux Advanced Server 3.0 for Intel (x86), update 4 </li></ul></ul><ul><ul><li>SuSE Linux Enterprise Server (SLES) for Intel (x86) 8 2.4 Kernel </li></ul></ul><ul><ul><li>IBM i5/OS V5R3 </li></ul></ul>
  11. 11. Introduction to Deployment <ul><li>Install very simple, four questions, and summary </li></ul><ul><li>Install is based on the Archive install process </li></ul><ul><li>Can be utilised out of the box without further configuration </li></ul>
  12. 12. Deployment Scenarios <ul><li>Single Server Install </li></ul><ul><ul><li>Out of the box installation, all components on one server </li></ul></ul><ul><li>Two Server Install </li></ul><ul><ul><li>LDAP on first server, WSE & Cloudscape on second server OR </li></ul></ul><ul><ul><li>LDAP on first server, WSE & DB2/SQL on second server </li></ul></ul><ul><li>Three Servers </li></ul><ul><ul><li>HTTP Server, LDAP Server and WSE/Database Server </li></ul></ul><ul><li>Four Servers </li></ul><ul><ul><li>HTTP Server, LDAP S e r v e r, WSE Server, Database Server </li></ul></ul>
  13. 13. Installation Steps <ul><li>Prepare the server </li></ul><ul><ul><li>Permissions </li></ul></ul><ul><ul><li>File Systems </li></ul></ul><ul><ul><li>IP Configuration </li></ul></ul><ul><ul><li>Host Name </li></ul></ul><ul><ul><li>Domain settings </li></ul></ul><ul><ul><li>Mode setting on Windows 2003 </li></ul></ul><ul><ul><li>Licensed Program pre-requisites on i5/OS </li></ul></ul><ul><ul><li>PTFs and Group PTFs on i5/OS </li></ul></ul>
  14. 14. Installation Steps <ul><li>Prepare the media or installation kit </li></ul><ul><li>Install IBM Workplace Services Express 2.5 </li></ul><ul><li>Optional Steps </li></ul><ul><ul><li>Install other components </li></ul></ul><ul><ul><li>Configure WSE2.5 for LDAP </li></ul></ul><ul><ul><li>Configure WSE2.5 for Database </li></ul></ul><ul><ul><li>Configure WSE2.5 for HTTP </li></ul></ul>
  15. 15. Installation Issues <ul><li>Defective media </li></ul><ul><li>Permissions </li></ul><ul><li>Incorrectly filenames </li></ul><ul><li>Host name </li></ul><ul><li>Domain name </li></ul><ul><li>Port Conflicts </li></ul>
  16. 16. Installation Issues <ul><li>Defective Media </li></ul><ul><ul><li>If the DVD is damaged then the installer can fail reporting an error during install. </li></ul></ul><ul><ul><li>If one of the compressed files has been corrupt during the rename or copy phase the install can fail. </li></ul></ul><ul><li>Permissions </li></ul><ul><ul><li>Without the correct permissions the installer will report errors </li></ul></ul>
  17. 17. Media & Filenames <ul><ul><li>http://publib.boulder.ibm.com/pvc/wse/250/en/release_notes.html </li></ul></ul>
  18. 18. Media & Filenames
  19. 19. Domain & Host name <ul><li>Your server must have a fully qualified host name </li></ul><ul><li>Your server must have a domain name assigned </li></ul><ul><li>Do not use localhost as the host name in the URL </li></ul><ul><li>Do not use the IP Address as the host name </li></ul><ul><li>Typical problems with incorrect host names </li></ul><ul><ul><li>Unable to logon </li></ul></ul><ul><ul><li>Unable to logon even when the above are set correctly using Microsoft Internet Explorer, but can logon with Firefox </li></ul></ul>
  20. 20. Unable to logon <ul><li>Enter user name and password, but get returned to logon screen, with no error </li></ul><ul><ul><li>Incorrect host name setting as shown in the URLs below is the cause </li></ul></ul><ul><ul><ul><li>Example 1 </li></ul></ul></ul><ul><ul><ul><ul><li>http://hostname:9081/lwp/workplace </li></ul></ul></ul></ul><ul><ul><ul><li>Example 2 </li></ul></ul></ul><ul><ul><ul><ul><li>http://192.168.1.1:9081/lwp/workplace </li></ul></ul></ul></ul><ul><ul><ul><li>Example 3 </li></ul></ul></ul><ul><ul><ul><ul><li>http://localhost:9081/lwp/workplace </li></ul></ul></ul></ul><ul><ul><ul><li>Example 4 </li></ul></ul></ul><ul><ul><ul><ul><li>http://hostname.domain.co.uk:9081/lwp/workplace </li></ul></ul></ul></ul>
  21. 21. Unable to logon – Example 4 Solution <ul><li>Open the admin console http://hostname.domain.co.uk:9091/admin </li></ul><ul><li>Click on the Security - Authentication Mechanisms - LTPA link. Click on the Single Signon (SSO) link, top figure. </li></ul><ul><li>Set the domain name field to match the domain of your server for example “ibm.co.uk”, and not “co.uk” as shown in bottom figure </li></ul>
  22. 22. Ports
  23. 23. Ports - continued <ul><li>netstat –ab (Win2003) netstat –pan (Linux) </li></ul>
  24. 24. Configuration Wizard <ul><li>Java based configuration program </li></ul><ul><li>Can be used for all platforms </li></ul><ul><ul><li>But on i5/OS it is preferred that you use the IBM HTTP Administration server configuration interface. </li></ul></ul><ul><li>Simplified interface to ease the transition </li></ul><ul><li>Parameter driven </li></ul><ul><li>LDAP Transfer </li></ul><ul><li>Database Transfer </li></ul>
  25. 25. I5/OS HTTP Administration Service
  26. 26. LDAP <ul><li>Supported </li></ul><ul><ul><li>Microsoft Active Directory 2000 & 2003 </li></ul></ul><ul><ul><li>Lotus Domino 6.0.x and 6.5.x </li></ul></ul><ul><ul><li>IBM Tivoli Directory Server 5.2 </li></ul></ul><ul><ul><li>Sun Java System Directory Server V5.2 FP3 </li></ul></ul><ul><ul><li>Novell eDirectory 8.7.3 </li></ul></ul>
  27. 27. LDAP – Transferring to LDAP <ul><li>Two Stage process </li></ul><ul><ul><li>Disable Security </li></ul></ul><ul><ul><li>Transfer to LDAP </li></ul></ul><ul><li>To use the wizard do the following: </li></ul><ul><ul><li>Start the Cloudscape Network Server </li></ul></ul><ul><ul><li>Start server1 </li></ul></ul>
  28. 28. LDAP – Preparing the Directory
  29. 29. LDAP – Preparing the Directory <ul><li>Domino </li></ul><ul><ul><li>Create accounts and group </li></ul></ul><ul><ul><li>Access Control </li></ul></ul><ul><ul><li>Server Configuration for LDAP </li></ul></ul><ul><ul><li>Indexing </li></ul></ul><ul><ul><li>PumaServices.Properties update </li></ul></ul><ul><ul><ul><li><wse_root>/PortalServer/shared/app/config/services </li></ul></ul></ul><ul><ul><ul><li>user.sync.remove.attributes=cn,CN,cN,Cn </li></ul></ul></ul>
  30. 30. LDAP – Preparing the Directory <ul><li>Active Directory </li></ul><ul><ul><li>Create accounts and group </li></ul></ul><ul><ul><li>Add required attributes </li></ul></ul><ul><ul><li>Indexing attributes </li></ul></ul><ul><li>Tivoli Directory Server </li></ul><ul><ul><li>Create accounts and group </li></ul></ul><ul><ul><li>Indexing </li></ul></ul><ul><ul><ul><li>db2 &quot;create index maili2 on mail(mail_t,eid)&quot; </li></ul></ul></ul>
  31. 31. LDAP - Typical Issues <ul><li>Incorrect user DN </li></ul><ul><li>Passwords </li></ul><ul><li>Base Suffix </li></ul><ul><li>Groups </li></ul><ul><li>Access rights </li></ul><ul><li>Connection issues </li></ul>
  32. 32. LDAP Example Active Directory
  33. 33. LDAP - Active Directory <ul><li>PortalAdmin; WasUserID;LDAPAdminUid </li></ul><ul><ul><li>cn=wseadmin,ou=Itadmins,ou=igs,dc=pic,dc=uk,dc=ibm,dc=com </li></ul></ul><ul><li>PortalAdminGroupId </li></ul><ul><ul><li>cn=wseadmins,ou=Itgroups,ou=igs,dc=pic,dc=uk,dc=ibm,dc=com </li></ul></ul><ul><li>LDAPBindID </li></ul><ul><ul><li>cn=wsebind,ou=Itadmins,ou=igs,dc=pic,dc=uk,dc=ibm,dc=com </li></ul></ul><ul><li>LDAPSuffix </li></ul><ul><ul><li>dc=pic,dc=uk,dc=ibm,dc=com </li></ul></ul><ul><li>LDAPUserSuffix </li></ul><ul><ul><li>Leave Blank </li></ul></ul><ul><li>LDAPGroupSuffix </li></ul><ul><ul><li>ou=itgroups,ou=igs </li></ul></ul>
  34. 34. LDAP - Domino <ul><li>dominoUNID </li></ul><ul><ul><li>Below version 6.5.4 </li></ul></ul><ul><li>Wpsadmins group location and name </li></ul>
  35. 35. LDAP – Domino <ul><li>Unable to use the sign-up link or create users/groups through the Administration interface </li></ul><ul><ul><li>[18/08/05 11:58:20:797 BST] f945d8e WSMM Message E com.ibm.ws.wmm.ldap.LdapRepositoryImpl void create(String DN, Attributes attributes) The following Naming Exception occurred during processing: &quot;javax.naming.directory.InvalidAttributeValueException: 'objectClass' has no values.; remaining name 'cn=test001,o=ibm'; resolved object com.sun.jndi.ldap.LdapCtx@3811dce6&quot;. </li></ul></ul>
  36. 36. LDAP – Domino <ul><li>Navigate to <wse_install>PortalServersharedappwmm and edit wmm.xml file using a suitable editor on your server platform. </li></ul><ul><li>Locate the following reference: </li></ul><ul><ul><li><supportedLdapEntryType name=&quot;Person&quot; rdnAttrTypes=&quot;cn&quot; objectClassesForRead=&quot;dominoPerson&quot; objectClassesForWrite=&quot;&quot; searchBases=&quot;&quot;/> </li></ul></ul><ul><li>Change the objectClassesForWrite value to the following: </li></ul><ul><ul><li>objectClassesForWrite=&quot;dominoPerson&quot; </li></ul></ul><ul><li>Locate the entries for the groups, organization and organizational unit and update them so that the objectClassesForWrite is set to be dominoGroup, dominoOrganization and dominoOrganizationUnit respectively as in the example below: </li></ul><ul><ul><li><supportedLdapEntryType name=&quot;Group&quot; rdnAttrTypes=&quot;cn&quot; objectClassesForRead=&quot;dominoGroup;ibm-mailList&quot; objectClassesForWrite=&quot;&quot; searchBases=&quot;dominoGroup&quot;/> <supportedLdapEntryType name=&quot;Organization&quot; rdnAttrTypes=&quot;o&quot; objectClassesForRead=&quot;dominoOrganization&quot; objectClassesForWrite=&quot; dominoOrganization&quot;/> <supportedLdapEntryType name=&quot;OrganizationalUnit&quot; rdnAttrTypes=&quot;ou&quot; objectClassesForRead=&quot;dominoOrganizationalUnit&quot; objectClassesForWrite=&quot;dominoOrganizationUnit&quot;/> </li></ul></ul><ul><li>Save and Close the file </li></ul>
  37. 37. LDAP – Disable Security <ul><li>During the disable of global security you may encounter this error </li></ul><ul><ul><li>action-create-deployment-credentials: </li></ul></ul><ul><ul><li>[xmlaccess] <?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; ?> </li></ul></ul><ul><ul><li>[xmlaccess] <failure> </li></ul></ul><ul><ul><li>[xmlaccess] com.ibm.wps.command.xml.XmlCommandServlet$AuthorizationException: XMLC0005E: Authorization for user wpsadmin failed. </li></ul></ul><ul><ul><li>[xmlaccess] </failure> </li></ul></ul><ul><ul><li>[ldapcheck] Checking for 'CN=wpsadmins,OU=Groups,DC=WSE,DC=PIC,DC=UK,DC=IBM,DC=COM' </li></ul></ul><ul><ul><li>[xmlaccess] XMLA0006I: Connecting to URL http://win2003.wse.pic.uk.ibm.com:9081/lwp/config </li></ul></ul><ul><ul><li>[xmlaccess] XMLA0002I: Reading input file C:IBMWSEPortalServerconfigworkcreateDeploymentCredentials.xml </li></ul></ul><ul><ul><li>[xmlaccess] XMLA0011I: Request was accepted. </li></ul></ul><ul><ul><li>BUILD FAILED </li></ul></ul><ul><ul><li>file:../config/actions/wps_cfg.xml:319: XMLA0015E: Server response indicates an error. </li></ul></ul>
  38. 38. Databases <ul><li>Cloudscape </li></ul><ul><ul><li>Supplied out of the box with the product </li></ul></ul><ul><li>IBM DB2 UDB Express 8.2 </li></ul><ul><li>IBM DB2 for iSeries </li></ul><ul><li>Microsoft SQL Server 2000 SP3 or SP3a </li></ul>
  39. 39. Databases - Transferring to… <ul><li>Configuration Wizard </li></ul><ul><li>Three stage process </li></ul><ul><ul><li>Set-up Workplace database </li></ul></ul><ul><ul><li>Transfer Portal data </li></ul></ul><ul><ul><li>Transfer Workplace data </li></ul></ul>
  40. 40. Databases - Transfer to DB2 process <ul><li>Ensure DB2 Express 8.2 installed </li></ul><ul><li>Start Cloudscape Network Server </li></ul><ul><li>Start Server1 </li></ul><ul><li>Start Configuration Wizard </li></ul><ul><ul><li>Select IBM DB2 Universal Database </li></ul></ul><ul><ul><li>Select Step 1 – Set-up the Workplace Database </li></ul></ul><ul><ul><li>Default Database is WPS50 </li></ul></ul><ul><ul><li>Use your DB2 administrator account </li></ul></ul><ul><ul><ul><li>Default is db2admin </li></ul></ul></ul>
  41. 41. Databases - Transfer to DB2 process <ul><li>Select the database location </li></ul><ul><ul><li>Utilising a separate disk where possible </li></ul></ul><ul><li>Ensure you keep the default schema names </li></ul><ul><li>Run the DB creation script created </li></ul><ul><li>Restart the Configuration Wizard for Step 2 </li></ul><ul><ul><li>Transfer Portal Data </li></ul></ul><ul><li>Restart the Configuration Wizard for Step 3 </li></ul><ul><ul><li>Transfer Workplace Data </li></ul></ul>
  42. 42. Database - Transfer to MS SQL Server <ul><li>Install MS SQL Server 2000 </li></ul><ul><li>Install MS SQL Server SP3 or SP3a </li></ul><ul><li>Install the MS SQL JDBC driver </li></ul><ul><li>Run the Configuration Wizard Step 1 </li></ul><ul><ul><li>Create Workplace Database </li></ul></ul><ul><li>Create SQL server database users </li></ul><ul><ul><li>EJB, FEEDBACK, PZNADMIN, WCMDBADM, WMMDBUSR, WPSDBUSR </li></ul></ul><ul><ul><li>Add these users to the WPS50 database </li></ul></ul>
  43. 43. Database - Transfer to MS SQL Server <ul><li>Enable SQL authenication </li></ul><ul><li>Configure the XA Stored Procedures </li></ul><ul><li>Run the Configuration Wizard Step 2 </li></ul><ul><ul><li>Transfer Portal Data </li></ul></ul><ul><li>Run the Configuration Wizard Step 3 </li></ul><ul><ul><li>Transfer Workplace Data </li></ul></ul><ul><li>Complete installation using OSQL scripts </li></ul>
  44. 44. Common Issues <ul><li>Instant Messaging does not work </li></ul><ul><ul><li>Port Conflict </li></ul></ul><ul><ul><li>Login timed out </li></ul></ul><ul><ul><li>JVM missing from browser </li></ul></ul><ul><li>Mail Notifications do not work </li></ul><ul><ul><li>Port conflict </li></ul></ul><ul><ul><li>Relay Host missing </li></ul></ul><ul><ul><li>Configuration incomplete </li></ul></ul><ul><ul><li>Policy setting for mail accounts </li></ul></ul>
  45. 45. Common Issues <ul><li>Blank List Portlet </li></ul><ul><ul><li>ConcurrentModificationException ListPortlet.doView.viewViewItem(CN=scoot,OU=people,dc=ibm,dc=com): Unable to write attachment to temporary file </li></ul></ul><ul><li>Form/List Portlets cannot be configured </li></ul><ul><ul><li>Read-only directory </li></ul></ul>
  46. 46. Common Issues <ul><li>Single Sign-on with Domino not working </li></ul><ul><ul><li>Time issues </li></ul></ul><ul><ul><li>Multiple SSO documents </li></ul></ul><ul><li>Errors in Team Spaces </li></ul><ul><ul><li>[25/07/05 16:06:57:875 BST] 4ce73434 LdapRegistryI E SECJ0342E: Could not get the groups matching the pattern cn=wpsadmins,o=default organization because of the following exception javax.naming.NameNotFoundException: [LDAP: error code 32 - No Such Object]; remaining name 'cn=wpsadmins,o=default organization‘ 25/07/05 16:06:57:891 BST] 4ce73434 LdapRegistryI E SECJ0341E: Could not get the uniqueId for the group cn=wpsadmins,o=default organization because of the following exception </li></ul></ul>
  47. 47. Common Issues <ul><li>Document Editors not working </li></ul><ul><ul><li>Error 500: Portlet Couldn’t be contacted </li></ul></ul><ul><ul><li>Error 500 </li></ul></ul><ul><ul><li>An unexpected error occurred during the operation. Error code=0001. </li></ul></ul><ul><li>Cloudscape shuts down when admin logs off </li></ul><ul><ul><li>This can occur due the batch file used to start the Cloudscape Network Server listening for log-on and log-off events, change startNetworkServer.bat to have –Xrs flag </li></ul></ul><ul><ul><ul><li>START &quot;Cloudscape&quot; /min %JAVA_HOME%injava –Xrs -cp %CNS_CLASSPATH% -Xms512M -Xmx1024M -Ddb2j.drda.sendLongBitVaryingAsBlob=true -Ddb2j.drda.sendLongVarcharAsClob=true com.ibm.db2j.drda.DB2jServer start -ld </li></ul></ul></ul>
  48. 48. Portlets <ul><li>You cannot deploy the following portlets to pages outside of Workplace applications or templates: </li></ul><ul><ul><li>Discussion </li></ul></ul><ul><ul><li>Chat </li></ul></ul><ul><ul><li>Team Task List </li></ul></ul><ul><ul><li>Team Calendar </li></ul></ul><ul><ul><li>Team Space Home </li></ul></ul><ul><ul><li>Membership </li></ul></ul>
  49. 49. Portlets <ul><li>Domino Web Access </li></ul><ul><li>Domino Application Portlet </li></ul><ul><li>Exchange </li></ul><ul><li>IMAP </li></ul><ul><li>POP3 </li></ul><ul><li>IBM RSS News feed </li></ul><ul><li>IBM WebSphere </li></ul>
  50. 50. Domino Web Access <ul><li>Secure WSE to Domino LDAP </li></ul><ul><li>Setup Single Sign On (SSO) between WebSphere and Domino </li></ul><ul><li>Configure the Lotus Collaborative Components (LCC) settings </li></ul><ul><li>Deploy the DWA portlets </li></ul>
  51. 51. Domino Application Portlet <ul><li>Renders web-enabled Domino applications within the Portal interface. </li></ul><ul><ul><li>No coding required </li></ul></ul><ul><ul><li>manages cookies, caching, user authentication, and framing. </li></ul></ul><ul><li>Deploy the portlet by dragging the “Domino Application Portlet” from the palette onto the page where you want to deploy it. </li></ul><ul><li>Configure the portlet by clicking the “Wrench” icon on the portlet </li></ul>
  52. 52. Domino Application Portlet <ul><li>Demo </li></ul>
  53. 53. POP3/IMAP
  54. 54. Exchange
  55. 55. Other Examples <ul><li>IBM RSS Portlet </li></ul><ul><ul><li>Used for News feeds, can be downloaded from the Workplace & Portal Catalog </li></ul></ul><ul><li>IBM WebSphere Portal Application Integrator (WPAI) </li></ul><ul><ul><li>Used to build portlets quickly that can connect to data sources such as a Domino database </li></ul></ul>
  56. 56. Tuning <ul><li>Heap Sizes </li></ul><ul><ul><li>Take your physical memory size, look at your memory consumption prior to running IBM Workplace Services Express. This is normally around 300-500Mb, the remaining memory can be utilised by WSE. Remember that all the JVM maximum heap sizes and operating system requirements must not to exceed the actual install memory. </li></ul></ul><ul><ul><ul><li>Min = 384 MB, Max = 1536 MB for 1CPU with 4 GB memory and 2CPU with 4 GB memory </li></ul></ul></ul><ul><ul><ul><li>Min = 256 MB, Max = 1024 MB for 1CPU with 2 GB memory and 2CPU with 2 GB memory </li></ul></ul></ul><ul><li>Logging </li></ul><ul><ul><li>Set preferences for console to refresh from 60 to 300seconds </li></ul></ul><ul><ul><li>Set log files to 32MB and 8 versions </li></ul></ul><ul><ul><li>Set filter for errors only on service logs </li></ul></ul>
  57. 57. Tuning <ul><li>Connections </li></ul><ul><ul><li>You can increase the maximum connections in the connection pools for the JDBC providers below: </li></ul></ul><ul><ul><ul><li>wps50DS – Increase to 50 </li></ul></ul></ul><ul><ul><ul><li>wmmDS – Increase to 30 </li></ul></ul></ul><ul><ul><ul><li>lwpApp – Increase to 100 </li></ul></ul></ul><ul><ul><ul><li>wcmDS – Min 16 maximum 64 </li></ul></ul></ul><ul><li>Session Timeouts </li></ul><ul><ul><li>Session timeout 30 minutes </li></ul></ul><ul><li>Processor Affinity on Intel </li></ul><ul><ul><li>Binding Java processes to Processor 0 </li></ul></ul>
  58. 58. Tuning <ul><li>Database </li></ul><ul><ul><li>For Microsoft SQL Server refer to the product documentation </li></ul></ul><ul><ul><li>IBM DB2 Express </li></ul></ul><ul><ul><ul><li>Update general DB2 settings </li></ul></ul></ul><ul><ul><ul><li>Update WPS50 database settings, e.g. bufferpools </li></ul></ul></ul><ul><ul><ul><li>Create additional performance indexes </li></ul></ul></ul><ul><ul><ul><li>Update table statistics regularly via the runstats command </li></ul></ul></ul><ul><ul><ul><li>Run regular reorganises of the tables using the reorg command </li></ul></ul></ul>
  59. 59. Red Hat Promotion <ul><li>Get a 90-day evaluation copy of IBM Workplace Services Express and Red Hat Enterprise Linux -- at no charge! </li></ul><ul><li>The offer: For a limited time only, customers can download a complimentary copy of IBM® Workplace™ Services Express and Red Hat Enterprise Linux preconfigured in a VMware virtual environment for a 90-day evaluation period. Customers can electronically download the package from the Red Hat Network. </li></ul><ul><ul><li>http://www.lotus.com/products/product5.nsf/wdocs/wselinuxpromo </li></ul></ul>
  60. 60. Useful Links <ul><li>Documentation Page </li></ul><ul><ul><li>http://www.lotus.com/products/product5.nsf/wdocs/productdoc#info </li></ul></ul><ul><li>InfoCenter </li></ul><ul><ul><li>http://publib.boulder.ibm.com/infocenter/wseic/v2r5/index.jsp </li></ul></ul><ul><li>Release Notes: </li></ul><ul><ul><li>http://publib.boulder.ibm.com/pvc/wse/250/en/release_notes.html </li></ul></ul><ul><li>DeveloperWorks Forum </li></ul><ul><ul><li>http://www-128.ibm.com/developerworks/forums/dw_forum.jsp?forum=451&cat=41 </li></ul></ul><ul><li>WSE Sizing Guidelines </li></ul><ul><ul><li>http://partnerinfo.software.ibm.com/smi13.nsf/SearchResults-AP?SearchView&query=Workplace%20Services%20Express </li></ul></ul><ul><li>WebSphere Application Server Tuning Guide </li></ul><ul><ul><li>ftp://ftp.software.ibm.com/software/webserver/appserv/library/wasv502base_perf.pdf </li></ul></ul>
  61. 61. Questions

×