trixbox Pro FAQ

blovett
Posts: 234
Member Since:
2007-04-26

trixbox Pro Frequently Asked Questions

Where Do I Login to the Web Admin Panel?

Your tb Pro system is hybrid hosted so all users will login to the same web panel at:

http://cp.trixbox.com

If you get an error message stating your server cannot be reached over the internet right now then continue to read the next section "The trixbox Pro control panel thinks my server is offline".

The trixbox Pro control panel thinks my server is offline

This is usually caused by the following:

  1. The VPN tunnels to our data centers are not established correctly.

    a. The trixbox Pro system does not have a working internet connection. Ensure you can ping hosts outside of your network, for example: www.google.com, www.yahoo.com, 4.2.2.4. Try to ping your gateway address, does it work?

    b. DNS is not resolving the names of our VPN servers properly. If you can’t ping www.yahoo.com due to DNS not resolving names to IP addresses, this will cause the tunnels to not establish.

    c. Outbound traffic to our VPN servers is being blocked, see the trixbox Pro Installation Guide for information regarding what ports are required for the trixbox Pro system to operate properly.

  2. Asterisk is not running on your trixbox Pro system.

    a. Asterisk is having troubles initializing analog/T1/E1 cards. If you have changed settings recently, there is a chance that the settings did not apply correctly.

Why is my trixbox Pro install failing?

The trixbox Pro install could be failing for a number of reasons, including:

  1. Failed ISO download (verify the MD5 checksum).

    a. You can verify that the disk is correct by booting off the CD and at the GRUB boot prompt, enter “linux mediacheck”. When prompted, select “OK” to test the CD.

  2. Non-proven hardware. Please ensure that the system is listed on our Certified Hardware list, or at the very least meets our minimum system requirements. However even with hardware that meets the minimum requirements, you may still have troubles with the installation or activation.

My activation is failing, help!

In order for the trixbox Pro activation to succeed, your system must be connected to a network with internet access, and have at the minimum the following ports accessible to the outside: 53 UDP (DNS), 80 (HTTP), 8000 and 9000 TCP (VPN tunnels). When prompted for your activation username and password, you must enter the information that was e-mailed to you. Remember that the activation username will start with “tbadmin” followed by a 6 digit number (your server ID).

Activation can also fail if you are not running on hardware that meets our requirements. We strongly recommend the use of hardware on the Certified Hardware list, or at the very least hardware that meets our minimum system requirements.

My phone doesn’t work

Phone registrations could of course be failing for many reasons. However, these are the most common we see.

  1. Invalid credentials.

    a. Ensure you have entered the correct authorization username and password. If this is a certified phone (Polycom IP 501, 601, 4000 or Aastra 9112, 9133, 480i, and 480iCT), the system will automatically generate configuration files and place them onto your server. Simply set the boot server to the IP address of your trixbox Pro system, and reboot the phone!
    b. For uncertified phones, see the “Devices” section under “Extensions” on the trixbox Pro control panel for the authorization username and password.

  2. SIP registration host not reachable.

    a. Ensure that sXXXXXX.trixbox.fonality.com resolves to the correct internal IP address for your trixbox Pro system. We recommend that you use the trixbox Pro system as the primary DNS for the phones.

How do I set my root password?

When your trixbox Pro is activated, the root password is disabled to prevent any nefarious activity. If you want to shell into your system remotely, you will need to set the root password. You will need physical access to the system and have a keyboard and monitor attached.

  1. Log into your trixbox Pro from the console using username ‘ip’ and password ‘ip’.
  2. Select option 11.
  3. Enter your desired password.

How Do I Reconfigure My Phone?

