To install either the recorder or the videoconference application, the only step that needs to be done is to copy the .war file in the $RED5_HOME/webapps directory.
You have to restart red5 to get the applications deployed inside red5. You can install both applications inside red5. They can run together
inside the same server without conflict.
2. Configuration
2.1. How does it work ?
War files are shipped with a bunch of default configuration files. Normally, you should never touch the files in the war file.
Upon startup, the applications are checking if any external configuration file can be found. If not, the application will be loading
the configuration files located in the war file, thus loading the default configuration.
Each application has one main configuration file that the administrator can customize. The location and the name of this configuration file can
be found in a resource file in the war file. This resource file is called either videoconference.propeties or recorder.properties.
One of the well-known issue here is that you have to recompile the application with other settings if you want to change
the configuration location and name. We will find a better solution for a future release.
The main configuration file is an XML file. Currently, there is no validation of this XML. It will probably be supported in a future release.
2.2. Recorder
The recorder configuration file is named recorder-config.xml. It has the following format:
A server-key is a parameter used for authentication. It helps in determining whether the client connecting to the server is authorized to connect to the server by sharing a common key. For a given server-key, you provide the hostname and the shared key. The host name has currently a very specific format. It must start with two __ and end with one _. This will probably be improved in the future.
moderator-check-on-whiteboard defines whether only the teacher or all people in the room have access to the whiteboard. This parameter is deprecated in videoconference 2.0.0. The value can be true or false. Any other strings different from true are considered false.
Video-streams-dir and vod-streams-dir are not used at all. See recorder config for more info.
3. Known issues and possible improvements
We are not living in a perfect world... Even if we make a lot of efforts to get an application flexible and easy to use, we still have a lot of
improvements to do. Here is a list of improvment to be done for configuration handling:
* Find a solution to get external config directory platform independant.
* Rename parameters video-streams-dir and vod-streams-dir to a more explicit name.
* Check whether hostname can be stripped of these underscores.
* Remove or integrate moderator-check-on-whiteboard.
