WebLogic SIP Server findme Example

The following sections describe the findme example that is installed with WebLogic SIP Server 2.0.1.

• About the Example
• Files Used in the Examples
• Build the Example
• Register SIP Phones
• Run the Example

 

---

About the Example

The WebLogic findme example provides registration, proxy, and conference calling capabilities for SIP addresses. You can register multiple SIP phone addresses with the findme application and initiate conference calls via a JSP.

findme is implemented as a SIP application that contains three SIP Servlets:

• registrar processes SIP REGISTER requests by registering addresses with the application. SIP addresses are removed after a fixed expiration period. The registrar Servlet provides a service class for adding, removing, and resolving SIP addresses.
• findme processes SIP INVITE requests by proxying the request to one or more request URIs.
• conference creates and manages conference calls for registered addresses. Calls are associated with an application sessions for the duration of the call.

The multiple Servlets are assembled as a SIP application, and Servlet mappings are defined, using the sip.xml descriptor.

findme also provides several JSPs that are used to interact with the included Servlets, as described in Files Used in the Example.

 

---

Files Used in the Example

Directory Location:

BEA_HOME/wlss201/samples/server/examples/src/findme

File	Description
src/FindMe.java	Java source file for a SIP Servlet for proxying INVITE requests.
src/Registrar.java	Java source file for a SIP Servlet that registers SIP addresses in response to REGISTER requests, removes registered addresses after the timeout specified by the phone, and resolves addresses as needed to proxy SIP INVITE requests.
src/Conference.java	Java source file for a SIP Servlet that sets up conference calls for registered SIP addresses.
src/dump.jsp	JavaServer Page that displays a list of registered SIP addresses. This JSP interacts with the Registrar.java Servlet.
src/conf.jsp	JavaServer Page for selecting registered users to invite to a conference call. This Servlet gets the addresses to use for setting up the call.
src/conf_setup.jsp	Non-interactive JavaServer Page that posts the addresses obtained with conf.jsp, using the Conference.java Servlet to set up and connect the addresses in a conference call.
WEB-INF/sip.xml	SIP descriptor that defines the components of the SIP application as well as the Servlet mapping.
WEB-INF/web.xml	Web Application deployment descriptor.
WEB-INF/weblogic.xml	WebLogic Web Application deployment descriptor.
build.xml	Ant build script.

 

---

Build the Example

Prerequisites

Before working with this example:

1. Install WebLogic SIP Server.
2. Use the Configuration Wizard to create a new SIP Server domain. If you create a new example SIP Server domain, the findme example is automatically built and deployed to the domain.

Configuring WebLogic SIP Server

The findme example requires no additional server configuration.

Building the Example

Note: The pre-built findme example is automatically installed with WebLogic SIP Server 2.0.1. Follow these instructions to rebuild the example after modifying the code:

1. Set up your environment if you want to build the findme example and deploy it to a new domain:

cd c:\davinci\user_projects\domains\mydomain
setEnv.cmd

2. Change to the WL_HOME\samples\server\examples\src\findme directory, where WL_HOME refers to the main WebLogic SIP Server 2.0.1 installation directory (for example, c:\davinci\wlss201\samples\server\examples\src\findme).
3. Execute the following Ant command to build and install the example:
   
   ant build
   
   This command compiles the example into WL_HOME\samples\server\examples\build\findme. If you want to build a complete WAR file and copy the WAR to the applications directory of your domain (automatically deploying it), use the Ant command:
   
   ant application

Deploying the Example

The findme example is automatically deployed to the example domain you can create using the Configuration Wizard (see Creating a New SIP Server Domain). The example build.xml file contains a deploy target that you can use to deploy the example to a new domain. By default, the target is setup to deploy using the following attributes:

  <target name="deploy">
    <wldeploy action="deploy"
      source="../../build/findme"
      name="findme"
      user="system"
      password="weblogic"
      verbose="true"
      nostage="true"
      adminurl="t3://localhost:7001"
      targets="myserver"
    />
  </target> 

To deploy the example to a different domain, open build.xml in a text editor and change the user, password, adminurl, and targets attributes accordingly. Then deploy using the command:

ant deploy

This command deploys the exploded example application directly from the build subdirectory. To redeploy the application, use the command:

ant redeploy

Note: After you redeploy the findme example, you must restart SIP soft phones to register them with the updated application.

 

---

Register SIP Phones

The findme example is compatible with the X-Lite, X-PRO, and Pingtel SIP soft phones. The Pingtel SIP phone does not require registration services.

Follow these instructions to register a free X-Lite SIP phone with the findme application:

1. Start the X-Lite soft phone software.
2. Open the Main menu.
3. Select System Settings > SIP Proxy > [Default]
4. Enter information for the following fields:
• Enabled: Select Yes
• Username: Enter a username for this address
• Password: Enter a password for this address
• Domain/Realm: Enter the domain name of your WebLogic SIP Server (for example, mycompany.com)
• SIP Proxy: Enter servername:5060, where servername is the DNS name or IP address of your WebLogic SIP Server machine (for example, myserver:5060)
5. Save the menu settings.
6. Restart the X-Lite soft phone to register with the findme application. The X-Lite software status message reads "Logged in - Enter Phone Number" after it has successfully registered.

Note: After you redeploy the findme example, you must restart SIP soft phones to register them with the updated application.

Run the Example

To run the example, follow these steps:

1. Complete the steps in the "Build the Example" section.
2. Register two or more SIP phones using the instructions in the "Register SIP Phones" section.
3. Navigate to http://servername:7001/findme/dump.jsp to view the currently-registered SIP addresses.
4. Navigate to http://servername:7001/findme/conf.jsp to set up a conference call between registered SIP addresses.