Sometimes phones do not have configuration information; there can be a many reasons why. Some common reasons are 1) the phone is new or 2) you were playing around with some cool features on the phone and accidentally reset something you shouldn't have. In any case there is one way to reload the default configuration files for your phones.

  1. Generate configuration file information for your phone.

    To do this do the following:

    1. Access the Extensions->view extensions page of your web interface.
    2. Click the extension you wish to generate files for.
    3. Verify the correct MAC address is being used in the "phones/devices" field.
    4. Click "Update" to update that extension.

    This will generate configuration files for this phone.

  2. Get the IP address of your tb Pro

    There are a few ways to do this

    1. ping sNNNNNN.trixbox.fonality.com, this should resolve to your internal IP address.
    2. Login as username "ip" and password "ip" and select the option "Show the IP address of this system". The IP address is next to the words "inet addr:"

      inet addr:192.168.15.201

    3. Type "ifconfig" on the command line. You'll see similar output to above.
  3. If you have an Aastra phone

    This guide is for Aastra firmware version 1.4.2, other versions may vary slightly. Make sure these steps are performed while the phone is on the same LAN as the tb Pro.

    1. Browse to the IP address of the phone
    2. Login with the username and password "admin" and "22222", respectively.
    3. Select "Configuration Server" from the web interface.
    4. Enter the IP address of your tb Pro system in the "TFTP Server" field.
    5. Make sure the "Protocol" is set to "TFTP".
    6. Click "Save Settings"
    7. Restart your Aastra phone when prompted.
  4. If you have a Polycom phone

    For the firmware version 1.6.4 you cannot set the configuration server in the web interface - but you can do this one the phone itself. Make sure these steps are performed while the phone is on the same LAN as the tb Pro.

    1. Press the "Menu" hardkey.
    2. Select the "Settings" option.
    3. Select the "Advanced" option.
    4. Enter the password "456".
    5. Select the "Admin Settings" option.
    6. Select the "Network Configuration" option.
    7. Select the "Server Menu" option.
    8. Change "Server Type" to "TFTP" and save.
    9. Change "Server Address" to the IP of your tb Pro and save.
    10. Hit the "Exit" softkey until prompted to reboot.

My phones are not displaying the correct time!

This can of course be caused by a number of things, however these are the reasons we most frequently see:

  1. The phone has the incorrect GMT offset defined. See our wiki article “How To Set a Time Zone on Your Phones and Server”.
  2. The phone can not reach a valid NTP server.

    a. Your trixbox Pro system runs a NTP server which can be used by your phones to obtain the correct time. Sometimes, however the server loses sync, and stops providing any time source. When this happens, ensure that your trixbox Pro system is able to make outbound connections to other time servers over UDP port 123. If your phones do not have a valid NTP server defined, either set them to use sXXXXXX.trixbox.fonality.com (or your systems internal IP address), or use an external NTP server such as tick.ucla.edu.

    b. Ensure that your phones are able to connect to hosts outside of your network over UDP port 123.

My trixbox Pro is not displaying the correct time.

If your trixbox Pro system is reporting the incorrect time (off by 2 hours for example). If for instance the time stamp on any voicemail that is left is incorrect, it’s possible that the time zone isn’t set correctly on your system. See our wiki article “How To Set a Time Zone on Your Phones and Server”. You may find that you need to initiate a trixbox Pro reset after changing the time zone before it records the correct time. To perform a reset, log into your trixbox Pro control panel, and go to “Options”, and then “reset server”. Select the choice that best applies, for instance “Reset — Idle”.


How do I configure a Cisco 7960 to work with trixbox Pro?

Kerry has just written a Wiki page for this. Please visit: http://help.trixbox.com/index.php/Cisco_7960_Setup_Guide

How do I configure a Cisco 7971 to work with trixbox Pro?

trixbox Pro always sets the default nat setting for an extension to be 1, while this should work with pretty much every phone out there, this does not seem to work with the Cisco 7971. No combination of nat settings in the Cisco configuration file seem to be able to get past this like you can on a Cisco 7960. If someone figures out some other setting that will get it to work, please let us know.


How secure is my trixbox Pro system?

This depends. If you have it protected behind a firewall than it should be fairly secure, however if you have ports like 22 for SSH open than it is still vulnerable to brute force password attacks. The best way to protect against this is to use very difficult to crack passwords. Do NOT use any dictionary word as this will virtually always end up in a hacked system. Use long passwords with a combination of upper and lower case, numbers, and symbols. So 'password' is probably a bad choice but My_HaRd-:Pazzw0rd345 would be much better.

How Do I Dial Outside Numbers Without A 9

  1. 10 digit numbers are automatically corrected.

    If you dial a ten digit number without a 9 (example: 877-366-2548) then the tb Pro system will automatically correct this and add a "9". This means all 10 digit numbers without a 9 will follow the dialplan of a 10 digit number with a 9.

  2. Make sure there is a dialplan in your IP phone as well.

    Your IP phone will need to know it's ok to dial without a 9 as well. You will need to add a dialplan string to your dialplans (also called digitmap) for you phones. A good example for Polycom phones is:

    [2-9]XXXXXXXXX

    Make sure you are *adding* this to your dialplans - not replacing everything that's there! If you'd like more information read the administrator guide for your phone (most are online):

    Phone Manuals

    or reference this thread:

    Dial 9 To Get Out


Please see trixbox.com for more FAQ’s!