Deploying and Running the Conferencing Application

Back to "Accelerating Multimedia Application Development with JSR 309 Media Server Control API"

To run the application, you need to perform the following installation steps:

  1. Install the Eclipse IDE (optional).
  2. Download and install OCMP; the Media Server will play announcements, collect digits and mix audio during the conference session. For installation instructions, please refer to the OCMP site and JSR 309 RI User Guide
  3. Download and install Oracle Communications Converged Application Server 4.0; the Application Server will control each participant's signaling path and the overall conferencing logic.
  4. Download and install JSR 309 Reference Implementation; it will install the JSR 309 RI that runs in OCCAS. For installation instructions, please refer to the JSR 309 RI User Guide.
  5. Download the sample Conferencing Application.
  6. Download the Standard Tag Library for JavaServer Pages (JSTL) 1.2 available at https://jstl.dev.java.net/. Download both the JSTL API (jstl-api-1.2.jar) and the JSTL Implementation (jstl-impl-1.2.jar).
  7. Build and deploy the Conferencing Application using either Ant (see below) or Eclipse (see "Import the Conference Eclipse Project").

Build and Deploy the Conferencing Application using Ant

  1. Unzip conference.zip, the unzipped directory named conference is from now on referred to as <CONF_APP_DIR>
  2. Copy jstl-api-1.2.jar and jstl-impl-1.2.jar to <CONF_APP_DIR>\src\WEB-INF\lib
  3. Open <CONF_APP_DIR>/local.properties, and edit according to your environment.
  4. Download and install Ant (e.g. apache-ant-1.7.1-bin.zip)
  5. Open a terminal window (DOS Command Prompt or similar)
  6. Go to the <CONF_APP_DIR> directory:
                                        e.g prompt>cd C:\conference
                                    
  7. Add Java (JDK) to your path environment variable:
                                        e.g. prompt>set PATH=C:\occas40\jdk160_05\bin;%PATH%
                                    
  8. Add ant to your path environment variable:
                                        e.g. s prompt>et PATH=%PATH%;C:\opt\apache-ant-1.7.1\bin 
                                    
  9. Start OCCAS if not already running.
  10. Build and deploy the Conferencing Application:
                                        prompt>ant deploy
                                    

Import the Conference Eclipse Project

  1. Start the Eclipse IDE
  2. Unzip conference.zip in your eclipse workspace or elsewhere.
  3. Copy jstl-api-1.2.jar and jstl-impl-1.2.jar to conference\src\WEB-INF\lib
  4. Import the conference eclipse project by:
    1. Go to File->Import->General->Existing Projects into Workspace and click Next.
    2. Select Select root directory and browse to the directory where you unzipped conference.zip.
    3. Under Projects:, select conference
    4. Click Finish.
  5. Right-click on the conference project and select Properties
  6. Select Java Build Path in the left column, and in the Libraries tab, edit the paths of the different jar files to match your environment, and click OK.
  7. Open conference/local.properties, and edit it according to your environment.
  8. Open the Ant view ( Window->Show View->Other…->Ant->Ant).
  9. Drag-and-Drop conference/build.xml to the Ant view.

Build and Deploy the Conferencing Application using Eclipse

  1. Double-click conference in the Ant view.

 

Logging



To enable logging for the conferencing sample application, add the following to log4j.xml, located in the WebLogic domain directory (e.g. C:\occas40\user_projects\domains\jsr309ri)

                                <logger  name="multiparty">     <level value="debug"/>     <appender-ref  ref="console"/>     <appender-ref  ref="file"/> </logger> 
                            

Testing

The conferencing application has been tested with the X-Lite SIP soft phone. For other phones tested with OCCAS, see this documentation.

Download the X-Lite softphone from X-Lite-Download. Configure X-Lite as shown below:

  1. Go to Menu->SIP Account Settings…
  2. Click Add...
  3. Select the Account tab.
  4. Set the properties in the User Details section as below:
    • Display Name: your full name as this will be displayed in the Web interface.
    • User name: anything, e.g. tericson, this is used as the user part of your SIP URI.
    • Password: anything (not used)
    • Authorization user name: anything (not used)
    • Domain: your company's domain name, e.g. oracle.com, this is used as the domain part of your SIP URI.
  5. Set the properties in the Domain Proxy section as below:
    • Don't check the Register with domain and receive incoming calls checkbox.
    • Under Send outbound via:, select proxy and enter the IP address and SIP port of OCCAS as the Address, e.g. 127.0.0.1:5060
    • Click OK.

Using the App

Browse to http://IP-of-OCCAS:7001/demo/ and make a call to sip:conf@IP-of-OCCAS:5060. When prompted, enter a four-digit conference ID; the conference will be created and will show up in the Web interface.

When asked if you are the organizer, you will be given the following options:
    - Enter 1 and you will be asked to set the conference password
    - Wait for the organizer to join, and listen to some music while waiting

Click on the conference id to go to the conference info page. From there, it's possible to mute/unmute and unjoin (kick-out) a conference participant.

If you are annoyed by the sound Internet Explorer makes every time a page is refreshed, all you have to do to stop / disable it is the following: Go to Start >> Control Panel >> Sounds and Audio Devices. Then click on the Sounds tab. Once there, scroll down the list of Program Events until you see Windows Explorer. Underneath that you should then see S tart Navigation. Select (highlight) start navigation. Now, looking underneath the list of Program Events you should see a section for Sounds. Use that drop-down box to select (None) which is at the very top of the list in most cases. This should do the trick once saved or applied.

Getting Support

Back to "Accelerating Multimedia Application Development with JSR 309 Media Server Control API"