WebSphere brand IBM WebSphere Telecom Web Services Server, Version 7.1

Administering Parlay X Address List Manager over XCAP

After you deploy Parlay X Address List Manager over XCAP, you can use the TWSS Administration Console to change the deployment configuration properties for the Web service and related Service Platform components.

The Parlay X Address List Manager over XCAP Web service implementation receives Web service inputs from the Access Gateway and interacts with the IBM® WebSphere® XML Document Management Server (IBM XDMS) component. All operations use the XDM/XCAP interface of IBM XDMS.

Address List Management uses the TWSS Administration Console to configure the definition of constraints of an address book. The service configuration properties for Address List Management are displayed on a General properties page in the Console.

TWSS Administration Console settings

This Web service implementation adds the following configurable settings to the TWSS Administration Console:
  • You can change the setting in the TWSS Administration Console Web servicesIMA Address List ManagerAddress List Manager Web Service.

    Services: Default values used for Parlay X Address List Manager over XCAP:
    • UpdateQueryProcessingCostRatio: The processing cost ratio of updating transactions that query the transactions in the XCAP server. The default is 10.
    • MaxGroupMembers: The number of members in a group against the maximum number that is checked in the XCAP server. If this error occurs, the Address List Manager generates a POL0210 message. The default is 100.
    • SupportNestedGroups: Support for nested groups for the criteria of POL0211. The default is True.
    • MaxGroupLength: The maximum length of the group name for the criteria of POL0212. The default is 20.
    • AverageGroupMembers: The average number of members in a group for workload calculation. The default is 25.
    • AverageGroupAttributes: The average number of attributes in a group, or in a member workload calculation. The default is 2.
    • UseAssertedIdentity: This is set to True, if you use the X 3GPP Asserted Identity. Set to False, if you use the HTTP digest authentication. The default is True.
    • RootURI: Used when the Address List Manager generates an XCAP URI to reference a XCAP document within XDMS. It starts with http:// and ends with /. For example; http://fh4a.test.austin.ibm.com:9080/services/.
    • GroupScheme: The scheme name of a group used for generating the actual group URI. The value should be same as groupScheme of XDMS MBean. The default is Group.
    • UserScheme: A scheme name for the users. The default is sip.
    • ProviderDomain: The provider domain name used for generating the actual group URI.
    • DefaultUserFileName: A file name for users in the XCAP URI when the null string is specified in the domain part of the createGroup operation. The default is user_file.
    • DefaultGlobalFileName: The file name for the global in XCAP URI, when the null string is specified in the domain part of the createGroup operation. The default is global_file.

Connecting to IBM XDMS

To connect Address List Management to an IBM XDMS server, specify the root URI as http://hostname:port/services, where hostname and port are the appropriate values for the IBM XDMS server. Refer to the topic Finding the IBM XDMS XCAP root for help with locating these values.

XCAP passwords

If the XCAP server requires passwords, you can configure them by defining a policy as follows:
  1. Launch Service Policy Manager console.
    Note: If you are using the Service Policy Manager console with the Firefox browser, Firefox version 3.0 is strongly recommended.
  2. Set the password policy for each requester, using service.config.auth.Password in the Service Policy Manager Console. The policy type should be "Password," and this will encrypt the policy.

Policies

Parlay X Address List Manager over XCAP does not use policies.




Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.