Lotus Notes Traveler 8.5.3 Upgrade Pack 1 High ...

Lotus Notes Traveler 8.5.3 Upgrade Pack 1
High Availability (HA)

By
Shrikant Jamkhandi
Sandeep Deshpande

© 2012 IBM Corporation

OPEN MIC LOTUS TEAM 2

●Shrikant Jamkhandi – Staff Software Engineer
●Presenter

●Sandeep Deshpande – Staff Software Engineer
●Presenter

Ranjit Rai - Lotus Technical Advisor
Focussing on Notes/Domino, LotusLive

●Hansraj Mali - Lotus Technical Advisor
●Focussing on Notes/Domino, LotusLive

●J Rajendran - Lotus Technical Advisor
●Focussing on Notes/Domino, LotusLive

●Vinayak Tavargeri Lotus Support Manager

Facilitator for Open Mics

© 2011 IBM Corporation

Agenda

● Overview and System Requirements
● High Availability for Lotus Notes Traveler
● Other Server Enhancements
● Traveler Documentation
● General Troubleshooting
● References and Q&A

© 2012 IBM Corporation

Lotus Notes Traveler 8.5.3 Upgrade Pack

● Why an Upgrade Pack?

­ Desire to get the HA solution to customers.

● What is in the Upgrade Pack?

­ High Availability (HA) - also called a Lotus Traveler server pool.
­ Web based administration and additional security enhancements
­ Enhancements for Android Client.

● Is the Upgrade Pack the maintenance vehicle for 8.5.3?

­ No. The upgrade pack is an optional install intended for customers needing
to deploy a highly available solution.

­ Will continue to ship maintenance on 8.5.3 (currently at 8.5.3.2 IF1)

© 2012 IBM Corporation

Basic Traveler Architecture without HA

Mail servers

Traveler server

Mobile Devices Notes RPC

HTTP/S

Authenticating ntsdb
proxy server (Derby)

A Derby database is implemented entirely in Java and it
stores the files that live in a directory of the same name as
the database.

© 2012 IBM Corporation

Basic Traveler HA Architecture Mail servers

Traveler service pool

Notes RPC

Mobile Devices

Load Balancer
IP Sprayer

Remote DB

HA Traveler
DB

© 2012 IBM Corporation

System Requirements for High Availability

● Same server and device requirements as 8.5.3

● Requirements specific to running an HA Pool.

­ Must run on 64 bit Windows or Linux OS.
­ Can migrate a 32 bit server to a pool, but should then retire the server.
­ Must run on Lotus Domino Enterprise or Utility Server 8.5.3.x.
­ Require an Enterprise Database, preferably remote located and configured for disaster

recovery and fail over.
• DB2 Workgroup or Enterprise server 9.7 FP5 or later.
• MS SQL Enterprise Server 2008 or later.

­ IP Sprayer/Load Balancer – Any proxy, load balancer or IP sprayer capable of basic
round robin balancing function with no or limited session affinity.

● 8.5.3 Upgrade Pack 1 Version Numbers

Component Version Build Note: the Lotus Traveler 8.5.3 Upgrade Pack
Server 8.5.3.100 20120613_2102 requires Domino 8.5.3 Upgrade Pack 1 but
Android 8.5.3.100 20120611_0951 will install it if it is not already on the target
Windows Mobile 8.5.3.2 20120528_2100 system.
Nokia 8.5.3.2 20120525_1525

© 2012 IBM Corporation

HA Architecture Traveler service pool

Mail servers

Web Administration Administer any user
from any server.

Direct connect or through Notes RPC
proxy/load balancer

Mobile Devices

Single IP address Load Balancer/ IP Remote DB
configuration Sprayer
HA Traveler
Recommend Sprayer is Connects
Highly Available if possible. DB
Generally will be in DMZ.
using JDBC to
Traveler services will
perform smart load balance RDBMS on

Recommend pool is behind DB2/SQL Recommend Highly Available
corporate firewall

DB configuration

© 2012 IBM Corporation

Traveler Utility for HA Mode Configuration

● How do I upgrade the Domino server and Traveler to Up1 ?

­ Take the backup of Lotustraveler.nsf, ntsclcache.nsf, notes.ini and entire traveler folder
which is in the lotus traveler server data directory

­ Shut down the domino server and upgrade the domino server to 853 UP1
­ Install the Traveler 853 UP1
­ Start the Domino server. You will see many activity going on the domino server console for

