Are you looking to deploy Domino V10 but don’t know where to start? Upgrade servers or clients first? Should I upgrade the ODS? If you have questions like these, this session is for you. Get a complete understanding of the process to upgrade to Domino V10, and learn from best practices and tips from the field.

2. #dominoforever
Domino Tech School
Upgrading to Domino V10: Best Practices
Delivered by:
Kim Greene Christoph Adler
Kim Greene Consulting, Inc. panagenda

3. #dominoforever
Page 3
Kim Greene - Introduction
Owner of Kim Greene Consulting, Inc.
– www.kimgreene.com
IBM Collaboration Solutions and MongoDB
Services offered include:
– System and application performance optimization
– Administration
– Upgrades
– Troubleshooting
– Health, performance, security, etc. reviews
– Custom development
– Enterprise integration
– Migrations
Blog: www.dominodiva.com
Twitter: iSeriesDomino

4. #dominoforever
Page 4
Christoph Adler - Introduction
Senior Consultant at panagenda
– www.panagenda.com
18 years of IBM solutions experience
Focused on
– IBM Notes Client Management
– Analysis and Optimization of ICS Infrastructures
– Cloud onboarding
– Application Modernization
Slideshare: https://www.slideshare.net/christophadler50
Twitter: @cadler80

5. Page 5
Planning

6. #dominoforever
Page 6
Planning Checklist
1. Determine if system will support version upgrading to
2. Determine if compatible OS level is being used
3. Verify all needed OS software options are installed
4. Obtain necessary OS service packs / PTFs
5. Obtain necessary hotfix(es)
6. Verify compatibility with extended products
7. Verify compatibility with 3rd party add-on products

7. #dominoforever
Page 7
Planning Checklist
8. Plan for upgrading the Notes client (more details later)
9. Plan for the new ODS level
10. Determine if any unsupported notes.ini variables are in use
11. Plan when to upgrade the Domino Directory design
12. Plan to upgrade the mail template
13. Review template customizations
14. Plan to test custom applications at new release

8. #dominoforever
Page 8
Planning – Steps 1 & 2
1. Determine if system will support version upgrading to
2. Determine if compatible OS level is being used
• Found in System Requirements document
• 10.0.1: https://www-01.ibm.com/support/docview.wss?uid=ibm10737115
• Click on ‘Operating Systems’
– Note: IBM i is a supported platform, the table on the site will be updated soon
to reflect this

9. #dominoforever
Page 9
Planning – Steps 1 & 2
Find your platform of choice and click ‘Detailed system requirements’

10. #dominoforever
Page 10
Planning – Steps 1 & 2
For the IBM i, there is a Software Compatibility Guide as well:
– https://www-01.ibm.com/common/ssi/cgi-bin/ssialias?htmlfid=41013141USEN&
– Note: Domino 10.0.1 is supported on the IBM i, the above document and graphic below were not yet
updated at the time the webcast was given

11. #dominoforever
Page 11
Planning – Step 3
3. Verify all needed OS software options are installed
Click on ‘Detailed system requirements’ for chosen platform
Click ‘Proceed’ on the next screen

12. #dominoforever
Page 12
Planning – Step 3
Select to ‘Download PDF’

13. #dominoforever
Page 13
Planning – Step 3
Leave all options selected

14. #dominoforever
Page 14
Planning – Step 3
Resulting PDF contains all required information

15. #dominoforever
Page 15
Planning – Step 3
Check ‘detailed system requirements’ section of System Requirements document
for any additional details

16. #dominoforever
Page 16
Planning – Steps 4 & 5
4. Obtain necessary OS service packs / PTFs
– Locate and download as appropriate
5. Obtain necessary hotfix(es)
– Only one hotfix can be installed
– Contact HCL/IBM Support to:
• Determine if hotfix is included in new release
• If not, obtain new hotfix to work with release and FP/IF level upgrading to

17. #dominoforever
Page 17
Planning – Steps 6 & 7
6. Verify compatibility with extended products
– Check prerequisites for extended products
• Traveler
• Sametime
• Enterprise Integrator
7. Verify compatibility with 3rd party add-on products
– Check with vendor to ensure planned release is supported
• Spam, anti-virus, mail signature, etc.

