This section provides troubleshooting information for Oracle Virtual Desktop Clients.
The Maximum Transmission Unit (MTU) is the maximum packet size for connections. By default, the MTU is set to 1500 bytes.
If you experience problems when using a Virtual Private Network (VPN) or a wide area network (WAN), the MTU setting might be too high for your network.
To diagnose the correct MTU setting for your network, use the ping command to find the largest packet size that can be transmitted successfully.
On Windows platforms:
pingserver-name
-lbytes
-f
where
is the name of the Sun Ray server and
server-name
is the
packet size.
bytes
On Mac OS X platforms:
ping -sbytes
-Dserver-name
where
is the name of the Sun Ray server and
server-name
is the
packet size.
bytes
On Linux platforms:
pingserver-name
-sbytes
where
is the name of the Sun Ray server and
server-name
is the
packet size.
bytes
To calculate the MTU setting, add eight bytes to the packet size.
To set the MTU, either change the setting on the Network tab or run the following command:
ovdc --mtubytes
server-name
where
is the
MTU, in bytes and
bytes
is the
name of the Sun Ray server.
server-name
Screen rendering problems, such as slow screen redraw or blocks of black pixels, can occur if the Maximum Transmission Unit (MTU) setting is too high for the network.
The MTU is the maximum packet size for connections. By default, the MTU is set to 1500 bytes.
See Section 17.7.1, “Connection Problems When Using a VPN or WAN” for details of how to diagnose the correct MTU setting for your network.
To help you to diagnose problems with Oracle Virtual Desktop Clients, you can increase the logging level.
Table 17.4, “Oracle Virtual Desktop Client Logging Levels” shows the available logging levels.
Table 17.4. Oracle Virtual Desktop Client Logging Levels
Level | Description |
---|---|
0 | No logging |
1 | Critical messages |
2 | Warnings |
3 | Informational messages |
By default, the logging level is 0
, which sets logging to off. You
can also set the logging domains (categories to log) with the --logging-domains
option, but all logging domains are logged by default.
The logging level is cumulative. For example, the maximum
logging level 3
includes informational
messages, warnings, and critical messages.
To set the logging level, run the following command:
ovdc --logging-levelnum
server-name
where
is the
logging level and
num
is the
name of the Sun Ray server.
server-name
For example, to record warnings and critical messages for a
connection to the sr-1.example.com
Sun Ray
server, run the following command:
ovdc --logging-level 2 sr-1.example.com
By default, log messages are written to a
.log
text file on the client computer. The
.log
file is named after the profile used.
For example, the log file for the default profile is called
default.log
.
The default location of the log file depends on the installation platform, as follows:
Microsoft Windows XP platforms –
C:\Documents and Settings\username\Application
Data\OVDC\profilename.log
Microsoft Windows Vista and Microsoft Windows 7
platforms –
C:\Users\username\AppData\Roaming\OVDC\profilename.log
Mac OS X platforms –
$HOME/.OVDC/profilename.log
Linux platforms –
$HOME/.OVDC/profilename.log
If you use the --profile
command option to specify the path to a
profile, the log file is created automatically in the same directory as the profile. In the
following example, log messages are written to the
C:\temp\fullscreen.log
file.
ovdc --profile C:\temp\fullscreen
You can use the --logfile
command option to
change the name and location of the log file. If the path to
the log file contains spaces, surround the path with straight
quotation marks (").
The following example uses the default profile and writes log
messages to the mylog.txt
file in the
default location.
ovdc --logfile mylog.txt
The following example uses the default profile and writes log
messages to the C:\temp\logfile.txt
file.
ovdc --logfile C:\temp\logfile.txt
The following example uses the
C:\profiles\fullscreen
profile and writes
log messages to the C:\temp\logfile.txt
file.
ovdc --profile C:\profiles\fullscreen --logfile C:\temp\logfile.txt
The following example uses the
C:\profiles\fullscreen
profile and writes
log messages to the mylog.txt
file in the
default location.
ovdc --profile C:\profiles\fullscreen --logfile mylog.txt
Sun Ray Software uses a combination of the on-screen display (OSD) icons and localized error messages to display the status of a connection. The OSD icons can be used to diagnose connection problems with Oracle Virtual Desktop Clients.
See Chapter 16, Sun Ray Client Troubleshooting Icons for details about the available OSD icons.