Troubleshooting

When troubleshooting an error lookup the matching code from this section. If you require further information on what is happening on the thin client follow the instructions on how to contact support in Chapter 8 under the section “Support”.

2X ThinClientServer External Database

2X ThinClientServer provides a small utility to change the IP address of the external database, should you need to change the IP address of the external database server.

You can launch the utility from Start > All Programs > 2X > ThinClientServer > Configure DB Access

From the utility you can edited

2X ThinClientOS Boot Process Error Messages

TCMR001 /proc filesystem already mounted!

Corrupt installation detected. Please contact 2X Technical Support.

TCMR002 Installer package not available.

Corrupt installation detected. Please refer to Chapter 6 and review the methodologies for creating a bootable CD from an ISO file. For further assistance please contact 2X Technical Support.

TCMR003 Distribution not found.

Corrupt installation detected. Please refer to Chapter 6 and review the methodologies for creating a bootable CD from an ISO file. For further assistance please contact 2X Technical Support.

TCMR004 Not enough memory to create root partition in ram.

Insufficient memory for correct operation. Please refer to minimum hardware specifications in Chapter 14.

TCMR005 Unable to load unionfs module.

Corrupt installation detected. Please contact 2X Technical Support.

TCMR006 Unable to mount distribution media.

Reconfigure your thin client’s BIOS settings to disable DMA or UDMA features on all IDE channels. Please contact 2X Technical Support.

TCMR007 Distribution version mismatch.

Corrupt installation detected. Please contact 2X Technical Support.

TCMR008 rootdisk.img failed integrity check.

Corrupt installation detected. Please refer to Chapter 6 and review the methodologies for creating a bootable CD from an ISO file. For further assistance please contact 2X Technical Support.

TCMR011 install.img failed integrity check.

Corrupt installation detected. Please refer to Chapter 6 and review the methodologies for creating a bootable CD from an ISO file. For further assistance please contact 2X Technical Support.

TCMR012 Unable to mount rootdisk image.

Corrupt installation detected. Please refer to Chapter 6 and review the methodologies for creating a bootable CD from an ISO file. For further assistance please contact 2X Technical Support.

TCMR015 Unable to mount installer image.

Corrupt installation detected. Please refer to Chapter 6 and review the methodologies for creating a bootable CD from an ISO file. For further assistance please contact 2X Technical Support.

TCMR016 Unable to pivot to new root.

Corrupt installation detected. Please contact 2X Technical Support.

TCMR018 Unable to update rootdisk image.

Hard Disk error detected. Please re-install 2X ThinClientOS to attempt to resolve this issue. If this error persists after repeated re-installation, it is likely that the only solution will be to replace the faulty Hard Disk.

TCMR020 Kernel version is unsupported.

The version of the loaded OS is not a version supported by the 2X ThinClientOS. Check that the correct files were installed on the system. For further assistance please contact 2X Technical Support.

TCMR021 Unable to load USB drivers.

The drivers for USB support on this device were not loaded successfully. Try to change between USB2/USB1 to enable support or disable the driver if the problem persists.

2X ThinClientOS Autoconfiguration Error Messages

TCAC001 No network devices were detected.

A network card was not detected by 2X ThinClientOS. Make sure that a working network card is installed on the thin client. If a network card is correctly installed and you still encounter this problem, please send us the full technical details of the model and manufacturer of the card in question.

TCAC002 No network settings were received from the DHCP service.

If no settings are provided by the DHCP service, or if the settings provided are incomplete, you should consult Chapter 3. The following settings are required for 2x ThinClientOS to boot up:

Should you be doing a PXE install you may optionally need:

TCAC003 Unable to mount root file system read-only.

Corrupt installation; reinstall 2X ThinClientOS.

TCAC004 Unable to mount root file system read/write.

Corrupt installation, reinstall 2X ThinClientOS.

TCAC005 Unable to correct root file system errors.

Corrupt installation, reinstall 2X ThinClientOS.

TCAC006 Started in install mode however installer is not available.

The installation package couldn’t be loaded from the Server or CD/USB.

TCAC007 No settings were received from the 2X ThinClientServer.

2X ThinClientOS was unable to contact the 2X ThinClientServer. Either the 2X ThinClientServer is off, or otherwise inaccessible. Check your firewall configuration.

2X ThinClientOS Update Error Messages

TCUP001 Unable to download latest package version.

No 2X ThinClientOS was uploaded to 2X ThinClientServer. This can be obtained as a ZIP file from:

