This section describes the various ways you can manage a Windows session when hotdesking occurs.
The uttsc command enables you to specify what
happens to the Windows session when a user hotdesks to another
client. You can set this behavior by using the
-H
option.
The modes include:
-H reconnect
- If the remote desktop server is configured in Device
Client Access License Mode, hotdesking a Sun Ray session disconnects and reconnects the
existing remote desktop session. The user must re-enter credentials. This is the default
mode.
-H nodisconnect
- Hotdesking the Sun Ray session does not disconnect
and restart the remote desktop session. The remote desktop session remains connected.
Previously the -O
option.
-H autoreconnect
- If the Automatic Reconnection feature is enabled on
the Windows remote desktop server, hotdesking a Sun Ray session always reconnects to the
remote desktop session. This action updates the client information on the remote desktop
server. The user does not have to re-enter credentials. See Section 17.10, “Automatic Reconnection” for more information.
Location awareness is a feature that provides additional hotdesking capabilities for a Windows session, which enables you to:
Obtain the unique client's name in a Windows session after session startup or even after hotdesking. The client's name is forwarded during hotdesking.
Set up actions through commands or scripts to execute in a Windows session when the associated client session disconnects and reconnects during hotdesking. Actions set up for reconnection also occur at session startup.
In the context of the Windows connector, the client's name is the client ID of the Sun Ray Client or Oracle Virtual Desktop Client, also known as the DTU ID. See Section 13.1.1, “Client ID Differences Between Oracle Virtual Desktop Clients and Sun Ray Clients” for more details.
In some situations, this feature replaces the need to use the utaction at the Sun Ray server operating system level, such as setting up follow-me printing.
Location awareness sets several environment variables, which can be used when actions are executed in a Windows session. Table 17.7 lists the environment variables and the information they contain.
Table 17.7. Location Awareness Environment Variables
Environment Variable | Description |
---|---|
| IP address of the Sun Ray Client or Oracle Virtual Desktop Client. |
| The client ID of the Sun Ray Client or Oracle Virtual Desktop Client. |
| The location of the client, as defined by a Sun Ray server administrator. See Section 13.1.6, “How to Configure a Client's Location and Information” for details. |
| Other information about the client, as defined by a Sun Ray server administrator. See Section 13.1.6, “How to Configure a Client's Location and Information” for details. |
When a session starts or reconnects, the value of the UTCINFO_CLIENTNAME
variable is copied to the Windows CLIENTNAME
environment variable and the
HKey_Current_User\Volatile Environment\CLIENTNAME
registry key.
To enable location awareness, you must install the Client Information Agent on the Windows system using the Sun Ray Windows Components installer, which is described in Section 3.2.7, “How to Install the Windows Connector Components on a Windows System”. Once installed, location awareness is enabled by default and is automatically used when a Windows session starts.
The location awareness feature enables you to obtain a client's name after session startup or even after hotdesking. The client name can be used for various configuration scenarios. You can obtain a client's name by using one of the standard Windows interfaces:
The CLIENTNAME
environment variable.
The HKCU\Volatile
Environment\CLIENTNAME
registry key.
Using the GetComputerName()
function in
a Windows desktop session.
Using the WTSSessionQueryInformation()
function in a Terminal Services session.
The location awareness feature enables you to set up commands
or scripts to execute in a Windows session when the associated
client session disconnects or reconnects during hotdesking,
and when a Windows session starts. To do this as
administrator, specify one or more registry values,
pairs, to the following registry keys:
name
=data
For session disconnects -
HKLM\Software\Oracle\Sun
Ray\ClientInfoAgent\DisconnectActions
For session reconnects and session startup -
HKLM\Software\Oracle\Sun
Ray\ClientInfoAgent\ReconnectActions
For session disconnects -
HKLM\Software\Wow6432Node\Oracle\Sun
Ray\ClientInfoAgent\DisconnectActions
For session reconnects and session startup -
HKLM\Software\Wow6432Node\Oracle\Sun
Ray\ClientInfoAgent\ReconnectActions
Always back up the registry on the Window system before modifying registry keys.
Here are some examples of registry values for the registry
keys mentioned above, where the
Command
name is
used to imply order.
n
Command1=notepad.exe Command2=wscript.exe c:\tmp\myscript.vbs
The
value
specifies the command or script to be executed, and you can
specify either a 'data
String
' or
REG_SZ
value type.
For an executable command, such as a .exe
file, you can specify an absolute path. If you do not provide
a path, the executable is searched for in the following order:
the current directory, the Windows system directory, the
Windows directory, and the directories in the PATH
environment.
For a script, you should specify the script to be run in an interpreter or shell and the script path must be absolute. For example cmd.exe /c c:\foo\script.bat or wscript.exe c:\foo\script2.vbs
There are a number of ways to use location awareness for real-world situations. Here are just a few examples.
A health care provider requires access to the local printer in each patient's room. By using
the ReconnectActions
registry key, you can specify a script to run
whenever a health care provider logs in to a room's Sun Ray Client. For this
situation, you would need to create a script to read the new client's name (Sun Ray
Client's unique ID), perform a lookup to determine the printer in the room, and
configure the Windows session's default printer to be the room's printer. You could
also use the DisconnectActions
registry key to run another script
that removes the currently configured printer when the health care provider
disconnects from the Sun Ray Client.
An instructor wants to automatically display the student's daily syllabus and lab
instructions when the students log in. Since you know the client's name of the Sun Ray
Clients in the training room, you can set up a script to automatically display the
training content when the students log in to any of the Sun Ray Clients in the
classroom. Again, this script would be run by the ReconnectActions
registry key.