SIP Preference Page

During Session Initiation Protocol (SIP) project creation, the SIP Deployment Descriptor (sip.xml) and Web Deployment Descriptor (web.xml) files are created. To enable deployment to WebSphere Application Server 6.1, the SIP application must be added to an EAR project and the web.xml file must be modified to include the SIP content. This modification occurs automatically if the "Automatic update..." option is selected on the SIP Preference Page. When changes to sip.xml are saved, a dialog will display asking if you want to update the web.xml file. Select Yes to update the file. If, during this process, the web.xml has unsaved modifications, the SIP update cannot continue and a dialog asking whether to save the web.xml will appear. Select Yes to save the web.xml and update with the SIP content. Select No to perform this task manually, if desired. See the Manual Updates section for additional information.

To access the SIP Preference Page select Window -> Preferences -> SIP.

The SIP Preference Page contains the following options:
  1. Always update Web Deployment Descriptors (web.xml) with SIP Deployment Descriptor (sip.xml) content
  2. Prompt to update Web Deployment Descriptors with SIP Deployment Descriptor content

If Option 1 is selected, the web.xml file will automatically be updated with SIP content.

If Option 2 is selected, you will be prompted to update the web.xml file when saving the sip.xml file, regardless of the setting of Option 1.

By default, both options are enabled. Each behavior can be disabled by de-selecting the option.


Validation

WebSphere Application Server 6.1 requires that the web.xml be updated with sip.xml content. If the web.xml is not updated, a warning message will display in the Problems View. This typically occurs if the automatic update of web.xml is disabled or if No is selected on the update dialog.


Manual Updates

You can choose to manually update the web.xml file. Right click the sip.xml file in the Project Explorer, then select Sip Operations -> Update web.xml from the context menu. Use this method to quickly modify the file, and clear the update warning messages, if you have disabled automatic updating.



Related items
Creating a SIP project
Creating a SIP servlet
Editing the SIP deployment descriptor


Feedback