http://www.2x.com/thinclientserver/downloadlinks.html

Please refer to the chapter entitled “Configuring 2X ThinClientServer”

TCUP002 Unable to download X11R6 package.

There seems to be an error while downloading the Video package for 2X ThinClientOS. In the case of PXE booting this may be due to insufficient memory on the thin client. If you have performed a Hard Disk installation, this may be due to insufficient space.

TCUP004 Unable to download rootdisk package.

There seems to be an error while downloading the 2X ThinClientOS package. In the case of PXE booting this may be due to insufficient memory on the thin client. If you have performed a Hard Disk installation, this may be due to insufficient space.

TCUP005 Unable to download minird package.

There seems to be an error while downloading the pre-boot image. In the case of PXE booting this may be due to insufficient memory on the thin client. If you have performed a Hard Disk installation, this may be due to insufficient space.

TCUP006 Unable to download kernel package.

There seems to be an error while downloading the kernel package for 2X ThinClientOS. In the case of PXE booting this may be due to insufficient memory on the thin client. If you have performed a Hard Disk installation, this may be due to insufficient space.

TCUP008 X11R6 package failed integrity check.

A corruption has occurred in the package downloaded from 2X ThinClientServer. This may be due to an error in the file hosted on the 2X ThinClientServer, a network transmission error, or lack of space on the 2X ThinClientOS.

TCUP010 Failed to overlay X11R6 package.

TCUP014 Unable to access temporary filesystem.

2X ThinClientOS has run out of memory used during the update process.

TCUP015 Unable to mount X11R6 package.

TCUP017 Unable to mount services package.

TCUP018 Failed to overlay services package.

TCUP019 Services package failed integrity check.

TCUP020 Unable to download services package.

There seems to be an error while downloading the services package for 2X ThinClientOS. In the case of PXE booting this may be due to insufficient memory on the thin client. If you have performed a Hard Disk installation, this may be due to insufficient space.

TCUP024 2X ThinClientServer has insufficient licences to start your session.

2X ThinClientServer has run out of licences while setting up this client. Purchase additional licences to implement more thin clients

TCUP025 2X ThinClientServer licence has expired.

The licence for 2X ThinClientServer has expired. Please purchase a licence to continue using 2X ThinClientServer.

TCUP029 Unable to overwrite kernel with update.

An error has occurred while replacing kernel with a newer version. This may be due to lack of space on the 2X ThinClientOS or a corruption on the hard disk.

TCUP030 Unable to overwrite minird with update.

An error has occurred while replacing a package with a newer version.

This may be due to lack of space on the 2X ThinClientOS or a corruption on the hard disk.

TCUP031 Unable to copy rootdisk update.

An error has occurred while copying new package version to disk. This may be due to lack of space on the 2X ThinClientOS or a corruption on the hard disk.

TCUP034 Unable to remount media as read/write.

An error has occurred while trying to configure hard disk for read/write access. This may be due to a corruption on the hard disk.

TCUP035 Unable to remount media as read-only.

An error has occurred while trying to configure hard disk for read-only access. This may be due to a corruption on the hard disk.

TCUP036 Unable to download install package.

An error has occurred while trying to download package from the network. This may be due to a network transmission error or 2X ThinClientServer is no longer available.

TCUP037 Unsupported running kernel version.

The version of the loaded OS is not a version supported by the 2X ThinClientOS. Check that the correct files were installed on the system. For further assistance please contact 2X Technical Support.

TCUP038 Unable to download checksum list.

An error has occurred while trying to fetch the package integrity checksums. This may be due to a network transmission error or 2X ThinClientServer is no longer available.

TCUP039 Rootdisk package doesn't match checksum.

A corruption has occurred in the rootdisk package. This may be due to an error in the file hosted on the 2X ThinClientServer, a network transmission error, or lack of space on the 2X ThinClientOS.

TCUP040 Minird package doesn't match checksum.

A corruption has occurred in the minird package. This may be due to an error in the file hosted on the 2X ThinClientServer, a network transmission error, or lack of space on the 2X ThinClientOS.

TCUP041 Kernel package doesn't match checksum.

A corruption has occurred in the kernel package. This may be due to an error in the file hosted on the 2X ThinClientServer, a network transmission error, or lack of space on the 2X ThinClientOS.

TCUP043 Installer package doesn't match checksum.

