WINDOWS 10

Note: Windows 10 features a bash shell that can run linux software directly on Windows. This makes the installation of MercuryDPM much easier, as it no longer requires the use of an emulator (like cygwin) or a virtual machine.

Step 1: Activate the Ubuntu bash for Windows 10

      1. Search for " Windows Update settings"

2. Go to " For developers" and activate "Developer mode"

3. Close the "Settings" app and open "Control Panel" -> "Programs" -> "Turn Windows features on or off

4. Enable "Windows Subsystem for Linux" and click OK. You will be prompted to reboot. Click "Restart now" to install Bash

5. Go to the "Microsoft Store" and download "Ubuntu" (this step is not necessary for older Windows 10 versions, where only Ubuntu was available).

6. After reboot, search for "bash" or "Ubuntu" in the start menu and open the program.

7. The first time it will ask you to accept the terms of service and to create a username and password. If you're not familiar with the linux environment, this password is needed for most sudo (i.e., administrator) commands.

5. You now have the bash console, and all linux commands, available at your computer. To start in linux mode just open the "bash" program. (Your windows files are under /mnt/c).

6. If you prefer to work from your windows files from start, it is also possible to enter from the Command Prompt by typing bash

Step 2: Install X11

    1. For visualisation, an X11 server is needed. We recommend the Xming X server, available at https://sourceforge.net/projects/xming.
      Download that program and follow the default installation instructions

    2. Open "Xming" from the start menu. There should now be a "X" logo in the notification bar at the bottom left corner of your screen. Mouseover to see the address of the X11 display. (default case 0.0)

3. Open "bash" to open a terminal

4. For using the CMake graphical user interface, as well as Xballs or other visual programs, connection with the X11 server has to be established. For that you need to define the DISPLAY variable in your bash terminal. You do this by adding the command "export DISPLAY=localhost:0.0" to the ~/.bashrc file and restarting bash. All this can be done by executing the two lines below in the bash terminal:

echo "export DISPLAY=localhost:0.0" >> ~/.bashrc
bash

Mind the capitals! If your address from step 2 is different from 0.0, change the number.

Tip: You can paste each command into the command window by right-clicking the title bar:

Please note: Before using xballs or cmake-gui, make sure you have the Xming X11 server running (step 2, item 2), otherwise the visualisation will NOT work.

Step 3: Change your linux home directory such that it is easily accessible from Windows

1. By default, the Ubuntu shell creates a home directory in the AppData folder in your user directory. This folder is hidden and very hard to access in Windows. We therefore recommend you to use a folder within the Windows file system instead. To do so, create a new folder "C:\dev" on your C-drive, and make bash enter this folder at start-up.

mkdir /mnt/c/dev

cd /mnt/c/dev

echo "cd /mnt/c/dev" >> ~/.bashrc

2. Add this folder to your Quick Access toolbar:

Step 4: Install MercuryDPM

Now open the bash and follow the installation instructions for linux to install MercuryDPM.