You can deploy
a Session Initiation Protocol (SIP) application
through the administrative console.
Before you begin
SIP applications
are deployed as Java 2 Platform Enterprise
Edition (J2EE) applications. In order to process requests, a virtual
host must be defined when deploying the SIP application. If there
is no virtual host defined for the configured SIP container listen
port, the installed application will be inaccessible.
Procedure
- Open the administrative console.
In
a browser, go to URL http://hostname:9090/admin,
where hostname is the name of the host computer. Enter
the appropriate login information, and click OK.
- In the left frame click .
- Browse and select a SAR file.
Specify the context root,
beginning with a slash (/), in the Context Root field.
For example, if your application is named ThisApplication,
type /ThisApplication.
-
Click Next (under the Context
Root field not beside the WebSphere Status title).
If the SAR file has been assembled correctly, the screen will still
have the title "Preparing for the application installation",
but the content will change. If an error message appears, check the
contents of the SAR file; in particular, verify the web.xml file
contents, and try to reload the SAR file.
- Click Next.
If you see a screen
indicating "Application Security Warnings", click Continue.
- The Install New Application screen
should appear with "Step 1: Select application options" highlighted.
Select the options you need and click Next.
- "Step 2: Map modules to servers" should appear
highlighted
now. You can choose the cluster or server where you want to install
the application's modules.
- If you are installing
the application in a stand-alone system,
click Next.
- If you are installing
the application in a clustered system,
select WebSphere:cell=cellname,cluster=cluster_name in
the Clusters and Servers field, select the
check box beside the web module that you want to install, and click Apply and Next.
- Now "Step 3: Map virtual hosts for web
modules" should
appear highlighted. To the right of the application name there should
be a drop-down labeled Virtual Host.
- If you are installing the application in a stand-alone
system,
set the value of the drop-down to default_host,
and click Next.
- If you are
installing the application in a clustered system,
set the value of the drop-down to the name of the virtual host that
was chosen during setup, and click Next.
Remember: You must define a virtual host
for your
configured SIP container listen port or else you will not be able
to access the application.
- You should
now see "Step 4: Summary" highlighted.
In the right panel you will see a Summary of installation
options table that details your selected options and their
values. If you need to change an option, click Previous to
return to the section where you can make your change. Click Finish to
install the application with your settings. The screen
should display, Application appname_sar
installed successfully, where appname is
the name of the application.
- Click the Save
to Master Configuration link. A Save
to Master Configuration window
appears.
- In the Save to Master
Configuration window,
click Save. The application
has now been saved in the current configuration.
- To confirm that the installation succeeded, in the left
frame click . The newly
installed application should appear in the list of installed applications
as appname_sar.
- To
start the application so that it can service SIP requests,
check the box beside appname_sar, and click Start.
You might also want to look at the logs for a successful startup message.
Results
The application can service SIP requests now.