The article looks at how to reset a Wyse terminal to factory defaults. There have been many different types of hardware platforms that Wyse have produced over the years ranging from generic x86 platforms to Wyse proprietary designs. This range of designs has also seen a number of different tools to manage them, any administrator new to Wyse devices should be aware of these tools and how to use them.
During the course of this article we will cover four key points for each platform, these are
- Reset to factory defaults
- Access a locked terminal
- Recover a terminal with a corrupt OS
- Manage a functional terminal
This refers to setting a terminal back to to state it was when it first left the factory. This can be done with a key combination on some terminals and others require the factory firmware to be loaded again. With the Wyse Thin OS (Formally Blazer), CE and Linux platforms this can be performed by holding the "G" key down on the key board as the terminal boots. Linux terminals my require you to "tap" the G-Key continuously rather than hold it down. If all goes well the terminal will display a message "Resetting to factory defaults" and reboot.
This works well for WTOS (Wyse Thin OS) as these are stateless devices and the base firmware never changes, the G-Key reset instructs the device to drop the configuration. CE and Linux devices can operate in a mode where it holds a config that supports removal by the G-Key however they also support custom firmware changes. It is very possible the a CE/Linux terminal with custom firmware will not reset its self as the factory firmware is not on the unit or it has been modified.
With all devices it is possible for the administrator to disable the G-Key feature, if this is the case with WTOS you will need to perform the steps in the "Access a Locked Terminal" section. If you have a CE/Linux terminal with custom firmware or the G-Key disabled you will need to load new firmware as outlined in the "Recover a terminal with a corrupt OS" section
Note that NTe and XPe terminals DO NOT support the G-Key as any configuration to Windows is made a file level and requires a firmware reload to remove changes.
Access a locked terminal
On most terminals it is possible to lock the device down and hide the administrator controls, if using second hand terminals they will have to be unlocked even if you do not have the administrator passwords before configuring.
WTOS can be controlled using DHCP option tags and a text file on a FTP server, this method of configuration always over rides and existing settings. This is important to remember as for a locked terminal the device can be simply put into a DHCP managed environment and have the signon=0 privilege=high statement in the WNOS.INI file and the device will be unlocked, you can then reset the device by choosing shutdown and tick the "reset to factory defaults" dialog box. To summarise for WTOS:
- Setup the DHCP option tags as sown here
- Crete a ftp server with a wnos.ini file (overview here and example configs here)
- Edit the wnos.ini file to include these two statements - signon=0 privilege=high
For all other operating systems (CE, Linux, NTe and XPe) check that the device has not been locked with the default passwords. Check the admin guides however with NTe and XPe hold the shift key and log off, this will bring up the Login GUI. Log in as Username: Administrator Password: Administrator. Windows CE can use the Ctrl-F4 to access the admin menu during the logon or logoff prompt (you will need the admin password that it has been set to). If you can not access the terminal still the simplest way is to load the firmware with the factory version, this can be downloaded from the Wyse web site. The trick is in actually loading the firmware as depending on the OS and hardware platform there a variety of tools that may be required. Later in the article we look at the tools associated with the various platforms. In the next section we cover what there tools are.
Recover a terminal with a corrupt OS
Often it is required to load a fresh image to recover a terminal, either because the thin client is locked out of admin mode or the OS is missing/corrupted. This will load the operating system however you must have a unit with a functional BIOS to fully recover a unit. If the BIOS is corrupt you will need to have it reprogrammed with a EPROM burner at a service centre - fortunately this is not usually required and it is only the OS that needs reloading.
Lets look at some of the tools that may be required depending on the age of your device.
- DOC Tools (Disk On Chip Tools)
- Xfer
- netXfer
- Wyse Simple Imager
DOC Tools (Disk On Chip Tools)
This is a DOS based set of tools from M-Systems who made the Disk On Chip flash used in the old Netier XL series terminals, Wyse purchased Netier and re-branded these devices such as the 8440XL/SL. You will need to boot the device in to DOS to use the tools and this was done during manufacture of the devices by loading a PXE DOS disk and mapping a drive to run the tools and load the .img file.
Xfer
Xfer (Transfer?) is used from DOS again to load an image via a Parallel LapLink cable. This tool must be run from DOS not a NT based command shell, it is a very simple tool to use. Boot a PC from a DOS disk and connect to the target terminal with the laplink cable, download this tool with full instructions here
netXfer
netXfer is a self contained bootp and TFTP client however is is configured to listed on port 10067 and 10068 for the bootp broadcast and deliver the image on port 10069. A terminal booted with the "P" key depressed will start the netXfer process. netXfer is easy to use and runs from a simple .exe, this is an old tool and will require that the OS have Microsoft Java (not SUN) installed. Because of this Vista will not run the tool and MS Java has a number of security holes since Microsoft can no longer update it. If you wish to use your own standard bootp and TFTP tools (ports 67, 68 and 69) boot the device holding the "Q" key.
Download this tool with instructions here, to get the old MS Java click here
Wyse Simple Imager (WSI)
WSI is really a tool that has the core Wyse wizard imaging system which is PXE based. To install this tool you will need to create a complete PXE environment with a ftp server as well. The tool should not be installed on a server that has Rapport/WDM installed as it uses many of the same files. This tool will also require a DHCP server and there is a link to a free-ware one to use with a standalone PC. WSI is clunky to install but simple to use once its running.
Any newer Wyse device that support PXE can have an image loaded via WSI. Visit the wyse.com download section to get this tool and the installation instructions.
USB memory disk
Wyse do not support imaging from a USB key however a un-official USB imaging system that works with XPe/Linux V-class devices can me downloaded from this site here.
Manage a functional terminal
Finally once the device is up and running we look at the tools to manage it
Classic – Models WT2000T, WT2300, WT2300T, WT2300SE, WT2500, WT2500T, WT2600, WT2700, and WT2700T
Mars – Models WT2310SE, WT2315SE, WT2510SE, WT2515SE, WT2610SE, WT2710SE, WT2715SE, WT3315SE, WT3515SE, WT3715SE, WT5315SE
These devices ran "Bills OS" which was a DOS based OS (the 2000 series) and also early Windows CE and Linux. I have no idea how these were managed centrally, use Xfer to recover.
Leo – Models WT3350SE, WT5250SE, WT5355SE, CPQ T1000, CPQ T1500
The Leo devices ran Windows CE and Linux and had the SNMP Rapport agent as well as supporting the Hagent on CE. Use Xfer to recover.
Midway, Hiway, Speedway – Models WT3320SE, WT3360SE, WT3520SE, WT3620SE, WT3720SE, CPQ T1010, CPQ T1510
These devices ran Windows CE and Linux and had the SNMP Rapport agent as well as supporting the Hagent on CE. Use Xfer to recover.
ULC/UTC – Models WT1200LE, WT3200LE, WT3230LE, WT3630LE, WT8230LE, WT8630LE
STP – Models WT1200 Plus, WT3235LE, WT8235LE, WT9235LE, CPQ T20
PEI – Model CPQ T30 (With Windows CE)
Franklin – Models WT1125SE, WT3125SE, WT5125SE, WT3425SE
Franklin – Models WT1125SE, WT3125SE, WT5125SE, WT3425SE
These devices ran Windows CE, Linux, NTe and support the Rapport Hagent. WDM can be used on these devices. The 8230/8235LE modles will require NT extract to "pull" the OS from a NT device. This can then be loaded to new device via a Windows share, it is also possible to use the NT extracted files to create a new binary image. Use ftp (for Blazer) or netXfer to recover.
PEI – Model CPQ T30 (With Windows NTe or XPe)
As above but use WSI to recover
XL – Models WT5440XL, WT8440XL, WT9440XL
These devices were manufactured by Netier and this company was purchased Wyse. Rapport 3 managed these devices however it is possible to load the DOC tools boot floppy into Wyse Device Manager. USe a PXE DOC tools to recover
Armstrong / Gemini – Models WT3455XL, WT3650XE, WT5455XL, WT9450XE, WT9455XL, WT9650XE, WT941GXL
Use Wyse Device Manager with these devices and WSI to recover.
Saturn – Models WT3150, WT5150, WT9150
Callisto/CallistoII – Models S30, S50, S90
Venus - V30, V50, V90
VL - V10L, V30L, V50L and V90L
Use Wyse Device Manager with these devices and WSI to recover.
Tools:
Xfer
netXfer and MSJava
WSI (from Wyse firmware downloads, select V90L from dropdown page)
USB imaging
