HUD FAQ

1. I cannot get *any* local HUD clients to connect.

First off, this question is *only* for folks who cannot get *any* local HUD clients to connect. If you *are* able to get local to connect, but are *not* able to get telecommuter to connect, then this is the *wrong* answer for you. Also, if you *are* able to get *some* local but not *all* local, then this is the wrong answer for you.

So, if you qualify for the above to items, then read on:

1. Make sure you are using a valid username and password.

   Do not use the administrator information to login to HUD. This will not work!

   Each extension on your tb Pro server has an web username and web password. The web username and web password are what you should use to login to HUD. If you do not know the web username and web password for a particular extension do the following:

   In the Web Admin Panel...

   1. Login to the tb Pro admin panel at cp.trixbox.com
   2. Select the "Extensions" tab and "view extensions" option.
   3. Click the extension you wish to use in HUD
   4. Update the "web username" and "web password" fields to the username/password you desire.
   5. Click apply all changes

      On your computer...

   6. Open the HUD client
   7. Select the "File" menu and "Settings" option.
   8. Click the "Connections" tab
   9. Enter your web username and password.
   10. Click Apply

   What is my "Server Password"?

   The server password is a unique credential for your instance of the HUD Server. It is required information for all HUD Clients to connect to the HUD Server. Here is how you locate your "Server Password":

   1. Connect to your trixbox Pro via SSH
   2. run the command 'ps aux | grep hudlite' - The password will appear as an argument to the HUD server process. Here is an example:
      
      [root@trixbox117272 ~]# ps aux | grep hud
      root 3617 0.0 10.1 55644 50564 ? SNs Mar27 8:10 ./hudlite-server 6NckWkxvi
      [root@trixbox117272 ~]#
      

   3. If you have HUD Pro your hud process will be called 'saxirx'. You will need to run the command ps aux | grep saxirc instead. The password will appear in the same fashion as above:
      
      [root@trixbox117272 ~]# ps aux | grep hud
      root 3617 0.0 10.1 55644 50564 ? SNs Mar27 8:10 ./saxirc 6NckWkxvi
      [root@trixbox117272 ~]#
      
      The "Server Password" in both of the above example is 6NckWkxvi

   You can now set your "Server Password" in your HUD Client using the password that you retrieved from the command line.

2. Is the HUD(pro/lite) server installed?

   A very small number of customers did not get HUD installed on their tb Pro system. If you were in this group users we attempted to update your server. If you were offline when we tried to install HUD then you may still not have HUD installed on your system.

   SSH to your trixbox Pro system (or connect via the console if you are local), then type:

   
   [root@trixbox ~]# ls /usr/local/fonality/hud/
   

   If you see "hudlite-server" or "saxirc" among the listed files then you have HUD(pro/lite) installed.

   If you see

   
   ls: /usr/local/fonality/hud/: No such file or directory
   

   Then you do not have HUD installed. There are two ways to remedy this problem:

   1. Reactivate your tb Pro system

      A reactivation should install HUD correctly. Make sure you identify that HUD is not installed before reactivating!

   2. If you have a support contract - submit a ticket

      If you have a support contract with Fonality submit a ticket stating HUDlite was not installed.

3. Is the HUD(pro/lite) server (daemon) running?
   SSH to your trixbox Pro system (or just connect via the console if you are local). Then type:

   pgrep "hudlite|saxirc"

   If you see a number come back then HUD(pro/lite) is running and the returned number is the process ID.

   If you don’t, then your HUD(pro/lite) server (daemon) is *not* running. This means that none of your HUD(lite/Pro) clients will ever be able to connect!

   OK, how to do I start HUD(pro/lite) manually?
   First off, you shouldn’t ever have to start HUD manually. It should originally start when you activate your server, and should automatically restart whenever you reboot. Then, even if it doesn’t, astwatch.pl (the trixbox Pro premise monitoring system) should be trying to start it every minute or so. What we mean by this is: if the HUD server is not running on your box, you may have a larger issue. But, anyway, here is how you start the HUD server manually:

   1. Start HUD(pro/lite) via astwatch.pl

      First see, if astwatch is running. You can figure this out by typing:

      ps awx | grep astwatch

      You should see something back like:

      30412 ? SN 1:23 /var/adm/bin/astwatch.pl

      If you don’t, this is *not* good. You have two choices. 1) be nice and let us know on this forum (so we can diagnose your box *live* with the problem and help out many other users in the process) or 2) be mean and start it yourself by typing:

      /var/adm/bin/astwatch.pl

      The tb Pro premise monitoring system should be checking to see if HUD is running about every 30 seconds (by default.) If HUD is not running and you want to force the monitoring system to check for HUD right away you can stop and start the process by running this command:

      killall astwatch.pl; /var/adm/bin/astwatch.pl

      Then check again to see if the HUD process has started. If not proceed to the next step.

   2. Start HUD(pro/lite) Directly

      You can try and start the process manually, however, if you have gotten this far and it still is not running you may have a larger problem - we hope by now you have posted on the forums so we can help you!

      HUDlite

      Run this command to start the HUDlite server manually.
      cd /usr/local/fonality/hud ; nice -n 19 ./hudlite-server `cat auth.cfg`

      HUDpro

      Run this command to start the HUDpro server manually.
      cd /usr/local/fonality/hud ; nice -n 19 ./saxirc `cat auth.cfg`
      

   3. Is the IRC server (daemon) running?
      Running HUDlite requires both the HUDlite server and the IRC server to be running. So, let’s now check if your IRC server is running:

      ps awx | grep ircd

      You should see something back like:

      4539 ? Ss 0:01 /usr/local/ircd/bin/ircd

      If you don’t, then again astwatch.pl should have started it and you may have a larger problem. Please report to this board before fixing so we can see what is going on (perhaps this is a global or non-isolated case). But, if you cannot wait, then start your IRC server yourself by typing:

      cd /usr/local/ ; /bin/su ircd -c /usr/local/ircd/bin/ircd

   2. I am remote and can’t connect *any* of my HUD(lite/Pro) clients

   You might be having remote HUD connectivity issues for a number of reasons, including:

   1. Port 6600 (TCP/IP) is not open
      You need to open port 6600 (TCP/IP) on the router that your trixbox Pro server sits behind. You can verify that this port is in fact open correctly, when remote, by typing (e.g. from a dos prompt):

      telnet s[server_number]x.trixbox.fonality.com 6600

      Of course don’t actually type “server_number”. This means that if your server_number was 110345 you would actually type:

      telnet s110345x.trixbox.fonality.com 6600

      If your remote telnet client does *not* connect, then your remote HUD client will *not* connect either. Get your port opened and try again!

   2. You are not using the "x" in your HUD(lite/Pro) client settings
      You must be using the "x" in the connection settings of your HUD client when you are remote. How to enable this? In your HUD (client) under File->Settings->Connection->Server Name you must add an "x" after the server number. So for instance if your Server Name is currently set to: "s110345.trixbox.fonality.com" you need to (when going remote) change it to: "s110345x.trixbox.fonality.com". BTW, Our next release of HUD will automatically connect when remote. So, when it comes out you won't have to add that "x" anymore.

   3. Most clients connect, but one will not

   1. ”In HUD” = yes?

      Go into your Admin Panel. Click on “Extensions”. Then click on the extension you are trying to get connected to your HUD(lite/Pro) client. Is “In HUD” set to “yes”? It needs to be.

   Unable to log in any local client to HUD ›
   --
   

   Chris Lyman
   Fonality CEO / Janitor
   My new CEO / Janitor blog