Single most important tip is to look in the log file. See Logging for log information and how to change the log level

An internal error has occurred. Click here to continue.

Look in the /var/log/sipxpbx/sipxconfig.log for more information. TIP: Brief error is also on the page if you turn style sheet off or view page source, but complete error should be in sipxconfig.log file

Only see Apache Test Page

If you have apache preinstalled, chances are it's setup to start when your system starts which causes a conflict when sipXpbx starts. You'll know this if you the apache test page.

You can check this by running this command:

it should return

If any read "on", then

Cannot log into Web Admin UI

Postgresql server not running or missconfigured

TEST: Try logging into postgres from client

SOLUTION Start postgres.

If postgres is running and you just want to clear all configuration information

If you suspect your database is corrupt, you can reinitialize postgres with the following commands:

Forgot superadmin password

SOLUTION:: You can always reset superadmin password to blank, log in then immediately change the password to a new value.

 /etc/init.d/sipxconfig reset-admin
 

You can run this while PBX is still running.

I changed my REALM and users cannot log in

In short, you cannot change your realm, however here are some commands to help you test PINs from the command line. PINs are not stored in the postgres DB for security reasons. Only a hashcode is stored to validate PINs. If you want to test a PIN from the command line, try this command.

For your values of username , password , and realm, the following values must match:

TIP: If you know basic SQL, it would be relatively easy to write a shell script to reset all passwords to the same value. Better still, if you have access a list of passwords for each user in a text file, you could also write a shell script that sets each pintoken for each user.

SipXconfig won't start

Verify the processes status:

SipXconfig is represented by: "ConfigServer"=>"Running"
You can try starting sipXconfig alone by using
./sipxconfig.sh

For any possible error you can check /var/log/sipxpbx/sipxconfig.log

General failure to start server

TEST: Look for string

in

SOLUTION Stop sipXpbx service. Start sipXconfig from console by running

In 3.4

In 3.2 or older:

You should see an error somewhere in the console.

TEST: Look in

/var/log/sipxpbx/sipxconfig.log

for error messages.

SOLUTION As indicated by the messages.

org.postgresql.util.PSQLException: The connection attempt failed.

An error such as below appears in the console when you run sipxconfig.sh:

One thing that could be causing this error is if postgres is using IPv6 when it binds to "localhost". This is very common on Fedora Core 6 / Debian Etch (and probably other 2.6 kernel distros) as they enable IPv6 by default. The best way to solve this problem is by disabling IPv6 completely and editing your hosts file, however if your network is using IPv6 you might be able to get away with just editing your /etc/hosts file.

CHECK: If you see ::1 in your /etc/hosts file and not 127.0.0.1 then this is likely the source of your problems.

should be

use your favorite editor to make this change and then restart postgres

if this is your first time trying to run the sipxconfig then you will need to drop and create the database since that failed the first time sipxconfig.sh tried to do it.

If this does not solve the problem then you may need to disable IPv6 completely. These instructions for Fedora Core 6 should work well for other distro's with some tweaking.

Phones failed to restart

After projecting profiles, Cisco phones should restart. Try restarting phones manually.

TFTP server not started or misconfigured

TEST: Try to download from from your TFTP server. You may need to install tftp client software and your tftp client may have slightly different command syntax

SOLUTION: Walk through installation notes for TFTP server installation and look in /var/log/messages for TFTP error messages.

Convenient Commands

• To take a quick backup of the database

  pg_dump -U postgres -F t SIPXCONFIG | gzip --best > sipxconfig.tar.gz

• To restore from a quick database

  sipxconfig.sh --database drop
  createdb -U postgres --encoding=UNICODE SIPXCONFIG
  zcat sipxconfig.tar.gz | pg_restore -U postgres -d SIPXCONFIG

Using Wireshark to see inside the box

• Decrypting the SSL
  sipXconfig uses HTTPS, which in turn uses SSL encryption to hide the details of the transaction from prying eyes. But that can be a pain for developers who want to figure out exactly what is happening. The WireShark network protocol analyzer has the ability to decrypt the SSL communications if given the appropriate keys. The documentation for how to do that is here under "Preference Settings", and below is an example that should work for sipXconfig. In the WireShark "Preferences" pane, under SSL, there is an "RSA keys list" text box (Edit->Preferences->Protocols->SSL->RSA keys list. Fill it out thusly:

  {sipxconfig ip addr},8443,http,{prefix}/var/sipxdata/certdb/{host}.{domain}.key

  Then, after capturing packets between a client and sipXconfig, highlight one of the packets to port 8443, right-click to bring up the menu, and select "Decode As...", then select SSL. Then, right-click again and the option "Follow SSL Stream" should now be enabled. Select that, and enjoy seeing inside the box.