Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. Desktop App 7.7 (Windows), 2.6 (Mac)
  4. Desktop App Installation and Administration Guide
  5. Desktop app settings
  6. Installation settings (Windows)
  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 BlackBerryAtHocNotifier_7.3.x.x.msi /l*vx BlackBerryAtHocNotifier_7.3.x.x.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 BlackBerryAtHocNotifier_7.3.x.x.msi /l*vx BlackBerryAtHocNotifier_7.3.x.x.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.”
BlackBerryAtHocNotifier_7.3.x.x.msi
 is the name of the installer associated with the switch.
The
/l*vx
 switch specifies a verbose log.
BlackBerryAtHocNotifier_7.3.x.x.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
PID
Provider ID. The organization that the desktop app should connect to.
Required:
 Yes
Format:
 Integer, for example 1234567.
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
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
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
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.
Default:
 N