logo_space_Veins.svg

Installation


This installation guide only works with space_Veins-0.3. All other versions of space_Veins are deprecated and are no longer supported. There are two recommended ways to run space_Veins which either use VS Code Devcontainers (Docker) or Singularity.

VS Code Devcontainers

Requirements/Tested with:
Guide:
  1. Start Docker

  2. Open the space_Veins root directory in VS Code. Install the VS Code extension ‘Dev Containers’ if it is not already installed.

  3. A pop-up in VS Code asks if the current folder should be reopened in a container. Click “Reopen in Container”.

  4. VS Code automatically starts creating the Docker container. This takes several minutes to finish.

  5. As soon as building the container is finished, VS Code indicates the use of the Docker container in its lower left corner.

  6. Build space_Veins:

    1. Press Ctrl + Shift + p
    2. Type Tasks: Run Task
    3. Hit Enter
    4. Select build all
  7. Run the example

    1. Press Ctrl + Shift + p
    2. Type Tasks: Run Task
    3. Hit Enter
    4. Select run veins_launchd
    5. Use the terminal to navigate to examples/space_veins
    6. Run ./run

Singularity

Requirements/Tested with:
Guide:
  1. Build the Singularity container

    1
    2
    
    cd space_veins/singularity
    singularity build --fakeroot singularity-space_veins.sif singularity-space_veins.def
    
  2. Build space_Veins

    1
    2
    
    singularity run -H ..:/space_veins --net --network none singularity-space_veins.sif --chdir /space_veins -- make makefiles
    singularity run -H ..:/space_veins --net --network none singularity-space_veins.sif --chdir /space_veins -- make
    
  3. Run the example

    1
    
    singularity run -H ..:/space_veins --net --network none singularity-space_veins.sif --chdir /space_veins/examples/space_veins --launchd -- ./run -u Cmdenv -c Null-Island-Launchd -r 0
    

Alternatively the following commands can be used to build space_Veins and run the example:

1
2
3
./singularity-space_veins.sh /space_veins -- make makefiles
./singularity-space_veins.sh /space_veins -- make
./singularity-space_veins.sh /space_veins/examples/space_veins --launchd -- ./run -u Cmdenv -c Null-Island-Launchd -r 0

Native Installation

Please have a look at the .devcontainer folder or the singularity definition file singularity/singularity-space_Veins.def. These files contain all necessary information for setting up a native development environment. Please be aware that space_Veins is only tested with Ubuntu 22.04 Jammy so far.