Revised: June 18, 2001 IBM® ^ pSeries Solution Series for e-business Lotus® Domino™ Server R5 Implementation Guide Page 1
Lotus Domino Server R5 Implementation Guide June 18, 2001 Table of Contents pSeries Lotus Domino Server e-business Solution Overview . . . . . . Page 3 Supported Software Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 5 PTF Matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 6 Performance Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Lotus Domino Server R5 Implementation Guide June 18, 2001 pSeries Lotus Domino Server e-business Solution Overview Domino™, a server-based product from Lotus® Corporation of IBM®, is positioned in the e-business™ marketplace as a messaging/groupware system with dynamic application serving.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Domino is a generic name for a family of server products: Domino Mail Server for mail, groupware, calendaring and Internet support functions; Domino Application Server for mail plus application development capabilities; and Domino Enterprise Server which adds partitioning, clustering, and usage tracking capabilities on top of Domino Application Server.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Supported Software Releases Domino Server R5 is supported on the following versions of AIX: Domino Release Domino Server R5 AIX Release 4.3.1 4.3.2 4.3.
Lotus Domino Server R5 Implementation Guide June 18, 2001 PTF Matrix In order to install Domino Server R5 on AIX, certain program temporary fixes (PTFs) are required or specific authorized program analysis reports (APARs) should be read. The following table lists the patch requirements: Component Bos.mp Bos.up Bos.rte.aio Bos.rte.libc Bos.rte.libpthreads Bos.rte.commands Bos.rte.control Bos.rte.tty Bos.rte.net Bos.rte.cron Bos.net.tcp.client Bos.net.tcp.server Bos.net.tcp.smit Bos.sysmgt.smit Bos.sysmgt.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Performance Guidelines Disclaimer: Performance of applications can only be made in a general sense. Specific characteristics of application implementation on specific hardware will yield different performance characteristics. Performance tools for measurement and tuning exist in most instances and should be used.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Other Workload Factors Other factors that can impact the actual load that a given user community places on a Domino server include: Ÿ The extra overhead associated with a significant number of dial-up connections, such as mobile employees getting E-mail or suppliers accessing a supply chain automation application. Ÿ The extent to which applications access back-end data like relational databases and transaction monitor systems.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Distribute I/O Across Physical Disks Our experience has shown that physical and logical disk structures are our customers' least understood system resource, and the one most often undersized. The best way to boost performance on many Domino servers is to distribute I/O across separate physical disk subsystems. Ideally, you want to put the following I/O-intensive files on separate physical disks: Ÿ The Notes paging file Ÿ Your .
Lotus Domino Server R5 Implementation Guide June 18, 2001 Ÿ For partitioned systems, you will need to ensure the NSF Buffer Pool is properly set since Domino cannot automatically determine the memory that’s actually available to it across multiple partitions. This can be accomplished by placing the following variable in the notes.
Lotus Domino Server R5 Implementation Guide June 18, 2001 additional users probably won't be equivalent to the resources required for an equal number of your current users. For example, per-user memory requirements decrease as the number of users increases, because fixed memory overhead is divided across more users. Consider Clustering Clustering is the premier feature of the Domino Enterprise Server.
Lotus Domino Server R5 Implementation Guide June 18, 2001 specialized benchmarks that are unique to a customer’s deployment. This allows Business Partners to assess specific server environments and compare it with various RS/6000 models and configurations. An independent agency audits and published NotesBench reports. For the latest information and NotesBench reports, see http://www.notesbench.org or http://ideasinternational.com.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Sizing Guidelines Disclaimer: System sizing for applications can only be described from a general perspective. Definitive characteristics of application implementation and behavior on specific hardware will yield different sizing requirements. Use system sizing tools when available for your specific environment. Domino on AIX: Several factors should be considered when determining the size of the hardware for use with Domino Server.
Lotus Domino Server R5 Implementation Guide June 18, 2001 A. Domino R5 on AIX Domino R5 was designed to provide overall performance and scalability improvements over Domino R4.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Among the key Domino R5 features that enable it to scale with these platforms are: Ÿ Unlimited database size (currently certified up to 64 GB), to support increased database workloads. Ÿ Directory scalability in excess of one million users, to easily handle the directory requirements of even the largest deployments.
Lotus Domino Server R5 Implementation Guide June 18, 2001 B. RS/6000 Domino Server Sizing Tool The RS/6000 Domino Server Sizing Tool is a server-sizing, capacity-planning tool used to suggest server configurations based on benchmark information and on your customer requirements. You can evaluate different server offerings with a mix of workloads that map to your internal deployment, such as mail, discussion databases, groupware, and Web users.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Sample Configurations The verification test was run on the configuration mentioned previously. Below are sample configurations for light (small), medium, and high (large) workload /user communities. These are meant to be guideline configurations relative to memory, disk, and adapters. Specific configurations should be based on customer requirements. The configurations briefly described here can be found in Appendix A.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Pre-installation Support A. Pre-sales Technical Support Further assistance is available to assist in overall marketing activities through Partner Line. When called, the first step will be the Business Partner entitlement. Partner Line for non-entitled Business Partners will also send the information that will enable the Business Partner to gain access. Advanced and Premiere level IBM Business Partners are eligible for Partner Line.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Domino product education is available worldwide from Lotus Authorized Education Centers. A full range of Domino courses from administration, to installation, to programming are available for a fee and can lead to Lotus Domino certification. For courses and schedules access the Domino homepage at http://www.lotus.com.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Implementation Process Overview The installation of Domino not only includes installing and configuring the server software, but also making sure that the network, hardware, and operating system meet certain requirements. Installation requires training and performance tuning. This section discusses items that are important to the installation process that are usually overlooked or not normally considered as being part of the install process. 1.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Network: Ÿ Network equipment (hubs, switches, routers, firewalls) Ÿ Network diagram Ÿ WAN diagram Ÿ Bandwidth capacity Next, you will probably want to conduct a detailed inventory of the server equipment and all related equipment. The list below contains some items that you should include in your inventory. Since every environment is different, you may have additional equipment or items that may be pertinent to your particular environment.
Lotus Domino Server R5 Implementation Guide June 18, 2001 connectivity maps, and a list of possible errors that they or end users may encounter during the installation project and how to resolve them. After an initial course, it is highly recommended that each administrator and support staff member receive full training on Domino R5.
Lotus Domino Server R5 Implementation Guide June 18, 2001 5. Document Experiences, Problems, and Solutions From the Pilot Project The most important item of the pilot project is the documentation of the administrator’s and end users’ feedback. It is vital that feedback be gathered from the very beginning all the way through the end of the pilot project.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Ÿ Document issues encountered and their solutions Ÿ Coordinate communication, including project databases, meetings, and conference calls Set responsibilities and designate who performs which functions and at what times. Ensure that there is a contact person for each role and responsibility -- this person should be one of the members of the install team.
Lotus Domino Server R5 Implementation Guide June 18, 2001 1. What should be done when a given system fails? For example, when System A fails the solution is to verify that System B came online and took over the responsibilities of System A. 2. Who should be notified? A list of contact telephone numbers should be available. This information should contain office, home, pager, and mobile telephone numbers of the administrator responsible for the equipment that has failed.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Be sure to designate one or more project leaders for this phase of the Domino implementation. These leaders should be responsible for: Ÿ Coordinating the schedule. Ÿ Setup and monitor the installation of the server hardware and operating system. Ÿ Notifying users and management of any issues that may effect them. Ÿ Capture knowledge and share it through best practices. Ÿ Documenting issues encountered (and their solutions).
Lotus Domino Server R5 Implementation Guide June 18, 2001 Ÿ Tape backup Ÿ Disaster recovery and documentation Workstation: Ÿ Hardware and operating system requirements Ÿ User training Ÿ Tape backup Ÿ Disaster recovery and documentation Be sure to designate one or more project leaders for this phase of the Domino implementation.
Lotus Domino Server R5 Implementation Guide June 18, 2001 When scheduling, consider the effect on your organization and solicit input from the representatives on your team and from management for each area or department that will be affected by this phase of the process. Some departments maybe in a period when they are working on time, or mission critical projects and can not be disturbed. Because of this, parts of the project may have to be scheduled after normal business hours.
Lotus Domino Server R5 Implementation Guide June 18, 2001 projects and cannot be disturbed. Because of this, parts of the project may have to be scheduled after normal business hours. Be certain to allow sufficient time not only to perform the tasks involved in this part of the project, such as doing system backups, installing equipment and software, checking for problems, and training, but also allow time to record issues encountered, solutions created, and feedback.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Be certain to allow sufficient time not only to perform the tasks involved in this part of the project, such as doing system backups, installing equipment and software, checking for problems, and training, but also allow time to record issues encountered, solutions created, and feedback. This initial investment of time results in streamlined procedures and increased satisfaction.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Education can be conducted using any of the following methods. Each method has its pros and cons, depending on your particular environment.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Checklist for Implementation The checklist provided here is a guide to assist in the installation of Lotus Domino Server. Although this checklist is a good reference point, it may not contain everything since each environment is unique. TASK 1. Select an install team. 2. Take a complete inventory of server, network, and workstation equipment. 3. Train Domino and Network Administrators. 4. Setup a pilot project. 5.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Installation Steps Before installing a Lotus Domino R5 Server, certain software, hardware and system requirements must be met and the AIX environment must be prepared. Step by step instructions are provided here to assist in the correct installation of the Lotus Domino Server software.
Lotus Domino Server R5 Implementation Guide June 18, 2001 These daemons must be stopped in order to free up certain network ports that the Domino Server will need. In order to check to see if you have any of these daemons running, use the command ps -ef | grep . If the daemons are not running, then please skip to step 6. The easiest daemon to stop is sendmail. Although the Domino R5 installation will stop this for you, you must still disable the daemon from restarting upon boot.
Lotus Domino Server R5 Implementation Guide June 18, 2001 The SMIT utility displays the screen to create a new volume group. Enter a new volume group name. In our example we will use the preferred name dominovg. Also, select the physical volume to use in this new volume group. When this information has been entered, press Enter. A pop up message will appear asking you to verify that you really want to create a new volume group. Press Enter again to create the volume group.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Step 12 - Create a File System for the Domino Binaries Create a new journaled file system (JFS) for the Domino binaries with the command smitty crjfslv. The SMIT utility displays a menu for creating a journaled file system. Select Add a Standard Journaled File System and press Enter. You will see the configuration screen for the new file system. Select dominobinlv for the logical volume name.
Lotus Domino Server R5 Implementation Guide June 18, 2001 chdev -l sys0 -a maxuproc=128 To check the current setting for the maximum number of fixed licenses, use the command lslicense. This value must be a minimum of 2 or more in order for the Domino server to function properly. To change the value, use the command chlicense -u .
Lotus Domino Server R5 Implementation Guide June 18, 2001 Step 5 - Select the Type of Domino Server to Install The next screen asks you which of the different types of Lotus Domino Servers you want to install. The default answer is Domino Mail Server. Press the Spacebar until you see the server type you want to install. Press the Tab key to continue. Step 6 - Select the Directory Location for the Domino Binaries On the next screen, select the directory location for the Domino binaries.
Lotus Domino Server R5 Implementation Guide June 18, 2001 This can be done from the .profile file for Notes users. In addition, you would need to update .profile with binary and data directories in the PATH variable. Step 16 - Start the HTTP Server Task For Server Configuration We will start the Domino HTTP task so we can configure the new Domino Server with our Web browser. To start the HTTP task, type /opt/lotus/bin/http httpsetup at the prompt and press Enter.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Post-installation Support A. Domino Product Support IBM provides the technical post installation support for Lotus Domino and related software. Several fee offerings are available and recommended based on the specifics of the customer. Overall, support and upgrade protection is offered under a program called Passport Advantage.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Ÿ Additional designated callers available for a fee More information about Passport Advantage support is available if you are partnering with a Lotus Business Partner through that Business Partner. Or you may contact URL http://www.lotus.com/home.nsf/welcome/support. Customers will most likely also need to obtain Lotus quarterly upgrades and releases as they occur. This is supported under a program called Subscriptions by Lotus.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Services Available IBM provides a set of services to assist both Business Partners and customers to implement Domino solutions. These services can also be marketed and sold by Business Partners. For more details, go to http://www.as.ibm.com/asww.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Additional Technical Resources URLs: IBM pSeries Web Site http://www-1.ibm.com/servers/eserver/pseries IBM AIX PTF Information http://techsupport.services.ibm.com/rs6000/fixes IBM RS/6000 Support http://techsupport.services.ibm.com/rs6000/support IBM Services for RS/6000 and Domino http:/www.as.ibm.com/asww Lotus Domino Information http://www.lotus.com/r5 Domino Support http://www.lotus.com/home.
Lotus Domino Server R5 Implementation Guide June 18, 2001 RS/6000 SP Monitoring: Keeping It Alive IBM Redbook SG24-4873 International Technical Support Organization, IBM Corporation Inside the RS/6000 SP IBM Redbook SG24-5145 International Technical Support Organization, IBM Corporation RS/6000 SP High Availability Infrastructure IBM Redbook SG24-4838 International Technical Support Organization, IBM Corporation High Availability on the RISC System/6000 Family IBM Redbook SG24-4551 International Technical
Lotus Domino Server R5 Implementation Guide June 18, 2001 Appendix A. Sample Configurator Configurations The information shown here does not necessarily constitute a complete or valid order. Prices are in US dollars. A. Small Configuration The configuration is an IBM pSeries 640 with 4 POWER3-II 375 MHz processors, 8 GB memory, and 64 18.2 GB drives for data.
Lotus Domino Server R5 Implementation Guide June 18, 2001 7133-D40 Advanced SSA Disk Subsystem 4 51000 736 (Rack-Mounted) 0987 Rochester Integration 4 N/C 8022 50/60Hz AC, 300 VDC Power 4 8000 4 1000 64 288000 4 N/C Supplies 8031 Raven Black Drawer Cover 8518 One 10K/18.
Lotus Domino Server R5 Implementation Guide June 18, 2001 5005 Preinstall 1 N/C 5924 AIX 4.3 PII - English 1 N/C 9001 Asset Registration 1 N/C ========= 5692-AIX OTC 50 Lotus Domino Server 1 ******************************* GRAND TOTALS 5000 ******************************* Hardware Price 441274 Software OTC 5050 ========= Grand Total 446324 Monthly Maintenance 1016 B.
Lotus Domino Server R5 Implementation Guide June 18, 2001 5005 Preinstall 1 N/C 5203 4-Way RS64 III 500MHz Processor 2 148000 1 75 1 95 6197 190A Processor Power Regulator 1 4000 6230 Advanced SerialRAID Plus 1 3000 1 725 1 750 6324 Primary I/O Drawer, 5 EIA 1 8000 6540 IPL Disk Mounting Hardware, 1 100 1 100 840 F Card, 4MB L2 Cache 5992 System Control and Initialization Cable 6132 CEC to Primary I/O Drawer Power Control Cable, 3m Adapter 6283 Redundant AC Power Supply, I/O
Lotus Domino Server R5 Implementation Guide June 18, 2001 ********************************* Product SOFTWARE Description ********************************* Qty License 1 N/C 4061 AIX 4.3 1 N/C 5005 Preinstall 1 N/C 9001 Asset Registration 1 N/C 5765-C34 AIX Version 4 ========= 5765-C34 OTC 0 5692-AIX System Software 1 N/C 0598 AIX Welcome Center 1 N/C 0838 AIX 4.3 Update CD 1 N/C 0857 AIX 4.3 1 N/C 0859 Preinstall AIX 4.3 Server 1 N/C 1 N/C Bundle 0860 AIX 4.
Lotus Domino Server R5 Implementation Guide June 18, 2001 C. Large Configuration The configuration is an IBM pSeries 680 with 24 RS64-IV 600 MHz processors, 96 GB memory, and 288 18.2 GB drives for data. ********************************* Product HARDWARE Description 7017-S85 pSeries 680 ********************************* Qty Purchase Maint 941 F 1 11188 1.44MB 3.
Lotus Domino Server R5 Implementation Guide June 18, 2001 6323 Secondary I/O Drawer Group 1 734 6326 Support Processor Group 1 2700 6503 Remote I/O Hub, Dual Loop 1 8000 6547 SCSI 6-pack Hot Swap Back Plane 1 600 7036 36U I/O Rack 1 3100 9171 Power Distribution Unit, 1 N/C 9300 Language - English (US) 1 N/C 9800 Power Cord - US/Canada 1 N/C 32 F Side-Mount , 1 Phase ========= 7017-S85 Price ====== 1983130 Monthly Maintenance 10269 7014-T00 Enterprise Rack - 36 EIA 1 3100
Lotus Domino Server R5 Implementation Guide June 18, 2001 9001 Onlinet Network for AIX, RS-232 1 N/C Cable ========= 9910-EP8 Price ********************************* Product 6625 SOFTWARE Description ********************************* Qty License 5765-C34 AIX Version 4 1 N/C 4061 AIX 4.3 1 N/C 5005 Preinstall 1 N/C 9001 Asset Registration 1 N/C ========= 5765-C34 OTC 0 5692-AIX System Software 1 N/C 0598 AIX Welcome Center 1 N/C 0838 AIX 4.3 Update CD 1 N/C 0857 AIX 4.
Lotus Domino Server R5 Implementation Guide June 18, 2001 Appendix B. IBM Production Configuration The vast majority of Domino servers in the IBM deployment run on the AIX platform today. Managed by IBM Global Services, this is the largest Domino deployment in the world with over 1900 R5 mail and application servers supporting more than 300,000 production Notes and Web users.
Lotus Domino Server R5 Implementation Guide June 18, 2001 represents an opportunity for increased user workload and scalability with the same configuration. Only time will tell.