Lotus traveler for updating the existing information to UP1. Many messages shown similar
to below on server console

08/06/2012 08:18:46 PM Updating 'NTFNotesFS' into database 'IBM Lotus Notes Traveler' from template 'Lotus Notes
Traveler'
08/06/2012 08:18:47 PM Adding 'actionsUsingRest_pt.properties' to database 'IBM Lotus Notes Traveler' from template
'Lotus Notes Traveler'
08/06/2012 08:18:47 PM Adding 'defaultDeviceSettingsSecurity_sk.properties' to database 'IBM Lotus Notes Traveler'
from template 'Lotus Notes Traveler'
08/06/2012 08:18:47 PM Adding 'device_settings_pl.properties' to database 'IBM Lotus Notes Traveler' from template
'Lotus Notes Traveler'
08/06/2012 08:18:48 PM Adding 'xServers_tr.properties' to database 'IBM Lotus Notes Traveler' from template 'Lotus
Notes Traveler'.
08/06/2012 08:18:48 PM Adding '.settings/org.eclipse.core.resources.prefs' to database 'IBM Lotus Notes Traveler' from
template 'Lotus Notes Traveler'

© 2012 IBM Corporation

Traveler Utility for HA Mode Configuration

● How do I upgrade the Domino server and Traveler to Up1 ?

­ After some time Traveler shows it is starting followed by 10 steps for upgrading to UP1

08/06/2012 08:18:49 PM Lotus Traveler: Server starting...
08/06/2012 08:19:06 PM Lotus Traveler: Upgrading Lotus Traveler schema to latest version.
08/06/2012 08:19:06 PM Lotus Traveler: Upgrading Global Data (STEP 2/10)
08/06/2012 08:19:06 PM Lotus Traveler: Upgrading Push Data (STEP 3/10)
08/06/2012 08:19:08 PM Lotus Traveler: Upgrading Sec Records (STEP 4/10)
08/06/2012 08:19:09 PM Lotus Traveler: Upgrading Record Maps (STEP 5/10)
08/06/2012 08:19:09 PM Lotus Traveler: Adding Record Map Columns (STEP 6/10)
08/06/2012 08:19:36 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:20:12 PM Lotus Traveler: Adding Field Columns (STEP 7/10)
08/06/2012 08:20:38 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:21:28 PM Lotus Traveler: Compressing table ACCOUNT
08/06/2012 08:21:28 PM Lotus Traveler: Compressing table GUIDMAP
08/06/2012 08:21:39 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:21:42 PM Lotus Traveler: Compressing table TS_FIELD_NAME
08/06/2012 08:21:42 PM Lotus Traveler: Compressing table TS_FILTERS
08/06/2012 08:21:42 PM Lotus Traveler: Compressing table TS_GLOBAL
08/06/2012 08:21:42 PM Lotus Traveler: Compressing table TS_GUD_RECORD_EX
08/06/2012 08:21:44 PM Lotus Traveler: Compressing table TS_GUD_TIMESTAMP
08/06/2012 08:22:09 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:22:51 PM Lotus Traveler: Compressing table TS_RECORD_MAPPING
08/06/2012 08:23:11 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table TS_SYNC_TIMESTAMP
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table TS_SYNC_TIMESTAMP_FOLDER
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table PUSH
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table SEC_RECORDS
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table REPLICAS
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table CLIENT_VERSIONS
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table SCHEMAVERSION
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table INV_MAP
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table LOGSETTINGS
08/06/2012 08:24:05 PM Lotus Traveler: Compressing table GUIDNEXT
08/06/2012 08:24:05 PM Lotus Traveler: Defragging Indexes: 0/22 complete
08/06/2012 08:28:49 PM Lotus Traveler: Defragging Indexes: 15/22 complete
08/06/2012 08:28:50 PM Lotus Traveler: Defragging Indexes: 22/22 complete
08/06/2012 08:28:50 PM Lotus Traveler: Defragging and Compressing is complete.

© 2012 IBM Corporation

Traveler Utility for HA Mode Configuration

● How do I upgrade the Domino server and Traveler to Up1 ?

­ Messages continue to appear for 10 steps to complete & after completion for final step
traveler restart itself for these configuration changes

