BB Quickr Reference Guide

8/13/2019 BB Quickr Reference Guide

1/24

BlackBerry Client for IBM Lotus Quickr v0.01 | 711-01896-123 | 2009 Research In Motion Limited


2/24


3/24

BlackBerry Client for IBM Lotus Quickr

711-01896-123 2009 Research In Motion Limited 3v0.01

2009 Research In Motion Limited. All rights reserved. BlackBerry,RIM, Research In Motion, SurePress, SureType and relatedtrademarks, names and logos are the property of Research In MotionLimited and are registered and/or used in the U.S. and countries aroundthe world.

IBM, Domino, Lotus, and Quickr are trademarks of InternationalBusiness Machines Corporation. Java and J2EE are trademarks of SunMicrosystems, Inc. Microsoft, Exchange, Windows Server aretrademarks of Microsoft Corporation. All other trademarks are theproperty of their respective owners.

The BlackBerry smartphone and other devices and/or associatedsoftware are protected by copyright, international treaties, and variouspatents, including one or more of the following U.S. patents: 6,278,442;6,271,605; 6,219,694; 6,075,470; 6,073,318; D445,428; D433,460; D416,256.Other patents are registered or pending in the U.S. and in various

countries around the world. Visit www.rim.com/patents for a list ofRIM (as hereinafter defined) patents.

This documentation including all documentation incorporated byreference herein such as those provided or made available by hyperlinkis provided or made accessible "AS IS" and "AS AVAILABLE" andwithout condition, endorsement, guarantee, representation or warrantyof any kind by Research In Motion Limited and its affiliated companies("RIM") and RIM assumes no responsibility for any typographical,technical, or other inaccuracies, errors or omissions in thisdocumentation. In order to protect RIM proprietary and confidentialinformation and/or trade secrets, this documentation may describe

some aspects of RIM technology in generalized terms. RIM reserves theright to periodically change information that is contained in thisdocumentation; however, RIM makes no commitment to provide anysuch changes, updates, enhancements, or other additions to thisdocumentation to you in a timely manner or at all.

This documentation might contain references to third-party sources ofinformation, hardware or software, products or services includingcomponents and content such as content protected by copyright and/orthird-party web sites (collectively the "Third Party Products andServices" ). RIM does not control, and is not responsible for, any ThirdParty Products and Services including, without limitation the content,accuracy, copyright compliance, compatibility, performance,trustworthiness, legality, decency, links, or any other aspect of ThirdParty Products and Services. The inclusion of a reference to Third PartyProducts and Services in this documentation does not implyendorsement by RIM of the Third Party Products and Services or thethird party in any way.


4/24


4 2009 Research In Motion Limited 711-01896-123v0.01

EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BYAPPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS,ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, ORWARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDINGWITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS,GUARANTEES, REPRESENTATIONS OR WARRANTIES OFDURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE,MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, ORARISING FROM A STATUTE OR CUSTOM OR A COURSE OFDEALING OR USAGE OF TRADE, OR RELATED TO THEDOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, ORANY THIRD PARTY PRODUCTS AND SERVICES REFERENCEDHEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHERRIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR

LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TOTHE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIESOR CONDITIONS RELATING TO THE DOCUMENTATION TO THEEXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUTCAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYSFROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATIONOR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW INYOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FORANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATIONOR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY

SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY 711-01896-123

PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDINGWITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES:DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL,INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES,DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TOREALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION,LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESSOPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURESTO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATEDWITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIMPRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USEOF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OROF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTSOF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OROTHER SIMILAR PECUNIARY LOSSES ,WHETHER OR NOT SUCH


5/24



DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIMHAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW INYOUR JURISDICTION, RIM SHALL HAVE NO OTHER OBLIGATION,DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OROTHERWISE TO YOU INCLUDING ANY LIABILITY FORNEGLIGENCE OR STRICT LIABILITY.

THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREINSHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THECAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDINGBUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE,TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY ANDSHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES ORTHE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENTOR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO RIM AND

ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS,AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS),AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIMESERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS,EMPLOYEES AND INDEPENDENT CONTRACTORS.

IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUTABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE,AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOROF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITYARISING FROM OR RELATED TO THE DOCUMENTATION.

Prior to subscribing for, installing or using any Third Party Products andServices it is your responsibility to ensure that your airtime serviceprovider has agreed to support all of their features. Some airtime serviceproviders may not offer Internet browsing functionality with asubscription to BlackBerry Internet Service. Check with your serviceprovider for availability, roaming arrangements, service plans andfeatures. Installation or use of Third Party Products and Services withRIM's products and services may require one or more patent,trademark, copyright or other licenses in order to avoid infringement orviolation of third party rights. You are solely responsible fordetermining whether to use, Third Party Products and Services and ifany third party licenses are required to do so. If required you areresponsible for acquiring them. You should not install or use Third PartyProducts and Services until all necessary licenses have been acquired.Any Third Party Products and Services that are provided with RIM'sproducts and services are provided as a convenience to you and areprovided "AS IS" with no express or implied conditions, endorsements,guarantees, representations or warranties of any kind by RIM and RIMassumes no liability whatsoever, in relation thereto. Your use of Third


