Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. Desktop App 6.2.x.280 (Windows), 1.9 (Mac)
  4. Desktop App Installation and Administration Guide
  5. Desktop app settings
  6. Installation settings
  7. Run.bat

Run.bat

The 
Run.bat
 file is used to start the installer.
The following is a sample 
Run.bat
 file:
msiexec /qn /i 
AtHoc
CorpDSW6.2.3.270.msi /l*vx 
AtHoc
CorpDSW6.2.3.270.log BASEURL=http://172.16.6.38/config/baseurl.asp PID=2050329 RUNAFTERINSTALL=Y DESKBAR=N TOOLBAR=N SILENT=N VALIDATECERT=N MANDATESSL=N UNINSTALLOPTION=Y
See the 
msiexec
 help for more information about the following part of the 
Run.bat
 command line:
msiexec /qn /i 
AtHoc
CorpDSW6.2.3.270.msi /l*vx 
AtHoc
CorpDSW6.2.3.270.log
The 
/qn
 switch specifies quiet mode with no UI. This switch overrides the SILENT property. If you rely on the SILENT property passed in the command line and do not include the 
/qn
 switch, the installation dialog appears briefly while the Windows Installer processes the command line.
The 
/i
 switch indicates “Install.”
AtHoc
CorpDSW6.2.3.270.msi
 is the name of the installer associated with the switch.
The 
/l*vx
 switch specifies a verbose log.
AtHoc
CorpDSW6.2.3.270.log
 is the name of the file where logging output is written.
The following table describes the other elements in the 
run.bat
 file.
Run.bat file elements
Element
Description
BASEURL
The URL that the desktop app should connect to.
Required:
 Yes
Format:
 
http://<server_name_or_ip>/config/baseurl.asp
Written to:
 
HKLM/SOFTWARE/Wow6432Node/
AtHoc
[edition]/BASEURL
PID
Provider ID. The organization that the desktop app should connect to.
Required:
 Yes
Format:
 Integer, for example 1234567. 
Written to:
 
HKLM/SOFTWARE/Wow6432Node/
AtHoc
[edition]/PROVIDER ID
 
RUNAFTERINSTALL
Specifies if the desktop app should 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.
Required:
 No
Values:
 Y = Start after installation. N= Do not start after installation.
Default:
 N
Written to:
 
HKLM/SOFTWARE/Wow6432Node/
AtHoc
[edition]/RunAfterInstall
There is no HKCU copy.
Added to:
 
HKLM/SOFTWARE/Wow6432Node/Microsoft/Windows/CurrentVersion/Run
DESKBAR
Specifies if the Deskbar (
AtHoc
[editionName]Desk.exe
) should run. The deskbar is a toolbar that appears on the Windows desktop.
The feature in the 
BlackBerry AtHoc
 management system that creates deskbar menu options has been removed, so the deskbar no longer has any use. The deskbar was removed from the installer in release 6.2.x.27x.
Required:
 No
Values:
 Y or N
Default:
 N
TOOLBAR
Specifies whether or not the Toolbar (
AtHoc
[editionName]TBr.dll
) should run. This is the toolbar that appears in Internet Explorer.
The feature in the 
BlackBerry AtHoc
 management system that creates Toolbar menu options has been removed, so the Toolbar no longer has any use. The toolbar was removed from the installer in release 6.2.x.27x.
Required:
 No
Values:
Y = Enabled. The user is prompted to allow or disable the toolbar when IE starts. The toolbar appears in the Manage add-ons dialog.
N = Disabled.
Default:
 Y
SILENT
Specifies if the MSI user interface (UI) should be displayed to the user.
If the SILENT value is set to Y, there is no UI. If SILENT is set to N, the BASEURL and PID parameters in the 
run.bat
 file are ignored.
 
Required:
 No 
Values:
 Y = Do not show the UI. N = Show the UI.
Default:
 N
MANDATESSL
Specifies if the URLs used for Sign On, Check Update, and Get Update must use the HTTPS protocol.
Required:
 No
Values:
Y = URLs must use HTTPS. If they do not use HTTPS, the operation ends and logs the message "SSL required".
N = URLs can use either HTTP or HTTPS.
Default:
 N
Written to:
 
HKLM/SOFTWARE/Wow6432Node/
AtHoc
[edition]/MandateSSL
There is no HKCU copy.
VALIDATECERT
Specifies that the client certificate must not be expired, revoked, or otherwise invalid. Server certificates must not be expired, revoked, or otherwise invalid.
Required:
 No
Values:
Y = Certificates are checked for validity.
N = Certificates are not checked.
The server may require certificate validation. If a server requires certificate validation, an error is logged and the desktop app automatically attempts to open the certificate store and loop through the certificates, resending the request until it succeeds or until there are no more certificates.
Default:
 N
Written to:
 
HKLM/SOFTWARE/Wow6432Node/
AtHoc
[edition]/ValidateCert
There is no HKCU copy.
UNINSTALLOPTION
Determines if a user can remove the desktop app using the Control Panel.
Required:
 No
Values:
 Y = Can be removed. N = cannot be removed.
The 
<UninstallOption>no</UninstallOption>
 node in the 
options.xml
 file has a default value of "Yes." The value in the 
options.xml
 file is overridden by the value in the 
run.bat
 file.
Default:
 N