18. #dominoforever
Page 18
Planning – Steps 8 & 9
8. Plan for upgrading the Notes clients (more details later)
– Three versions: Standard, Basic and ICAA
9. Plan for the new ODS level
– Most major releases have a new ODS level
– Get new features with the latest ODS
– Examples:
– R5.0 (ODS41) = participate in transaction logging
– R6.0 (ODS43) = LZ1 compression and shared templates
– R8.0 (ODS48) = design and document compression; more details captured when recording user activity
– R8.5 (ODS51) = DAOS
– R9.0.1 (ODS52) = Performance improvements, better handling of huge (2GB+) attachments
– R10.0 (ODS53) = Larger databases and folders, summary data doubled, reduced I/O when scanning DBs with NLOs

19. #dominoforever
Page 19
Planning – Step 10
10. Determine if any unsupported notes.ini variables are in use
– Found here: https://www-10.lotus.com/ldd/dominowiki.nsf/dx/obsolete-notes.ini-variables
– Some examples
• PercentAvailSysResources
• ConstrainedSHM
• ConstrainedSHMSizeMB
• MEMAddressableMem
• MEMAddressableMemSizeMB
• MEM_EnablePreAlloc
• MEM_EnableSubAlloc

20. #dominoforever
Page 20
Planning – Steps 11 & 12
11. Plan when to upgrade the Domino Directory design
– Upgrade when server is upgraded?
• What impact does this have on other servers?
– Upgrade at a later time?
12. Plan to upgrade the mail template(s)
– Any customizations will need to be carried forward
– Don’t forget about customizations for iNotes!
• forms10.nsf (iNotes common forms)
• forms_x10.nsf (iNotes extension forms)

21. #dominoforever
Page 21
Planning – Steps 13 & 14
13. Review template customizations
– Have any customizations been made to HCL/IBM-supplied templates?
• Will custom templates inherit new design or must new templates be created and
deployed?
• Have default ACL entries been modified?
14. Plan to test custom applications at new release
– Most over looked step!!

22. Page 22
Preparation

23. #dominoforever
Page 23
Preparation Checklist
1. Locate and download required software
2. Download and install required prerequisites
3. Install any Java requirements
4. Install any prerequisites for extended products or add-on products
5. Place code loads on system and extract / unpackage files
6. Locate code for current hotfix installed (if applicable)
7. Document any unsupported notes.ini variables

24. #dominoforever
Page 24
Preparation – Step 1
1. Locate and download required software
– Passport Advantage – for Domino server and Notes client code
• https://www-01.ibm.com/software/passportadvantage/pacustomers.html
– Fix Central – for Feature Packs (FPs) and Interim Fixes (IFs)
• https://www-945.ibm.com/support/fixcentral/
• Easiest to use when using ‘Select product’ option

25. #dominoforever
Page 25
Preparation – Steps 2, 3 & 4
2. Download and install required Operating System prerequisites
– Services packs / PTFs
– Product options not already installed on system
3. Install any Java requirements
4. Install any prerequisites for extended products or add-on products

26. #dominoforever
Page 26
Preparation – Steps 5, 6 & 7
5. Place code loads on system and extract / unpackage files
6. Locate code for current hotfix installed (if applicable)
– Need to run hotfix installer to uninstall the current hotfix
• Only applicable if installing a new hotfix for the existing Domino version installed
• At the time of this webcast, there are no Interim Fixes (IFs) for Domino 10.0 or 10.0.1
7. Document any unsupported notes.ini variables

27. Page 27
Execution

28. #dominoforever
Page 28
Execution Checklist
1. Upgrade Notes clients for administrators
2. End Domino server(s)
3. Backup Domino server(s)
4. Remove any obsolete notes.ini variables
5. Uninstall hotfix (if applicable)
6. Install Domino code
7. Install Feature Pack (FP) of choosing
8. Install Interim Fix (IF) or hotfix, if applicable

29. #dominoforever
Page 29
Execution Checklist
9. Upgrade Administration server first
10. Upgrade other servers
11. Verify notes.ini
12. Upgrade Domino extended products
13. Upgrade 3rd party add-on products
14. Bring template customizations forward
15. Test custom applications
16. Upgrade users to new release of Notes (more details later)

