Configuring and deploying Sametime for mobile users Tony Payne, Sametime Development March 27, 2012 ©2011 IBM Corporation
Agenda
●
Software Requirements
●
Configuration Steps
●
Clients
●
Installing the client(s)
Configuring the client(s)
Troubleshooting the client(s)
More Information
© 2011 IBM Corporation
2
Software Requirements
●
Sametime 8.5.2 IFR 1
© 2011 IBM Corporation
3
Server Configuration Steps
●
Sametime Proxy Database creation DataSource configuration Access to the APNS • “Apple Push Notification Service”
© 2011 IBM Corporation
4
Configuration Time
●
Create Sametime Proxy Database for iPhone
●
Create JNDI datasource references
●
Copy APNS Keystore
●
Configure Connectivity to Apple Services
© 2011 IBM Corporation
5
Creating a Proxy Server database to support iPhone ●
On the DB2® server, log in to the system as the DB2 administrator created during DB2 installation.
●
●
From the folder where you extracted STProxyHotFix.zip, copy the DatabaseScripts folder to a local directory.
Open a command prompt and navigate to the folder where you copied the DatabaseScripts folder. Create the database by entering one of the following commands from the DatabaseScripts folder. Wait until you see confirmation that the database has been created and the command has finished.
AIX®, Linux™, or Solaris •
Windows™ •
●
./createProxyDB.sh STPROXY dbadmin createProxyDB.bat STPROXY dbadmin
Replace STPROXY in the command if you want to choose a different database name. Names can be from 1 - 8 characters, but cannot contain special or multibyte characters.
Replace dbadmin with the DB2 Application User ID you created when you installed DB2. This user has database administration authority.
When naming DB2 objects, follow the rules for your operating system.
Close the command window. © 2011 IBM Corporation
6
Creating the STProxy Datasources ●
●
●
●
●
Verify that the Deployment Manager and node agent have been started. On the server being updated, copy proxyDbSetup.py from the DatabaseScripts folder to was_install_root\STPServerCell. In a text editor, open the proxy.properties file stored in was_install_root\STPServerPN_or_SN\SametimeProxyServerOffering\SametimeServer\STProxy\pr oxy\. Edit the following values:
proxy.DbAppUser
proxy.DbAppUserPassword
proxy.DataBaseServerName
proxy.DataBaseServerPort
proxy.DbName
From the bin directory, run the following command:
●
..\AppServer\profiles\proxyProfileName/bin wsadmin.bat -lang jython -user wasUser -password wasPwd -f "script_location/proxyDBSetup.py" "was_install_root\STPServerPN\SametimeProxyServerOffering\SametimeServer\STProxy\prox y\proxy.properties"
After the script completes, verify the JNDI resources
© 2011 IBM Corporation
7
Copy APNS Keystore – PN Profile ●
This type of installation typically means that you are using the Sametime System Console (SSC) as the dmgr. The steps are as follows (basically the same as above):
●
Locate the apns-prod.pkcs12 file •
This file is typically found in a new 'profile' directory created on install on the primary node OS file system, that should not be here. It is most likely something similar to:
•
../IBM/WebSphere/AppServer/profiles/STPSNAppProfile/config/cells/ [cellName]/nodes/[stproxyPNNodename]/apns-prod.pkcs1
•
*Note that the profile name is NOT the name of your installed profile.
Copy this file to the following directory on the SSC operating system file system: •
./IBM/WebSphere/AppServer/profiles/[SSCdmgrProfileName]/config/cells/ [SSCcellName]/nodes/[stProxyPNNodename]/
•
*Note that this is the SSC dmgr profile, NOT the SSC Application profile
Synchronize the nodes and restart the STProxyServer and Nodeagent
If you have any secondary nodes, you need to copy the apns-prod.pkcs12 file to ALL secondary node directories on the SSC dmgr. The secondary node directories are found in the same place as the primary node directory was found: © 2011 IBM Corporation
8
Copy APNS Keystore – CELL Profile ●
If you chose this type of installation, then you have a deployment manager (dmgr) as well as a nodeagent and server all on the same operating system.
To resolve the problem, follow these steps: •
Locate the apns-prod.pkcs12 file
•
This file is typically found in a new 'profile' directory created on install, that should not be here. It is most likely something similar to:
•
../IBM/WebSphere/AppServer/profiles/STPSNAppProfile/config/cells/ [cellName]/nodes/[stproxyNodename]/apns-prod.pkcs12
•
*Note that the profile name is NOT the name of your installed profile
Copy this file to the following directory: •
../IBM/WebSphere/AppServer/profiles/[dmgrProfileName]/config/cells/ [cellName]/nodes/[stProxyNodename]/
•
*Note that this is the dmgr profile, NOT the Application profile
Synchronize the nodes and restart the STProxyServer and Nodeagent
© 2011 IBM Corporation
9
Configure the Connections to Apple Services ●
●
●
●
Log in to the Integrated Solutions Console.
Click Sametime System Console -> Sametime Servers -> Sametime Proxy Server.
In the Sametime Proxy Servers list, click the Edit next to the deployment name of the server with the connection information that you want to change.
The settings to review or change are under Mobile device settings.
If you select Disable PUSH notification, iPhone users are logged out rather than paused. Unviewed messages are not held for them in the Sametime Proxy Server database. If you select Allow sending photos from a mobile device, iPhone and Android users are permitted to send photos. Sending photos is allowed by default, but you can clear the setting if company policy or server load prohibit sending photos.
© 2011 IBM Corporation
10
Sametime Proxy Deployment – Apple Services
Sametime Proxy Server 9080/9443
Sametime Community Server 1516
PN
9080/9443
2196
389/636
50000
feedback.push.apple.com
DMGR 2195
DB2
Sametime System Console LDAP
gateway.push.apple.com
© 2011 IBM Corporation
11
Sametime Proxy Deployment – Clustered Environment Sametime Proxy Cluster Sametime Community Cluster
80/443
9080/9443
PN
1516
Load Balancer SN 9080/9443
2196 feedback.push.apple.com
2195
389/636
50000
DB2
DMGR Sametime System Console
LDAP
gateway.push.apple.com
© 2011 IBM Corporation
12
Configure the Connection to Apple Notification Server ●
●
●
The Apple notification server host name and port are used by the Sametime Proxy Server to send Sametime instant messages, meeting invitations, and announcements to iPhone users. When a user pauses receipt of messages, the Sametime Proxy Server database holds messages until the user views the messages or the mobile device's pause time expires. The default settings for connecting to the service are shown below.
Apple notification server hostname: •
gateway.push.apple.com
Apple notification server port: •
2195
© 2011 IBM Corporation
13
Configure the Connection to Apple Feedback Service ●
The Apple feedback service keeps track of which iPhone mobile devices are still valid and sends the information to the Sametime Proxy Server. The default settings are shown below.
Apple feedback service host: •
feedback.push.apple.com
Apple feedback service port: •
2196
© 2011 IBM Corporation
14
Configure the Connections to Apple Services ●
Access the Sametime Proxy Servers and select the Proxy Server ...
© 2011 IBM Corporation
15
Configure the Connections to Apple Services ●
Default Settings
If you make any changes, Click OK and restart the Sametime Proxy Server(s) to apply
© 2011 IBM Corporation
16
Configure the Connections to Apple Services ●
●
If you do not have the Sametime System Console
You can manually edit the stproxyconfig.xml file
This file is located in the Deployment Managers profile config tree, under the cells//nodes//servers/ directory
Always make this change in the dmgr profile and synchronize and restart to apply
Default Settings
© 2011 IBM Corporation
17
Clients ●
Installing the client(s)
●
Configuring the client(s)
●
Troubleshooting the client(s)
© 2011 IBM Corporation
18
Sametime Clients ●
Sametime clients are available for
Rich client platforms • Windows, Mac, Linux
MIDP-based devices • Blackberry, Nokia S60
Smart phones/tablets • IOS 4 and later • Android 2.2 and later
Web clients • Desktop browsers - Windows, Mac, Linux • Smart phones/tablets – iOS, Android © 2011 IBM Corporation
19
Smart Phone Native Client ●
Android and iOS clients are very similar
●
Setup follows common sequence:
Download the app
Specify the community
Provide the userID and password
Optional reverse proxy
Troubleshooting settings
© 2011 IBM Corporation
20
iPhone Native Client – Downloading the app ●
Download
Directly on the client
In iTunes
© 2011 IBM Corporation
21
iPhone Native Client – Initial setup
© 2011 IBM Corporation
22
iPhone Native Client – Sametime Proxy ●
Server Community
●
Host Server
●
The Sametime Proxy Server address
Port
●
A name you can remember
Defaults to 9080
Secure connection
Set to ON for SSL
Remember to change port (9443)
© 2011 IBM Corporation
23
iPhone Native Client - Login ●
User ID
●
Password
●
Your Sametime login name
Leave blank to force entry each time
Remember password
Do you really want to do this?
Also applies to the reverse proxy
© 2011 IBM Corporation
24
iPhone Native Client - Firewall ●
Direct connection
●
●
Rare – used in-house only
Authenticating Proxy
Reverse proxy
Used to allow external access
For photo images, set the port
© 2011 IBM Corporation
25
iPhone Native Client – Firewall login ●
Reuse Credentials
●
Same username/password as login
Otherwise
Provide proxy username & password
© 2011 IBM Corporation
26
Android Native Client – Download the app ●
Navigate to the download page on your Sametime Proxy server
http://:9080/stmobile/Sametime.html
© 2011 IBM Corporation
27
Android Native Client – Proxy Settings
© 2011 IBM Corporation
28
Android Native Client - Settings
© 2011 IBM Corporation
29
Android Native Client – Photo port
© 2011 IBM Corporation
30
Android Native Client – Initial login ●
If you haven't already specified the server ....
© 2011 IBM Corporation ●
Otherwise, normal login
31
Troubleshooting ●
Sometimes something goes wrong which the user can't resolve
●
This requires more detailed information, i.e. logs
●
If the user collects the information, the process must be reasonably simple
●
Collecting a report follows a few simple steps
●
Start the client
Enable logging
Reproduce the problem being analysed
Capture the log
There are three main sources of logs
The client
The Sametime Proxy server
The Sametime Community server
© 2011 IBM Corporation
32
Troubleshooting - iPhone Native Client ●
Open settings for Sametime
-------------------------------->
© 2011 IBM Corporation
33
Troubleshooting - iPhone Native Client ●
Click on “Troubleshooting”
© 2011 IBM Corporation
34
Troubleshooting - iPhone Native Client ●
Enable Logging
© 2011 IBM Corporation
35
Troubleshooting - iPhone Native Client ●
After session, send the logs
© 2011 IBM Corporation
36
Troubleshooting - iPhone Native Client ●
Send the E-mail
© 2011 IBM Corporation
37
Troubleshooting - Android Native Client ●
Click on “Troubleshooting”
-------------------------------->
© 2011 IBM Corporation
38
Troubleshooting - Android Native Client ●
Enable logging
© 2011 IBM Corporation
39
Troubleshooting - Android Native Client ●
After session, send the logs
© 2011 IBM Corporation
40
Known Fixes
●
Hotfix TPAE-8S5TPP – resolves an issue where the APNS settings were not being read from the XML
Only needed IF you have changed from the default.
© 2011 IBM Corporation
41
More Information
●
Lotusphere 2012 Presentation SHOW-301has walkthru of all steps to install full environment plus web application development hints and debugging https://greenhouse.lotus.com/wikis/home? lang=en_US#/wiki/Wdc57f3ceaf9f_4f41_af5a_6ead7a08412e/pa ge/Lotusphere%202012%20Content
●
'Zero to Hero – Make your bosses happy' is another in the series and dedicated to this same mobile deployment http://www.lotus.com/ldd/stwiki.nsf/dx/IBM_Sametime_8.5.2_IFR1_ Implementation-From_Zero_To_Mobile-Make_your_boss_happy
●
Push Notification Service not working? http://www.ibm.com/support/docview.wss?uid=swg21576076 © 2011 IBM Corporation
42
Questions
Press *1 on your telephone to ask a question.
IBM Lotus Support page http://www.facebook.com/IBMLotusSupport
@Lotus_Support
© 2011 IBM Corporation
43
Legal Disclaimer © IBM Corporation 2012. All Rights Reserved. The information contained in this publication is provided for informational purposes only. While efforts were made to verify the completeness and accuracy of the information contained in this publication, it is provided AS IS without warranty of any kind, express or implied. In addition, this information is based on IBM’s current product plans and strategy, which are subject to change by IBM without notice. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, this publication or any other materials. Nothing contained in this publication is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in this publication to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in this presentation may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific sales, revenue growth or other results. IBM, Lotus, Lotus Notes, Notes, and Domino are trademarks of International Business Machines Corporation in the United States, other countries, or both. Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others. All references to renovations.com refer to a fictitious company and are used for illustration purposes only. © 2011 IBM Corporation
44