Building a Centralized System
This chapter contains instructions for modifying the centralized configuration files. These files are the key to building a centralized system based on your computing resources, applications, and users' needs.
You do not need to edit all of the files. Complete the Workbook in Chapter 3, Making Choices to help determine which files need to be edited.
The first file is xp.cnf, the remote configuration file. It is located in: . One key element of the xp.cnf file is to provide the path (file_path_1 or file_path_2) to the other configuration files:
- Gateway Table (gateway.tbl) maps network addresses to gateway routers.
- Internet Host Table (hosts.tbl) maps internet addresses and host names.
- TDEnet Node Table (nodes.tbl) maps TDEnet addresses and node names.
- NFS Table (nfs.tbl) maps NFS mount points to local directory structures.
- Font Path Table (fonts.tbl) contains font directory paths.
- Color Table (rgb.txt) maps colors to X server RGB color specifications.
- Display Access Table (xhosts.tbl) lists hosts that can access the network computer.
These files are read in the order listed. The files are unloaded in the directory . You must specify a primary or secondary file path in the remote configuration file in order for the network computer to locate these files.
Remote Configuration Commands
This section lists all the commands available in the xp.cnf file. For complete information on the commands, refer to the comments in the actual file, or to Chapter 2 in the NCBridge Reference Manual.
Note: If you previously had an xp330.cnf file, either rename it to something else, or remove it. It will no longer be read. Network Tables
clear_table clears the entries in the specified NVRAM table.
ip_host_table stores TCP/IP information for up to four hosts in NVRAM.
tde_host_table stores DECnet information for up to four nodes in NVRAM.
gateway_table stores TCP/IP information for up to four gateways in NVRAM.
nfs_table stores information for up to four NFS mounts in NVRAM.
ip_host_entry stores subsequent TCP/IP host information in RAM.
tde_host_entry stores subsequent DECnet node information in RAM.
gateway_entry stores subsequent TCP/IP gateway information in RAM.
nfs_entry stores subsequent NFS mounts in RAM.
lat_service_entries is used to reserve LAT service entries for network computer use.
lat_services_table is used in environments supporting the LAT protocol.
File Host Configuration
file_access_1 specifies the access method for the primary host
file_host_name_1 specifies the primary host.
file_path_1 specifies the configuration files location on the primary host.
file_access_2 specifies the access method for the secondary host.
file_host_name_2 specifies the secondary host.
file_path_2 specifies the configuration files location on the secondary host.
Environment Configuration
retain_x_settings controls whether X settings are saved when the server resets after the last client is closed (YES).
backing_store specifies whether the network computer saves pixels when a window is obscured or unmapped (ENABLED).
dual_display_configuration specifies the position of multiple displays (HORIZONTAL).
display_access_table specifies a display access host table entry.
enable_access_control specifies whether to restrict client access to the network computer (NO).
default_visual sets the visual type for the root window (PSEUDOCOLOR for color network computers and GRAYSCALE for gray scale network computers).
host_connect_method sets the network computer to host connection (XDMCP).
default_host_list specifies the hosts displayed on the HostMenu client.
xdmcp_connect specifies an additional connection method for xdmcp (BROADCAST).
xdmcp_keepalive sets whether keepalive requests are sent to xdm (OFF).
xdmcp_server specifies the xdmcp server host (used if xdmcp_connect is DIRECT or INDIRECT).
vms_autologin_transport specifies the network protocol to use to autoconnect to a VMS host (used if host_connect_method is VMS).
vms_autologin_tdenet_host specifies the VMS host for DECnet X11 autologin (used if host_connect_method is VMS).
vms_autologin_tcpip_host specifies the VMS host for TCP/IP X11 autologin (used if host_connect_method is VMS).
screen_saver controls whether the screen blanks if the keyboard and mouse are inactive for 10 minutes (ON).
enable_xie specifies whether the XIE (X Imaging Extension) option is used to add image enhancements and display operations to applications.
enable_xv specifies whether the X Video Server Extension is enabled.
old_decwin_compatible supports old DECwindows clients that expect bitmap and image data in least significant byte (LSB) order (NO).
vendor_string specifies that a VT200/LK401 keyboard is used with a DEC system using DECwindows applications.
font_cache_limit sets the amount of memory to allow for the font cache.
Boot Configuration
boot_method specifies one of four boot methods: TFTP, NFS, MOP, or ROM.
boot_host_name specifies the host where the boot files are located.
boot_path specifies where the boot files reside.
boot_method_ 2 specifies the secondary boot method.
boot_host_name_2 specifies the secondary host.
boot_path_2 specifies the secondary boot path.
determine_address_from specifies whether the network computer determines its internet protocol address from the network or from NVRAM.
boot_delay controls whether the network computer waits before requesting boot files to avoid overloading the host during a simultaneous boot.
verbose_boot_msg specifies if filenames are displayed during booting.
enable_boot_interrupt controls whether the boot process can be interrupted by a user (YES).
boot_config_type specifies (limits) the methods used by the network computer to obtain boot information when booting from the network.
TCP/IP Configuration
netstation_name specifies the name of the network computer, if used.
subnet_mask specifies the mask used for subnet addresses.
broadcast_address specifies the IP address used for broadcasts.
enable_broadcasts specifies whether the network computer responds to broadcasts (YES).
default_telnet_host specifies the telnet host.
name_server_1,_2,_3 specifies the primary and two backup name servers.
enable_name_service controls whether name service is used (default NO).
default_domain_suffix specifies the default domain for name service requests.
TDEnet Configuration Parameters
tdenet_netstation_name specifies the name of the TDEnet network computer.
default_cterm_host specifies the default host for a Cterm session.
enable_trigger_reboot specifies whether the network computer reboots when the NCP TRIGGER command is executed.
trigger_reboot_password specifies the password used with the NCP TRIGGER command.
tdenet_connect_timer specifies the time between TDEnet connection attempts.
tdenet_hello_timer specifies the time interval between hello packets.
tdenet_inactivity_timer specifies the inactivity time on an established connection before a keepalive packet is sent to the remote node.
tdenet_retransmit_limit specifies the number of times a packet requiring acknowledgment is transmitted on an established connection.
tdenet_mop_id_timer specifies the interval between MOP identification packets.
Serial Port Configuration Parameters
data_bits_0 specifies the number of data bits for Port 0.
stop_bits_0 specifies the number of stop bits for Port 0.
parity_0 specifies the parity for Port 0.
flow_control_0 specifies the flow control for Port 0.
baud_rate_0 specifies the baud rate for Port 0.
tty_abort_session_0, 1 specifies whether open serial session windows exit or remain open if the serial line is physically disconnected from the network computer.
delay_rts_signal_0 specifies whether the RTS signal is delayed until the serial session is started.
data_bits_1 specifies the number of data bits for Port 1.
stop_bits_1 specifies the number of stop bits for Port 1.
parity_1 specifies the parity for Port 1.
flow_control_1 specifies the flow control for Port 1.
baud_rate_1 specifies the baud rate for Port 1.
Net to Port Configuration
disable_net_to_port disables direct access to the serial and/or parallel ports.
enable_net_to_port enables direct access to the serial and/or parallel ports.
define_net_port redefines the port number that the net_to_port command listens to.
net_to_port_protocol specifies a port, its network protocol, and socket number.
net_to_port_connections controls the number of net to port connections.
Keyboard Configuration Parameters
language specifies the language used for Setup fields and messages.
keyboard_type specifies the type of keyboard in use.
keyboard_language specifies the language of the keyboard.
dp_mode specifies whether a VT200 keyboard is in data processing mode.
compose_sequences specifies whether compose sequences are loaded.
key_map_file specifies a custom keyboard.
keymap_file_list_entry specifies a custom keyboard file and identification.
keysym_action_entry specifies a key to cause an action on a keyboard.
keyboard_repeat_rate specifies the how many characters are repeated per second, when a key is held down.
keyboard_repeat_delay specifies the delay time between when the first character displays after a key press and when it starts repeating.
control_alt_delete specifies the function of the Control, Alt, and Delete keys.
alt_printscreen specifies what action is taken when the Alt+Printscreen keys are pressed.
Input Extensions Configuration Parameters
touchSc_Min_X sets the screen left edge boundary for the touch screen.
touchSc_Min_Y sets the screen lower edge boundary for the touch screen.
touchSc_Max_X sets the screen right edge boundary for the touch screen.
touchSc_Max_Y sets the screen upper edge boundary for the touch screen.
touchSc_Down_Threshold specifies the button press for the touch screen.
touchSc_Up_Threshold specifies the button release for the touch screen.
lightpen_Min_X specifies the left edge boundary for the light pen.
lightpen_Min_Y specifies the upper edge boundary for the light pen.
lightpen_Max_X specifies the right edge boundary for the light pen.
lightpen_Max_Y specifies the lower edge boundary for the light pen.
enable_lightpen enables the lightpen calibration client.
lightpen_Flood specifies that a blue color replaces dark or opaque display color.
input_ext_config_file_0 specifies the device specific configuration file to use for input extensions for port 0.
input_ext_config_file_1 specifies the device specific configuration file to use for input extensions for port 1.
core_device_type specifies up to three input devices.
enable_mouse_2 specifies that a non-logitech mouse (or compatible) is used with the network computer.
pointer_control controls the pointer parameters for speed and distance moved.
SNMP Configuration
snmp_trap_list specifies the host trap list for SNMP.
snmp_comm_list specifies the host and community string for SNMP GET, GETNEXT, and SET operations.
Local Clients
start downloads and starts local clients at boot time.
preload downloads clients at boot time, but does not start them.
start_session downloads session clients at boot time.
LAT Configuration
lat_keepalive_timer specifies the amount of time between keepalive messages (default 20).
lat_connect_timer specifies the amount of time between service connection attempts before the connection attempts are terminated (default 16).
lat_retransmit_timer specifies the amount of time between retransmission attempts (default 200).
lat_circuit_timer specifies the message interval (default 80).
lat_retransmission_limit specifies the retransmission number (default 8).
add_lat_group_codes specifies the recognized group codes (default 0).
delete_lat_group_codes specifies codes to ignore and delete (default 0).
Miscellaneous Functions
unsupported_feature_warnings specifies whether warning messages appear if a valid but unsupported command is encountered by the network computer.
restricted_setup determines whether a password is required to access many Setup fields.
setup_password is used to set the password for restricted Setup.
save_current_settings controls whether the settings downloaded from the remote configuration file are saved in NVRAM.
Including Other Configuration Files
include_host_access specifies a host and file access method if you are reading a remote configuration file from a host other than the boot host.
include specifies the remote configuration file name.
select specifies selected network computers to execute a specific remote configuration file command.
Restricting Configuration Parameters
select command allows selected network computers to execute a specific remote configuration file command.
Tek220 and Tek340 Configuration
num_col specifies the number of columns to display.
autowrap sets whether a line wraps to the next line or truncates.
rev_video specifies the foreground and background colors.
cursor_style sets the cursor to a block or underscore.
emulation specifies different levels of emulation.
dev_attr_resp controls the emulator's device attribute response to the host.
user_features controls preferences and whether or not applications can change them.
keypad_mode specifies the keypad mode: standard numeric or application-specific.
cursor_key_mode specifies the cursor key mode: standard ANSI cursor control or application-specific.
newline_mode specifies what happens when Return is pressed.
autorepeat specifies whether auto repeat is enabled.
answerback specifies the response to a host ENC command.
tekterm_resource_control specifies where the Tek220 and Tek340 emulators find configuration settings for the menubar and reverse colors.
tekterm_menubar specifies whether the emulator has a menubar displayed at the top of the Tek220 and Tek340 window.
reverse_ansi_colors specifies whether the ANSI colors on the Tek220 and Tek340 emulator are displayed in reverse-video.
Black and White Pixel Compatibility
black_pixel specifies whether clients use the X server BlackPixel and WhitePixel values, or the values 0 and 1 to represent black and white. This command is typically only needed in Sun environments.
Flash Memory Configuration
do_flash writes the flash_features to the network computer's flash memory.
flash_console determines the console to receive flash messages.
- flash_do_not_compress specifies that files written to flash memory are not compressed (otherwise, files are automatically compressed).
flash_feature determines which features are to be written to flash memory.
HostMenu Configuration
xdmcp_menu_entry specifies preferred host names to be displayed by the HostMenu client. Preferred hosts are first on the list of hosts that respond to an xdmcp broadcast when the XDMCP button is selected.
thm_broadcast specifies whether the HostMenu client automatically broadcasts to the local subnet for XDM hosts.
thm_entrybox specifies whether the Host Name field displays at the bottom of the HostMenu client.
vms_menu_entry specifies a list of VMS hosts to be displayed by the HostMenu client when one of the VMS buttons is selected.
telnet_menu_entry specifies a list of Telnet hosts to be displayed by the HostMenu client when the TELNET button is selected.
cterm_menu_entry specifies a list of CTERM hosts to be displayed by the HostMenu client when the CTERM button is selected.
ibm_menu_entry specifies a list of IBM hosts to be displayed by the HostMenu client when the IBM button is selected.
windd_menu_entry specifies a list of Windows NT servers to be displayed by the HostMenu client when the WinDD button is selected.
lat_menu_emulator specifies that a TEK220 or TEK340 emulator session starts when a user connects to a LAT service from the HostMenu LAT list.
Local Print Spooler/Printing Configuration
enable_print_spooler enables the local print spooler.
spooler_size reserves memory for use with the spooler.
spooler_listen_port specifies the TCP port on which the spooler listens for and accepts print requests.
spooler_local_queue defines a printer queue name for the specified port.
spooler_remote_queue defines a local printer queue name that forwards print requests to a printing via a remote queue.
spooler_auth_host specifies hosts that are allowed print queue access.
spooler_auth_user specifies users that are allowed print queue access.
DEC Session Manager Configuration
dec_sme_resetserver specifies whether the server is reset when the DEC Session Manager quits.
TFTP Daemon
enable_tftp_daemon specifies whether the tftp daemon is enabled for a master network computer used to boot other network computers via Flash memory.
Telnet Logout Configuration
telnet_exit_on_logout specifies whether Telnet quits when you log out from a host in a Telnet local client.
Remote Console
enable_remote_logging specifies the console log messages are sent to a log file.
loghost specifies the remote host to receive console messages.
logfacility specifies the type of log message.
logpriority specifies the priority level for the console messages.
console_pages specifies the number of pages in the console buffer.
WinDD Configuration
default_windd_host specifies the Windows NT host to connect to when you invoke WinDD from the Client Launcher.
windd_host_entry specifies the name or address of a WinDD server.
windd_size specifies the size (resolution) of the WinDD window.
windd_auto_connect specifies whether to automatically connect to a server.
windd_auto_reconnect specifies whether to reconnect to a server after logging out of a session.
windd_menubar specifies whether to display the WinDD window menubar.
windd_entrybox specifies whether to display the WinDD entry box.
Update Authorization Keys
update_authkey specifies that the network computer reads the authkey.dat file when booting and updates specified network computer's authorization keys.
RSHD Configuration
rshd_security specifies from where the .rhosts file is read when using rsh.
Hardware MPEG Configuration
Note: This feature is not available on NC900 Series. hwmpeg_dbsize specifies the size of the Video Player's memory buffer used when playing mpeg files.
hwmpeg_chunksize specifies whether the Video Player's memory buffer is divided into "chunks".
hwmpeg_chunkdelay specifies how long the Video Player waits after each read request fills a memory chunk in the buffer.
CSLIP Configuration
slip_compression specifies whether TCP/IP headers are compressed using Van Jorgenson compression while sending and receiving data.
slip_serial_port specifies the network computer's port number on which to use CSLIP.
slip_dest_ip specifies the host to which you are connecting. You can enter the host name, or its address.
slip_src_ip specifies the network computer's name or IP address used with CSLIP.
slip_mtu specifies the maximum transmission unit for data transmission.
slip_mask specifies the subnet mask used for the CSLIP session.
slip_def_route specifies whether the destination IP address (entered with the slip_dest_ip command) is added as the gateway default in the gateway table.
Script Variable Configuration
script_variable defines variables and values used with the Scripting Language scripts.
Gateway Table Commands
All gateway information can now be added directly to the remote configuration file (xp.cnf). The applicable commands are gateway_table, to add up to four of the most frequently accessed gateways to the network computer's NVRAM, and gateway_entry, to add subsequent gateways that are stored in RAM.
The older method of using the gateway table is still available for this release.
The gateway table, gateway.tbl, can be used to hold gateway router information in addition to what is stored in NVRAM. Entries are added to NVRAM through the gateway_table command in the xp.cnf file, or through Setup on the network computer. Typically, you would store frequently accessed gateways in NVRAM.
Each network is mapped to a corresponding gateway host as follows:
A gateway table might look like the following example. The first entry is the default gateway; its address is 128.07.60.100, and it routes all non-local traffic that is not explicitly matched by another gateway entry. The special entry 0.0.0.0 matches all possible networks and is used to set the default gateway when no other specified gateway matches. The second entry lets the network computer access network 10 through the machine with address 128.07.60.110.
- 0.0.0.0 128.07.60.100
10.0.0.0 128.07.60.110
Note: If you have multiple routers, you can use the Route Manager to automatically re-route information if a router goes down. The Route Manager is started with the xp.cnf start command. Internet Host Table Commands
All internet host information can now be added directly to the remote configuration file (xp.cnf). The applicable commands are ip_host_table, to add up to four of the most frequently accessed hosts to the network computer's NVRAM, and ip_host_entry, to add subsequent hosts that are stored in RAM.
The older method of using the internet host table is still available for this release.
The internet host table, hosts.tbl, maps host names to their corresponding IP addresses. You can refer to the hosts listed in this table by name in subsequent configuration files (see ordered list at the beginning of this chapter), Setup, or in a Telnet session.
The hosts.tbl entries are in addition to what is stored in NVRAM. Entries are added to NVRAM through the ip_host_table command in the xp.cnf file, or through Setup on the network computer. Typically, you would store frequently accessed gateways in NVRAM.
To add entries to the hosts.tbl file:
The internet host table uses the same format as a standard UNIX /etc/hosts file. The alias portion of the file format is not supported in this version of the network computer. The host table can be a copy of /etc/hosts or a symbolic link to it. If you use NFS, it can only follow symbolic links within the exported directory. For example, if / is exported, /etc can be found, whereas if /usr is exported, /etc is not available.
Note: With secure tftp, symbolic links do not work outside the secure directory. See Chapter 1, Installing the Software, for more information. An example hosts.tbl might look like:
- # Internet Protocol Host entries:
128.07.60.10 washington
128.07.60.11 nevada
128.07.60.12 arizonaTDEnet Node Table Commands
All TDEnet node information can now be added directly to the remote configuration file (xp.cnf). The applicable commands are tde_host_table, to add up to four of the most frequently accessed hosts to the network computer's NVRAM, and tde_host_entry, to add subsequent hosts that are stored in RAM.
The older method of using the TDEnet host table is still available for this release.
The TDEnet node table, nodes.tbl, maps node names to their corresponding TDEnet addresses. This table is only used for network computers enabled with TDEnet. You can refer to the nodes listed in this table by name in subsequent configuration files (see ordered list at the beginning of this chapter), Setup, or in a Cterm session.
The nodes.tbl entries are in addition to what is stored in NVRAM. Entries are added to NVRAM through the tde_host_table command in the xp.cnf file, or through Setup on the network computer. Typically, you would store frequently accessed gateways in NVRAM.
To add entries to the nodes.tbl file:
An example nodes.tbl might look like:
- # TDEnet Node entries:
11.22:: alaska::
11.23:: hawaii::
11.24:: texas::NFS Table Commands
All NFS mount information can now be added directly to the remote configuration file (xp.cnf). The applicable commands are nfs_table, to add up to four of the most frequently mounts to the network computer's NVRAM, and nfs_entry, to add subsequent mounts that are stored in RAM.
The older method of using the NFS host table is still available for this release.
The NFS table, nfs.tbl, specifies a host and directory (hostname:/directory) and the corresponding local path name (path) to be used by the network computer. This table is frequently used to access additional fonts.
The nfs.tbl entries are in addition to what is stored in NVRAM. Entries are added to NVRAM through the nfs_table command in the xp.cnf file, or through Setup on the network computer. Typically, you would store frequently accessed mounts in NVRAM.
A transfer size can be specified for each mount point. Transfer sizes can be in the range of 128 to 8192.
To add entries to the nfs.tbl file:
- # Format "hostname:directory" "path" "size"
oregon:/usr /usr 8192
montana:/usr/tekxp/boot/fonts /u1/tekxp/fonts 1024
arizona:/mydir/special/fonts /myfonts 512
nevada:/usr3/tekxp/XP/fonts /usr3/tekxp 512Font Path Table Commands
The font path table, fonts.tbl, specifies the full path names of additional font directories that the network computer searches when looking for font files. These directories are added to the default font path for the X server before the boot directory and resident paths. The font path table allows the network computer to automatically locate font directories at boot time. If a font directory is in fonts.tbl, the user does not need to issue the xset +fp command during login to access that font; the X server on the network computer knows where to locate the fonts when a client requests them.
The fonts are not downloaded at boot time, but each font directory is searched for a fonts.dir and fonts.alias file. A long list of entries in fonts.tbl increases the boot time and uses network computer memory that could otherwise be used for windows and local clients. The fonts.tbl file should only list font directories used regularly. Comment lines are allowed.
- Add one font directory path per line. If the fonts are installed in \tekxp\boot\fonts, the fonts.tbl file may look like this:
/tekxp/boot/fonts/75dpi- /tekxp/boot/fonts/100dpi
- /tekxp/boot/fonts/tek100dpi
- /tekxp/boot/fonts/misc
- /myfonts/runes
- /usr3/lotus/128.v11/fonts/X11
Color Table Commands
The color table, rgb.txt, contains the RGB color specifications and the corresponding color names for the X server in the network computer. By modifying the file rgb.txt, you can change or add color names and definitions available to X clients. No comments are allowed. Some example entries are:
- 255 250 250 snow
248 248 255 ghost white
245 245 245 white smokeDisplay Access Table Commands
The display access table, xhosts.tbl, contains entries for all hosts that are allowed access to the X server of the network computer. The entries specified in this file do not have the ability to change access control or modify the access list. Only the entries specified with the display_access_table commands in the remote configuration file can change the access control and access list. Entries can be added as follows:
Entries that end with two colons are DECnet nodes.Use two colons to specify TDEnet node names. Comment lines are allowed. Using the entries from the previous hosts.tbl and nodes.tbl examples, the xhosts.tbl looks like this:
- washington
128.07.60.11
arizona
alaska::
hawaii::
11.24::
Note: If the host-based xlock does not work, add the host's IP address to the display access table, then run xlock again. To decrease network use, use the local xlock client.