30. #dominoforever
Page 30
Execution Checklist
17. Convert files to new ODS level
18. Upgrade mail files to new mail template
19. Remove any unused versions of Domino

31. #dominoforever
Page 31
Execution – Steps 1, 2, 3, 4 & 5
1. Upgrade Notes client for administrators
2. End Domino server(s)
3. Backup Domino server(s)
4. Remove any obsolete notes.ini variables
5. Uninstall hotfix (if applicable)
– A note about FPs and IFs / hotfixes
• Feature packs
– Do not need to be removed before upgrading a server
• Hotfixes
– DO need to be removed before upgrading a server to a higher point release

32. #dominoforever
Page 32
Execution – Steps 6, 7, 8 & 9
6. Install Domino code
– Upgrade all servers upon upgrade
- OR -
– Utilize multi-version support where applicable
7. Install Feature Pack (FP)
8. Install Interim Fix (IF) or hotfix
9. Upgrade Administration server first
– Type “Yes” to upgrade Domino Directory (if have chosen to do so at upgrade time)
– If on IBM i
• Start first OR issue UPDDOMSVR command

33. #dominoforever
Page 33
Execution – Steps 10, 11, 12 & 13
10. Upgrade other servers
– Development, Hub, Mail, SMTP, Application, …
11. Verify notes.ini
– Remove or change any entries added by default during the upgrade (ServerTasksAt…)
12. Upgrade Domino extended products
– Refer to extended product documentation for details
13. Upgrade 3rd party add-on products
– Refer to 3rd party add-on product documentation for details

34. #dominoforever
Page 34
Execution – Steps 14 & 15
14. Bring template customizations forward
– Mail templates
– iNotes customizations
– HCL/IBM supplied templates
– ACL customizations
15. Test custom applications
– Ensure business users are involved
– Check agents to ensure there are no errors

35. #dominoforever
Page 35
Execution – Steps 16 & 17
16. Upgrade users to new release of Notes
– Install Standard edition of the client, can change icon to point to nlnotes.exe if
necessary
17. Convert files to new ODS level
– Add appropriate notes.ini variable to server and restart
• Create_R10_Databases=1
– Compact databases using copy style compact (-c option) or use DBMT
– System databases will be locked
• Bring server down and compact OR use Compact Replication (-REPLICA option)

