Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Installing the SDK

When you run the setup application, you can choose from the following options:

  • Option 1: Install the SDK distributions for the high-level and low-level APIs.
  • Option 2: Install the SDK distributions for the high-level and low-level APIs, and an Apache Tomcat server with the sample Push Initiators deployed on the server.

Installation option 1

If you choose the SDK distributions for the high-level and low-level APIs, the setup application creates two folders:pushsdk-high-level for the high-level distribution and pushsdk-low-level for the low-level distribution.

Installation option 2

If you choose the SDK distributions for the high-level and low-level APIs along with an Apache Tomcat server with the sample Push Initiators deployed on the server, the setup application performs the following actions:

  • Creates two folders:pushsdk-high-level for the high-level distribution and pushsdk-low-level for the low-level distribution.
  • Installs an Apache Tomcat server where you can choose to deploy the low-level sample Push Initiator, the high-level sample Push Initiator, or both.
  • Prompts you to specify which PPG the sample Push Initiators should use: the BlackBerry Internet Service, the BlackBerry Enterprise Server, the BlackBerry Device Service, or a combination. You'll need to provide the URL for the PPGs that you select.
  • Prompts you for the path for the log files for the sample Push Initiators.

Installing a database

If you choose to deploy either the high-level sample Push Initiator or both sample Push Initiators, you should install a database that will be used by the high-level sample Push Initiator. You can, however, choose to store SDK data in system memory and in files managed by the Ehcache cache.

If you choose to use a database, you need to install the database before you run the setup application for the SDK because the setup application prompts you for information about the database. For more information, see Installing a database management system.

If you have an earlier version of the SDK installed with a database, the setup application updates the database for version 1.2.

Push Service SDK requirements

Item

Requirement

Hardware

  • 64 MB of free RAM

Operating system

Any version of the following operating systems, as long as the operating system supports Java 6 or later:

  • Windows 7, Windows XP, and Windows Server 2003 (32-bit and 64-bit x86, Intel Itanium 2, and AMD-64)
  • Windows Server 2008 (32-bit and 64-bit)
  • Windows Vista (32-bit and 64-bit x86)
  • Windows 2000 and Windows NT (32-bit x86)
  • Red Hat Enterprise Linux 4 and 5 (x86, Intel Itanium 2, and AMD-64)
  • SUSE Linux 9, 10, and 11 (x86 and PowerPC)
  • Linux on zSeries
  • Other Linux operating systems (POSIX-compliant shell required)
  • Mac OS X 10.4 and 10.5 with Java 1.6 (Intel and PowerPC)

Beta and early access releases of these operating systems are not supported.

Install and configure the JDK

Before you install the Push Service SDK, you need to install JDK 6 or later for your operating system.

  1. Download the setup application for JDK 6 or later for your operating system.
  2. Run the JDK setup application and complete the instructions on the screen.
  3. Set the JAVA_HOME environment variable to the installation folder of the JDK.

Install the SDK

  1. Download one of the following setup applications for your operating system:
  2. Start the setup application for your operating system.
  3. Follow the instructions in the setup application to install the SDK.