All of the installers for PreEmptive Protection™ DashO™ can be downloaded from our website with your login. We currently provide installers for Windows, macOS, and Linux/GNU. These installers include an AdoptOpenJDK JRE (11.0.17+8 which will be used, by default, when running DashO. Alternatively, we also distribute DashO in archive form (Zip archive and Gzipped Tar archive) which does not include the JRE. The installers make DashO a little easier to use because they provide OS-specific links to start the DashO GUI and include an appropriate JRE.
The installers only distinguish between major and minor versions, thus installing version 9.3.1 would replace version 9.3.0, but would not replace versions 9.2.0 or 8.5.0.
System Requirements
The following are the system requirements for running DashO.
- Java 8, 11 (preferred), or later. DashO’s support for running on Java 8 is deprecated and will be removed in a future release. Both Oracle and OpenJDK versions of Java are supported. (We test with AdoptOpenJDK builds.)
- Any Windows, macOS, Linux/GNU, or Unix system which supports the version of Java being used to run DashO. The installers include AdoptOpenJDK JRE v11.0.11 (64-bit) which is supported on these platforms.
DashO supports processing class files from Java 1.3 - Java 18 compiled from Java or Kotlin sources. DashO supports processing Android applications and libraries with the minimum API level of 16 (v4.1) (or later). It can inject checks into classes for Java 5 (or later) or Android v4.1 (or later).
Note: Please see Java Modules for details about Module support.
DashO can be installed on Apple Silicon hardware, and the included JVM will be run via Rosetta. It can also be run on an Apple Silicon based JVM by configuring
DASHO_JAVA_HOME
.
Installers
Install
The Windows installer, PreEmptive_Protection_DashO_X.y.z.exe
, will require you to agree to the terms of the license in order to install. Installation will require elevated privileges.
DashO Home (default):
C:\Program Files\PreEmptive Protection DashO X.y\app
Note: When specifying this path in a Gradle build script, use forward slashes:
C:/Program Files/PreEmptive Protection DashO X.y/app
The installer also registers an uninstaller with Windows, which allows you to easily remove old installations.
Run
To start DashO, search for PreEmptive Protection DashO X.y
on the Start Menu or Start Screen.
This runs the dashogui.bat
script, starting the DashO User Interface. You can configure DashO to launch with a specific JVM by configuring DASHO_JAVA_HOME
. Other options can also be set in dashorc.bat
. See the Command Line Interface page for more details.
Install
The macOS installer, PreEmptive_Protection_DashO_X.y.z.pkg
, will require you to agree to the terms of the license in order to install. Installation will require elevated privileges. You can select the drive on which to install, but the installer will not allow the directory to be changed.
/Applications/PreEmptive Protection DashO X.y.app/Contents/Java
In order to see all of the files included in the installation in Finder, go to Applications
, secondary-click the PreEmptive Protection DashO X.y
application, and select "Show Package Contents".
Old versions of DashO can be uninstalled by deleting the corresponding installation directory from Applications
.
Run
To start DashO, click PreEmptive Protection DashO X.y
from Launchpad. This runs the dashogui
script starting the DashO User Interface. You can configure DashO to launch with a specific JVM by configuring DASHO_JAVA_HOME
. Other options can also be set in dashorc
. See the Command Line Interface page for more details.
Install
The Debian package PreEmptive_Protection_DashO_X.y.z.deb
can be installed from a shell, using the following command:
sudo dpkg -i ~/Downloads/PreEmptive_Protection_DashO_X.y.z.deb
The RPM package PreEmptive_Protection_DashO_X.y.z.rpm
can be installed from a shell using yum
:
sudo yum install ~/Downloads/PreEmptive_Protection_DashO_X.y.z.rpm
Installation will require elevated privileges. Although you will not be prompted to agree to the license, by using the software you agree to the terms of the license.
/opt/PreEmptive_Protection_DashO_X_y/app
Uninstall
On Debian, old versions of DashO can be removed with the following commands:
dpkg --get-selections '*dasho*' # list of DashO packages
sudo dpkg -P <name-of-package-to-remove>
On RPM-based systems, old versions can be removed using yum
:
yum list installed | grep dasho # list of DashO packages
sudo yum erase <name-of-package-to-remove>
Run
To start DashO, search for PreEmptive Protection DashO X.y
from the applications listing (the exact process will vary by desktop environment, e.g. Gnome).
Selecting the icon or menu item runs the dashogui
script starting the DashO User Interface. You can configure DashO to launch with a specific JVM by configuring DASHO_JAVA_HOME
. Other options can also be set in dashorc
. See the Command Line Interface page for more details.
Install
Although you will not be prompted to agree to the license, by using the software you agree to the terms of the license.
Within both archives, all of the files are contained in a directory named PreEmptive Protection DashO X.y
. Typically, expanding the archives will put the files in a directory with this same name. This is the DashO Home directory.
DashO Home (default):
/path-where-archive-was-extracted/PreEmptive Protection DashO X.y
Zip Package (.zip
)
Expand the PreEmptive_Protection_DashO_X.y.z.zip
archive using your preferred Zip utility.
Gzipped Tar (.tar.gz
)
Expand the PreEmptive_Protection_DashO_X.y.z.tar.gz
archive using your preferred utility, or run the following command:
tar xzvf ~/Downloads/PreEmptive_Protection_DashO_X.y.z.tar.gz
# x - extract, z - gzipped, v - verbose, f - from file
Note: Depending on your system configuration and how the archives are extracted, you may need to change file permissions on scripts (or directories) in order to execute them directly.
Run
To start DashO, either run the dashogui.bat
script for Windows, or the dashogui
script for other platforms.
These scripts will start the DashO User Interface. You can configure DashO to launch with a specific JVM by setting the DASHO_JAVA_HOME
variable, either in dashorc
or in the environment. The value of this variable should be the path of the desired Java installation, e.g. C:\Program Files\AdoptOpenJDK\jdk-11.x.y
for Windows, /Library/Java/JavaVirtualMachines/adoptopenjdk-11.jdk/Contents/Home
for macOS, or /usr/java/jdk-11.x.y
for Linux/GNU. Other options can also be set in dashorc
. See the Command Line Interface page for more details.
DashO Home
We define DashO Home as the directory containing DashOPro.jar
. This directory contains other components as well, including the DashO Gradle Plugins for Java, scripts, utilities, external tools, and documentation. When the DashO Gradle Plugin for Android, one of the DashO Gradle Plugins for Java, or an external build tool invoke DashO, they need to be able to determine an appropriate DashO Home. The DashO Gradle Plugin for Android will search standard installation locations for DashO Home. If you are using the DashO Gradle Plugin for Android with a non-standard installation location, are using one of the DashO Gradle Plugins for Java, or are using an external build tool, you will need to explicitly configure a DashO Home.
We refer to the directory where DashO is installed as the installation directory. If you install DashO from one of the archives, DashO Home is the installation directory. If you install DashO using one of the installers, DashO Home will be nested under the installation directory, either app
(Windows and Linux/GNU) or Contents/Java
(macOS).
Activate PreEmptive Protection DashO
The first time you use the product you will be prompted with an activation dialog that will walk you through the process.
Note: The PreEmptive Solutions Support Department can be reached through our website. The
About
dialog shows your masked license key, DashO version, and JVM version.
Proxy Configuration
If you use DashO in an environment that requires use of a proxy to access the internet, you will need to configure your proxy settings before trying to activate.
Customer Feedback Options
DashO uses a system for reporting application usage. We use this data to help guide our development of new and existing features. Only high level usage data is gathered -- configuration details are not collected.
How to Change Your Feedback Option
With the Config Editor
You may change your feedback options at any time from the Help > Customer Feedback Options menu in the DashO GUI. This value will be saved to and reflected in your user preferences.
If a feedback option is not specified in your user preferences, you will be opted in by default.
With an Environment Variable
You can also set your feedback preference by setting the environment variable PREEMPTIVE_TELEMETRY_OPT_OUT
to true
or false
. If preferences are specified in both the config editor GUI and the environment variable, the environment variable's setting will be obeyed.
If neither the PREEMPTIVE_TELEMETRY_OPT_OUT
environment variable nor your user preferences specify a feedback option, you will be opted in by default.