36. #dominoforever
Page 36
Execution – Steps 18 & 19
18. Upgrade mail files to new mail template
– Remember the –u option
• load convert mail –u mail/*.nsf * mail10.ntf
19. Remove any unused versions of Domino
– Check, you may be surprised by what you find!
• DLTLICPGM LICPGM(5733LD9) OPTION(11)

37. Page 37
Upgrading to IBM Notes 10.0.1

38. #dominoforever
Page 38
1. Know your current environment
• It’s fundamentally important that your know the details about your current
Notes Client Infrastructure to be able to make smart decisions for future deployments
− Which exact versions are deployed?
− Which Installation types and modes are used?
− Locations of Program-, Data- and SharedData- directories?
− Usage of Laptops, Desktops, Citrix and VDI, in numbers/percentages?
− Which OS including version is used?
− Usage of Notes addons → Connections plugins, SwiftFile, CTI, … ?
• If you can’t answer the questions above 100% correctly,
the following two slides will help you a lot!

39. #dominoforever
Page 39
MarvelClient Essentials – included in IBM Notes/Domino 10.0.1
• Makes it easier, faster and cheaper to upgrade to IBM Notes 10.x
• Provides valuable insights into Notes client landscapes for Notes 9.x and beyond
• Helps reduce helpdesk tickets, support, client maintenance and upgrade efforts
• Runs on all Notes client platforms supported by IBM (Intel Mac 64 bit, Windows,
Citrix and VDI)
• Runs on all IBM Domino platforms supported by IBM
• Best of all:
It’s included in IBM Notes and Domino 10.0.1 and FREE

40. #dominoforever
Page 40
MarvelClient Essentials – included in IBM Notes/Domino 10.0.1 (2)
• If you are not on IBM Notes and/or Domino 10.0.1 - you can get
MarvelClient Essentials here:
https://www.panagenda.com/essentials/
• More information about MarvelClient Essentials here:
https://www.ibm.com/support/knowledgecenter/en/SSKTMJ_10.0.1/admin/wn_marvelclient_essentials.html
https://www-01.ibm.com/support/docview.wss?uid=ibm10737079
https://www-01.ibm.com/support/docview.wss?uid=ibm10737079&aid=1

41. #dominoforever
Page 41
2. Define target (version and more …)
• Version is very easy at the moment → 10.0.1
− Feature Pack 1 is planned for Q1 2019
http://www-10.lotus.com/ldd/fixlist.nsf/(Progress)/10.0.1%20FP1
− My personal guess: Notes 11 will be shipped in Q4 2019 / Q1 2020
• Which Client Package?
− Standard, Basic and/or ICAA (IBM Client Application Access)
• Which Installation type?
− Single or MultiUser

42. #dominoforever
Page 42
2. Define target (version and more …) (2)
• Adding languages using MUI-Pack installation(s)
− Multilingual User Interface
− Group1, 2a, 2b and 3 → Group1 was just released on 5th Feb 2019 *w00t*
• Where to deploy?
− Laptops, Desktops, Citrix and/or VDI
− Windows7, Windows10, macOS 10.13 and/or macOS 10.14
https://www-01.ibm.com/support/docview.wss?uid=ibm10737113

43. #dominoforever
Page 43
2. Define target (version and more …) (3)
• Adding other functions/packages?
− Sametime embedded → not needed, 10.0.1 is up-to-date
− JVMPatch → not needed, 10.0.1 is up-to-date
− SwiftFile → use latest version 4.2.1 here:
http://www-01.ibm.com/support/docview.wss?uid=swg24035896
− IBM Connections Plugins for Notes → use latest version 5.5.0.20180813-1729 here:
https://xspy.mybluemix.net/nx
− Programs/Applications that interacts/communicates with Notes
▪ CTI, Instant Messengers, …

44. #dominoforever
Page 44
2. Define target (version and more …) (4)
• Let’s assume (for this webcast) you want to Upgrade from Notes 9.0.1 FPx IFx
to the following components:
− IBM Notes 10.0.1 Standard Client → MultiUser Installation on Windows 10 64Bit
− Adding French and Japanese (Multilingual User Interface = MUI)
− SwiftFile 4.2.1
− Connections Plugins for Notes 5.5.0.20180813-1729
− Use of default paths for
▪ Program directory
C:Program Files(x86)IBMNotes
▪ Shared data directory
C:ProgramDataIBMNotesDatashared
▪ Data directory
C:Users<USERNAME>AppDataLocalIBMNotesData

45. #dominoforever
Page 45
3. Choose Upgrade/Deployment Tool
• I personally wouldn’t suggest to use “Notes Smart Upgrade”
• “AUT – Notes Auto Update” is not available for this upgrade path
− Only IBM Notes 10.0.1 or later clients on Windows can be upgraded
− See here for more details:
https://www.ibm.com/support/knowledgecenter/en/SSKTMJ_10.0.1/admin/inst_aut_overview.html
• Third-Party-Solution for Notes → Yes – but no advertising here!
• Third-Party-Solutions for Windows, like SCCM or others

46. #dominoforever
Page 46
4. Create Upgrade Package
• No need to make changes to MSI package(s)
− Scripts can help here
− Differentiation between package and configuration (notes.ini, ConfigFile, etc.)
− That will help you a lot when it comes to package changes, new versions and testing
• Always include an Uninstall part in your package
− In-place upgrades are not recommended
− You can use the package also in cases of a new installation or re-install

47. #dominoforever
Page 47
4. Create Upgrade Package (2)
• Installation order
a) Uninstall current version
▪ Using NICE (Notes Install Cleanup Executable)
https://www-01.ibm.com/support/docview.wss?uid=swg21459714
b) Run local cleanup
▪ Remove old Program- and SharedData- Directory
c) Install IBM Notes 10.0.1
d) Adding French and Japanese (Multilingual User Interface = MUI)
e) Install SwiftFile 4.2.1
f) Install Connections Plugins for Notes 5.5.0.20180813-1729
g) Copy customized files like stub notes.ini, ConfigFile, etc.

48. #dominoforever
Page 48
4. Create Upgrade Package (3)
• Command lines for silent Uninstall and Cleanup
• Command lines for silent Install/Upgrade
• Command lines to copy customized stub notes.ini & ConfigFile

49. #dominoforever
Page 49
4. Create Upgrade Package (4)
• Check the log files (created during installation) for errors for all installed components
− Successful
− Not successful (with errors) – new installation needed after Windows restart
(complete package)

50. #dominoforever
Page 50
4. Create Upgrade Package (5)
• Additional Information
− For an installation on Citrix, please check out this slideshare:
https://www.slideshare.net/christophadler50/panagenda-webinar-virtual-faster-better-how-to-virtualize-ibm-notesv10
− If you need/want to switch from Single to MultiUser installation
▪ Check out the MUMA Tool (Multi-User Migration Assistant) – must be done before Upgrade
to Notes 10.0.1:
https://www-01.ibm.com/support/docview.wss?uid=swg21459627
▪ A specific Third-Party solution can help here during Upgrade process – also if you want to
migrate the DataDir from NetworkDrive to default local

51. #dominoforever
Page 51
4. Create Upgrade Package (6)
• Additional Information
− Customized stub notes.ini (example)
− config.txt (example)

52. #dominoforever
Page 52
5. Define post Upgrade actions
• notes.ini changes for existing configurations (via MarvelClient Essentials or Policy)
− Remove CREATE_R85_DATABASES=1
− Remove CREATE_R9_DATABASES=1
− Add CREATE_R10_DATABASES=1
− Add NSF_UpdateODS=1
− Add V10_WORKSPACE_BACKGROUND_MODE=1 → see next slide

53. #dominoforever
Page 53
IBM Notes 10.x – Workspace
• This will be controlled by a notes.ini parameter:
− V10_WORKSPACE_BACKGROUND_MODE=0 → default (blue)
− V10_WORKSPACE_BACKGROUND_MODE=1 → classic (grey lines)
− V10_WORKSPACE_BACKGROUND_MODE=2 → customized
• If you choose for “2”, make sure you have an image resource in your local bookmark.nsf
named “$WorkspaceImage”

54. #dominoforever
Page 54
6. Test, pilot, production
• Test
− Try to use virtual machines with snapshots
− Use images, which are very close to your production configuration
▪ Desktops vs. Laptops vs. VDI
▪ ActiveDirectoy → GPOs (Group Policy Objects)
▪ No local Admin rights
▪ Enabled UAC (User Account Control)
▪ Installed AV (Anti-Virus) Software
▪ …

55. #dominoforever
Page 55
6. Test, pilot, production (2)
• Pilot
− Choose the members of the pilot group wisely and let them know
− 20 – 50 users from different departments and with different requirements on IBM Notes
− …
• Production Deployment
− Inform your ServiceDesk and your users before you push the button
− Balance your deployment by upgrading e. g. 100-500 users at the same time – no more
− …

56. #dominoforever
Page 56
Summary: Upgrading to IBM Notes 10.0.1
1. Know your current environment
2. Define target (version and more …)
3. Choose Upgrade/Deployment Tool
4. Create Upgrade Package
5. Define post Upgrade actions
6. Test, pilot, production

57. Page 57
ODS53

58. #dominoforever
Page 58
ODS53 – Breaking NSF Boundaries
Maximum Database Size
Large Folders
Summary Data (per Item)
More Field Names
ID Tables
256GB64 GB
50x
64kDoubled to
60k23k
10x

59. #dominoforever
Page 59
ODS53 – Update your existing Databases
• ODS53 needs to be enabled (new default is ODS52) using notes.ini parameter
− CREATE_R10_DATABASES=1
• Update – Client:
− Use notes.ini parameter NSF_UpdateODS=1 for a one-time upgrade of most local
databases
▪ NOTE: USE WITH EXTREME CARE IF YOUR DATA DIRECTORIES ARE ON A NETWORK DRIVE!
▪ NOTE: End users can't access databases during compact OR databases will be ignored if in use
• Update – Server:
− DBMT –ods –ct 4
▪ NOTE: Some databases with internally hard coded older ODS might still need
compact -upgrade

60. #dominoforever
Page 60
ODS53 – Proceed with caution
• Running with mixed release levels?
− Notes 10.x client can work with ODS53 and earlier
− Notes 9.x and earlier client can open ODS53 database IF:
− 64 GB or less
− Folder limit within R9 limits
− Notes 9 client can work with documents IF:
− Summary data within 32k limit
− Field names within 23k limit

61. Page 61
Upgrade Tips and Tricks

62. #dominoforever
Page 62
Preventing Updates to ServerTasksAt
Tired of losing your ServerTasksAt customizations when upgrading?
SetupLeaveServerTasks to the rescue
– Add SetupLeaveServerTasks=1 to server’s notes.ini
– Disables automatic updating of the ServerTasks= and ServerTasksAtXX= lines during a
Domino Server upgrade

63. #dominoforever
Page 63
Java Tricks
If get Java errors when doing an installation
– Trying to patch the Java error can be daunting
– Install the full product (always includes Java)
• Applies to Domino, Notes, Traveler
Want to switch to 64-bit JVM on IBM i?
– New in 10.0.1, can use CFGDOMSVR or CHGDOMSVR to change/set
JVM version
– Prior releases, set JAVA_HOME variable
• JAVA_HOME=/QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit
– Careful, it IS case sensitive!!

64. #dominoforever
Page 64
Understanding Design Ping-Pong
10.0.1 Server 9.0.1 Server
Updates design of mail files
to 10.0.1 design
Updates design of mail files
to 9.0.1 design
Replicates design
changes to 10.0.1
server
Replicates design
changes to 9.0.1
server

65. #dominoforever
Page 65
Preventing Design Ping-Pong
Replicating templates between servers
– Most templates share same replica ID across servers
– Latest design gets replicated
– Stops ping-pong chain of events
Limiting Design task execution
– Runs by default at 1:00 AM along with Catalog task
• ServerTasksAt1=Catalog, Design
– Remove ‘Design’ from this variable
• set config ServerTasksAt1=Catalog
• Or edit notes.ini file directly
– Until all servers are at same code level

66. #dominoforever
Page 66
Preventing Design Ping-Pong
Selective replication
– Choose to not replicate design elements

67. #dominoforever
Page 67
Delaying Upgrading Directory
If choose to not upgrade directory during installation set notes.ini
– SERVER_UPGRADE_NO_DIRECTORY_REDESIGN=0
Set variable and restart server BEFORE upgrading Domino level

68. #dominoforever
Page 68
What if I Don’t Have a License?
Community Edition is for you!!
There are free downloads available with the
Community Edition
https://www.ibm.com/blogs/collaboration-
solutions/2018/12/21/your-guide-to-
domino-v10-0-1-part-numbers/
https://www.ibm.com/account/reg/us-
en/signup?formid=urx-33713

69. #dominoforever
Page 69
Antivirus realtime scanning in IBM Notes Client Data directory
~55% of the entire data volume in the Data
directory changes on a DAILY basis in most setups
• 5 - 10% in Dataworkspace (up to 300 files)
• DISABLE Antivirus scanning for at least
*.ns*
*.ndk
*.xml
*.properties
*.jar
in Data Directory
55%
45%
Data directory:
File changes per day
Once or more Less

70. #dominoforever
Page 70
Don’t forget to upgrade your local IBM Notes Client databases to
latest ODS53
ODS = On Disk Structure
• ODS 16 = Notes 2
• ODS 17 = Notes 3
• ODS 20 = Notes 4
• ODS 41 = Notes 5
• ODS 43 = Notes 6 & 7
• ODS 48 = Notes 8
• ODS 51 = Notes 8.5 & 9
• ODS 52 = Notes 9.0.1
• ODS 53 = Notes 10
The difference between ODS 43 and 53 = up to 80% LESS FILE I/O
This helps with ANY client AND server hardware

71. #dominoforever
Thank you!

72. #dominoforever
Kim Greene Christoph Adler
President & Owner Senior Consultant
Kim Greene Consulting, Inc. panagenda
+1 507-216-5632 +49 172 494 4141
kim@kimgreene.com christoph.adler@panagenda.com
@iSeriesDomino @cadler80
Kimgreeneconsulting cadler