Request a new desktop app

To request a new desktop app, contact BlackBerry AtHoc customer support and be prepared to provide the information in the following tables.

Windows

Element

Description

Contact Information

Full name and email address. You will receive an email when the new desktop app is available.

Client Name

The name of the organization. The Windows installer displays the client name in the list when running the installer manually. The client name is not an installation parameter.

Version

Desktop app version. Always choose the latest version unless there is a reason to choose an older one.

Edition

Select one of the following:

  • 1_BlackBerry AtHoc
  • 2_BlackBerry AtHocAlt
  • 3_BlackBerry AtHocAux

Base URL

The URL that the desktop app should connect to.

Format: http://<server_name_or_ip>/config/baseurl.asp.

Provider ID

The identifier of the organization that the desktop app should connect to.

Format: Integer. For example, 1234567.

Audio

Audio files are downloaded with an alert but can be packaged with the Windows installer. This increases the size of the installer substantially. Select from the following options: Default, All, or None.

silent_installation

Optional. Select this option to hide the the MSI user interface from the user. If this option is selected, there is no UI.

run_after_install

Optional. Select this option to configure the desktop app to start when the installer completes the installation. This element cannot be used to prevent the desktop app from starting when the machine starts. The desktop app is always added to the list of applications that start when the machine starts.

mandate_ssl

Optional. Select this option to require that the URLs used for Sign On, Check Update, and Get Update use the HTTPS protocol.

validate_cert

Optional. Select this option to require that the client certificate cannot be expired, revoked, or otherwise invalid.

uninstall_option

Optional. Select this option to allow users to remove the desktop app using the Control Panel.

MSI Installer Customizations: schedule_reboot

Optional. Select this option to configure the installer to reboot Windows automatically after a manual installation.

MSI Installer Customizations: manual_selection

Optional. Select this option to allow the user to overwrite the request form configuration and specify the new base URL and organization ID.

vps_list_header

Optional. Enter text that appears above the organization list on the organization dialog that appears during manual installation. The default is no text.

connection_instructions

Optional. Enter text that appears above the organization list on the organization dialog that appears during manual installation. The default is "Please select your system from the list below."

For more information about these options, see Installation settings (Windows) and Run.bat.

Mac

ElementDescription

Contact Information

Full name and email address. You will receive an email when the new desktop app is available.

Client Name

The name of the organization.

Release

Desktop app version. Always choose the latest version unless there is a reason to choose an older one.

Edition

Select BlackBerry AtHoc.

Base URL

The URL that the desktop app should connect to.

Format: http://<server_name_or_ip>/config/baseurl.asp.

Provider ID

The identifier of the organization that the desktop app should connect to.

Format: Integer. For example, 1234567.

mandate_ssl

Optional. Select this option to require that the URLs used for Sign On, Check Update, and Get Update use the HTTPS protocol.

validate_cert

Optional. Select this option to require that the client certificate cannot be expired, revoked, or otherwise invalid.

Replace Previous Setting

Optional. Select this option to use the new settings when the Mac desktop app is installed before uninstalling an existing instance. Leave this option unselected to use the current settings. The current settings are specified in the Configuration.plist file.

Manual Registration

Optional. Select this option to present the end user with a registration screen. The end user must enter their email address and then reply to a verification email before the desktop app for Mac connects. If this option is not selected, the desktop app for Mac connects automatically after installation.

Manual Registration URL

URL of the server used during manual registration process.

Format: http://<server_name_or_ip>.