We're working with a customer on deploying a custom app to some users' Blackberry devices and everything so far has gone well. One user called to say that they haven't seen the icon on their device yet. Going through the BES policy logs (thankfully, one of the smaller logs), I found that the user was causing the following error to be written to the log:
[20000] (09/15 13:47:13.750):{0xB70} {username@domain.com, PIN=XXXXXXXX, UserId=419}PollForMissingApps: GetHHCodePackages reported: HHCM_DEVICE_NOT_SUPPORTED. Upgrade your copy of device.xml
Device.xml is the "master" list of Blackberry devices. It includes model numbers, networks, and other information. It is something that is copied into software packages by the apploader. If the device isn't listed in the device.xml file, the software doesn't get deployed. Checking the BES, the user had a model 8830m and our device.xml on the server didn't know what that was. So there you go... any devices put out since this client's BES software was installed - and it's not that old, would be excluded from installing software.
To resolve the issue, you need an updated device.xml. Where does one obtain a new version if they aren't ready to install BES 5.0? Why, update your Blackberry Desktop Software, of course. There's a RIM technote that tells the reader to just install the desktop software on the server, but why install Desktop software on a Server, especially when all you need is one file? How about this - update the Desktop software on your Desktop and copy the file you need to the server? The device.xml file is kept in c:\Program Files\Common Files\Research in Motion\AppLoader. You need to replace it in the similar location on the BES server.
Next, on the BES server, go to the :\Program Files\Common Files\Research in Motion\shared\applications folder and in each application you've deployed, delete the PkgDbCache.xml and the specification.pkg file. Also, go to the :\Program Files\Research in Motion\Blackberry Enterprise Server\PackageCace folder and delete all the subfolders in it.
Now you can open up a command prompt and go to :\Program Files\Common Files\Research in Motion\AppLoader and enter the command "loader /reindex" to rebuild all the packages and include the updated device.xml.
If you need to resend the software to the users, you can go into the Blackberry Manager, right-click on the user's name and choose the "Deploy Applications" action to force the policy to be checked. Once this was done, the user's device picked up the software deployment policy and downloaded the application.
So, if your users get new devices quicker than you update the BES software, you'll want to check the device.xml file and update it before you deploy a custom app to them via the BES.
And one other item - what's with the using "you" and "your" for errors that reference the server. Why not make the error "Upgrade the copy of device.xml on the server" - that's much plainer and easily understood. By no means is this the only instance I've seen that type of error, but just thought I'd throw that out there.
Posted by: Ted Hardenburgh at Home
Tags :Blackberry