Man pages sections > man8 > osipsconsole

osipsconsole - utility for provisioning OpenSIPS

osipsconsole(8) OpenSIPS osipsconsole(8)

NAME

osipsconsole - utility for provisioning OpenSIPS

SYNOPSIS

osipsconsole
 
osipsconsole command [ parameters ]
 

DESCRIPTION

osipsconsole is a console like utility for provisioning OpenSIPS SIP server. It can be used to manage users, domains, aliases and other server options. If command arguments are passed it will work in non-interactive mode, and behave as old opensipsctl and opensipsdbctl tools. If no arguments are passed, it behaves as a console - you will get a prompt, and can run the available commands, with embedded help and command history -.
 

FILES

/etc/opensips/osipsconsolerc
 
~/.osipsconsolerc
 
 

COMMANDS

help
Displays a short usage description, including all available options.
 
Command 'online' - dump online users from memory
online
display online users
 
Command 'monitor' - show internal status
monitor
show server's internal status
 
Command 'ping' - ping a SIP URI (OPTIONS)
ping <uri>
ping <uri> with SIP OPTIONS
 
Command 'ul|alias' - manage user location or aliases
ul show [<username>]
show in-RAM online users
ul show --brief
show in-RAM online users in short format
ul rm <username> [<contact URI>]
delete user's usrloc entries
ul add <username> <uri>
introduce a permanent usrloc entry
ul add <username> <uri> <expires>
introduce a temporary usrloc entry
 
Command 'start|stop|restart'
restart
restart OpenSIPS
start
start OpenSIPS
stop
stop OpenSIPS
 
Command 'tls'
tls rootCA [<etcdir>]
creates new rootCA
tls userCERT <user> [<etcdir>]
creates user certificate default <etcdir> is /usr/local/etc/opensips/tls
 
Command 'acl' - manage access control lists (acl)
acl show [<username>]
show user membership
acl grant <username> <group>
grant user membership (*)
acl revoke <username> [<group>]
revoke user membership(s) (*)
 
Command 'cr' - manage carrierroute tables
cr show
show tables
cr reload
reload tables
cr dump
show in memory tables
cr addrt <routing_tree_id> <routing_tree>
add a tree
cr rmrt <routing_tree>
rm a tree
cr addcarrier <carrier> <scan_prefix> <domain> <rewrite_host>
[<prob>] [<strip>] [<rewrite_prefix>] [<rewrite_suffix>] [<flags>] [<mask>] [<comment>] add a carrier
cr rmcarrier <carrier> <scan_prefix> <domain>
rm a carrier
 
Command 'rpid' - manage Remote-Party-ID (RPID)
rpid add <username> <rpid>
add rpid for a user (*)
rpid rm <username>
set rpid to NULL for a user (*)
rpid show <username>
show rpid of a user
 
Command 'add|passwd|rm' - manage subscribers
add <username> <password>
add a new subscriber (*)
passwd <username> <passwd>
change user's password (*)
rm <username>
delete a user (*)
 
Command 'add|dump|reload|rm|show' - manage address
address show
show db content
address dump
show cache content
address reload
reload db table into cache
address add <grp> <ip> <mask> <port> <proto> [<context_info>] [<pattern>]
add a new entry address rm <grp> <ip> <mask> <port> remove all entries for the given grp ip mask and port
 
Command 'dispatcher' - manage dispatcher
dispatcher show
show dispatcher gateways
dispatcher reload
reload dispatcher gateways
dispatcher dump
show in memory dispatcher gateways
dispatcher addgw <setid> <destination> <flags> <description>
add gateway
dispatcher rmgw <id>
delete gateway
 
Command 'db' - database operations
db exec <query>
execute SQL query
db roexec <roquery>
execute read-only SQL query
db run <id>
execute SQL query from $id variable
db rorun <id>
execute read-only SQL query from $id variable
db show <table>
display table content
 
Command 'speeddial' - manage speed dials (short numbers)
speeddial show <speeddial-id>
show speeddial details
speeddial list <sip-id>
list speeddial for uri
speeddial add <sip-id> <sd-id> <new-uri> [<desc>]
add a speedial (*)
speeddial rm <sip-id> <sd-id>
remove a speeddial (*)
speeddial help
help message
 
