The following are runtime parameters available to control your workstation via your thinstation.conf<whatever> file. These settings can go in any of the thinstation.conf<whatever> files, except where noted. (Please see FAQ#Configuring_Thinstation for the order in which thinstation.conf<whatever> files are used).
The thinstation.conf<whatever> files have some global parameters that will affect how a workstation behaves
DAILY_REBOOT Will reboot server if up over a day and one of the session types is closed AUTOPLAYCD If enabled this will autoplay music cds when inserted. CUSTOM_CONFIG Allows choosing custom boot config from SCREEN_RESOLUTION and SCREEN_DEPTH RECONNECT_PROMPT This displays the reconnection/shutdown options for when a session is ended OFF No reconnect prompt ON Reconnect prompt will be displayed MENU Shows a menu with a shutdown and reconnection option MENUXX As MENU option, but the XX is a time period in minutes. After XX minutes shutdown will occur unless the reconnect option is choosen SYSLOG_SERVER Log server ip address or hostname. If the work "local" is used, then syslog starts logging locally If not specified syslogd is not loaded.
Setting the system time every minute from a NTP or rdate server
TIME_ZONE Used to set time zone on TS client by entering the UTC offset. This can be set automatically if the appropriate dhcpc option is selected (Option 2, time offset in seconds)
To set the default keyboard layout to use from the list of installed keyboard layouts
KEYBOARD_MAP Keyboard layout
To set the default sound level
AUDIO_LEVEL Audio Level for sound, 0-100
To enable local USB devices and mount options
USB_ENABLED Enable USB Drivers into memory if USB package is chosen
To synchronise all USB writes (immediately, otherwise it is cached - slightly slower, but ensures that data is written immediately).
Mount usb disks to this directory (rather than the generic /mnt/usbdevice)
Use the label of the usb device rather than the generic hardware name (eg. /media/nano vs /mnt/usbdevice/sda1)
Any options that you want passed to the USB mount statement (eg. use utf8 encoding and the win95 naming conventions for 8 character file names).
X Screen settings
The following settings are either a single number or can be a list of numbers (separated by |), that can be selected from if CUSTOM_CONFIG=On
SCREEN_RESOLUTION Screen resolutions available in the workstations SCREEN_COLOR_DEPTH Number of bits per pixel (8,16,24)
Only use these if your monitor is NOT auto-detected.
SCREEN_HORIZSYNC Monitor horizontal sync frequency in Khz. SCREEN_VERTREFRESH Monitor vertical refresh frecuency in Hz.
An option for using another Linux/Unix box for providing fonts to your workstation
SCREEN_X_FONT_SERVER IP address or hostname of the font server for X
Optional settings for your Monitor
SCREEN_BLANK_TIME Minutes to X session goes blank SCREEN_STANDBY_TIME Minutes to X session goes into standby mode SCREEN_SUSPEND_TIME Minutes to X session goes into suspend mode SCREEN_OFF_TIME Minutes to X session turn off
Only use this if your mouse is NOT auto-detected.
MOUSE_PROTOCOL Mouse protocol type (Microsoft, PS/2, etc.) MOUSE_DEVICE Mouse device: /dev/ttyS0 -> COM1 /dev/ttyS1 -> COM2 /dev/ttyS2 -> COM3 /dev/ttyS3 -> COM4 /dev/psaux -> PS/2 mouse port /dev/input/mice -> USB mouse (needs USB package) MOUSE_RESOLUTION Mouse resolution MOUSE_ACCELERATION Mouse acceleration
Miscellaneous xserver parameters
X_NUMLOCK Set numlock state on boot X_COOKIE Will set X Cookie if specified
Advanced XServer Options - Experts Only
X_DRIVER_NAME Driver for X, this will override the autodetection scripts X_DRIVER_BUSID Screen Card BusID X_DRIVER_OPTION1-5 Addditional options for driver X_MONITOR_OPTION1-5 Addditional options for monitor X_MONITOR_MODELINE Add user defined ModeLine
The following are the standard settings for networking:
NET_HOSTNAME Hostname to use if not using a thinstation.hosts file, note that the machine MAC address will replace any * if used. NET_SMTP_SERVER Email server address for error logs NET_SMTP_EMAIL Email address of administrator NET_TIME_SERVER Time server on network to sync to, uses rdate NET_TELNETD Enables built-in telnetd server package NET_REMOTE_ACCESS_FROM List of hostnames/ip address accepted by the server for remote control, used by telnetd and www packages
Mounting networked filesystems
NET_NFS_SERVER This is the path to the NFS server, ie server:/path/to/share. NET_SMB_SERVER This is the path to the SMB server, ie server:/path/to/share. NET_SMB_WORKGROUP Workgroup of samba server NET_SMB_USER This is the username for SMB mounts, password is defined at build time in build.conf
For use in thinstation.conf.buildtime only:
NET_USE_DHCP Enable DHCP Resolution, On/Off NET_IP_ADDRESS IP Address of client NET_MASK Network mask of client NET_GATEWAY IP Address of gateway NET_DHCP_DELAY Delay before continuing script after bringing up interface, only needed if using spanning tree "port discovery" in a switched environment. Default is 0 seconds. NET_FILE_METHOD Method to download files, ie scp or tftp, scp is only available if package ssh is selected in build as a "package". NET_FILE_ENABLED Use server for config file, On/Off NET_FILE_USER User to connect to SCP server as NET_FILE_ALTERNATE Alternate server for vmware or non-standard dhcp servers NET_DNS1 DNS Server 1 NET_DNS2 DNS Server 2 NET_DNS_SEARCH Default DNS domain to search
Additional Options For use in thinstation.conf.buildtime only:
NET_FILE_METHOD Method to download files, ie scp or tftp NET_FILE_USER User to connect to SCP server as NET_FILE_METHOD=tftp NET_FILE_USER=not_needed_for_tftp
Global Session options
These are the defaults for the corresponding items that can be set per session
SCREEN Display number to run the X server on AUTOSTART ON Application will be executed immediately at startup OFF Application will appear in a menu to be started manually WORKSPACE Workspace in the window manager to run the application in ICONMODE MANUAL Default sessions are not created in window manager/xtdesk AUTO Default sessions types are created in window manager/xtdesk
Standard Session options
The following options are available for every session you specify.
The parameters for each session needs to have the same sessions number (SESSION_#).
Sessions start at 0 (zero) and there MUST be a SESSION_0.
The ONLY mandatory item is SESSION_#_TYPE.
SESSION_#_TITLE Title description for SESSION. Needed for replimenu. SESSION_#_TYPE Package to run SESSION_#_SCREEN Display number to run the X server on SESSION_#_AUTOSTART ON Application will be executed immediately at startup OFF Application will appear in a menu to be started manually SESSION_#_CUSTOM_CONFIG ON Allows choosing custom config for when session starts OFF Session boots normally SESSION_#_ICON ON Places Icon on Desktop if package xtdesk is selected and in Window Manager Main Menu SUBMENU Places Icon on Desktop if package xtdesk is selected and in a Submenu within the window manager SESSION_#_WORKSPACE Workspace to run program on in a window manager
The following parameters are per session, but require the type to be the same as the SESSION_#_TYPE for this session.
SESSION_#_type_SERVER IP address/hostname of the server SESSION_#_type_OPTIONS Command line options for the session type SESSION_#_type_specific This allows you to specify specific config file details for certain session types (eg. NX, ICA)
Examples of settings are included with the various scenarios below.
Specific Usage Examples
The following are a set of usage scenarios for a Thinstation workstation with examples of parameters for your thinstation.conf<whatever> file. These settings can go in any of the thinstation.conf<whatever> files, except where noted. (Please see FAQ#Configuring_Thinstation for the order in which thinstation.conf<whatever> files are used).
Thinstation includes a number of Microsoft Windows connectivity options. (rdesktop, Citrix ICA, NX, ThinLinc)
Automatic - Single Session on Microsoft Server via RDP
Scenario: You have a workstation that should automatically connect into your Terminal Services server.
RECONNECT_PROMPT=On SESSION_0_TYPE=rdesktop SESSION_0_AUTOSTART=On SESSION_0_RDESKTOP_SERVER=<ip of terminal services server>
If you want to add some default options you need to include them in the OPTIONS parameters, eg.
SESSION_0_RDESKTOP_OPTIONS='-u <user> -p " " -d <domain>'
This will pre-populate the <user> and <domain>, and blank the password at the Windows logon screen.
For information on all the available rdesktop parameters see the rdesktop man page.
NO dhcp server
You have a workstation on the network and your network does NOT have a dhcp server.
These parameters can go in any thinstation.conf<whatever> file as the network on the workstation is restarted after reading all thinstation.conf<whatever> files. If you have NET_FILE_ENABLED=Off you MUST have these in thinstation.conf.buildtime or thinstation.conf.user (as network based files won't get read....).
NET_USE_DHCP=Off NET_HOSTNAME=<your hostname> NET_IP_ADDRESS=<ip address> NET_MASK=<ip mask eg. 255.255.255.0> NET_DNS1=<ip address of your first DNS server> NET_DNS2=<ip address of your second DNS server> NET_DNS_SEARCH=<default domain to search in, eg. mydomain.com> NET_GATEWAY=<ip address of your gateway>
NO tftp or http server for network based configuration files
You have a workstation on the network and your network does NOT have a tftp/http server (for supplying thinstation.conf<whatever> files).
Include the following in your thinstation.conf.buildtime file
The workstation will still be able to read a thinstation.conf.user, if it exists.
NO network card (or not connected)
If your workstation does NOT have a network card at all (or you are not connecting to a network), you will need to have the settings for 'NO dhcp server' and 'NO tftp or http server for network based configuration files' set as above, and built your thinstation image with
param haltonerror false
in the build.conf file to ensure that the startup of Thinstation does not stop unexpectedly.