Lotus Notes Traveler Upgrade Pack 1 High Availability (HA)

Transcription

1 Lotus Notes Traveler Upgrade Pack 1 High Availability (HA) By Shrikant Jamkhandi Sandeep Deshpande

2 OPEN MIC LOTUS TEAM 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 2

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

4 Lotus Notes Traveler 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 (currently at IF1)

5 Basic Traveler Architecture without HA Mail servers Traveler server Mobile Devices Notes RPC HTTP/S Authenticating proxy server ntsdb (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.

6 Basic Traveler HA Architecture Traveler service pool Mail servers Notes RPC Mobile Devices Load Balancer IP Sprayer Remote DB HA Traveler DB

7 System Requirements for High Availability Same server and device requirements as 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 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 Upgrade Pack 1 Version Numbers Component Version Build Server _2102 Android _0951 Windows Mobile _2100 Nokia _1525 Note: the Lotus Traveler Upgrade Pack requires Domino Upgrade Pack 1 but will install it if it is not already on the target system.

8 HA Architecture Traveler service pool Mail servers Web Administration Administer any user from any server. Direct connect or through proxy/load balancer Notes RPC Mobile Devices Load Balancer/ IP Sprayer Single IP address configuration Recommend Sprayer is Highly Available if possible. Generally will be in DMZ. Traveler services will perform smart load balance Recommend pool is behind corporate firewall Remote DB Connects using JDBC to RDBMS on DB2/SQL HA Traveler DB Recommend Highly Available DB configuration

9 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/ :18:46 PM Updating 'NTFNotesFS' into database 'IBM Lotus Notes Traveler' from template 'Lotus Notes Traveler' 08/06/ :18:47 PM Adding 'actionsusingrest_pt.properties' to database 'IBM Lotus Notes Traveler' from template 'Lotus Notes Traveler' 08/06/ :18:47 PM Adding 'defaultdevicesettingssecurity_sk.properties' to database 'IBM Lotus Notes Traveler' from template 'Lotus Notes Traveler' 08/06/ :18:47 PM Adding 'device_settings_pl.properties' to database 'IBM Lotus Notes Traveler' from template 'Lotus Notes Traveler' 08/06/ :18:48 PM Adding 'xservers_tr.properties' to database 'IBM Lotus Notes Traveler' from template 'Lotus Notes Traveler'. 08/06/ :18:48 PM Adding '.settings/org.eclipse.core.resources.prefs' to database 'IBM Lotus Notes Traveler' from template 'Lotus Notes Traveler'

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

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

12 Traveler Utility for HA Mode Configuration Use travelerutil configuration utility to configure for enterprise DB2/SQL Database. travelerutil is not new, but prior to 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 log collect pmr pmr show pmr remove pmr set db show db remove db check db set ssl show ssl remove ssl check ssl set Shows the database configuration Used to go back to using local derby database Used to verify configuration Used to update db user ID and PW. It won't prompt for URL and path if found. Shows the SSL certificate store information Removes any stored SSL credentials Validates the SSL certificate store password(s) Set SSL certificate key store password and trust store password if they pass validation

13 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

14 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

15 Continued. Configure DB2 database for Lotus Notes Traveler using the DB2 Configuration Wizard 2) Control Center window is launched

16 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'

17 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.

18 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.

19 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.

20 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

21 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

22 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

23 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

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

25 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

26 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'

27 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'

28 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

29 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

30 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

31 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.

32 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

33 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 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

34 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

35 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.

36 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/ :35:19 PM 08/06/ :35:23 PM mode. 08/06/ :35:28 PM... 08/06/ :35:28 PM 08/06/ :35:28 PM Lotus Traveler: Server starting... Lotus Traveler: Transfer has completed successfully. Traveler will now start in HADR Lotus Traveler: Traveler Pool already has a client with version: Lotus Traveler: Traveler Pool already has a client with version: Lotus Traveler: Traveler Pool already has a client with version: > RESTART TASK HTTP >C:\Users\IBM_AD~1\AppData\Local\Temp\notes0979B1\rem18747.con 08/06/ :55:31 PM Lotus Traveler: Restarting HTTP Server for configuration changes. 08/06/ :55:31 PM HTTP Server: Using Web Configuration View 08/06/ :55:38 PM JVM: Java Virtual Machine initialized. 08/06/ :55:38 PM HTTP Server: Java Virtual Machine loaded 08/06/ :55:38 PM HTTP Server: DSAPI Domino Off-Line Services HTTP extension Loaded successfully 08/06/ :55:38 PM Lotus Traveler: Server started. 08/06/ :55:38 PM XSP Command Manager initialized 08/06/ :55:38 PM HTTP Server: Started

37 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 to 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.

38 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.

39 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)

40 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:

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

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

43 Web Based Administration Continued Device Security, Device Settings, Devices and Users view are almost identical to traditional interface.

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

45 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.

46 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.

47 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.

48 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>

49 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 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 max device per Traveler pool. Contact Techline or Services team for sizing help

50 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

51 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 finest tell traveler log adduser finest username tell 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 * systemdump tell traveler -s * pmr 12345,999,744 tell traveler -s myserver/myco log collect For complete list of options: tell traveler log help

52 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

53 Availability Index Availability Index (AI) used by Traveler servers in the pool to balance load. The AI range can be from 100 to to 0 Normal processing range (base AI 100) 0 to -100 Traveler server is in constrained state (base AI 0) -100 to -200 Traveler server is unavailable (base AI -100) Constrained state is when the server recognizes it is overloaded and starts send 503 server busy responses in attempt to recover. 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.

54 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

55 TipsQ:- 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 standalone 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 on top of Upgrade Pack 1? What is difference between them exactly? Ans:- Don't install Traveler on top of Upgrade Pack 1. Traveler is only standalone mode server. Later separate Maintenance Release will provided for Upgrade Pack 1.

56 TipsQ:- 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.

57 TipsQ:- 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.

58 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:

59 Wiki Based Product Documentation READ FIRST: Product Doc Main Content Individual Articles APAR listing, fixpack release notes etc. %20Documentation 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 with suggestion Original un-edited content always available

60 References Lotus Notes Traveler Product Documentation Lotus Traveler Detailed System Requirements Traveler Companion FAQ Lotus Traveler Support FAQ %20Documentation Lotus Traveler Releases by Date Configuring Traveler HA using DB2 and MS SQL with_an_enterprise_ibm_db2_database

61 Questions Q&A