08/06/2012 08:39:29 PM Lotus Traveler: Upgrade is still in progress... ● Traveler has been
08/06/2012 08:40:00 PM Lotus Traveler: Upgrade is still in progress... successfully upgraded to UP1
08/06/2012 08:40:08 PM Lotus Traveler: Adding Record Map Indexes (STEP 8/10)
08/06/2012 08:40:08 PM Lotus Traveler: Settings Record OOD (STEP 9/10) ● Shut down the domino server
08/06/2012 08:40:30 PM Lotus Traveler: Upgrade is still in progress... to carry out HA configuration
08/06/2012 08:41:01 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:41:13 PM Lotus Traveler: Setting Records OOD (1/70824)
08/06/2012 08:41:15 PM Lotus Traveler: Setting Records OOD (2049/70824)
08/06/2012 08:41:17 PM Lotus Traveler: Setting Records OOD (4097/70824)
08/06/2012 08:42:32 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:42:35 PM Lotus Traveler: Upgrade Final Steps (STEP 10/10)
08/06/2012 08:43:03 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:43:33 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:44:04 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:44:35 PM Lotus Traveler: Upgrade is still in progress...
08/06/2012 08:44:40 PM Lotus Traveler: Upgrading Lotus Traveler schema to latest version.
08/06/2012 08:48:16 PM Lotus Traveler: Restarting HTTP Server for configuration changes.
RESTART TASK HTTP >C:\Windows\TEMP\notes0979B1\rem63213.con
08/06/2012 08:48:16 PM HTTP Server: Using Web Configuration View
08/06/2012 08:48:20 PM Lotus Traveler: Server started.
08/06/2012 08:48:21 PM JVM: Java Virtual Machine initialized.
08/06/2012 08:48:21 PM HTTP Server: Java Virtual Machine loaded
08/06/2012 08:48:30 PM XSP Command Manager initialized
08/06/2012 08:48:53 PM HTTP Server: Started

© 2012 IBM Corporation

Traveler Utility for HA Mode Configuration

● Use travelerUtil configuration utility to configure for enterprise DB2/SQL
Database.

● travelerUtil is not new, but prior to 8.5.3 UP 1 was used solely for
collecting logs when the Traveler server was not running.

● Run <data>/traveler/util/travelerUtil -help for command reference:

Usage: travelerUtil <options>
where <options> include:

log clear → Shows the database configuration
log collect → Used to go back to using local derby database
pmr → Used to verify configuration
pmr show → Used to update db user ID and PW. It won't prompt for URL and path if found.
pmr remove → Shows the SSL certificate store information
pmr set → Removes any stored SSL credentials
db show → Validates the SSL certificate store password(s)
db remove → Set SSL certificate key store password and trust store password if they pass validation
db check
db set
ssl show
ssl remove
ssl check
ssl set

© 2012 IBM Corporation

Setting up the Database

­ Automatic Way

• Administrator Creates Empty Database in DB2/SQLServer

­ DB2 database must use UTF 8 encoding if any Domino IDs contain DBCS,
national language or other special characters.

• On startup Traveler will create/update Schema/Tables/Indexes,etc as
needed.

­ Manual / Data Definition Language (DDL) Way

• 'Advanced' option for Database Administrator
• Administrator customizes DDLs shipped with Traveler

­ From folder <data>/traveler/cfg/db

• Add notes.ini: NTS_AUTO_DB_SCHEMA=false

­ Tells Traveler not to alter Schema.

• Administrator executes DDLs against DB2/SQLServer to generate
Schema/Tables/Indexes

• Future Versions/Fixpacks: Administrator runs incremental DDL's to
update schema

© 2012 IBM Corporation

Deploying & configuring the enterprise database
step by step explained (1)

● Configure DB2 database for Lotus Notes Traveler using the DB2
Configuration Wizard

1) Launch the DB2 Control Center. Start this from the DB2 System tray in windows
OR from the windows Start -> All Program -> IBMDB2 -> DB2Copy1->General
Administration Tools -> Control Center

OR

© 2012 IBM Corporation

Continued.

● Configure DB2 database for Lotus Notes Traveler using the DB2
Configuration Wizard

2) Control Center window is launched

© 2012 IBM Corporation

Continued..

● Configure DB2 database for Lotus Notes Traveler using the DB2
Configuration Wizard

3) Right click on 'All Databases' and choose Create Database -> Standard

This will open up the window for 'Create Database Wizard'

© 2012 IBM Corporation

Continued...

● Configure DB2 database for Lotus Notes Traveler using the DB2
Configuration Wizard

