Service Manager
This is a web interface to monitor and control the server and virtual hosts. It provides the following features.
  • To display current status of server, listeners and virtual hosts
  • To restart server process
  • To reload the configuration of server or a virtual host, most configuration changes can be applied in this way.
  • To enable/disable the service of a particular virtual host
  • To view the server log through the log viewer
 
Table of Contents
Server Name - Server   PID   Actions   Restart   Reload - Server   View Log   
Listeners Name - Listener   Status - Listener   Virtual Host Mappings   
Virtual Hosts Name - Virtual Host   Status - Virtual Host   Actions - Virtual Host   Enable   Disable   Reload - Virtual Host   
 
Name - ServerGo to top
Description: The unique name that identifies this server. This is the "Server Name" specified in the configuration
PIDGo to top
Description: PID (Process ID) of current server process.
Tips: The PID will change when the server is restarted.
ActionsGo to top
Description: Three actions are available for the server: "restart", "reload" and "view log". "Restart" is to restart server process. "Reload" is to reload server configuration. "View log" is to view the server log through the log viewer.
Tips: Shell utility $SERVER_ROOT/bin/lswsctrl can be used to control the server process as well, but requires a login shell.
RestartGo to top
Description: By clicking "Restart", the current server process will exit and a new server process will be started. Most configuration changes can be applied on the fly with "Reload", only a few configuration changes requires restarting the server. All requests being processed will be discard.
Tips: Restart will take less than 2 seconds.
Reload - ServerGo to top
Description: By clicking "Reload", configuration of the whole server includes (listeners and virtual hosts) will be reload. Most configuration changes can be applied on the fly in this way. Web service is not interrupted; all requests being processed will not be affected.
View LogGo to top
Description: By clicking "View Log", the log viewer will be loaded in a pop-up window. Log viewer is a convenient tool to browse current server log, to check any error or problem. Log viewer searches server log file in blocks for the specified log level, The default block size is 20KB. To navigate a large log file, use the "Next"|"Prev" button.
Note: The size of dynamically generated page is limited, if the block is too big, the page might be truncated.
Name - ListenerGo to top
Description: The unique name that identifies this listener. This is the "Listener Name" specified in the configuration.
Status - ListenerGo to top
Description: Status shows current status of this listener. The status is either Running or Error.
Tips: If the listener is in "Error" state, you can view the server log to find out why.
Virtual Host MappingsGo to top
Description: Virtual Host Mappings shows currently established mappings to virtual hosts from this listener. Virtual host name is in the bracket followed by the matching domain name(s).
Tips: If a virtual host is not loaded successfully (fatal errors in the virtual host configuration), the mapping to that virtual host will not be displayed.
Name - Virtual HostGo to top
Description: The unique name that identifies this virtual host. This is the "Virtual Host Name" specified in the configuration.
Status - Virtual HostGo to top
Description: Status shows current status of a virtual host. The status can be: Running, Disabled, Disabled - Not Loaded or Running - Removed from configuration.
  • Running means it is loaded and in service.
  • Disabled means it is loaded but not in service (disabled).
  • Disabled - Not Loaded means it is a newly added virtual host and the server has not loaded the configuration.
  • Running - Removed from configuration means it is deleted from the configuration but it is still in service.
Actions - Virtual HostGo to top
Description: Three actions are available for a virtual host: disable, enable and reload. Only the available actions for the current virtual host status are displayed. The action taken on one virtual host does not affect the rest of the web server.
Tips: It is good idea to disable a virtual host temporarily when updating its content.
EnableGo to top
Description: By clicking Enable, the virtual host will be set to in-service mode, new requests will be accepted. This action is only available to Disabled virtual host.
DisableGo to top
Description: By clicking Disable, the virtual host will be set to out-of-service mode, new requests will be accepted and requests being processed will finish as usual. This action is only available to "Running" virtual host.
Reload - Virtual HostGo to top
Description: By clicking "Reload", web server will reload the new configuration for this virtual host, requests being processed will finish with the old configuration and new configuration will only apply for new requests. If the virtual host is removed from configuration, web server will remove the virtual host from its runtime environment. If the virtual host is a newly added one, web server will add it to its runtime environment. All changes to a virtual host can be applied on the fly this way.