Application Installation Instructions
for Java^® powered BlackBerry^® handhelds
October  2010

3. Installation instructions
 

BlackBerry software in general can be installed in several different ways.

Probably the most common, but not necessarily the easiest way is through RIM's Desktop Manager software. Unfortunately, that's only currently available for Microsoft Windows users.
Not only that, but it often presents additional problems, especially when one upgrades to a new phone.

One slightly less popular but in many ways easier approach is downloading directly over the air to the BlackBerry.
The benefits are that this is totally independent from any desktop software, which means it is universal, regardless of whether your desktop/laptop uses Windows, OS X or Linux. The other benefit is that it is available anywhere where there is a connection.
The major drawback is that some carriers - as of time of writing this manual two examples are Cingular/AT&T in US and Orange in France - prevent downloading large files, often reporting fake errors like invalid COD files etc.

On top of that, since the introduction of BEIKS Phrase Book Reader 5.0 and the support of installing the phrase book components on a media card, one can and may often be forced to cook their own installation.
An example would be a Mac OS X user who wants to take advantage of the new media card support, but is left without default options since there is no automated installer for Mac OS X that can target the media card.

The over-the-air installation is also more complicated when one wants to download files to the media card.

3.1 Installing though Microsoft Windows host

Below is an illustrated step-by-step instruction for installing a BEIKS application on a BlackBerry handheld through a Microsoft Windows powered computer.

It picks up from the moment when the automated InstallExpert installer had copied the necessary application files to the host computer and had registered them with the BlackBerry Desktop Manager. They are now ready to be transferred to the device.
Note the same files could have been manually extracted from the ZIP distributive of the program as well, as explained in the chapter for the Mac OS X users.

Step 1: Launching the BlackBerry Desktop Manager

Launch the BlackBerry Desktop Manager from its icon on the Desktop of your computer or from the Applications group in the Windows launcher (the "Start" button).
When started, the Desktop Manager will look like this:

Make sure the device is connected to the computer and turned on; when it is, the Desktop Manager will indicate "Connected" in the middle section of its bottom row as shown above.

When connected and ready, double-click the Application Loader icon.

Step 2: The Application Loader

Just move on by clicking the Start button.

After a short period of communication activity indicated by a progress bar, you should see a form like this:

At the top of the applications list you will see an entry for the currently installed System Software on your BlackBerry.
It is important that the version 4.2 or higher of the System Software is installed on your BlackBerry in order to use BEIKS Phrase Book Reader 6.1!
For additional information, see the Troubleshooting section of this manual.

Step 3: Locate the newly installed applications

Using the scroll bar at the right of the applications list control, locate the newly installed applications on your device; they may show at the top or at the bottom or generally anywhere in the list.

Note: the above screenshot contains a total of five BEIKS phrase books: English-Arabic Phrase Book, English-French Phrase Book, English-German Phrase Book, English-Italian Phrase Book and English-Spanish Phrase Book. If you have installed different phrase book language, you will be looking for its title instead.

When you first see the applications, the checkboxes on their left will not be marked; mark them to indicate you want the application and/or its modules to be installed on the device. For generic applications like phrase books, dictionaries and/or e-books, make sure to mark the one row that indicates the application itself. There is no point in installing e-books if you do not install the application to view them, in the same way that there is no sense in buying DVDs unless you have a DVD player.

When ready, click the Next button to proceed.

Notes:
1) If you can not find the applications in the list, this is most likely due to outdated system software version; the only resolution to this problem is to update the system software with a newer version from your carrier.
For more details refer to the Troubleshooting section.

2) Phrase books installed on media cards will NOT show in Application Loader above. This is because Desktop Manager does not concern itself with media files other than applications, music and video files. Instead, the phrase book files can be seen as files with File Explorer at the drive volume mapped to the media card.

 

Step 4: Complete the install process

Clicking on the "Next" button in the previous form will bring you to a new one, summarizing the changes to be made in the device's configuration.
Click the "Finish" button and wait until the progress bar is complete.

Note it may take the device a little longer to finish.

3.2 Installing though Mac OS X host
In the absence of an official RIM Desktop Manager application for Apple, OS X users have the options of using third-party substitutes or direct over-the-air application downloads.

The BlackBerry MissingSync by Mark-Space (www.markspace.com) provides OS X users with the ability to install BlackBerry applications from host to device in the manner Desktop Manager does on the Windows platform.

