BB Quickr Reference Guide
BB Quickr Reference Guide
2009 Research In Motion Limited. All rights reserved. BlackBerry, RIM, Research In Motion, SurePress, SureType and related trademarks, names and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries around the world. IBM, Domino, Lotus, and Quickr are trademarks of International Business Machines Corporation. Java and J2EE are trademarks of Sun Microsystems, Inc. Microsoft, Exchange, Windows Server are trademarks of Microsoft Corporation. All other trademarks are the property of their respective owners. The BlackBerry smartphone and other devices and/or associated software are protected by copyright, international treaties, and various patents, 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 of RIM (as hereinafter defined) patents. This documentation including all documentation incorporated by reference herein such as those provided or made available by hyperlink is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition, endorsement, guarantee, representation or warranty of 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 this documentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation may describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information that is contained in this documentation; however, RIM makes no commitment to provide any such changes, updates, enhancements, or other additions to this documentation to you in a timely manner or at all. This documentation might contain references to third-party sources of information, hardware or software, products or services including components and content such as content protected by copyright and/or third-party web sites (collectively the "Third Party Products and Services" ). RIM does not control, and is not responsible for, any Third Party Products and Services including, without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services in this documentation does not imply endorsement by RIM of the Third Party Products and Services or the third party in any way.
711-01896-123 v0.01
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NONINFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NONPERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY 71101896-123 PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY LOSSES ,WHETHER OR NOT SUCH
711-01896-123 v0.01
DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY. THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR 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 AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES AND INDEPENDENT CONTRACTORS. IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE, AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY ARISING FROM OR RELATED TO THE DOCUMENTATION. Prior to subscribing for, installing or using any Third Party Products and Services it is your responsibility to ensure that your airtime service provider has agreed to support all of their features. Some airtime service providers may not offer Internet browsing functionality with a subscription to BlackBerry Internet Service. Check with your service provider for availability, roaming arrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products and services may require one or more patent, trademark, copyright or other licenses in order to avoid infringement or violation of third party rights. You are solely responsible for determining whether to use, Third Party Products and Services and if any third party licenses are required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products and Services until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM's products and services are provided as a convenience to you and are provided "AS IS" with no express or implied conditions, endorsements, guarantees, representations or warranties of any kind by RIM and RIM assumes no liability whatsoever, in relation thereto. Your use of Third
711-01896-123 v0.01
Party Products and Services shall be governed by and subject to you agreeing to the terms of separate licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or other agreement with RIM. Certain features outlined in this documentation require a minimum version of BlackBerry Enterprise Server software, BlackBerry Desktop Software, and/or BlackBerry Device Software and may require additional development or Third Party Products and Services for access to corporate applications. This product includes software developed by the Apache Software Foundation (http://www.apache.org/) and/or licensed pursuant to Apache License, Version 2.0 (http://www.apache.org/licenses/). For more information, see the NOTICE.txt file included with the software. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.
711-01896-123 v0.01
711-01896-123 v0.01
711-01896-123 v0.01
Contents
Contents
BlackBerry Client for IBM Lotus Quickr......................... 11
Introduction......................................................................................................... 11 Log in to the BlackBerry Client for IBM Lotus Quickr................................... 11 Libraries and folders ......................................................................................... 12 Working with files.............................................................................................. 12 Roles and permissions ...................................................................................... 13 BlackBerry Social Networking Application Proxy for IBM Lotus Quickr... 13 Architecture: BlackBerry Social Networking Application Proxy and the BlackBerry Client for IBM Quickr.................................................................... 13 Technical support information ........................................................................ 15
Troubleshooting....................................................................................... 19
Initial troubleshooting ...................................................................................... 19 Troubleshooting the BlackBerry Social Networking Application Proxy... 20 Error messages................................................................................................... 21
711-01896-123 v0.01
Contents
10
711-01896-123 v0.01
Note
To log out of the BlackBerry Client for IBM Lotus Quickr, press the Menu key. Click Logout.
711-01896-123 v0.01
Note
Favorite Libraries - View libraries and folders you previously marked as favorites, and navigate directly to items with a single click Add as Favorite - Mark a library as a favorite Sort Libraries - Library contents, folders or files can be sorted by 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 library owner or folder owner
12
711-01896-123 v0.01
Architecture: BlackBerry Social Networking Application Proxy and the BlackBerry Client for IBM Quickr
The BlackBerry Social Networking Application Proxy is part of a client and server solution that provides access to IBM Lotus Quickr on BlackBerry smartphones.
711-01896-123 v0.01
13
Component
BlackBerry Client for IBM Lotus Quickr
Description
The BlackBerry Client for IBM Lotus Quickr is the application that provides access to the team collaboration and content sharing features of IBM Lotus Quickr from BlackBerry smartphones. The BlackBerry Client for IBM Lotus Quickr communicates with the BlackBerry Social Networking Application Proxy using the BlackBerry MDS Connection Service which runs on the BlackBerry Enterprise Server. The BlackBerry Social Networking Application Proxy is designed to optimize the data that travels between BlackBerry smartphones and the IBM Lotus Quickr server. The BlackBerry Social Networking Application Proxy communicates with the IBM Lotus Quickr server using APIs that are specific to IBM Lotus Quickr. IBM Lotus Quickr is team collaboration and content sharing software for organizations. The software runs on the IBM Lotus Quickr server.
14
711-01896-123 v0.01
Requirement
Intel 2.40 GHz dual-core processor (or greater) Minimum 2 GB of RAM available Dedicated server that does not run other applications might help improve performance Access to the BlackBerry MDS Connection Service from your organization's network The BlackBerry Social Networking Application Proxy and the IBM Lotus Quickr server should be located on the same LAN to help improve performance Windows Server 2003 (32-bit) with Service Pack 2 All required service packs for the operating system 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, or 5.0.1
Operating system
Registered with the BlackBerry Enterprise Server Version 8.1.1 for J2EE BlackBerry Curve 8300 Series, and BlackBerry 8800 Series running BlackBerry Device Software 4.5.0 BlackBerry Bold 9000 smartphone running BlackBerry Device Software 4.6.0 BlackBerry Curve 8900 smartphone, BlackBerry Curve 8350i smartphone, BlackBerry Curve 8520 smartphone running BlackBerry Device Software 4.6.1 BlackBerry Storm 9500 smartphone running BlackBerry Device Software 4.7 BlackBerry Tour 9630 smartphone running BlackBerry Device Software 4.7.1 Supported BlackBerry smartphones must be provisioned on the BlackBerry Enterprise Server
711-01896-123 v0.01
15
Note
Installation
To install the BlackBerry Client for IBM Lotus Quickr, complete the following steps: 1. 2. 3. Install the BlackBerry Social Networking Application Proxy. Import IT policies into the BlackBerry Enterprise Server. Allow trusted connections between the BlackBerry Social Networking Application Proxy and the BlackBerry MDS Connection Service. Distribute the BlackBerry Client for IBM Lotus Quickr to the BlackBerry smartphones in a user group. The BlackBerry Social Networking Application Proxy can run with other applications, but to optimize its performance it is recommended that it be installed on a dedicated server that does not run any other applications.
4.
Note
For information on installing and configuring BlackBerry Client for IBM Lotus Quickr, see the BlackBerry Client for IBM Lotus Quickr - User Guide and the BlackBerry SNAP - Installation and Configuration Guide.
Post installation
After installing the BlackBerry Social Networking Application Proxy, verify that it is running, by completing the following steps:
16
711-01896-123 v0.01
1.
In the BlackBerry Browser on a BlackBerry smartphone, type https://<SNAP_server_name>:22443/qkr-100/ services. In a browser on the computer, type the following web addresses: https://{SNAP_server_name}:22443/snapconsole If prompted for a usename and password, the server is operating correctly. The default username and password is admin SNAPpsw
2.
Note
Configuration
Most installations should not require any configuration changes but if necessary, the following configuration changes can be made: Change the default password for the BlackBerry Social Networking Application Proxy Change the listening ports on the BlackBerry Social Networking Application Proxy Enable the BlackBerry Social networking Application Proxy for use with a proxy server to report usage information Enable the BlackBerry Social networking Application Proxy for use with a single sign-on solution View statistics reports for the BlackBerry Social Networking Application Proxy Change the maximum size of the files that BlackBerry smartphone users download from the IBM Lotus Quickr Change the maximum size of the files that BlackBerry smartphone users upload to the IBM Lotus Quickr Change the email message that users send to distribute the BlackBerry Client for IBM Lotus Quickr Change the number of concurrent connections from the BlackBerry Social Networking Application Proxy to the IBM Lotus Quickr server Change the mapping to the IBM Lotus Quickr server
711-01896-123 v0.01
17
18
711-01896-123 v0.01
Troubleshooting
Initial troubleshooting
For information on troubleshooting issues associated with the BlackBerry Client for IBM Lotus Quickr, visit www.blackberry.com/ support and search lotus quickr. When troubleshooting a BlackBerry Client for IBM Lotus Quickr issue that is not documented in a knowledge base article, make sure to check the following: HTTP, HTTP verbose, and TLS logging are turned on in the BlackBerry MDS Connection Service logging settings Specific information is gathered, including information that appears in the requested (or input) field and the returned result (or displayed) field This information can be captured using the loader.exe tool. For more information on how to use loader.exe to take a screenshot, visit www.blackberry.com/support to read article KB18982.
Note
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
711-01896-123 v0.01
19
Possible solution
1. Check the status of the BlackBerry Social Networking Application Proxy by completing the following steps: 1. 2. Open Windows Services. Right-click BlackBerry SNAP for Quickr V1.0.0.x. If the BlackBerry Social Networking Application Proxy is not running, the status of BlackBerry SNAPfor Quickr - V1.0.0.x is Stopped. To restart the BlackBerry Social Networking Application Proxy, right-click BlackBerry SNAP for Quickr - V1.0.0.x. Click Start.
3.
4. 2.
Check the log files to see which errors were logged that might prevent the BlackBerry Social Networking Application Proxy from running. The log files are located in the subfolder in the default folder C:\Program Files\Research In Motion\BlackBerry\SNAP\snap_tomcat\logs\YYYYMMDD
Check that the proxy rules for the BlackBerry Enterprise Server do not override the hosts file configuration for the BlackBerry Enterprise Server. If necessary, make the required changes to prevent the proxy rules from overriding the hosts file configuration.
20
711-01896-123 v0.01
Error messages
Error message
File extensions must match
Insufficient Permissions
Favorite Folders are full Favorite Libraries are full Incorrect login information. You may need to modify your server settings or contact your system administrator.
711-01896-123 v0.01
21
22
711-01896-123 v0.01
Acronym list
Acronym list
A
API application program interface
B
BlackBerry MDS BlackBerry Mobile Data System
H
HTT Hyptertest Transfer Protocol
I
IT information technology
J
J2EE Java 2 Platform, Enterprise Edition
T
TLS Transport Layer Security
711-01896-123 v0.01
23
Acronym list
24
711-01896-123 v0.01