Sun GlassFish Communications Server 2.0 Application Deployment Guide

sun-sip-app

Defines Communications Server specific configuration for a SIP module. This is the root element; there can only be one sun-sip-app element in a sun-sip.xml file. See The sun-sip.xml File.

A SIP module that has web module features is a converged SIP module.

Superelements

none

Subelements

The following table describes subelements for the sun-sip-app element.

Table A–124 sun-sip-app Subelements

Element 

Required 

Description 

security-role-mapping

zero or more 

Maps roles to users or groups in the currently active realm. 

session-config

zero or one 

Specifies session manager, session cookie, and other session-related information. 

ejb-ref

zero or more 

Maps the absolute JNDI name to the ejb-ref in the corresponding Java EE XML file.

resource-ref

zero or more 

Maps the absolute JNDI name to the resource-ref in the corresponding Java EE XML file.

resource-env-ref

zero or more 

Maps the absolute JNDI name to the resource-env-ref in the corresponding Java EE XML file.

service-ref

zero or more 

Specifies runtime settings for a web service reference. 

message-destination-ref

zero or more 

Specifies the name of a physical message destination. 

class-loader

zero or one 

Specifies class loader configuration information. 

property (with attributes)

zero or more 

Specifies a property, which has a name and a value. 

message-destination

zero or more 

Specifies the name of a logical message destination. 

Properties

The following table describes properties for the sun-sip-app element.

Table A–125 sun-sip-app Properties

Property 

Default 

Description 

trust-id-ref

none 

Specifies the name of the trust configuration. In the domain.xml file, this is the id attribute of the identity-assertion-trust element.

For more information, see the Trust Configurations description in the Admin Console online help, the asadmin create-trust-config command in the Sun GlassFish Communications Server 2.0 Reference Manual, or the identity-assertion-trust element description in the Sun GlassFish Communications Server 2.0 Administration Reference.

trust-auth-realm-ref

none 

Specifies an auth-realm of type jdbc, with class name jdbcRealm, that has assertedRealm as its JAAS context value.

For more information about realms, see the Realms description in the Admin Console online help, the asadmin create-auth-realm command in the Sun GlassFish Communications Server 2.0 Reference Manual, or the auth-realm element description in the Sun GlassFish Communications Server 2.0 Administration Reference.