In addition to the default guided installation distributives, BEIKS provides alternative distributives, containing only the files required by Desktop Manager in order to implement host-to-device installation. Therefore, those can be used on Windows, OS X and actually any other type of platform that duplicates the functionality of the official Desktop Manager available for Windows.

Note: if you use MissingSync for BlackBerry or likely any other alternative and want to take advantage of the media card of your BlackBerry you will have to manually copy the files to the card. See the Media Card installation notes section below.

3.3 Installing over-the-air

BlackBerries can install applications from Internet directly to the device.

This is often easier and even faster than going through desktop.

In addition to serving as a workaround solution to situations where there is no desktop manager for a particular platform, this is particularly convenient due to its unlimited location availability. A new phrase book, e-book, dictionary, game or anything else can be downloaded right on the spot, at the airport or in the meeting room, as long as there is a coverage.

Note: over-the-air installations, just like local wired installations, are subject to company enforced security policy. A BES controlled device may have been disabled from installing any applications by its administrator.

For direct over-the-air download refer to your favorite application vendor or http://mobile.beiks.com.

If you want to take advantage of the ability to install the large phrase books on the BlackBerry's media card you will also want to check the next section, Media Card installation notes.

Installation is relatively seamless when downloading directly to the device, however downloading files to the media card is slightly more complex and requires additional attention.
This is because RIM limits the options on where one can put files being downloaded to the card.

3.4 Media Card installation notes

BEIKS' executable distributive for installing through Microsoft Windows host (see Installing though Microsoft Windows host) will guide Windows users through successful card installation.

This section is Mac OS users, wireless users or Windows users who for one reason or another can not take advantage of the guided installation.

First you need to know that the files that are being installed in the main memory are different from the files that are installed on the media card.

- If you install through a desktop, you will need the ZIP packaged distributive, which you can then extract and get to the folder called "SDCard" (located within the phrase book's folder, e.g. "English-Spanish Talking Phrase Book\SDCard\" or "English-German Talking Phrase Book\SDCard\").
- If you install directly over the air, you should look for download links especially indicated to be for media card.

Only the phrase book files can be installed on media cards; BEIKS Phrase Book Reader itself is an application and can only be installed in the BlackBerry's main memory.

Each phrase book is made of two files, for example "En2Ger.bpb" (lexicon database) and "V_Ger.bpb" (voices database).

Note the BPB extensions; those files can not be installed via Desktop Manager.

Phrase Books's media card files need to be stored in a particular folder on the media card. It is:

/BlackBerry/BEIKS/PhraseBooks/

The files can be stored anywhere inside or under that directory (folder), e.g. all BPB files can be placed in that directory or any in sub-directory like "/BlackBerry/BEIKS/PhraseBooks/English-German Talking Phrase Book/".

4. Removal instructions

There are several ways to uninstall a BlackBerry application, but the most common one is by using the Desktop Manager to uncheck the application's modules from the list of installed handheld titles. The process is pretty much the opposite of the above described installation process.

When "uninstalled" by such means the application is indeed removed from the handheld, however a copy of its files still remains on the host PC and available to Desktop Manager. Generally, this is rather convenient, as a person could decide to install it back at any given moment. All that's needed is to run Desktop Manager again, enter the Application Loader, check the box on the left of the application name (or names) and continue.

A true, complete uninstallation, however, requires that the desktop files are removed and their availability (or rather unavailability) made known to Desktop Manager.

This is done from the Windows' Control Panel, the Add/Remove section. This is the same place where all other desktop software can be removed.
On Windows machines, you can get there by clicking the START button, then locating "Control Panel" in the pop-up menu and clicking in.

Once the Control Panel window opens, locate the icon "Add/Remove Applications" and double-click it.

Locate the application you want to remove, click to highlight it and click the "Remove" button on the right side of its title. That should do it!

Unless you have a good reason to leave BlackBerry software installed on the desktop when not installed on the handheld, we recommend that you follow the above instructions and remove it from the desktop as well.

Once again, a complete application removal will involve these steps:

1) Launching Desktop Manager and deleting the application from the list through the "Delete" button, then continuing until the Desktop Manager confirms the application was successfully removed.

2) Going to the "Add/Remove Programs" in the Windows Control Panel and launching the host application's installation wizard to remove it from Windows.

5. Troubleshooting

Important: BEIKS Phrase Book Reader 6.1 requires that both the BlackBerry system software AND the Desktop Manager are updated to versions 4.2 and higher.
If you have a device that, for some reason, could not be upgraded to system version 4.2, you are limited to using previous BEIKS Phrase Book Reader version, which you can request by sending an email to support@beiks.com.

