Ready to install d.side? #
Follow these few steps to install d.side on your workstation.
Checking your java version #
To run d.side, required version is Java 11 .
Both Oracle Java and Open JDK are suitable, you can choose your preferred vendor.
If Java is already part of your PATH environment variable, installed java version can be checked this way:
java -versionDownloading java 11 #
Java 11 must be present on your machine, but not necessarily installed.
This can be useful when for example you need to keep a default Java 8 version on the machine. Both installed java 8 and downloaded java 11 versions can be present on your machine.
So, you can just download java 11 and uncompress the java archive, in order to be able to run d.side installer.
Here are two examples of java 11 binaries download links:
| Open JDK | https://wiki.openjdk.org/display/JDKUpdates/JDK11u |
| Oracle Java | https://www.oracle.com/java/technologies/downloads/ |
Launching d.side installer #
First of all, unzip d.side.install.zip and ensure you are located in the d.side.install directory.
Java 11 has been installed on your workstation #
In that case, just double-click on the runnable d.side.install.for.java.11.jar file to launch d.side installer.
Java 11 has just been downloaded on your workstation but is not installed #
In that case you have to run d.side installer through a command line, from the directory where d.side has been uncompressed.
Example:
cd /path/d.side.install
/java/jdk11.0.17/bin/java -jar d.side.install.for.java.11.jarThe optional complete path to java (displayed here in red) has to match your java 11 directory.
Important:
Before installing and running d.side, ensure you are administrator of your desktop or you have sufficient privileges to be able to create and write files.
When running installer from a Windows command line, ensure Windows Command Prompt is opened “as administrator”.
Installing d.side using installer interface #
When d.side installer starts, you have to:
- 1. Agree with license terms.
- 2. Choose the new directory where you want d.side to be installed.
Browse through your existing directories and create a new folder
Optional silent mode installation: installing d.side with a command line #
Installation can be performed in silent mode. That is, using options in the command line, in order not to open the user interface. In this silent mode, no user interaction is required anymore. This is useful for example when performing automatic d.side installation on the workstation of each teammate.
In order to start installation in silent mode, ensure the two following options have been passed to the installer:
java -jar d.side.install.for.java.11.jar -iagreewithlicenseterms -dsidehome /path/d.sideThese options are both required to install in silent mode:
| -iagreewithlicenseterms | Ensure you have read and accepted the license terms before installing d.side. These terms are fully available in interactive mode. |
| -dsidehome | Allows you to specify the destination directory where d.side will be installed. In this example, /path/d.side has been chosen. |
WARNING:
If the selected directory does not exist yet, it will be created by the installer.
If it already exists, then it must be empty. Otherwise, an error will occur.
Silent mode runs installation without user interaction.
Installation completed #
Running “d.side free forever” version #
When installation completed, you can start d.side.
Running any other d.side version #
In order to get a valid license, please send the d.side.conf file generated during installation process, to “licenses” email address.
D.SIDE SOFTWARE licenses team will then send you back a valid license file, to be copied into your d.side home directory.
At this point, you are ready to start d.side!
Troubleshooting #
Here are a few errors that can be encountered while installing d.side.
| Error message | Cause |
|---|---|
| Java version not supported | d.side requires Java 11 to run. |
| Directory is not empty | Uninstall first, or choose another directory. |
| [d.side directory] already exists but is a file | Choose an other directory. |
| Directory [d.side directory] could not be created | Grant privileges to the OS user or choose an other directory. |
| Directory can’t be written | Grant privileges to the OS user or choose an other directory. |
| Installer could not copy d.side files | Check additional message for information or check d.side.software directory contents. |
| Script to create shortcuts does not exist | Check d.side.software directory contents. |
| Launcher already exists | Uninstall first or choose another directory. |
| Launcher could not be created | Check additional message for information or grant privileges to the OS user. |
| Launcher could not be written | Check additional message for information or grant privileges to the OS user. |
| Script to create shortcuts can’t be executed | Grant the OS user the privilege to execute this VB script. |
| Installer could not create d.side shortcuts | Check additional message for information or create the launcher shortcuts manually. |
