lotus notes traveler 8.5.3 upgrade pack 1 high ... ha open mic... · a derby database is...

© 2012 IBM Corporation

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

ByShrikant Jamkhandi

Sandeep Deshpande

© 2011 IBM Corporation 2

OPEN MIC LOTUS TEAM●Shrikant Jamkhandi – Staff Software Engineer●Presenter

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

Ranjit Rai - Lotus Technical AdvisorFocussing on Notes/Domino, LotusLive

●Sandeep Deshpande – Staff Software Engineer●Presenter

●Vinayak Tavargeri Lotus Support Manager Facilitator for Open Mics

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


Agenda

● Overview and System Requirements

● High Availability for Lotus Notes Traveler

● Other Server Enhancements

● Traveler Documentation

● General Troubleshooting

● References and Q&A


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)


Basic Traveler Architecture without HA

Authenticating proxy server

Mobile Devices

Mail servers

Notes RPCHTTP/S

ntsdb (Derby)

Traveler server

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.


Basic Traveler HA Architecture

Traveler service pool

Load Balancer IP Sprayer

HA Traveler DB

Mobile Devices

Remote DB

Mail servers

Notes RPC


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 NumbersComponent Version BuildServer 8.5.3.100 20120613_2102

Android 8.5.3.100 20120611_0951

Windows Mobile 8.5.3.2 20120528_2100

Nokia 8.5.3.2 20120525_1525

Note: the Lotus Traveler 8.5.3 Upgrade Pack requires Domino 8.5.3 Upgrade Pack 1 but will install it if it is not already on the target system.


HA Architecture Traveler service pool

Load Balancer/ IP Sprayer

HA Traveler DB

Mobile Devices

Remote DB

Mail servers

Notes RPC

Recommend Sprayer is Highly Available if possible.Generally will be in DMZ.

Recommend Highly Available DB configuration

Recommend pool is behind corporate firewall

Single IP address configuration

Web Administration

Direct connect or through proxy/load balancer

Administer any user from any server.

Traveler services will perform smart load balance

Connects using JDBC to RDBMS on DB2/SQL


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'



After some time Traveler shows it is starting followed by 10 steps for upgrading to UP108/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 ACCOUNT08/06/2012 08:21:28 PM Lotus Traveler: Compressing table GUIDMAP08/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_NAME08/06/2012 08:21:42 PM Lotus Traveler: Compressing table TS_FILTERS08/06/2012 08:21:42 PM Lotus Traveler: Compressing table TS_GLOBAL08/06/2012 08:21:42 PM Lotus Traveler: Compressing table TS_GUD_RECORD_EX08/06/2012 08:21:44 PM Lotus Traveler: Compressing table TS_GUD_TIMESTAMP08/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_MAPPING08/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_TIMESTAMP08/06/2012 08:24:05 PM Lotus Traveler: Compressing table TS_SYNC_TIMESTAMP_FOLDER08/06/2012 08:24:05 PM Lotus Traveler: Compressing table PUSH08/06/2012 08:24:05 PM Lotus Traveler: Compressing table SEC_RECORDS08/06/2012 08:24:05 PM Lotus Traveler: Compressing table REPLICAS08/06/2012 08:24:05 PM Lotus Traveler: Compressing table CLIENT_VERSIONS08/06/2012 08:24:05 PM Lotus Traveler: Compressing table SCHEMAVERSION08/06/2012 08:24:05 PM Lotus Traveler: Compressing table INV_MAP08/06/2012 08:24:05 PM Lotus Traveler: Compressing table LOGSETTINGS08/06/2012 08:24:05 PM Lotus Traveler: Compressing table GUIDNEXT08/06/2012 08:24:05 PM Lotus Traveler: Defragging Indexes: 0/22 complete08/06/2012 08:28:49 PM Lotus Traveler: Defragging Indexes: 15/22 complete08/06/2012 08:28:50 PM Lotus Traveler: Defragging Indexes: 22/22 complete08/06/2012 08:28:50 PM Lotus Traveler: Defragging and Compressing is complete.



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...08/06/2012 08:40:00 PM Lotus Traveler: Upgrade is still in progress...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)08/06/2012 08:40:30 PM Lotus Traveler: Upgrade is still in progress...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.con08/06/2012 08:48:16 PM HTTP Server: Using Web Configuration View08/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 loaded08/06/2012 08:48:30 PM XSP Command Manager initialized08/06/2012 08:48:53 PM HTTP Server: Started

