NameSurfer Suite
The WWW user interface configuration file
FusionLayer
HELP
  Table of contents
   Exit help

NameSurfer 7.6.4.1


The configuration file config/webui.conf in the NameSurfer directory tree contains a number of configurable settings in a simple, human-readable text format. It is read by the the NameSurfer HTTP server process on startup. Changes made to this file will not take effect until the process is killed and restarted.

Each setting is entered on a line of its own as a "name: value" pair. Empty lines and comments beginning with a # character are allowed. The following settings are supported:

http_port (integer), default 8053
The TCP port number where the NameSurfer daemon listens for incoming HTTP connections from web browsers.

https_port (integer), default 8443
The TCP port number where NameSurfer daemon listens for incoming HTTPS connections from web browsers.

max_children (integer), default 2
A soft limit on the maximum number of simultaneous child processes that may be spawned by the NameSurfer daemon. Additional child processes may be created in excess of this limit, but their creation will be delayed in order to limit server load.

part_max (integer), default 100
Zones containing more than this many domain names will be broken into multiple pages for display on the zone page.

part_size (integer), default 50
When a zone is displayed as multiple pages, display this many domain names on each page.

part_links (integer), default 100
When a zone is displayed as multiple pages, display at maximum this many links to the pages.

use_frames (true or false), default true
If true, use HTML frames in the WWW user interface.

hostname (character string), default <none>
The name of the host this NameSurfer is running on. This should be identical to the hostname part of the URL by which users connect to the NameSurfer WWW user interface. This is used by the WWW user interface when issuing HTTP redirects pointing back to the server itself. With certain (broken) WWW browsers, such redirects have to contain an absolute URL, making knowledge of the hostname necessary. If no value is specified, NameSurfer will attempt to determine the hostname by running the operating system's "hostname" command. If the server's idea of the hostname differs from that of the user, certain WWW browsers may display an additional authentication dialog after the first HTTP form submission in each NameSurfer session.

fancy_selectors (true or false), default false
When true, the WWW user interface will display MX, HINFO, and RP data in the form of HTML selectors with predefined choices based on the current zone contents. The selector display requires NameSurfer to generate special summary information from the zone data on startup. This may take a substantial amount of time and memory if the amount of data is large. We recommend setting fancy_selectors to "false" if your DNS data totals more than 2000 resource records, or if you are experiencing problems with excessive startup time.

background_color (character string), default FFFFFF
The background color, as a hexadecimal RRGGBB string. The default is white (FFFFFF).

stripe_color (character string), default E0E0F0
The color of the stripes, as a hexadecimal RRGGBB string. The default is purple (E0E0F0).

zone_row_color (true or false), default false
When true, the zone page will use contrasting background colors for alternate lines.
Please note: this applies only to FusionLayer NameSurfer versions 7.1.1 and earlier.

use_javascript (true or false), default false
When true, enable optional JavaScript features of the user interface. Currently, there is only one such feature: when the zone display or the index display is divided into multiple pages, positioning the mouse cursor over a page number shortcut will cause the first and last domain name on that page to be displayed in the window footer of compatible Web browsers.

use_cookie (true or false), default true
When false, HTML cookies will not be used in NameSurfer. When cookies are not used, NameSurfer will always return to the index page after help pages have been browsed. When true, NameSurfer will use HTML cookies.

recursive_name_server (character string), default <none>
The IP address of a name server providing recursive name service, e.g., a BIND server. This is needed to automatically look up the authoritative servers when loading data by zone transfer.

show_mx_preferences (true or false), default true
If true displays MX preferences for MX records, otherwise automatically generates preferences.

allow_multiple_cnames (true or false), default false
Allows multiple CNAMEs with the same name in user interface.

log_http_access (true or false), default true
Whether or not log all http accesses to the Web UI server. If true the log file might grow very much.

global_search (true or false), default false
When true, searching on the index page works for all the zones, and might be very slow. Othervise searching on the index page works only for domain names.

enable_ipv6 (true or false), default false
When true, users will see IPv6-specific menus on the zone pages.

default_auto_ptr (true or false), default true
Default value for automatic reverse map creation checkbox.

default_auto_delegation (true or false), default true
Default value for automatic update of delegation information (NS records) between parent and child zones.

enable_international_characters (true or false), default false
When true, international characters (extended ascii) are allowed for naming DNS nodes.

charset (character string), default <none>
Encoding characterset to be used for forms (for example gb2312 for Simplified Chinese).

enable_e164 (true or false), default false
Enable special support for 'e164.arpa' zone and NAPTR records.

idn_support (true or false), default false
Enable support for International Domain Names.

idn_encoding (character string), default ISO-8859-1
Encoding set used for International Domain Name coding.

remote_automation (true or false), default false
Run remote checkconf/upload/restart when changing remote servers.

max_results (integer), default 50
Maximum number of containers and parameters to display in one page, in IPAM and remote configurations.

max_message_length (integer), default 200000
The maximum number of bytes the web interface will read from confd or IPAM.

do_ipam (true or false), default <none>
When true, IPAM links appear on the index page. Valid values for this option are true and false.

confd_port (integer), default 8055
Confd default port.

confd_server (character string), default 127.0.0.1
Confd server(s) IP address.

ipam_port (integer), default 8889
IPAM default port.

ipam_server (character string), default 127.0.0.1
IPAM server(s) IP address.

current_as_link (true or false), default false
When true, the UI displays the current location as a link in remote and IPAM pages.

server_host (character string), default 127.0.0.1
The host name or numeric IP address of the machine running the NameSurfer server. Usually this is the same machine as the one running the user interface, so the loopback address 127.0.0.1 may be used.

server_port (integer), default 8054
The port number where the NameSurfer server listens for DNS queries. Used by the user interface to send queries and updates. Should be the same as the dns_port configuration option of the server.

rfc3152_support (true or false), default true
When true, IPv6 reverse records are automatically created as ip6.arpa. Otherwise ip6.int is used.

replace_ptrs (true or false), default false
This option controls how NameSurfer updates reverse map PTR records. If it is set to 'true', when doing update all the existing PTR records for the reverse zone node are removed and replaced with a single new PTR record. Default is 'false'.

use_extrenal_auth (true or false), default false
If this option is enabled, NameSurfer web UI will use one of the available external authentication methods for checking user credentials instead of the internally stored password. Detailed configuration for the external authentication is in the authentication.conf configuration file.

primary_addr default 62.236.69.201
The IP address of this host (the host on which FusionLayer NameSurfer primary name server runs). This address is used by BIND Configuration as the master ip address.

strict_security_checks no default value
This option enables more strict security policy for FusionLayer NameSurfer which enables that account will be disabled after 5 failed login attempts. Also when creating or modifying passwords, passwords are checked against dictionary files.

dictionary_databases no devault value
This options specifies the dictionary files to use with password checking and strict_security_checks option.

use_session_login (true or false)
If set true, FusionLayer NameSurfer uses login page and session based authentication instead of HTTP basic authentication for user identification.

session_timeout (seconds), default 3600
If session login is in use, invalidate inactive sessions after the specified time (seconds) of inactivity. If session login is not used, clear current noon-login session cookie data after the inactivity period has passed.