Java H.323 Beacon Server - Version 1.0
----------------------------------------------------------
 (C) Copyright ITEC-Ohio, 2002


1. INSTALLATION
1.1. Make sure you have installed a JDK or JRE 1.1.6 or above.
1.2. Download and install the Java Telephony API (JTAPI) 1.2 (NOT 1.3.x)
   class files (zip format is better) from Sun at:

    http://java.sun.com/products/jtapi/download2.html 
1.3. Download and install the Java Media Framework (JMF) 2.1 or above
   from Sun at:
    http://java.sun.com/products/java-media/jmf/
1.4. Download and install J323 Engine from IBM Alphaworks at:
    http://www.alphaworks.ibm.com/tech/j323engine
1.5 Download the jar file "JavaH.323BServer1.0.jar" from ITEC-Ohio at:
    http://www.itecohio.org/beacon


2. INVOCATION (on Win 32)
Beacon Server is invoked from the command line as follows:
     java -classpath "<path to Beacon Server jar file>;<path to J323 Engine jar file>;<path to JMF jar file>;<Path to JTAPI jar file>;" -Djmf.package=com.ibm.media.teljmf.TjTmProvider beaconserver.Main 

Example:
    java -classpath "C:\JavaH.323BServer1.0.jar;C:\Beacon_Project\BeaconServer\J323Engine\j323\lib\j323.jar;C:\Beacon_Project\JTAPI\jtapi-class.jar;C:\Program Files\JMF2.1.1\lib\jmf.jar;" -Djmf.package=com.ibm.media.teljmf.TjTmProvider beaconserver.Main 

Where
   "java"               invokes the Java virtual machine,
   "beaconserver.Main"  (note the case!) specifies the class to run,

   "-Djmf.package=com.ibm.media.teljmf.TjTmProvider " - To enable streaming of media, you must download and configure the JMF. 

Then you must tell J323 Engine to use the JMF-based media subsystem plugin by specifying the following system property: jmf.package=com.ibm.media.teljmf.TjTmProvider. 

3. How to Run Beacon Server using JBuilder 4:
3.1. Create a new project. Point it to the source.
3.2  Create new libraries (JMF, J323, JTAPI) each pointing to the "jar" files of the libraries downloaded.(Tools - Configure Libraries)
3.3  Add the new libraries to the project.(Right click Project - select "Properties")
3.4  Modify configuration to "Run".(Run - Configurations)
	set VM parameter to -Djmf.package=com.ibm.media.teljmf.TjTmProvider. This will give Beacon capability to stream media.
3.5  Set beaconserver.Main as the main class to the project.
3.6  Compile and run the project.

4. How to use Netcat on the client side for loopback of video file:
4.1 Download Netcat (Version 1.1 was the latest version at the time of writing this doc) from:
	http://www.atstake.com/research/tools/#network_utilities
4.2 Execute Netcat by invoking the nc.exe as follows(example):
c:\nc -v -l -p 12345 > loopback.mov
4.3 Explaination of the options
	-v - verbose shows debug statements on console
	-l - netcat in listening mode
	-p - port to listen on (Use only 12345 as it is hard-coded in the Java H.323 Beacon Server)
	>  - Redirect output to a .mov file.


5. How do I adjust the video quality from the client to get a better loopback movie file?
5.1 Use the  brightness and lightness settings in the client software and observe the video window on the server (if possible)

6. SUPPORT
6.1 To Obtain more information and to report bugs and comments, email:
			pcalyam@osc.edu