● Traveler has been successfully upgraded to UP1

● Shut down the domino server to carry out HA configuration


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 clearlog collectpmr pmr show pmr removepmr set db show → Shows the database configurationdb remove → Used to go back to using local derby databasedb check → Used to verify configurationdb set → Used to update db user ID and PW. It won't prompt for URL and path if found. ssl show → Shows the SSL certificate store informationssl remove → Removes any stored SSL credentialsssl check → Validates the SSL certificate store password(s)ssl set → Set SSL certificate key store password and trust store password if they pass validation


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


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



2) Control Center window is launched

Continued.



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

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

Continued..



4) Give the database name, path, Alias and comment in the 'Name' tab

* Select the defaults for each attribute unless otherwise noted.

Continued...



5) In the Region tab change the Code Set drop down box to UTF-8

* Select the defaults for each attribute unless otherwise noted.

Continued....



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

Continued.....



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

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

Continued.......

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



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

Continued........



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

Continued.........

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


● Configure Lotus Notes Traveler for enterprise DB2 database8) Start the Lotus Notes Traveler server, Server console shows traveler server will transfer existing users sync data to HADR

Continued..........

08/06/2012 09:37:57 PM Lotus Traveler: Starting JVM with Maximum Memory = 3072M08/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 Pool08/06/2012 09:38:11 PM Lotus Traveler: 0/954 Users' Sync Data have been transferred08/06/2012 09:38:47 PM Lotus Traveler: 16/954 Users' Sync Data have been transferred08/06/2012 09:39:54 PM Lotus Traveler: 123/954 Users' Sync Data have been transferred08/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 transferred08/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.con08/06/2012 10:13:28 PM HTTP Server: Using Web Configuration View08/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 loaded08/06/2012 10:13:32 PM Servlet engine initialization was successful08/06/2012 10:13:35 PM XSP Command Manager initialized08/06/2012 10:13:59 PM HTTP Server: Started


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



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

Continued.



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

Continued..



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

Continued...



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

Continued....



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

Continued.....



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

Continued......



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

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

Continued........

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



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

Continued.........


● Configure Lotus Notes Traveler for enterprise MS SQL database6) To validate what you just configured, use the travelerUtil db show command or the travelerUtil db check

Continued..........

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.



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

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

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.20120528210008/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.con08/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 View08/06/2012 10:55:38 PM JVM: Java Virtual Machine initialized.08/06/2012 10:55:38 PM HTTP Server: Java Virtual Machine loaded08/06/2012 10:55:38 PM HTTP Server: DSAPI Domino Off-Line Services HTTP extension Loaded successfully08/06/2012 10:55:38 PM Lotus Traveler: Server started.08/06/2012 10:55:38 PM XSP Command Manager initialized08/06/2012 10:55:38 PM HTTP Server: Started


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.

http://travelerserver.com/servlet/traveler





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.


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)


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:


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


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


Web Based Administration Continued● Device Security, Device Settings, Devices and Users view are almost

identical to traditional interface.


Web Based Administration Continued● Click on a device to see details – similar to traditional interface.


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.


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.


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” statustell 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.


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>


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


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


Logging in HA Environment

● Log location is local only – set in notes.ini● All other log settings are global and should be set using tell commands.

tell traveler log level finesttell traveler log adduser finest usernametell traveler log fields *

● Log level is always finest during startup, then switches to defined level.● log collect, log clear, systemdump and pmr commands all run locally, use

-s to run on other servers.

tell traveler -s * systemdumptell traveler -s * pmr 12345,999,744tell traveler -s myserver/myco log collect

● For complete list of options:

tell traveler log help