A corruption has occurred in the installer package. This may be due to an error in the file hosted on the 2X ThinClientServer, a network transmission error, or lack of space on the 2X ThinClientOS.

TCUP044 Kernel options do not match checksum.

A corruption has occurred in the boot option settings sent by the ThinClientServer. This may be due to an error in the file hosted on the 2X ThinClientServer, a network transmission error, or lack of space on the 2X ThinClientOS.

TCUP045 Unable to download kernel options.

An error has occurred while trying to download the default boot options from the network. This may be due to a network transmission error or 2X ThinClientServer is no longer available.

TCUP046 No settings were received from 2X ThinClientServer.

2X ThinClientOS was unable to contact the 2X ThinClientServer. Either the 2X ThinClientServer is off, or otherwise inaccessible. Check your firewall configuration.

TCUP047 Unable to download USB packages from 2X ThinClientServer.

An error has occurred while trying to download the packages necessary for USB support. This may be due to a network transmission error or the 2X ThinClientServer is no longer available.

2X ThinClientOS Video Error Messages

TCXS001 Failed to start in graphical mode.

2X ThinClientOS failed to start graphics mode correctly. A VESA compatible video card is required to start in graphical mode. Please contact 2X Technical Support with the exact details of the Manufacturer and Model of the video card used as well as that of the monitor.

TCSX001 No configuration was returned by 2X ThinClientServer.

2X ThinClientOS failed to receive the required configuration file from the 2X ThinClientServer. This could be possible to a misconfigured server or a server mismatch. Please check that the 2X ThinClientServer and 2X ThinClientOS are installed correctly.

TCSX002 Video card driver corrupted.

The video card driver needed for the thin client has been downloaded incorrectly or is corrupted. In the case of CD booting, make sure that the CD was burnt correctly. In the case of HD booting, make sure the ThinClientOS is not running out of disk space. In case of PXE booting, make sure that enough ram is available for the ThinClientOS as described in the minimum requirements section.

TCSX003 Wrong number of parameters in config_device()

The video card has been initialized incorrectly with the wrong set of parameters. Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSX004 Internal error.

Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSX005 Wrong number of parameters in config_device_dual()

The video card has been initialized incorrectly with the wrong set of parameters. Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSX006 Internal error.

Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSX007 No working configuration was found.

All possible video configurations have been attempted and no working configuration was found. Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSX008 Unable to download video card driver.

There seems to be an error while downloading the video card driver for the 2X ThinClientOS. In the case of PXE booting this may be due to insufficient memory on the thin client. If you have performed a Hard Disk installation, this may be due to insufficient space

TCSX009 No banner was received from 2X ThinClientServer.

There seems to be an error while downloading the logon banner for 2X ThinClientOS. In the case of PXE booting this may be due to insufficient memory on the thin client. If you have performed a Hard Disk installation, this may be due to insufficient space

2X ThinClientOS Sessions Error Messages

TCSP001 Missing session settings, aborting login session.

2X ThinClientServer failed to send one or more required settings. This could be caused by a network transmission error or 2X ThinClientServer is no longer available.

TCSP002 Failed top delete package cache.

An error has occurred while purging the package cache. This could be caused by a system corruption or failing hardware.

TCSP003 Package not available on CDROM.

A required package was not found on the CDROM media. This could be caused by a corrupted CD media or failing hardware.

TCSP004 Missing configuration files.

Required configuration file are no longer available on the system. This could be caused by a corrupted system or failing hardware.

TCSP006 Unable to download package from 2X ThinClientServer.

An error has occurred while downloading package from 2X ThinClientServer. This could be caused by a network transmission error or 2X ThinClientServer is no longer available.

TCSP008 Package failed integrity check.

A corruption has occurred in the package downloaded from 2X ThinClientServer. This may be due to an error in the file hosted on 2X ThinClientServer, a network transmission error, or lack of space on the hard disk.

TCSP009 Unable to mount package.

An error has occurred while loading the package into the system. This may be caused by a network transmission error or hardware failure.

TCSP010 Failed to overlay package.

An error has occurred while configuring the system with the new package. This may be caused by a system corruption or hardware failure.

TCSP011 Unable to copy download package from temporary location.

There seems to be an error while copying a package inside the 2X ThinClientOS. In the case of PXE booting this may be due to insufficient memory on the thin client. If you have performed a Hard Disk installation, this may be due to insufficient space or corruption.

TCSP012 Unable to remove package from local storage.

