Linux: Cannot Access the Administration Interface After Installation

This item refers to the DEB, RPM, Tarball and Mac OS x.

After installing Zend Server, it opens in the browser with an error.

Possible Causes and Solutions:

• lighttpd is not running - check that it is running http://localhost:10081/ZendServer (see below for information about where lighttpd is running and the lighttpd listening port.
• A 'Failed to get a response from the server', message - check http://localhost to see if the Apache default page loads.  If it does not then Apache is probably down.  If it does, check if the Apache host is listening to the zendserver_gui port

Administration Interface Configurations and Settings:

The Zend Server Administration Interface resides on its own virtual host as follows:

• DEB: /etc/apache2/sites-available/zendserver_gui.conf
• RPM: /etc/httpd/conf.d/zendserver_gui.conf
• MAC and tarball: /usr/local/zend/apache2/conf.d/zendserver_gui.conf

The Administration Interface's virtual host by default listens on port 10083 on the user's Apache, it's document root is under /usr/local/zend/gui Graphical user interface/UserServer.

In addition, the Administration Interface has its own dedicated web server [Lighttpd], listening on ports 10081 [HTTP] and 10082 [HTTPS]. The virtual host on Apache's end is used for communicating with Apache so that the Administration Interface can display its settings and status.

Troubleshooting:

1. Verify the 'url' directive in /usr/local/zend/gui/application/data/zend-server.ini is pointing to the right location, by default it is: "http://127.0.0.1:10083/ZendServer".
   This setting should not be changed unless you have to change you Administration Interface's virtual host settings in zendserver_gui.conf.
2. Ensure all daemons are up and have listeners:
   To check this run # netstat -plnt
   The output should look like this:      

Proto Recv-Q Send-Q Local Address           Foreign Address         

State       PID/Program name

tcp        0      0 0.0.0.0:10081           0.0.0.0:*               

LISTEN      4018/lighttpd

tcp        0      0 0.0.0.0:10082           0.0.0.0:*               

LISTEN      4018/lighttpd

tcp        0      0 127.0.0.1:10083         0.0.0.0:*               

LISTEN      4168/apache2

tcp6       0      0 :::80                   :::*                    

LISTEN      4168/apache2

The first line is the Lighttpd HTTP port [10081], second is the same for HTTPS port [10082], followed by the Apache Vhost for Administration Interface [10083], note that the listener is on 127.0.0.1 only as the communication between it and Lighttpd is local and last, the Apache also has a listener on port 80 for the user's purposes, regardless of. In tarball and MAC installations, Apache is bundled with Zend Server and is configured to listen on port 10088, with DEB and RPM installations, the Apache package from the distribution's repository is used.

Note for MAC users:

The netstat utility on MAC does not support the same usage flags as in Linux, therefore, you must execute:
# netstat -an|egrep "10081|10082|10083|10088"
This is assuming none of the port settings were changed for Apache/Lighttpd.

In the event Lighttpd failed to start:

1. Check the log at:
   /usr/local/zend/gui/lighttpd/logs/lighttpd.error.log for errors
2. Run:
   # /usr/local/zend/bin/lighttpdctl.sh --debug start
   See verbose output and check for errors preventing the server from starting
3. In the event Apache is not listening on port 10083, check the log at: /usr/local/zend/var/log/gui_vhost_error.log