4) Give the database name, path, Alias and comment in the 'Name' tab
* Select the defaults for
each attribute unless
otherwise noted.

© 2012 IBM Corporation

Continued....

● Configure DB2 database for Lotus Notes Traveler using the DB2
Configuration Wizard

5) In the Region tab change the Code Set drop down box to UTF-8
* Select the defaults for
each attribute unless
otherwise noted.

© 2012 IBM Corporation

Continued.....

● Configure DB2 database for Lotus Notes Traveler using the DB2
Configuration Wizard

6) View the Summary for option which you chosen for DB creation and click 'Finish' to
create Traveler DB.

© 2012 IBM Corporation

Continued......

● Configure DB2 database for Lotus Notes Traveler using the DB2
Configuration Wizard

7) DB creation will start with 'Progress' window, wait to create database and after
sometime you see another window 'DB2 Message' for successful creation of database

© 2012 IBM Corporation

Continued.......

● Configure Lotus Notes Traveler for enterprise DB2 database

1) Ensure that the Lotus Notes Traveler DB is created and available on the DB2 server,
We created the database in the previous steps.
2) On the DB2 server locate the file db2jcc4.jar in (<db2_install_dir>\sqllib\java\)
3) Copy the db2jcc4.jar from the DB2 server to the Lotus Notes Traveler server in
the below directory
<domino>\Traveler\lib
e.g E:\Lotus\Domino\Traveler\lib
4) Open a command prompt (cmd) on the Lotus Notes Traveler server and change
the directory to <domino data>\traveler\util
e.g E:\Lotus\Domino\Data\traveler\util

Note: On Windows™ run travelerUtil commands as administrator & on Linux™ run the commands as the root user

© 2012 IBM Corporation

Continued........

● Configure Lotus Notes Traveler for enterprise DB2 database

5) Run travelerUtil to configure Lotus Notes Traveler in the following format:
travelerUtil db set url=jdbc:db2://<db2server hostname>:<db port>/<traveler db name>
user=<db2 admin id> pw=<db2 password>
The URL for DB2 consists of

- Hostname of the DB2 server
- Port number of database instant (Default port is 50000)
- Database name and user name, password of DB2 server

E.g travelerUtil db set url=jdbc:db2://TRVLDB2.in.ibm.com:50000/TRAVELER
user=db2admin pw=p@ssw0rd
Utility validates the DB2 information and configures Lotus Notes Traveler to use the DB2
instance instead of derby database. The credentials are encrypted and stored in the
LotusTraveler.nsf

© 2012 IBM Corporation

Continued.........

● Configure Lotus Notes Traveler for enterprise DB2 database

6) To validate what you just configured, use the travelerUtil db show command or the
travelerUtil db check

7) Traveler running on Linux run the travelerUtil in the below format. Later issue the db show
and db check to validate what you just configured
./travelerUtil db set url=jdbc:db2://TRVLDB2.in.ibm.com:50000/TRAVELER
user=db2admin pw=p@ssw0rd

© 2012 IBM Corporation

Continued..........

● Configure Lotus Notes Traveler for enterprise DB2 database

8) Start the Lotus Notes Traveler server, Server console shows traveler server will transfer existing users
sync data to HADR

