SIP SIMPLE Client SDK

Sip settings » History » Revision 29

Revision 28 (Adrian Georgescu, 07/13/2010 03:10 PM) → Revision 29/30 (Adrian Georgescu, 07/13/2010 03:12 PM)

== sip-settings == 

 [[TOC(SipTesting*, sip_*, xcap_*, depth=2)]] 

 > This script is available in ''sipclients'' package that must be installed separately from SIP SIMPLE client SDK package. 

 === Description === 

 Manages the configuration used by the middleware and Command Line Tools.  

 For the complete lists of settings that can be managed see    [wiki:SipConfigurationAPI#MiddlewareSettings Middleware Settings] and [wiki:SipConfigurationAPI#SIPClientsSettings SIP Clients Settings] [wiki:SipConfigurationAPI Configuration API] 

 {{{ 
 adigeo@ag-imac3:~$sip-settings  
 Usage: sip-settings [--general|--account] [options] command [arguments] 
        sip-settings --general show 
        sip-settings --general set key1=value1 [key2=value2 ...] 
        sip-settings --account list 
        sip-settings --account add user@domain password 
        sip-settings --account delete user@domain|ALL 
        sip-settings --account show [user@domain|ALL] 
        sip-settings --account set [user@domain|ALL] key1=value1|DEFAULT 
        sip-settings --account default user@domain 

 This script is used to manage the SIP SIMPLE middleware settings. 

 Options: 
   -h, --help              show this help message and exit 
   -c FILE, --config-file=FILE 
                         The path to a configuration file to use. This 
                         overrides the default location of the configuration 
                         file. 
   -a, --account           Manage SIP accounts' settings 
   -g, --general           Manage general SIP SIMPLE middleware settings 
 }}} 

 To use the command line tools you must create at least one SIP account: 

 {{{ 
 sip-settings --account add user@domain password 
 }}} 

 You can make an account the default account for outgoing calls with: 

 {{{ 
 sip-settings -a default user@domain 
 }}} 

 Individual settings for the account can be set with: 

 {{{ 
 sip-settings -a set user@domain key=value 
 }}} 

 To see which per account settings are available, use: 

 {{{ 
 sip-settings -a show 
 }}} 

 The settings are organized in a hierarchy. Use dotted notation for the keys.  
 For instance, the outbound_proxy setting in the sip group is written  
 sip.outbound_proxy. Use the dotted form in the command-line: 

 {{{ 
 sip-settings -a set user@domain sip,outbound_proxy=proxy.sipthor.net 
 }}} 

 Global settings are arranged the same way; for instance, to change the global  
 outbound ringtone: 

 {{{ 
 sip-settings -g set sounds.audio_outbound=/path/to/wav 
 }}}