From thinstation

Jump to: navigation, search

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).

Global settings

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

NET_TIME_SERVER=oceania.pool.ntp.org

Localisation

Set your timezone (see Wikipedia list of zoneinfo time zones or glibc - Specifying the Time Zone with TZ)

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

Hardware defaults

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).

USB_STORAGE_SYNC=On

Mount usb disks to this directory (rather than the generic /mnt/usbdevice)

USB_MOUNT_DIR="/media"

Use the label of the usb device rather than the generic hardware name (eg. /media/nano vs /mnt/usbdevice/sda1)

USB_MOUNT_USELABEL="Yes"

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).

USB_MOUNT_OPTIONS="utf8,shortname=win95"

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

Network options

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).

Windows Connectivity

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.

Network Related

NO dhcp server

Scenario: 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

Scenario: 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

NET_FILE_ENABLED=Off

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.

thinstation:Conf