Problem 1

Symptom: After the installation, the newly installed phrase books do not appear in the list of installed applications on the "Application Loader Wizard" screen as shown above, and/or get an error message "No additional applications designed for your handheld were found" when trying to add them manually.
          
Explanation: This message usually means missing software called "BlackBerry handheld system software" by some carriers and "BlackBerry device software" by others. It is an addition to the BlackBerry desktop manager and is provided in addition to the BlackBerry desktop manager by the carrier. This software is specific for each BlackBerry model and carrier. The installed Device System Software can be found in Application Loader under Help > About Desktop Manager > Device Software.

Resolution: The solution to this problem is to download and install the missing software on the desktop PC. A list of all carriers with links to their BlackBerry support pages is available at http://www.beiks.com/rim/BlackBerrySystemHandheldSoftware.asp.

Problem 2

Symptom: After installing your application I got "Unspecified error encountered [J:0x0000000A]".

Explanation: The message is saying (in not exactly a user friendly manner) that the application you are trying to install requires a more recent version of the BlackBerry system software.

Resolution: You can either upgrade the BlackBerry system software OR install a different (usually older, if at all available) version of the application you are trying to install.
Overall, upgrading the system software of your BlackBerry is always a good idea - it is free and RIM are releasing infrequent, but so far quite reliable and free upgrades of the kernel operating system of the device.
Even if you think you have the latest and greatest software installed it is worth checking out again. Many time you will find you were wrong and this particular error message suggests exactly that.

Note there are TWO components of a BlackBerry system software: the desktop manager the actual system software, which is a piece of code that goes directly into the BlackBerry, much as all other applications, but serves a much higher need and purpose - it hosts and manages all of them.

For the latest device system software, refer to your network administrator or directly to your carrier.
For the latest desktop manager software, refer to the BlackBerry site; the site also includes many system software upgrades, but overall the best source of a system software upgrade remains the carrier which sells the phone.
 

Problem 3

Symptom: "I installed your application, but can not find it"
                    or
                    "Your program is not in Desktop Manager"

Explanation:  Could it be you have installed a phrase book module, but have missed to check the actual application in Desktop Manager?
 

Resolution: Run Desktop Manager, open the Application Loader and make sure all relevant titles in the list are checked. Note the list can scroll up and down with the arrows on its right.

Problem 4

Symptom: The Desktop Manager refuses to install the application to the device (usually claiming its modules are not signed).

Explanation: In corporate environment the handheld is under the BES user rights policy management; network administrators often prohibit installation of 3rd party software on the devices, which can manifest itself in a few different and not always clear messages in the Desktop Manager; those may include claims that the application does not have the required security signatures - this is incorrect! Our applications are signed with the required security signatures by RIM. If your desktop displays similar message, call your system administrator and ask them to allow applications to be installed on the handheld.
Note that this limit is set to the device, not to the host computer; in other words, if the device is under BES management, it does not matter if you will sync it at work or at home - the effect will be the same.
Further, if the device had been under BES management and then broke out of it, it is still possible that the previous setting might be in effect.

Resolution:  The resolution to this problem is to make sure third-party applications can be installed on the device. To verify this, you may want to download some other applications and test.

6. Contacting BEIKS

First and foremost, you need to be registered with BEIKS in order to receive technical support.

• If you are an individual and have placed your order directly with BEIKS or through a first-tier online distributor, your order will likely be automatically registered with our database. When this happens - usually within 24 hours after the order is placed - you should receive a notification from BEIKS with your order/registration details.
  You can then go to www.beiks.com/mystuff to manage your account with us, download updates etc.
• If you have purchased a BEIKS product as a CD from retail store, you need to register it with BEIKS before you become legible for technical support and updates. Each such CD comes with unique registration key, which can be used once at the BEIKS website to register the product.
  Refer to the CD installation documentation for details.
• If you are using a BEIKS product as part of an enterprise license, please ask your administrator for the direct support channels with BEIKS.

When contacting us, please remember to include your registration status with us, description of your configuration (device mode, OS version etc), what exactly the problem is and when exactly does it happen.

Mail:    BEIKS LLC
          618 Spring Hill Dr.
          Coppell, TX 75019

Email:    support@beiks.com (preferred, 24/7)

Phone: +1 214 774 2806 (from 9 AM to 5 PM Central Time)

Fax:    +1 720 294 9429 (24/7)

Web:    http://www.beiks.com/forums.htm