08/06/2012 09:37:57 PM Lotus Traveler: Starting JVM with Maximum Memory = 3072M
08/06/2012 09:37:59 PM Lotus Traveler: Server starting...
08/06/2012 09:38:11 PM Lotus Traveler: Traveler will now transfer the existing users into the HADR Pool
08/06/2012 09:38:11 PM Lotus Traveler: 0/954 Users' Sync Data have been transferred
08/06/2012 09:38:47 PM Lotus Traveler: 16/954 Users' Sync Data have been transferred
08/06/2012 09:39:54 PM Lotus Traveler: 123/954 Users' Sync Data have been transferred
08/06/2012 09:43:09 PM Lotus Traveler: 293/954 Users' Sync Data have been transferred
.
.
08/06/2012 09:50:49 PM Lotus Traveler: 734/954 Users' Sync Data have been transferred
08/06/2012 09:51:55 PM Lotus Traveler: 791/954 Users' Sync Data have been transferred
.
.
08/06/2012 09:59:45 PM Lotus Traveler: 200 users remaining.
.
.
08/06/2012 10:03:45 PM Lotus Traveler: 90 users remaining.
08/06/2012 10:04:46 PM Lotus Traveler: 63 users remaining.
.
.
08/06/2012 10:07:46 PM Lotus Traveler: 18 users remaining.
08/06/2012 10:08:46 PM Lotus Traveler: 7 users remaining.
08/06/2012 10:09:46 PM Lotus Traveler: 3 users remaining.
08/06/2012 10:10:46 PM Lotus Traveler: 1 users remaining.
08/06/2012 10:11:46 PM Lotus Traveler: 1 users remaining.
08/06/2012 10:12:48 PM Lotus Traveler: Transfer has completed successfully. Traveler will now start in HADR mode.
08/06/2012 10:13:02 PM Lotus Traveler: Adding Client Installation Files (8.5.3.2.201205282100) to Database.
08/06/2012 10:13:02 PM Lotus Traveler: Adding Client Installation Files (8.5.3.2.201205282100) to Database.
.
.
08/06/2012 10:13:02 PM Lotus Traveler: Adding Client Installation Files (8.5.3.2.201205282100) to Database.
08/06/2012 10:13:02 PM Lotus Traveler: Adding Client Installation Files (8.5.3.2.201205282100) to Database.
08/06/2012 10:13:02 PM Lotus Traveler: Adding Client Installation Files (8.5.3.2.201205282100) to Database.
08/06/2012 10:13:28 PM Lotus Traveler: Restarting HTTP Server for configuration changes.
RESTART TASK HTTP >C:\Windows\TEMP\notes0979B1\rem13346.con
08/06/2012 10:13:28 PM HTTP Server: Using Web Configuration View
08/06/2012 10:13:29 PM Lotus Traveler: Server started.
08/06/2012 10:13:32 PM JVM: Java Virtual Machine initialized.
08/06/2012 10:13:32 PM HTTP Server: Java Virtual Machine loaded
08/06/2012 10:13:32 PM Servlet engine initialization was successful
08/06/2012 10:13:35 PM XSP Command Manager initialized
08/06/2012 10:13:59 PM HTTP Server: Started

© 2012 IBM Corporation

Deploying & configuring the enterprise database
step by step explained (2)

● Configure MS SQL database for Lotus Notes Traveler using SQL Server
Management Studio

1) From the Windows Start menu select Microsoft SQL server 2008 R2 -> SQL Server
Management Studio

© 2012 IBM Corporation

Continued.

● Configure MS SQL database for Lotus Notes Traveler using SQL Server
Management Studio

2) Microsoft SQL server Management Studio is launched with another window
'Connect to SQL server'

© 2012 IBM Corporation

Continued..

● Configure MS SQL database for Lotus Notes Traveler using SQL Server
Management Studio

3) Connect to SQL server. To connect, type the computer name/host name and click
'Connect'

© 2012 IBM Corporation

Continued...

● Configure MS SQL database for Lotus Notes Traveler using SQL Server
Management Studio

4) Right click on the 'Logins' under Security and choose New Login to create user
profile in the SQL server

© 2012 IBM Corporation

Continued....

● Configure MS SQL database for Lotus Notes Traveler using SQL Server
Management Studio

5) Enter a Name and password for the profile, password policy as per company policy,
default language and keep other settings default

© 2012 IBM Corporation

Continued.....

● Configure MS SQL database for Lotus Notes Traveler using SQL Server
Management Studio

6) Create a Traveler database using the database wizard. Right click ‘Databases’ and
then select New Database

© 2012 IBM Corporation

Continued......

● Configure MS SQL database for Lotus Notes Traveler using SQL Server
Management Studio

7) In the 'Options' tab select the collation as 'Latin1_General_BIN' keep other settings
default and click OK to create database.

© 2012 IBM Corporation

Continued.......

● Configure MS SQL database for Lotus Notes Traveler using SQL Server
Management Studio

8) DB creation will start with Progress showing 'Executing', wait to create database and
after sometime it creates the DB. Created DB can be seen in Databases->TRAVELER

© 2012 IBM Corporation

Continued........

● Configure Lotus Notes Traveler for enterprise MS SQL database

1) Ensure that the Lotus Notes Traveler DB is created and available on the MS SQL
server, We created the database in the previous steps
2) Download the SQL Server JDBC Driver 3.0 ‘sqljdbc4.jar’ from below MS site link
http://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=21599
3) Copy sqljdbc4.jar file to the Lotus Notes Traveler server in the below path
<domino>\Traveler\lib
e.g E:\Lotus\Domino\Traveler\lib
4) Open a command prompt (cmd) on the Lotus Notes Traveler server and change
the directory to <domino data>\traveler\util
e.g E:\Lotus\Domino\Data\traveler\util

