Support April

VLMa installation

Prerequisities

  • Java 2 SDK 5.0 or later
  • VLMa binary distribution (either downloaded from a mirror or built from source)

Common

First extract VLMa distribution archive to the folder of your choice, you should see the following folders:

  • bin/ Command line wrappers to manage VLMa
  • conf/ Configuration
  • data/ Data
  • lib/ Dependencies
  • logs/ Log directory
  • webapps/ Webapps to deploy
  • work/ Folder needed by the servlet container

    • Installation on UNIX-like OSes (Mac OS, Linux, etc.)

    Ensure that the JAVA_HOME environment variable has been set. Run the following command:

     % echo $JAVA_HOME

    If it does not print anything to the standard input but whitespaces, this means that JAVA_HOME has not been set. You can set JAVA_HOME using the following command: 

     % export JAVA_HOME=/path/to/your/JDK/installation

    Then open a terminal and go to the folder where you extracted VLMa. You can run VLMa daemon by running the following command:

     % bin/vlmad start

    To run the web UI, open a new terminal and run:

     % bin/vlmaw start

    Installation on Windows

    Ensure that the JAVA_HOME environment variable has been set and that it points to a valid JDK installation. To do this, have a look at:

    Then open a prompt and change directory to where you extracted VLMa. You can run VLMa daemon by running the following command:

     % bin\vlmad start

    To run the web UI, open a new prompt and run:

     % bin\vlmaw start

    Access to the web interface

    To finish with, go to http://localhost:8080/vlmaw, you should see VLMa dashboard which tells you which medias are currently streamed and the list of servers VLMa didn't manage to contact through their telnet interface.

    The use of the embedded servlet container is a convenience for testing. If you plan to use VLMa in production, we recommend you make a complete installation of a servlet container like Tomcat, Jetty or whichever other servlet container.