A system package couldn’t be removed during the update process. This can be due to hard disk corruption or bad memory.

TCSS001 Missing connection settings, aborting login session.

An error has occurred while provisioning settings to the 2X ThinClientOS. Either a corruption has occurred over the line or else there is some misconfiguration in the connection settings. Please double check your connection settings and associated protocol.

TCSS002 Your connection requires an NX session however the client is not available.

The 2X ThinClientOS you are using is designed for a different Terminal Server. Please contact your administrator to obtain a version of 2X ThinClientOS targeted for an NX session.

TCSS003 Your connection requires an RDP session however the client is not available.

The 2X ThinClientOS you are using is designed for a different Terminal Server. Please contact your administrator to obtain a version of 2X ThinClientOS targeted for an RDP session.

TCSS004 Your connection requires an ICA session however the client is not available.

The 2X ThinClientOS you are using is designed for a different Terminal Server. Please contact your administrator to obtain a version of 2X ThinClientOS targeted for an ICA session.

TCSS005 Your RDP session terminated abnormally.

A network error has occurred while connected to your Remote Session. This can be due to incorrect settings or else due to the session being interrupted from the Terminal Server. If this is not the case make sure that the thin client is not experiencing any memory corruption or network outages, or is out of disk space.

TCSS006 Your ICA session terminated abnormally.

TCSS007 Unable to logoff user from session.

A network error has occurred while connected to your Remote Session. This can be due to incorrect settings or else due the session being interrupted from the Terminal Server. If this is not the case make sure that the thin client is not experiencing any memory corruption or network outages or is out of disk space.

TCSS008 Your NX session terminated abnormally.

TCSS009 Empty password is not permitted in an NX session.

An empty password is not permissible to establish a valid session to 2X TerminalServer. Please supply credentials with a valid username and the respective valid, non-empty, password.

TCSS010 Your connection requires a local desktop however the window manager is not available.

A required component to configure your system as a local desktop is missing. This could be caused by a corrupted package.

TCSS011 Your connection requires RDP published applications however the client is not available.

A required component to access RDP publish applications is missing. This could be caused by a corrupted package.

TCSS012 Your desktop session terminated abnormally.

An error has occurred during the desktop session. This could be caused by a corrupted system or faulty hardware.

TCSS013 Your connection requires ICA published applications however the client is not available.

A required component to access ICA publish applications is missing. This could be caused by a corrupted package.

TCSS014 Missing thin client settings, aborting login session

2X ThinClientServer failed to send one or more required settings. This could be caused by a network transmission error or 2X ThinClientServer is no longer available.

TCSS015 Missing session settings, aborting login session

2X ThinClientServer failed to send one or more required settings. This could be caused by a network transmission error or 2X ThinClientServer is no longer available.

TCSS017 An error has occured to populate the 2X managed desktop.

The list of published applications has caused an error in creating the appropriate 2X managed desktop. Reduce the list of published applications to identify which is the problem.

TCSS018 No published applications are available.

The user has no published applications available from the Terminal Server farm. Please check the applications provisioning for the particular user.

TCSS020 No published applications are available.

The user has no published applications available from the Terminal Server farm. Please check the applications provisioning for the particular user. Also check that all IP addresses and ports to the Farm are set correctly and that the username with the given domain and credentials have access to a set of applications.

TCSS021 Unable to populate protocol sessions.

An error has occurred when transferring the list of session settings for the user from the ThinClientServer. This could be due to a network error or due to a missing setting which is still registered to that user.

TCSS022 Unable to retrieve session settings from 2X ThinClientServer.

An error has occurred when transferring the list of session settings for the user from the cached store. This could be due to file corruption or due to a missing setting which is still registered to that user.

TCSS023 The administrator has terminated your session.

The administrator has forcefully stopped your session from the 2X ThinClientServer Management Console.

TCSS025 Your desktop requires Opera but it is not available.

A required component to run the Opera Web browser is missing. This could be caused by a corrupted package or lack of resources on the thin client.

TCSS026 Your desktop requires Flash but it is not available.

A required component to run the Flash plugin inside the Web browser is missing. This could be caused by a corrupted package or lack of resources on the thin client.

TCSS027 Your desktop requires Java but it is not available.

A required component to run the Java Virtual Machine is missing. This could be caused by a corrupted package or lack of resources on the thin client.

TCSS028 The server with your published applications could not be contacted. Check that your network settings are correct.