Note: On Windows™ run travelerUtil commands as administrator & on Linux™ run the commands as the root user

© 2012 IBM Corporation

Continued.........

● Configure Lotus Notes Traveler for enterprise MS SQL database

5) Run travelerUtil to configure Lotus Notes Traveler in the following format:

travelerUtil db set url=jdbc:sqlserver://<sqlserver hostname>:<db port>;databasename=<traveler db name>
user=<sqlserver user id> pw=<sqlserver user password>

The URL for MS SQL consists of

- Hostname of the MS SQL server
- Port number of database instant (Default port is 1433)
- Database name, user name, password of database owner of the SQL server

E.g travelerUtil db set url=jdbc:sqlserver://TRVLSQL.in.ibm.com:1433;databasename=TRAVELER

user=LNTDBUSER pw=password

Utility validates the MS SQL information and configures Lotus Notes Traveler to use the MS
SQL instance instead of derby database. The credentials are encrypted and stored in the
LotusTraveler.nsf

© 2012 IBM Corporation

Continued..........

● Configure Lotus Notes Traveler for enterprise MS SQL database

6) To validate what you just configured, use the travelerUtil db show command or the travelerUtil db check

7) Traveler running on Linux we need run the travelerUtil commands as the root user with below format
./travelerUtil db set user=LNTDBUSER pw=password
Note: The url command line parameter for SQL Server on Linux will not work because of the required semicolon. You will be
prompted for your database URL and JDBC file path.

© 2012 IBM Corporation

Continued...........

● Configure Lotus Notes Traveler for enterprise MS SQL database

8) Start the Lotus Notes Traveler server, Server console shows transfer has completed and traveler will

start in HADR mode

08/06/2012 10:35:19 PM Lotus Traveler: Server starting...
08/06/2012 10:35:23 PM Lotus Traveler: Transfer has completed successfully. Traveler will now start in HADR

mode.
08/06/2012 10:35:28 PM Lotus Traveler: Traveler Pool already has a client with version:8.5.3.2.201205282100
.
.
.
08/06/2012 10:35:28 PM Lotus Traveler: Traveler Pool already has a client with version:8.5.3.2.201205282100
08/06/2012 10:35:28 PM Lotus Traveler: Traveler Pool already has a client with version:8.5.3.2.201205282100

> RESTART TASK HTTP >C:\Users\IBM_AD~1\AppData\Local\Temp\notes0979B1\rem18747.con
08/06/2012 10:55:31 PM Lotus Traveler: Restarting HTTP Server for configuration changes.
08/06/2012 10:55:31 PM HTTP Server: Using Web Configuration View
08/06/2012 10:55:38 PM JVM: Java Virtual Machine initialized.
08/06/2012 10:55:38 PM HTTP Server: Java Virtual Machine loaded
08/06/2012 10:55:38 PM HTTP Server: DSAPI Domino Off-Line Services HTTP extension Loaded successfully
08/06/2012 10:55:38 PM Lotus Traveler: Server started.
08/06/2012 10:55:38 PM XSP Command Manager initialized
08/06/2012 10:55:38 PM HTTP Server: Started

© 2012 IBM Corporation

Migration Considerations

● Upgrade

­ notes.ini based configuration (no NTSConfig.xml, NTSLogging.properties)
­ HTTP removed from ServerTasks list in notes.ini – Traveler will start
­ Recommend start the server in stand-alone mode after upgrade.
­ URL changed to http://travelerserver.com/servlet/traveler to

http://travelerserver.com/traveler
­ Derby will defrag – may take over an hour

● Derby to Enterprise DB Migration

­ IMPORTANT – only add one server to the pool at a time.
­ First server creates the pool and establishes default settings.
­ On startup will migrate user data to enterprise db – may take over an hour
­ Allow data migration to complete before adding another server.
­ Use DNS or Proxy routing to prevent need for reconfigure of the device for a new

access URL.
­ Can add 32 bit server to the pool to migrate data, but should then retire the system.

© 2012 IBM Corporation

Load Balance Considerations

● Support any proxy, load balancer, IP sprayer capable of basic load
balancing with the following requirements:

­ If the balance will be authenticating users - must be configured to use basic
authentication (401 challenge)

