Troubleshooting Web UI and XML issues on Director


Article ID: 167146


Updated On:




Known issues if the UI won't launch:

  • No special characters are allowed in the password. Characters like "?%+" are not allowed.
  • Verify whether all required services are running.  For the console to successfully launch, the following Linux daemons must be running: Tomcat, Postgres, and Apache. 
  • You can also use the "monitoring db reset force"  followed by reload of director. This will reinitialize the database.  For details on how to use the CLI, see 000014637

A: Checking that the Tomcat, Postgres, and Apache services are running:

To determine if these services are running you will need to use SSH to login to Director. Director is based on the popular open source operating system Linux and consequently runs most Linux commands. One such command  that allows you to check a status on a demon is the command "ps - aux." Running this command, you should see an output, simliar to those below, if the three services are running properly. If you don't see them in the list, they are not running.

To login, using SSH, follow these steps.

Open a SSH session to to the Director box. .

  • Enter the enable mode by following the steps.
    • director > enable
    • Password:
    • director #
  •  Enter the configuration mode, by following these steps.
    • director # config t
    • director (config) #  
  • Enter the shell command.
    • director (config) # "shell."
  • Here you have access to most LINUX commands.
  • At the prompt., enter the "ps aux" command

The below screenshot shows what the output would looklike for the Postgres, and Apache daemons.

To narrow down your searches, use this syntax.

  • For Apache, use "ps aux | grep httpd "
  • For Postgres, use "ps aux |grep postmaster"

 The bellow screenshot is the output from a "ps aux" command looking for the Tomcat daemon.

  • To narrow down your search, you can  use the "ps aux |grep tomcat" command

Finding the process IDs.

Often, to check on the status of a daemon in Linux, you need to find the process ID. To find a process ID you use the pgrep command. For more information on the pgrep command, see pgrep.

  • Use "pgrep postmaster"  to find the Postgres service ID.
  • Use "pgrep java" to find the Tomcat service ID.
  • Use "pgrep httpd" to find the Apache service ID.

Verifying disk space:

  • Use " df -h" to verify if you are running low on disk space.

An output, simliar to the one below, should show used/available disk space.

B: Flow chart for how Tomcat interacts with the java client/browser:

  1. Browser sends a request along with the right credentials to load the login page.
  2. Tomcat verifies the credentials and then, once we know they are valid, stores them in the postgres database.
  3. Credentials are validated through the Java Password Authentication Module (JPAM) . For more information on what JPAM is, see WIKI.   NOTE:The credentials are kept in the default Linux file, found in /etc/shadow
  4.  If the user credentials are validated, credentials are stored in postgres database.
  5. The record ID of the database entry is copied into JNLP file and then passed back to the browser.
  6. The Director Management Console (DMC) can now be  launched through the downloaded .jnlp file.    
  7. The  DMC now uses the record ID in the .jnlp file to login to Director.
  8. The normal user interface is now launched. Once successful, the record ID is requested to be deleted by DMC and thus cleaned from the .jnlp file.
  • NOTE on Step 2: If  the Tomcat daemon is not running we will fail here.
  • NOTE on Step5: If the Postgres database daemon is not running, we will fail at this step.   Another way to verify if the the Postgres daemon is not running is to look through the var/log/messages file.   If you see the word 'bailing' as per the below example, please call Bluecoat support, and log a call, mentioning this KB article :
    •  seen in Var/log/messages file:
      • Line 3232: Jan  7 19:19:48 director cli[31836]: <-cli.crit> [email protected]::ffff: Binding not consumed during reverse-mapping: pm:process:dnscache:enable
        Line 3404: Jan  7 22:10:23 director dmd: <dmd.crit> Database connection not established
        Line 4191: Jan 10 19:07:51 director dmd: <dmd.crit> Database connection not established
        Line 4192: Jan 10 19:07:51 director dmd: <dmd.crit> dd_pgsql_db_create_tables(), dmd_pgsql_db.c:2543, build 000000: Error 1 returned, bailing out.
    • Workaround if the database is in this condition:  Take the archive of the director, and then execute the CLI  command - "monitoring db reset force"  followed by reload of director. This will reinitialize the database. After this, then restore the archive,  and reload the director.  
  • NOTE on Step7: If the HTTP daemon is not running, we will fail here.

 C: Check that the DNS daemon is running.

  • In the LINUX shell, run these commands.
    • sh-2.05b# /etc/init.d/djbdns stat   ( checks to see if the DNS service is running)
    • sh-2.05b# dnsip   ( procures the ip address of
    • sh-2.05b# Ping <SG ip address>  ( checks to see if we can reach the SG)