Traveler Server Status

● Traveler Server Status can be green, yellow, or red.● Thresholds are configurable (see NTS_STATUS_* properties) in doc.● Status conditions include:

Java and native memory

CPU utilization

Threads

Error counts

DB errors and connections

IPC delays

Disk free space

SSL certificate expiration (Traveler server not HTTP)

Logging set on FINEST


Availability Index

● Availability Index (AI) used by Traveler servers in the pool to balance load.

● The AI range can be from 100 to -200

100 to 0 Normal processing range (base AI 100)

0 to -100 Traveler server is in constrained state (base AI 0)• Constrained state is when the server recognizes it is overloaded and starts send 503 server

busy responses in attempt to recover.

-100 to -200 Traveler server is unavailable (base AI -100)• Administrator has marked server as unavailable using tell command.

● The AI is computed by subtracting the larger of the memory usage and CPU usage from the Base AI.

Native memory is the percentage of Native memory use vs physical memory

Average CPU percentage over last 15 minutes.


Isolating a Server or User in a Pool

● Have ability to temporarily remove a server from the pool.

tell traveler available on|off

This sets the AI to -100

All traffic except bound users will be off-loaded to other servers.● Ability to bind a user to a particular server

tell traveler bind enable <user>

tell traveler bind disable <user>

Binds the user to this server

Useful for isolating a user to reproduce a problem or prevent the user from crashing other servers.

Not recommended for long term usage as effectively


Tips-Q:- Is it mandatory to use DB2 or MS-SQL if we want to use Traveler server in HA mode ? Can we use old “ntsdb” in HA mode with some reduced functionality ?

Ans:- You must use either DB2 or MS-SQL if you want HA mode. Traditional “ntsdb” does not support HA mode.

Q:- If we are using Upgrade Pack 1, then it is mandatory to use HA ? & Can we use Traveler Upgrade Pack 1 server in stand-alone mode ?

Ans:- The main intention of Upgrade Pack 1 is providing HA, however it can also work in stand-alone mode. If you use stand-alone mode server, then you don't need use DB2 or MS-SQL

Q:- Once we migrate our data to DB2, then can we go back to old “ntsdb” if we ever want to switch from HA to stand-alone mode ?

Ans:- Yes you can go back to old “ntsdb” if you do not want to continue in HA mode. However Traveler server will create a fresh “ntsdb” folder rather than migrating data back from DB2 to “ntsdb”. Use “travelerutil db remove” command to discontinue using DB2.

Q:- Can I install latest Traveler 8.5.3.3 on top of Upgrade Pack 1 ? What is difference between them exactly ?

Ans:- Don't install Traveler 8.5.3.3 on top of Upgrade Pack 1. Traveler 8.5.3.3 is only stand-alone mode server. Later separate Maintenance Release will provided for Upgrade Pack 1.


Tips-Q:- Earlier we used to run “Load Traveler -defrag” to defrag our “ntsdb” database. Now since the database is moved to DB2, so do we still need to run this command for maintenance ?

Ans:- This command will send commands to DB2 server to “Reorg” every table in DB2 database and thereby performing maintenance on DB2 database.

Q:- Is it must to have the DB2 server also in HA for a true HA?

Ans:- For a true HA, especially if you have large number of users, then you should ideally be having DB2 server also in HA, so if one DB2 server fails then it can use another DB2 server.

DB2 databases are extremely reliable and normally they won't fail, so initially you can have only single DB2 server and run it for 2-3 months and then decide if you really want to have DB2 server in HA.

Q:- Can Traveler HA work without load balancer just on DNS based failover ?

Ans:- Traveler HA must have the load balancer. It will not work just based on DNS failover. Load balancers have ability to redirect the traffic to another host if they don't get response from a particular host. DNS based failover can't do this.

Q:- For a true HA, is it mandatory to have to load balancers also in HA ?

Ans:- Normally there is nothing in the load balancer to fail as they just redirect the traffic and don't keep any data with them, so load balancer will not normally fail unless there is a network or ISP line failure. You can configure multiple load balancers if you want failover protection in them.