­ Must support routing of HTTP OPTIONS, GET, POST traffic to Traveler Pool.
­ Must be able to handle “Max Users” number of concurrent connections.

● Best Practices

­ Capable of basic round robin balancing function.
­ For true HA should also setup the load balancer in HA mode.

● Traveler servers do their own load balancing.
­ Each user has a Master Monitor – server responsible for processing user
data.
­ Each server has a computed Availability Index (AI).
­ Master Monitor is changed as needed to maintain load balance.

© 2012 IBM Corporation

Securing Server to Server Communication

● Configure Traveler to use SSL communication for server-to-server and server-to-servlet
communication.

● Not the same as configuring Domino for SSL for client communication
● Optional - Will impact server performance (about 20% overhead).
● Create a self-signed certificate using keytool (in Domino's JVM).
● Copy certificate file to all servers in HA pool.
● Use “travelerUtil ssl set” on each server to configure
● All servers in the HA pool must be configured the same way (i.e. either all or none of the servers

using SSL)

© 2012 IBM Corporation

Web Based Administration

● http(s)://hostname/LotusTraveler.nsf
● Supports all traditional administration functionality, plus a few

enhancements.
● Can still access LotusTraveler.nsf with Admin/Notes client in stand-alone

mode.
● Web Admin only for HA mode - will get this message accessing with

Notes/Admin client:

© 2012 IBM Corporation

Web Based Administration Continued

● Role based ACL – both stand-alone and web based.
● Administrator role allows actions within the application.

© 2012 IBM Corporation

Web Based Administration Continued

● Same views as traditional administration interface.
● Servers, Client Software new and only in Web Administration interface.

© 2012 IBM Corporation

Web Based Administration Continued

● Device Security, Device Settings, Devices and Users view are almost
identical to traditional interface.

© 2012 IBM Corporation

Web Based Administration Continued

● Click on a device to see details – similar to traditional interface.

© 2012 IBM Corporation

Web Based Administration Continued

● Servers view lists all servers known in the pool and current status.
● No actions here – report only
● View not visible in stand-alone mode.

© 2012 IBM Corporation

Client Manager

● Client Manager – ability to control client distribution
● Can also manage with tell commands
● When applying client fix – only need to install on one server in the pool.
● Fix will not be the default client – allows admin to test it first.
● Fix Pack/Upgrade, clients will be marked default.

© 2012 IBM Corporation

Tell Commands in HA Environment

● User based commands are HA aware

­ Commands such as show, dump, delete, reset, stopsync get routed to the
users master monitor server.

­ Console messages will report which server the command was routed to.
­ Console output will be routed back to the server the command was issued.
­ User dump file will be generated on the Master Monitor server and not the

server the command was issued.

● Server based commands operate locally be default, such as log collect,
pmr, systemdump, status,etc

­ Use -s <server> option to route to a specific server. For example:

tell traveler -s “myserver/myco” status
tell traveler -s * pmr 12345,678,900

● New HADR command for viewing servers in the pool.

● New Available command to mark a system as unavailable – useful for testing.

© 2012 IBM Corporation

HA Commands

● tell traveler HADR Show
● tell traveler HADR Delete <server>
● tell traveler available on
● tell traveler bind enable <userid>
● tell traveler bind disable <userid>

© 2012 IBM Corporation

Capacity Guidelines

● 64 bit OS only for Traveler and database servers.
● Raid 0,5,6 or other striped array on database server for maximum disk

performance. High speed or even solid state drives recommended.
● Same memory and CPU recommendations as 8.5.3 for each Traveler

server.
● N+1 Traveler servers in a pool.

­ Ex: 7500 devices planned, assume 2500 per server max load, then want 4
Traveler servers.

● Upward limits not yet defined – currently using numbers of 2500 max
devices per server and 10000 max device per Traveler pool.

● Contact Techline or Services team for sizing help

© 2012 IBM Corporation

Additional Server Changes

● Database performance improvements for both HA and Stand-Alone.
● Improved handling of Notes document links

­ Will add web link for access from mobile device.
­ Not all applications are web enabled.
­ Server must be accessible to the device, VPN, Internet facing or device on

internal network.

● Sent folder save options (notes.ini) – user, never, always and no
attachments.

● Prohibit attachments on draft mail (notes.ini).
● Simplified URL:

­ http(s)://hostname.domain:port/traveler
­ Apple devices can just use the server address: hostname.domain:port

© 2012 IBM Corporation