Command 'avp' - manage AVPs
avp list [-T table] [-u <sip-id|uuid>] [-a attribute] [-v value] [-t type]
list AVPs
avp add [-T table] <sip-id|uuid> <attribute> <type> <value>
add AVP (*)
avp rm [-T table] [-u <sip-id|uuid>] [-a attribute] [-v value] [-t type]
remove AVP (*)
avp help
help message
 
Command 'alias_db' - manage database aliases
alias_db show <alias>
show alias details
alias_db list <sip-id>
list aliases for uri
alias_db add <alias> <sip-id>
add an alias (*)
alias_db rm <alias>
remove an alias (*)
alias_db help
help message
 
Command 'domain' - manage local domains
domain reload
reload domains from disk
domain show
show current domains in memory
domain showdb
show domains in the database
domain add <domain>
add the domain to the database
domain rm <domain>
delete the domain from the database
 
Command 'fifo'
fifo
send raw FIFO command
 
Command 'dialplan' - manage dialplans
dialplan show <dpid>
show dialplan tables
dialplan reload
reload dialplan tables
dialplan addrule <dpid> <prio> <match_op> <match_exp> <match_len> <subst_exp> <repl_exp> <attrs>
add a rule
dialplan rm
removes the entire dialplan table
dialplan rmdpid <dpid>
removes all the given dpid entries
dialplan rmrule <dpid> <prio>
removes all the given dpid/prio entries
 
Command 'unixsock'
unixsock
send raw unixsock command
 
Command 'droute'
dr gateway add <address=address_param> [<type=type_param>] [<strip=strip_param>] [<pri_prefix=pri_prefix_param>] [<description=description_param>]
adds new route
dr gateway rm <gwid=gwid_param>
removes route
dr gateway list <type=type_param>
lists route(s)
dr gateway list <address=address_param>
lists route(s)
dr gateway list
lists all routes
dr gateway h
droute help
dr rules add <gwlist=gwlist_param> [<groupid=groupid_param>][<prefix=prefix_param>] [<timerec=timerec_param>][<priority=priority_param>][<routeid=routeid_param>][<description=description_param>]
adds new rule(s)
dr rules rm <ruleid=ruleid_param>
removes rules
dr rules list
lists rules(s)
dr rules list <gwlist=gwlist_param>
lists rules(s)
dr rules list <groupid=groupid_param>
lists rules(s)
dr rules h
dr rules help
dr h
dr help
 
Databases management:
db create <db name or db_path, optional>
creates a new database
db presence adds the presence related tables
db extra
adds the extra tables
db migrate <old_db> <new_db>
migrates DB from 1.5 to 1.6
db drop <db name or db_path, optional>
!entirely deletes tables!
db reinit <db name or db_path, optional>
!entirely deletes and than re-creates tables!
db backup <file>
dumps current database to file
db restore <file>
restores tables from a file
db copy <new_db>
creates a new db from an existing one
 
Berkeley DB tables management:
bdb | db_berkeley list
lists the underlying db files in DB_PATH
bdb | db_berkeley cat <db>
db_dump the underlying db file to STDOUT
bdb | db_berkeley swap <db>
installs db.new by db -> db.old; db.new -> db
bdb | db_berkeley append <db> <datafile>
appends data to an existing db;output DB_PATH/db.new
bdb | db_berkeley newappend <db> <datafile>
appends data to a new instance of db; output DB_PATH/db.new
bdb | db_berkeley export <dump_dir>
exports table data to plain-txt files in dump_dir
bdb | db_berkeley import <dump_dir>
imports plain-txt table data and creates new db tables in db_path
 
 
 

NOTES

Commands labeled with (*) will prompt for a MySQL password. If the environment variable PW is set, the password will not be prompted.
IP addresses must be entered in dotted quad format e.g. 1.2.3.4
 

AUTHORS

see /usr/share/doc/opensips/AUTHORS
This manual page was written by Alejandro Rios P. <alerios@debian.org>, based on opensipsctl manpage by Bogdan-Andrei Iancu <bogdan@opensips.org>, for the Debian project (and may be used by others).
 

SEE ALSO

opensips(8),opensips.cfg(5),opensipsctl(8),osipsconfig(8)
Full documentation on opensips is available at http://www.opensips.org/.
Mailing lists:
users@lists.opensips.org - opensips user community
devel@lists.opensips.org - opensips development, new features and unstable version
22.11.2009 opensips-console