POSTS
PORTFOLIO
SEARCH
SHOP
  • Your Cart Is Empty!
1947 Evans Road Cary, NC 27513 +1 (919) 443-1617
QuBe PBX Command Line Tools
Questions about GUI modules or functionality? Follow this link to check out a collection of helpful information for the QuBe's GUI!
admin_fix_groups
admin_fix_groups will attempt to reestablish permissions for User Groups created in 
Admin->User Groups in the GUI. This is a useful command if you ever find a situation in which your users don't have the permissions they're supposed to.
admin_post_update
admin_post_update will check for any changes made in the GUI (more specifically Asterisk-related than what admin_fix_groups addresses) and apply them to the real-time database that controls call flow.
In more specific terms, this command creates new migrations that can later be applied, migrations being a Django concept (link opens in new window).
  • Text Hover
admin_reload_silent
admin_reload_silent is identical to admin_sys_reload but it writes any output on stdout or stderr to a logfile contained at /var/log/guiserver/reload.log.

see admin_sys_reload for more detailed information
  • Text Hover
admin_reset
admin_reset will reset the password for pbxadmin. Useful in case you are unable to get back into the GUI as pbxadmin.
  • Text Hover
admin_restore_backup
admin_restore_backup will clear any and all databases, sounds, and MOH on from the system before restoring from a local copy (created from Config->Backup and Restore). In case you ever run into issues that prevent you from being able to restore a backup on the GUI side, you can run it here.

WARNING: This command is from an older version of the QuBe and has not been updated. Thus, it is important that you do not run this command currently, as it will not correctly handle vital database creation and restoration! This will render your QuBe INOPERABLE
  • Text Hover
admin_restore_silent
admin_restore_silent is identical to admin_restore_backup, but will write all final pending stdout and stderr results to a log at /var/log/guiserver/restore.log

WARNING: This command is from an older version of the QuBe and has not been updated. Thus, it is important that you do not run this command currently, as it will not correctly handle vital database creation and restoration! This will render your QuBe INOPERABLE
  • Text Hover
admin_set_hosts
admin_set_hosts provides a small, simple TUI that allows you to add hosts for the QuBe to listen on. This is one of the commands run during the qube_init.sh script.

If you are unable to access your QuBe and it instead returns a "400 Bad Request" error, likely you do not have the domain you're trying to access it as listed as an allowed host to listen for with NGINX (for instance, you set up a DNS to pbx.mydomain.net, and it resolves properly to the QuBe but the QuBe returns 400). Adding the host as a custom host in admin_set_hosts and then running admin_sys_reload will fix this issue. It is also equivalent to adding an Allowed Host in Administration->System Settings
  • Text Hover
admin_shrink_syslog
admin_shrink_syslog will work to free up hard drive space by clearing system logs from the QuBe's database. 

Because of the nature of database shrinking, this command will fail if you attempt to run it with not enough free hard drive space, so be sure to run it before space gets critical or entirely used!
  • Text Hover
admin_sys_reboot
admin_sys_reboot will restart the whole server, logging any events in stdout or stderr to /var/log/guiserver/reload.log
  • Text Hover
admin_sys_reload
admin_sys_reload is a fairly comprehensive command that will tackle several tasks in succession. It will restart or reload several different management services (e.g. Asterisk, NGINX, supervisord), as well as make and apply any migrations. Additionally, it will collect any static files pending on the system as well (static files are another Django concept - link opens in new window). On top of that, it will see if there are any updates due for the python virtual environment or its component parts, and apply them. Any issues or results with individual processes run by this command will output to /var/log/guiserver/reload.log.

This is a very good first command to run if you ever experience small general issues with the QuBe. It does well at removing any bad cached data or call flow, and resetting resource usage. Additionally, it only reloads Asterisk, so it is safe to run during active calls.
  • Text Hover
admin_sys_start
Essentially one half of admin_sys_reload, this will start the supervisor services that admin_sys_reload restarts.

Keep in mind though, this command does not do anything with migrations, nor does it attempt to collect static files, unlike admin_sys_reload
  • Text Hover
admin_sys_stop
The other half of admin_sys_reload, this will stop the supervisor services that admin_sys_reload restarts.

Keep in mind though, this command does not do anything with migrations, nor does it attempt to collect static files, unlike admin_sys_reload. Additionally, this command stops Asterisk, so it is not safe to run during normal call hours.
  • Text Hover
admin_tls_certs
admin_tls_cert will create a new set of TLS certificates for the server. These can then be installed on phones connected to the system, and the phones set up for TLS communication. This is similar to the "Generate TLS certificate/Recreate certificate" (depending on whether or not you have certs already generated) in the "SIP TLS Configuration" submenu under 
Config->Channel SIP Settings

Please note that this neither enables TLS, nor does it configure individual extensions to communicate on TLS. Those settings are changed in the GUI.
  • Text Hover
admin_trust_net
admin_trust_net is a limited TUI version of Config->Firewall in the QuBe interface. From here, you are able to add IP addresses or IP ranges to the QuBe's firewall, as well as trust or untrust interfaces. This is one of the commands run during the qube_init.sh script.

Warning: Trusting an interface is functionally identical to turning off the firewall for that particular internet connection. This can be useful, but very unsafe for the QuBe if misused! Make sure any public facing interfaces that aren't protected by any outside security software or equipment are untrusted!
  • Text Hover
admin_update_silent
admin_update_silent checks for any pending updates for the QuBe from its repositories. Any results on stdout or stderr are printed out to /var/log/guiserver/reload.log.

After an update attempt, the system will then run admin_sys_reload. This is similar to, but distinct from, running "Update All" in Administration->Updates: admin_update_silent only updates the qube-utils, qube-management-server, and qube-pbx-asterisk-config packages. qube-astgui2, qube-common, and qube-repo will remain untouched. Good in case you have any issues with the GUI and want to see if an update can fix it.
  • Text Hover