Tips-

Q:- If I face any problems in connection with DB2, then how should I check the connection from Traveler server to DB2 server ?

Ans:- You can use the command “travelerutil db check” by going to “data\traveler\util” folder from command prompt and it will show you, if the connection to DB2 is successful.

Q:- How do I mark a particular Traveler server as “Out of Service” ?

Ans:- If you want to perform any maintenance on specific Traveler server, then you can mark it as “Out of Service” by giving the command “Tell Traveler available off” and once you finish the maintenance of that server, then you can bring it “In Service” by giving command “Tell Traveler available on”.

Q:- Do we need to have additional license for DB2 server for Traveler HA configuration ?

Ans:- Each entitlement to Lotus Traveler UP1 also entitles the customer to one license of DB2 Workgroup server 9.7. The DB2 download will be available under the Lotus Traveler Upgrade Pack listing on Passport Advantage.


Known Issues

● SQL Performance APAR LO70125 Will be made available on Fix Central with GA.

● Web Admin does not display data on Linux – LO70134 Workaround – change owner/group on this file to match notes.ini

<data>/domino/workspace/.config/config.ini

● HTC and complex password issue Some HTC devices will allow complex password, but then only show number pad to

enter it.

● Recommended Maintenance Technote:

http://www.ibm.com/support/docview.wss?uid=swg24019529

http://www.ibm.com/support/docview.wss?uid=swg24019529


Wiki Based Product Documentation● READ FIRST: Product Doc – Main Content

http://www.lotus.com/ldd/dominowiki.nsf/xpViewCategories.xsp?lookupName=Product%20Documentation

● Individual Articles – APAR listing, fixpack release notes etc.

http://www.lotus.com/ldd/dominowiki.nsf/xpViewCategories.xsp?lookupName=Lotus Notes Traveler

● Updating Wiki

Minor Updates• Update or add comment via Web Browser

• Update via Notes DB

Server: wiki1/web Address: wiki1.swg.usma.ibm.com

Larger Updates• Send us a PMR

• Send e-mail with suggestion

Original un-edited content always available



http://www.lotus.com/ldd/dominowiki.nsf/xpViewCategories.xsp?lookupName=Lotus%20Notes%20Traveler


References● Lotus Notes Traveler Product Documentation


● Lotus Traveler Detailed System Requirements https://www.ibm.com/support/docview.wss?uid=swg27007909

● Lotus Traveler Support FAQ http://www.ibm.com/support/docview.wss?uid=swg21450615

● Traveler Companion FAQ http://www.lotus.com/ldd/dominowiki.nsf/dx/Traveler_Companion_FAQ

● Lotus Traveler Releases by Date http://www.lotus.com/ldd/dominowiki.nsf/dx/Lotus_Notes_Traveler_APAR_listing

● Configuring Traveler HA using DB2 and MS SQL● http://www-10.lotus.com/ldd/dominowiki.nsf/dx/Configuring_IBM_Lotus_Notes_Traveler_High_Availability__with_an_enterprise_IBM_DB2_database

● http://www-10.lotus.com/ldd/dominowiki.nsf/dx/Configuring_IBM_Lotus_Notes_Traveler_High_Availability_with_enterprise_Microsoft_SQL_database




https://www.ibm.com/support/docview.wss?uid=swg27007909

http://www.ibm.com/support/docview.wss?uid=swg21450615Companion



http://www.lotus.com/ldd/dominowiki.nsf/dx/Traveler_Companion_FAQ

http://www.lotus.com/ldd/dominowiki.nsf/dx/Traveler_Companion_FAQ

http://www.lotus.com/ldd/dominowiki.nsf/dx/Lotus_Notes_Traveler_APAR_listing

http://www-10.lotus.com/ldd/dominowiki.nsf/dx/Configuring_IBM_Lotus_Notes_Traveler_High_Availability__with_an_enterprise_IBM_DB2_database


Questions

Q & A

lotus notes traveler 8.5.3 upgrade pack 1 high ... ha open mic... · a derby database is...

Documents