What BlackBerry devices are compatible with the OILwatch application?
		How do I find out what model of BlackBerry I have?
		How do I ensure I can access OILwatch on my BlackBerry?   Via BES   Via Internet
		Trouble Shooting
		Glossary
		Useful Resourses

The OILwatch application works on most BlackBerry models, with the exception of some of older models.

OILwatch IS compatible with:
7100t, 7100v, 7210, 7230, 7280, 7290, 7510, 7730, 7750, 7780

OILwatch is NOT compatible with:
6710, 6720, 6230, 6280 - 5790

[top]



To find out what model you have, select Settings/Options->About

[top]



There are two modes of receiving online data (including OILwatch) on your Blackberry:

• Via the Blackberry Enterprise Server (BES). Generally set up for corporate accounts.
• Via the Blackberry Internet Solution. Generally set up for individuals.

You can access OILwatch on both solutions - but the settings that you may need to set up on your device will vary.

Blackberry Enterprise Server (BES). Requirements for OILwatch

1. To ensure you can access OILwatch when you are on the BES, you must make sure you have MDS (Mobile Data Service) enabled. Contact your company IT support if in doubt.

The MDS is part of the BES and acts as a proxy between the handheld and external world - the Internet. MDS encrypts and compresses the traffic between the handheld and the server, so it is more secure and faster.

Blackberry Internet Solution. Requirements for OILwatch

• To access OILwatch via the Internet solution requires direct TCP/IP connections.
• You must be using BlackBerry OS version 3.8 or later.
• Go to Settings/Options -> TCP (if you already have TCP APN details entered you do not need to change)
• If you do not have TCP APN username/password details entered you will need to contact your service provider and ask for them - they are generic to that provider and not user specific. Sometimes you can find APN settings on your provider's website.
• Go to Settings/Options -> TLS -> TLS Default (make sure this is set to handheld)

[top]



Problem: I can download the application, but get an error message when I log on to OILwatch: "Your MDS has been configured to deny SSL requests to servers that have certificates which are untrusted or expired."
Fix: Make sure your TLS (Transport Layer Security) protocol is set to 'Handheld'.
Action: Go to Settings/Options ->TLS -> TLS Default = make sure this is set to Handheld

Problem: I get repeated prompts for server trust
Fix: Make sure Prompt for Server Trust in your TLS settings is set to "No".
Action: Go to Settings/Options->TLS-> Prompt for Server Trust = make sure this is set to NO
Action2: Sometimes a popup box prompts you to choose whether you want the system to 'always ask for this prompt'. Choose the appropriate box and 'tick' using the space key.

Problem: When I try to connect to OILwatch on my BlackBerry I receive the following message "Cannot connect to OILspace server. IOException: Could not find a service book entry for IPPP."
Fix: Make sure you have entered your APN details for your TCP settings.
Action: Options -> TCP -> enter APN (Access Point Name) username/password .

Problem: When I try to connect to OILwatch on my BlackBerry I receive the following message "Your MDS has been configured to deny SSL requests to servers that have certificates which are untrusted or expired."
Fix: Make sure your BlackBerry is set to trust Thawte signed certificates.
Action: If on a BES device - you will need to contact your service provider and ensure that their MDS is configured to trust Thawte signed certificates. If on non-BES device Go to Settings/Options -> certificates

Problem: When I try to connect to OILwatch on my BlackBerry I receive the following message "Cannot connect to OILspace server. IOException: Malformed Address. Returning null connection"
Fix: Your device hasn't connected to its GPRS properly.
Action: Your signal could be weak or down. - try connecting again.

[top]



APN (Access Point Name)
Used in GPRS connection settings, and usually defined by the service provider.

BES:
BlackBerry Enterprise Server.

GPRS (General Packet Radio Service)
A wireless communication service that permits fast, continuous access to the Internet from wireless phones, computers, and other devices.

MDS (Mobile Data Service) Feature of BlackBerry Enterprise Server enables always-on / push-based access to enterprise applications and information using the BlackBerry device, browser and software development tools. It provides HTTP/HTTPS connectivity as well as an open, extensible and secure interface for extending corporate applications and the corporate intranet based on existing Web standards.

TCP/IP (Transmission Control Protocol/Internet Protocol)
is the basic communication language or protocol of the Internet

TLS (Transport Layer Security)
is a protocol that ensures privacy between communicating applications and their users on the Internet.

[top]



This thread from the BlackBerry user forum discusses TCP/IP Configuration for your BlackBerry and outlines how to configure full internet access:
http://www.blackberryforums.com/showthread.php?t=2185

This thread from the BlackBerry user forum discusses the setting that you require for many service providers:
http://www.blackberryforums.com/archive/index.php/t-1156.html

This article outlines how BlackBerry supports https connections:
Click Here

[top]