Configuring and deploying Sametime for mobile users

Configuring and deploying Sametime for mobile users Tony Payne, Sametime Development March 27, 2012 ©2011 IBM Corporation Agenda ● Software Requir...
Author: Phyllis Stevens
9 downloads 0 Views 1MB Size
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

Suggest Documents