How To install GVirtuS framework and plugins#

Prerequisites:

GCC, G++

OS: Ubuntu 10.04 (tested) / Ubuntu 12.04 (tested) / Ubuntu 14.04 (tested) / CentOS 6.8 (tested)

CUDA Toolkit: Version 6.5

This package are required: build-essential gcc-4.4 autotools-dev automake libtool mesa-common-dev git

Installation:

1. Clone the gvirtus-linux-java main repository

   git clone https://github.com/RapidProjectH2020/gvirtus-linux-java.git

In the directory “gvirtus-linux-java” there are four directories named “gvirtus”, “gvirtus.cudart”, "gvirtus.cudadr" and "JavaFE".

“gvirtus” contains the framework.

“gvirtus.cudart” and "gvirtus.cudadr" contains the cuda runtime plugin and the cuda driver plugin.

"JavaFE" contains the Java version of Frontend.

2. Launch the installer script indicating the destination folder of the installation (es. "/home/rapid/opt"):

   ./gvirtus-installer "GVIRTUS_PATH"

--P.S. If you want to install GVirtuS 32 bit version ON X86_64 machine, you can launch the installer script "gvirtus-installer-32bit_onX86_64_machine". If your machine is 32 bit, you can use "gvirtus-installer" normally.

To check your installation please check the following directories:

Check GVIRTUS_PATH/lib for frontend and backend directories

EXAMPLE cuda application

Backend machine (physical GPU and Cuda required)

On the remote machine where the cuda executables will be executed

Modify the Gvirtus configuration file backend if the default port 9991 is occuped or the machine is remote:

GVIRTUS_PATH/etc/gvirtus.properties

#
# gVirtuS config file
#

#
# Communicator
#   AfUnix: afunix://path:mode
#   Shm: shm://
#   Tcp: tcp://hostname:port
#   VMShm: vmshm://hostname:port

communicator : tcp://localhost:9991 #change localhost with remote host if necessary
plugins : cudart, cudadr

#
# End Of File
#

Export the dynamic CUDA library:(typically /usr/local/cuda/lib64)

export LD_LIBRARY_PATH=”<CUDA_PATH>/lib64” 

--PS: If you are using GVirtuS-backend 32 bit: export LD_LIBRARY_PATH=”<CUDA_PATH>/lib”

Execute application server gvirtus-backend with follow command:

GVIRTUS_PATH/bin/gvirtus-backend

Frontend machine (No GPU or Cuda required)

The default port and ip are setted in the GvirtuSFE.java file:

static String ip="127.0.0.1"; //change localhost with remote host if necessary
static int port = 9991;

Change this value for other configurations.

Run the Java project!

###P.S. Run the project only AFTER have launched the gvirtus-backend process on the remote machine!###