A problem occurred when trying to contact the published application server due to the network settings that are currently being used by the thin client. Make sure that the server is reachable and that all hostnames and domain suffixes can be resolved. Also check that no ports on the server are blocked. Use the network diagnostics tool to troubleshoot this problem.

TCSS029 Invalid credentials when connecting to <host>.

The credentials supplied to the 2X desktop are not valid for this host. Make sure that the username, password as well as the domain are correct.

TCSS030 A connection to the server could not be established. Check network services and settings.

A problem occurred when trying to contact the server due to the network settings that are currently being used by the thin client. Make sure that the server is reachable and that all hostnames and domain suffixes can be resolved. Also check that no ports on the server are blocked. Use the network diagnostics tool to troubleshoot this problem.

2X ThinClientServer (Windows) Slave Redundancy Error Messages

TCSRD001 This is not the master server.

The IP/hostname of the server you provided is not a 2X ThinClientServer in master mode.

TCSRD002 The master cannot reach the slave server.

The external IP/hostname of the slave server is not reachable by the master 2X ThinClientServer. Make sure that the network configuration is correct and that the address is routable. Also, ensure that no ports are blocked by a firewall.

TCSRD003 Schema Mismatch.

The database schema of the master server does not match the one installed on this slave server. Make sure that the versions of the both the master server and of this server match. If the error persists, follow the instructions to generate a debug log and send it to the 2X Support Centre.

TCSRD004 Session Error.

An error has occurred during the replication process. This can be due to a network error or to lack of resources on the master of slave server.

TCSRD005 Invalid console credentials.

The credentials provided for the master 2X ThinClientServer do not match the credentials used in the Management Console. Verify that the credentials are correct in the Management Console and try again.

TCSRD006 Administrator does not have the rights to install new slaves in this farm.

You do not have enough rights to install a slave server. Contact your administrator.

TCSRD007 Cannot get mysqldump.

A critical error has occurred when replicating the database contents. Follow the instructions to generate a debug log and send it to the 2X Support Centre.

TCSRD008 Invalid or expired licence key.

Contact your 2X ThinClientServer sales representative for an Enterprise Edition licence key.

TCSRD051 Cannot open session lock file.

An error has occurred when attempting to read the session lock file. Make sure that you have the sufficient credentials to perform these operations.

TCSRD052 Cannot write session lock file.

An error has occurred when attempting to write the session lock file. Make sure that you have the sufficient credentials to perform these operations.

TCSRD053 Cannot connect to the master server.

The IP/hostname of the master server is not reachable by this server. Make sure that the network configuration is correct and that the address is routable. Also, ensure that no ports are blocked by a firewall.

TCSRD054 Missing parameters.

An internal error has occurred. Follow the instructions to generate a debug log and send it to the 2X Support Centre.

TCSRD055 File transfer error.

An error has occurred during the replication process. Please try again. If the error persists, check that the network connection is working properly.

TCSRD056 File open error.

A required file in the replication process is missing. Ensure that all ThinClientOS images on the master server are installed correctly. If the problem persists, follow the instructions to generate a debug log and send it to the 2X Support Centre.

TCSRD057 File write error.

A required file in the replication process could not be written. Ensure that you have enough permissions to complete the replication process and that there is enough disk space to replicate the master server. If the problem persists, follow the instructions to generate a debug log and send it to the 2X Support Centre.

TCSRD058 Cannot register the slave server.

An error has occurred when registering the slave in the database. Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSRD059 Post update schema mismatch.

The schema that was replicated does not match the schema which was originally installed on the slave server. Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSRD065 Cannot open server_id.

An error has occurred when trying to identify the ID of the master server. Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSRD066 Cannot write server_id.

An error has occurred when trying to register the identity of the slave server. Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSRD067 Cannot add new server entry to local database.

An error has occurred when registering the slave in the database. Follow the instructions to generate a debug log and send them to the 2X Support Centre.

TCSRD070 Cannot remove directory content.

Ensure that you have enough rights to the folder containing the ThinClientOS images on the slave server.

TCSRD071 Cannot create licence file.

An error has occurred when attempting to write the session lock file. Make sure that you have the sufficient credentials to perform these operations.

TCSRD072 Cannot write licence file.

An error has occurred when attempting to write the session lock file. Make sure that you have enough disk space.

TCSRD073 License file transfer error.

An error has occurred when transferring the licence to the slave server.

TCSRD099 An error has occured in the replication process.

The installation could not be completed successfully due to an error that occurred during part of the installation.