6/24



Party Products and Services shall be governed by and subject to youagreeing to the terms of separate licenses and other agreementsapplicable thereto with third parties, except to the extent expresslycovered by a license or other agreement with RIM.

Certain features outlined in this documentation require a minimumversion of BlackBerry Enterprise Server software, BlackBerryDesktop Software, and/or BlackBerry Device Software and mayrequire additional development or Third Party Products and Servicesfor access to corporate applications.

This product includes software developed by the Apache SoftwareFoundation (http://www.apache.org/) and/or licensed pursuant toApache License, Version 2.0 (http://www.apache.org/licenses/). Formore information, see the NOTICE.txt file included with the software.Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, eitherexpress or implied. See the License for the specific language governingpermissions and limitations under the License.

The terms of use of any RIM product or service are set out in a separatelicense or other agreement with RIM applicable thereto. NOTHING INTHIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANYEXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDEDBY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICEOTHER THAN THIS DOCUMENTATION.


7/24



About this trainingThis training material was designed under the assumption that allrequired prerequisites are completed by participants before attendingthe session. The manual was designed to accompany a presentationdelivered by a Research In Motion (RIM) recognized instructor.

To avoid negatively impacting the quality of the learning experience,RIM recommends participants complete the prerequisites or that apresentation accompanies the manual.


8/24




9/24

Contents


Contents

BlackBerry Client for IBM Lotus Quickr......................... 11Introduction......................................................................................................... 11Log in to the BlackBerry Client for IBM Lotus Quickr................................... 11Libraries and folders ......................................................................................... 12 Working with files.............................................................................................. 12Roles and permissions...................................................................................... 13BlackBerry Social Networking Application Proxy for IBM Lotus Quickr... 13 Architecture: BlackBerry Social Networking Application Proxy and theBlackBerry Client for IBM Quickr.................................................................... 13 Technical support information ........................................................................ 15

Installation and initial setup.................................................................. 16

Pre-requisites..................................................................................................... 16Installation ......................................................................................................... 16Post installation..................................................................................................17Configuration......................................................................................................17

Troubleshooting....................................................................................... 19Initial troubleshooting...................................................................................... 19 Troubleshooting the BlackBerry Social Networking Application Proxy... 20Error messages................................................................................................... 21


10/24

Contents



11/24

711-01896-123 2009 Research In Motion Limitedv0.01 11

BlackBerry Client for IBM Lotus QuickrIntroduction

The purpose of this reference guide is to provide BlackBerry TechnicalSupport representatives with information on troubleshooting issuesrelated to BlackBerry Client for IBM Lotus Quickr.

The BlackBerry Client for IBM Lotus Quickr allows BlackBerrysmartphone users to do the following:

Organize files and folders

Email document links to colleagues

Create folders, mark libraries as favorites, and sort libraries,

folders, and files Preview, download and edit documents and files

Log in to the BlackBerry Client for IBM Lotus

Quickr 1. On the Home screen or in the appropriate folder, click theBlackBerry Client for IBM Lotus Quickr icon.

2. Type the user name and password.

3. Click Login .

To log out of the BlackBerry Client for IBM Lotus Quickr, press theMenu key. Click Logout .

These features are only available to users withproper permissions.

Note


12/24



Libraries and foldersLibraries contain the folders and files that can be uploaded and sharedwith colleagues. New libraries can only be created using IBM LotusQuickr on the computer. The following features are available inBlackBerry Client for IBM Lous Quickr:

Library Details - View a library's description, author, creationdate and date the library was last modified.

Recent Libraries - View recently visited libraries

Favorite Libraries - View libraries and folders you previouslymarked as favorites, and navigate directly to items with asingle click

Add as Favorite - Mark a library as a favorite

Sort Libraries - Library contents, folders or files can be sortedby title, creation date, and the date when the library contents,files, or folder were last modified.

Send email message - Send an email message to a libraryowner or folder owner

Working with filesWhen using BlackBerry Client for IBM Lotus Quickr to work with files,BlackBerry smartphone users can do the following:

Preview a file

Edit a file

Download a file

Upload a file

Check in a file

Check out a file

Cancel a file checkout

Replace a file

Email a link to a file

The BlackBerry Client for IBM Lotus Quickrautomatically tracks the 20 most recently visitedlibraries.

Up to 20 libraries, and 20 folders can be stored asfavorites on the BlackBerry smartphone.

Note


13/24


14/24



Component Description

BlackBerry Client for IBM LotusQuickr

The BlackBerry Client for IBM Lotus Quickr is the applicationthat provides access to the team collaboration and contentsharing features of IBM Lotus Quickr from BlackBerry

smartphones. The BlackBerry Client for IBM Lotus Quickrcommunicates with the BlackBerry Social Networking Application Proxy using the BlackBerry MDS ConnectionService which runs on the BlackBerry Enterprise Server.

BlackBerry Social Networking Application Proxy

The BlackBerry Social Networking Application Proxy isdesigned to optimize the data that travels between BlackBerrysmartphones and the IBM Lotus Quickr server. The BlackBerrySocial Networking Application Proxy communicates with theIBM Lotus Quickr server using APIs that are specific to IBMLotus Quickr.

IBM Lotus Quickr server IBM Lotus Quickr is team collaboration and content sharingsoftware for organizations. The software runs on the IBMLotus Quickr server.


15/24



Technical support informationSystem requirements

Item Requirement

Server Intel 2.40 GHz dual-core processor (or greater)

Minimum 2 GB of RAM available

Dedicated server that does not run other applications mighthelp improve performance

Access to the BlackBerry MDS Connection Service from yourorganization's network

The BlackBerry Social Networking Application Proxy and theIBM Lotus Quickr server should be located on the same LAN tohelp improve performance

Operating system Windows Server 2003 (32-bit) with Service Pack 2 All required service packs for the operating system

BlackBerry Enterprise Server BlackBerry Enterprise Server for Microsoft Exchange 4.1.6, 5.0,or 5.01

BlackBerry Enterprise Server for IBM Lotus Domino 4.1.6, 5.0, or5.0.1

BlackBerry MDS ConnectionService

Registered with the BlackBerry Enterprise Server

IBM Lotus Quickr Version 8.1.1 for J2EE

BlackBerry smartphone BlackBerry Curve 8300 Series, and BlackBerry 8800 Seriesrunning BlackBerry Device Software 4.5.0

BlackBerry Bold 9000 smartphone running BlackBerryDevice Software 4.6.0

BlackBerry Curve 8900 smartphone, BlackBerry Curve8350i smartphone, BlackBerry Curve 8520 smartphonerunning BlackBerry Device Software 4.6.1

BlackBerry Storm 9500 smartphone running BlackBerryDevice Software 4.7

BlackBerry Tour 9630 smartphone running BlackBerryDevice Software 4.7.1

Supported BlackBerry smartphones must be provisioned on theBlackBerry Enterprise Server


16/24



Installation and initial setupPre-requisites

Get the service configuration web address for IBM LotusQuickr formatted as http://:

Port 22443 must be available on the Social NetworkingApplication Proxy server

InstallationTo install the BlackBerry Client for IBM Lotus Quickr, complete thefollowing steps:

1. Install the BlackBerry Social Networking Application Proxy.

2. Import IT policies into the BlackBerry Enterprise Server.

3. Allow trusted connections between the BlackBerry SocialNetworking Application Proxy and the BlackBerry MDSConnection Service.

4. Distribute the BlackBerry Client for IBM Lotus Quickr to the

BlackBerry smartphones in a user group.

For information on installing and configuring BlackBerry Client for IBMLotus Quickr, see the BlackBerry Client for IBM Lotus Quickr - User Guideand the BlackBerry SNAP - Installation and Configuration Guide.

Post installationAfter installing the BlackBerry Social Networking Application Proxy,verify that it is running, by completing the following steps:

The server account used to install the BlackBerrySocial Networking Application Proxy must havepermission to create a service.

Note

The BlackBerry Social Networking Application Proxycan run with other applications, but to optimize itsperformance it is recommended that it be installedon a dedicated server that does not run any otherapplications.

Note


17/24



1. In the BlackBerry Browser on a BlackBerry smartphone,type https://:22443/qkr-100/services.

2. In a browser on the computer, type the following webaddresses:

https://{SNAP_server_name}:22443/snapconsole

ConfigurationMost installations should not require any configuration changes but ifnecessary, the following configuration changes can be made:

Change the default password for the BlackBerry SocialNetworking Application Proxy

Change the listening ports on the BlackBerry SocialNetworking Application Proxy

Enable the BlackBerry Social networking Application Proxyfor use with a proxy server to report usage information

Enable the BlackBerry Social networking Application Proxyfor use with a single sign-on solution

View statistics reports for the BlackBerry Social NetworkingApplication Proxy

Change the maximum size of the files that BlackBerrysmartphone users download from the IBM Lotus Quickr

Change the maximum size of the files that BlackBerrysmartphone users upload to the IBM Lotus Quickr

Change the email message that users send to distribute theBlackBerry Client for IBM Lotus Quickr

Change the number of concurrent connections from theBlackBerry Social Networking Application Proxy to the IBMLotus Quickr server

Change the mapping to the IBM Lotus Quickr server

If prompted for a usename and password, the serveris operating correctly. The default username andpassword is

admin

SNAPpsw

Note


18/24



Configure logging for the BlackBerry Social NetworkingApplication Proxy


19/24



TroubleshootingInitial troubleshooting

For information on troubleshooting issues associated with theBlackBerry Client for IBM Lotus Quickr, visit www.blackberry.com/support and search lotus quickr .

When troubleshooting a BlackBerry Client for IBM Lotus Quickr issuethat is not documented in a knowledge base article, make sure to checkthe following:

HTTP, HTTP verbose, and TLS logging are turned on in theBlackBerry MDS Connection Service logging settings

Specific information is gathered, including information thatappears in the requested (or input) field and the returned

result (or displayed) field

The following information can also be retrieved while troubleshooting

issues with the BlackBerry Client for IBM Lotus Quickr: BlackBerry Social Networking Proxy logs

(snap_YYYYMMDD.log and snap_qkr_YYYYMMDD.txt)

IBM Lotus Quickr Server version

BlackBerry Social Networking Application Proxy version

BlackBerry Client for IBM Lotus Quickr version

This information can be captured using theloader.exe tool. For more information on how to useloader.exe to take a screenshot, visitwww.blackberry.com/support to read articleKB18982.

Note


20/24



Troubleshooting the BlackBerry Social Networking Application Proxy

Error message Possible solution

BlackBerry Social Networking Application Proxy is not running

1. Check the status of the BlackBerry Social Networking ApplicationProxy by completing the following steps:

1. Open Windows Services.

2. Right-click BlackBerry SNAP for Quickr -V1.0.0.x. If the BlackBerry Social NetworkingApplication Proxy is not running, the status ofBlackBerry SNAPfor Quickr - V1.0.0.x is Stopped .

3. To restart the BlackBerry Social NetworkingApplication Proxy, right-click BlackBerry SNAPfor Quickr - V1.0.0.x .

4. Click Start .

2. Check the log files to see which errors were logged that mightprevent the BlackBerry Social Networking Application Proxy fromrunning. The log files are located in the subfolder in the defaultfolder C:\Program Files\Research InMotion\BlackBerry\SNAP\snap_tomcat\logs\YYYYMMDD

CXF Service List page is notdisplayed

Check that the proxy rules for the BlackBerry Enterprise Server do notoverride the hosts file configuration for the BlackBerry EnterpriseServer. If necessary, make the required changes to prevent the proxyrules from overriding the hosts file configuration.


21/24



Error messagesError message Description and resolution

File extensions must match The BlackBerry smartphone user has attempted to replace a

document with another version that has a different extension thanthe original. Correct the file extension and retry the request.

Add Folder Failed The BlackBerry smartphone user has tried adding or deleting afolder within a library that has locked folders. If possible, correct thepermissions on the library, and reattempt the request.

Insufficient Permissions An action was attempted that the BlackBerry smartphone user doesnot have permission to use. Instruct the BlackBerry smartphone userto obtain the permissions to execute the action, and reattempt therequest.

File exceeds download size limit The BlackBerry smartphone user has attempted to obtain a file thatis larger than the maximum size configured on the BlackBerry SocialNetworking Application Proxy server. If possible, increase the filesize limit on the BlackBerry Social Networking Application Proxyconsole.

This application has beenblocked by your systemadministrator

The BlackBerry Enterprise Server administrator has set an IT Policyto block access to the application or has not configured a server URLand prohibited the user from manually specifying the server URL onthe client. Specify the server URL within the IT Policy on theBlackBerry Enterprise Server or allow users to manually specify theserver information.

Unable to Download File: An unknown or unexpected HTTP error was returned as a responseto a request for the BlackBerry Client for IBM Lotus Quickr client. This requires a review of the snap.log file to determine the cause ifthe additional information provided does not explain the problem.

Favorite Folders are full The BlackBerry smartphone user has tried to add more than themaximum number of favorite folders (20).

Favorite Libraries are full The BlackBerry smartphone user has tried to add more than themaximum number of favorite libraries (20).

Incorrect login information. Youmay need to modify your serversettings or contact your systemadministrator.

The BlackBerry Social Networking Application Proxy server does notcomplete the login operation successfully.

Note: This is not the same as an incorrect credentials used error.

This requires a review of the snap.log file to determine the cause.


22/24




23/24

Acronym list


Acronym list

A

APIapplication program interface

B

BlackBerry MDSBlackBerry Mobile DataSystem

H

HTTHyptertest Transfer Protocol

I

ITinformation technology

J

J2EE Java 2 Platform, EnterpriseEdition

T

TLSTransport Layer Security


24/24

Acronym list

24 2009 Research In Motion Limited 711 01896 123

Documents

BB Quickr Reference Guide