Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software © 2002 IBM Corporation Domino Multi-Versioning Mike Gordon – IBM Global Services Advanced Technical Support

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Agenda  Terminology and Myths  Underlying Architectures  Domino Environments  Packaging  Administering a Multi-Version Environment  Product Install of Domino 6  Applications

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Multi-Versioning Terminology  Multi-version capable release of Domino for iSeries - – A Domino for iSeries release (or MR) that can be independently installed on the same OS/400 partition as another, different, multi- version capable release. Servers on that OS/400 partition can be configured for and use any of the installed multi-version capable releases.  Multi-versioning - – Installing more than one multi-version capable release of Domino for iSeries on a single OS/400 partition.

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Multi-Versioning Terminology  Logical Partition (LPAR) - – Distribute resources within a single iSeries server to make it function as if it were two or more independent servers  Updating a Domino Server – Typically meant upgrading a Domino Code. Applying newer releases of software to a subset of Domino Servers.

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Multi-Versioning Myths  NOT multiple copy installs – Only one copy of the same MR or release can be installed  NOT a substitute for LPAR – All servers are using same OS/400 code, SYSVALs, QNOTES user profile, TCP/IP configuration...  NOT R5 (or early release 6.0.n) compatible – Multi-version capable releases will replace these releases and update existing servers when installed  NOT multiple languages for same release – Only one QNOTES profile for all servers and it has one user locale  NOT required! – Don't have to have multiple releases however have to be aware of install differences and applications can be affected

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software R5/D6.01 and 6.02 Product Layout  Library and Execution Directory – Qnotes library and user profile – QIBM/Proddata/Lotus/Notes  Product LPP – 5769LNT – 5733LD6  NOTE: Domino 6.03 holds LD6 product number

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software R5/Domino and Code Streams  What is stored in the QNOTES Library? – All Domino server code – PGMs, PNLGRPs, – *LOCALS

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software R5/Domino and Code Streams  Symbolic links to objects in OS/400 Integrated File System (IFS)  /QIBM/PRODDATA/LO TUS/NOTES & /QIBM/USERDATA/LO TUS/NOTES  Note: Still used in MV but is shared across MV capable releases

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Domino Environments for iSeries  Domino R5 installations: no change  Domino 6 installations: customers can choose whether to use multi-versioning (6.0.3, 6.5 and later)  Upgrade from R5 before implementing multi-versioning  “Dnext” (major version after 6.5) will support multi-versioning

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Multi-version capable release packaging

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Multi-version capable release packaging (MR 6.0.3)

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Multi-version capable release packaging (D6.5)

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software © 2002 IBM Corporation Install Considerations

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Installing First Multi-Versioning Capable Release QNOTES R5/D6 Server03 R5/D6 Server02 R5/D6 Server01 *Base SAVF for MR Domino 6.n Option 1n SAVF QNOTES R5/D6 Server02 Servers must be ended 1 Install maintenance release 2 Clear QNOTES 3 D6.0.3/D6.5 Server03 D6.0.3/D6.5 Server02 D6.0.3/D6.5 Server01 Servers updated in post-installation exit of option 1n 5 New library QDOMINO6nn is created; QNOTES is refreshed with “stub” commands, etc. QDOMINO6nn 4

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Installing Next Multi-Versioning Capable Release QNOTES Install maintenance release 1 D6.0.3 Server03 D6.0.3 Server02 D6.0.3 Server01 QDOMINO603 3 Current Domino servers are unaffected by installation *Base SAVF for MR Domino 6.n Option 1n SAVF New library QDOMINO650 is created on system 2 QDOMINO650

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Removing Multi-version capable release QNOTESQSYS QDOMINO60n+1 DLTLICPGM PRODUCT(5733LD6) OPTION(1n+1) QDOMINO60n  Install exit removes Domino MRI from QNOTES and QSYS if it is part of release option removed. If MRI removed exit copies next latest release MRI to QNOTES and QSYS if there is one installed

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Viewing Domino Releases Installed  DSPSFWRSC and F11 on to see Release

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software © 2002 IBM Corporation Administering a Multi-Version Environment

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software D6.0.3 Server03 Updating Servers to Use New Release QNOTES End server that you want to change 1 D6.0.3 Server02 QDOMINO603QDOMINO650 D6.0.3 Server01 Restart server 3 Update server to use new release 2 D65 Server02 Keep in mind: Individual servers can be updated Server downtime for maintenance releases is reduced (not down during code installation) Old code is not automatically removed

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Update Domino Server Command  Updating typically meant “Upgrading”  With MV totally new concept (UPDDOMSVR) – *all or multiples  Note: Defaults to Latest release\ Example: UPDDOMSVR SERVER(ServerX) TORLS(*LATEST)

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Domino Command Support  Latest" installed release copies commands to QSYS and QNOTES  All commands in any installed library will operate on all configured servers – Examples: WRKDOMSVR, STRDOMSVR, ENDDOMSVR SAVDOMBRM,... All "SERVER(*ALL)" commands – Must have server's configured release installed to start or change server  To create a server that is NOT the latest installed release use the CFGDOMSVR from the appropriate installed library – Example: “CFGDOMSVR..." creates a server that has the latest installed release "QDOMINO60n/CFGDOMSVR..." creates a server that uses release 6.0.n

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software WRKDOMSVR Server Command  Shows what release and what library is used for each server  Use F11 to change the views

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Creating or Changing Domino D6 Servers with More than One Version D6.0.3 Server02 D6.0.3 New Server D6.0.3 Server03 Qdomino60/ Cfgdomsvr chgdomsvr QDOMINO603QDOMINO650 D6.0+1 New2 D6.0.N+1 Server 2 CFDOMS VR CHGDOMSVR Note: QSYS and QNOTES have latest installed release's commands

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software IBM Rochester Today

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software © 2002 IBM Corporation Product Install

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software iSeries Product Installation Changes from R5  Removed: – C++ API and Toolkit Available on the Domino for iSeries or Lotus Developer Domain websites and on the Lotus Quarterly – LSX toolkit Available on the Domino for iSeries or Lotus Developer Domain websites and on the Lotus Quarterly – Single logon Available on the Domino for iSeries website – Advanced services partitioning support included, clustering/billing controlled by license agreement – HiTest API  no longer supported  Moved:  Option 1 feature: iSeries Navigator plug-in  Moved to *Base option  Changed: – C API is now option 1 – previously option 3

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Installshield-based Installation wizard

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Remote Installation

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Installation via iSeries Navigator

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software LODRUN Enhancements

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software LODRUN Example

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software LODRUN Example

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software LODRUN Example

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Pre-Upgrade Domino 6 Checklist

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Upgrading to Domino 6 Tips

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Domino 6 Server Upgrade

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Converting System and Mail databases to ODS 43

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Updating views and FT indexes for databases

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Java-based Server Setup Wizard initiated from iSeries Navigator

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Common Platform interface, but with OS/400 option

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Java-based Server Setup Wizard

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Java Server Console integration

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Domino Controller & Console

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Tips  Consider the time required to upgrade a system when choosing your strategy  Upgrade to Domino 6 upgrades all servers on a system  Domino 6 Domino Directory design can be pushed to all servers  Document your plan and follow the procedures

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software © 2002 IBM Corporation Applications and Multi-versioning

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Applications and Multi-versioning  Applications should not use library QNOTES and /QIBM/PRODDATA/LOTUS/NOTES paths – Every release installs into its own library (QDOMINO60n) and has its own execution path (/QIBM/PRODDATA/LOTUS/DOMINO60n...) – Domino servers are internally configured to run with the library and path that match their configured release  When accessing a Domino server's database, an environment (library, user profile, and PATH) has to be set up based on the server's configuration. – CL commands and APIs (added R and D6.0.1) to help RUNDOMCMD, SETDOMENV CL commands QnninSetDominoEnv, QnninGetDominoEnv, QnninListDominoRlsI  Applications that bind to QNOTES/LIBNOTES to use Domino APIs are supported via a "Stub"

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Domino D6 applications and the QNOTES/LIBNOTES "Stub"

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Domino D6 applications and the QNOTES/LIBNOTES "Stub"

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Domino D6 applications and the QNOTES/LIBNOTES "Stub"

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Domino D6 applications and the QNOTES/LIBNOTES "Stub"

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Sources for information  Lotus Domino iSeries Home Page, “What’s New” – 1.ibm.com/servers/eserver/iseries/domino/whatsnew.htm 1.ibm.com/servers/eserver/iseries/domino/whatsnew.htm  Redbook coming out 1Q04 – b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg html ?Open b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg html ?Open – SG

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software Questions

Domino iSeries Multi-Versioning © 2002 IBM Corporation | Lotus software © Copyright IBM Corporation All rights reserved. The information contained in these materials is provided for informational purposes only. While efforts were made to verify the completeness and accuracy of the information contained in these materials, it is provided AS IS without warranty of any kind, express or implied. In addition, this information is based on IBM's current product plans and strategy, which are subject to change by IBM without notice. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, these materials or any other materials. Nothing contained in these materials is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in these materials to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in these materials may change at any time at IBM's sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. IBM, the IBM logo, the e-business logo and other IBM products and services are trademarks or registered trademarks of the International Business Machines Corporation, in the United States, other countries or both. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries or both. Microsoft, Windows, Windows NT and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries or both. All other trademarks, company, products or service names may be trademarks, registered trademarks or service marks of others.