Hi there, The Guitar Hero release introduced the enforce_user_phone and enforce_global_only_lookup configuration options. This email clarifies their purpose.
Clearwater's default behaviour is designed so that it will work with most client devices, and in many deployment scenarios. However because of this, its default treatment of phone numbers is not completely compliant with the IMS specs (specifically TS 24.229). Therefore it is expected that for most clearwater users these options will *not* need to be enabled. They are not required for Tel URI support, which is enabled by default. The options are provided for users who desire rigorous spec compliance, and should only be used in networks where other devices are similarly rigorous. At a minimum the clearwater operator should ensure that clients supply a user=phone parameter on SIP URIs that contain phone numbers, and that their networks convert dialed digits to E.164 format before ENUM lookup takes place (e.g. by using clients or an application server that will do the conversion). Apologies for any confusion regarding these options. Alex. ----- From: [email protected] [[email protected]] on behalf of Graeme Robertson [[email protected]] Sent: 30 May 2014 11:18 To: [email protected] Subject: [Clearwater] Guitar Hero release note The release for sprint "Guitar Hero" has now been cut. It contains the following features and bug fixes. Features: * Added support for Tel URIs and user=phone parameter as per the spec that was distributed 2 weeks ago (https://www.mail-archive.com/[email protected]/msg00505.html) Bug Fixes: * Sprout spams logs with assert logs from PJSIP (https://github.com/Metaswitch/sprout/issues/567) * Sprout returns wrong error code when doing a LIR for non-existent user (https://github.com/Metaswitch/sprout/issues/543) * Crash if AS diverts a call to a different domain (https://github.com/Metaswitch/sprout/issues/519) * sprout should surround Contact URI with <> before adding expires parameter (https://github.com/Metaswitch/sprout/issues/507) * sprout logs 404 responses as 408 (https://github.com/Metaswitch/sprout/issues/456) * Sprout UTs overuse FakeCurl (https://github.com/Metaswitch/sprout/issues/240) * Homestead spins out of control when trying to resolve a Diameter NAPTR record. (https://github.com/Metaswitch/homestead/issues/94) * Configurable timers for the Diameter Cx interface (https://github.com/Metaswitch/homestead/issues/79) * Ralf is not issuing Interim Records for Call Sessions (https://github.com/Metaswitch/ralf/issues/43) * AccessLogger should log request latency if available (https://github.com/Metaswitch/cpp-common/issues/102) * Chronos crashes continuously on sprout node in minimal configuration (https://github.com/Metaswitch/chronos/issues/45) * repeat-for is not actually optional (https://github.com/Metaswitch/chronos/issues/43) * chronos crashes repeatedly while running call traffic (https://github.com/Metaswitch/chronos/issues/36) * Ralf security group allows access on TCP/11211 to *sprout* nodes. (https://github.com/Metaswitch/chef/issues/121) * Clearwater diags package should contain Cassandra `nodetool cfstats` (https://github.com/Metaswitch/clearwater-infrastructure/issues/62) * clearwater-diags-monitor should grab sar logs more frequently (https://github.com/Metaswitch/clearwater-infrastructure/issues/57) * clearwater-diags-monitor uses up too much I/O bandwidth (https://github.com/Metaswitch/clearwater-infrastructure/issues/55) * core files in diags packages should be automatically gzipped. (https://github.com/Metaswitch/clearwater-infrastructure/issues/42) * Diags package is missing useful files. (https://github.com/Metaswitch/clearwater-infrastructure/issues/41) * PJSIP TCP transport can report a TCP transport as failed when it is still active (https://github.com/Metaswitch/pjsip-upstream/issues/16) * Sprout crashed while stress testing with IMS (CFS) TAS configured (https://github.com/Metaswitch/sprout/issues/555) * If an OPTIONS request has a route header, don't absorb it in the options module (https://github.com/Metaswitch/sprout/issues/545) * Called-Party-Address AVP incorrect for I-CSCF Event Record (REGISTER) (https://github.com/Metaswitch/sprout/issues/539) * Homestead doesn't include ClearwaterRegData element on response to auth failure PUTs (https://github.com/Metaswitch/homestead/issues/102) * Chronos can attempt to send an Interim pop every 0 seconds (https://github.com/Metaswitch/ralf/issues/64) * Ellis web interface should explicitly declare Private Identities (https://github.com/Metaswitch/ellis/issues/44) To upgrade to this release, simply run "sudo clearwater-upgrade" on each node. If you have created your Clearwater deployment through the Chef automation system, you should also follow our "Updating the Chef server" instructions at https://github.com/Metaswitch/chef#updating-the-chef-server and then run "sudo chef-client" on each node. If you are deploying an all-in-one node, the standard image (http://vm-images.cw-ngv.com/cw-aio.ova) has been updated for this release. There are two new configuration options for sprout for the new Tel URI support, as per the spec. Add "enforce_user_phone = Y" and "enforce_globabl_only_lookups = Y" to etc/clearwater/config and run "sudo monit restart sprout" on each sprout node to turn on all the new functionality. Without the enforce_user_phone option turned on, user=phone will continue to be ignored on SIP URIs. Without the enforce_global_only_lookups option turned on, sprout will continue to attempt ENUM lookups for local numbers. Thanks, Graeme _______________________________________________ Clearwater mailing list [email protected] http://lists.projectclearwater.org/listinfo/clearwater _______________________________________________ Clearwater mailing list [email protected] http://lists.projectclearwater.org/listinfo/clearwater
