Reloading
Introduction
When is a reloadxml sufficient for "reloading and moving on"? This can be a tricky question. Sometimes reloading XML is sufficient. Sometimes more is needed.
Discussion
When making updates in FreeSWITCH it is frequently necessary to "reload" in order for the changes to take effect. Sometimes you need to issue just the reloadxml command, as with updating XML dialplan files. However, there are times when you need to do something in addition to reloading XML. Further complicating matters, there are some commands that will execute a reloadxml on your behalf so that you don't explicitly have to issue two commands!
Below is a list of items that require various types of reloading. (If you see something that isn't on this list then by all means add it if you know it.) For example, it mentions the reloadacl command. The reloadacl command performs a reloadxml for you and then updates the ACLs in the system. Also, the reload <module_name> command now performs a reloadxml for you as well. (This was added in mid 2012 and it available on all recent versions of FreeSWITCH.)
Reload List
| Item | Reload Command | Notes |
|---|---|---|
| XML Dialplan | reloadxml | Run each time you edit XML dial file(s) |
| ACLs | reloadacl | Edit acl.conf.xml first |
| Voicemail | reload mod_voicemail | Edit voicemail.conf.xml first |
| Conference | reload mod_conference | Edit conference.conf.xml first |
| Add Sofia Gateway | sofia profile <name> rescan | Less intrusive - no calls dropped |
| Remove Sofia Gateway | sofia profile <name> killgw <gateway_name> | Less intrusive - no calls dropped |
| Restart Sofia Gateway | sofia profile <name> killgw <gateway_name>sofia profile <name> rescan | Less intrusive - no calls dropped |
| Add/remove Sofia Gateway | sofia profile <name> restart | More intrusive - all profile calls dropped |
| Local Stream | see Mod_local_stream | Edit localstream.conf.xml first |
| Update a lua file | nothing necessary | file is loaded from disk each time it is run |
| Update LCR SQL table | nothing necessary | SQL query is run for each new call |
| Update LCR options | reload mod_lcr | Edit lcr.conf.xml first |
| Update CID Lookup Options | reload mod_cidlookup | Edit cidlookup.conf.xml first |
| Update JSON CDR Options | reload mod_json_cdr | Edit json_cdr.conf.xml first |
| Update XML CDR Options | reload mod_xml_cdr | Edit xml_cdr.conf.xml first |
| Update XML CURL Server Response | nothing, unless using cache |