C H A P T E R  5

Hotdesking (Mobile Sessions)

The Sun Ray system is designed to enable session mobility, or hotdesking, with or without smart cards. Every Sun Ray DTU is equipped with a smart card reader.

Configuring Sun Ray Server Software with non-smart card mobile (NSCM) sessions provides the benefits of hotdesking without the use of smart cards. This chapter explains NSCM sessions, how to configure them, and how to enable users to access their Sun Ray sessions across multiple failover groups (see Failover Groups).

This chapter contains the following sections:


NSCM Session

In an NSCM session, the user:

If a user does not want to use the NSCM session, inserting a smart card causes the session to be disconnected and replaced by a smart card session.

Sun Ray Mobile Session Login Dialog Box

When Sun Ray Server Software is configured for NSCM sessions, the Sun Ray Mobile Session Login dialog box is displayed on the Sun Ray DTU.

FIGURE 5-1 Sun Ray Mobile Session Login Dialog Box


Welcome screen has an empty text field for user name

A right click on the Options button opens a panel where the user can select:


procedure icon  To Log In to an NSCM Session

1. Type a user name and then a password into the user entry field.

FIGURE 5-2 User name Entry


This figure shows a user name entered in the text field

If there is no NSCM session for this user, the Authentication Manager creates an NSCM session token with the format: mobile.IEE802-<MACID>.

If the Sun Ray server is part of a failover group, the load-balancing algorithm may redirect the user to another Sun Ray server.

A user who has an NSCM session on a different Sun Ray server in a failover group is redirected to the server with the most current NSCM session.

FIGURE 5-3 User Password Entry


This screen welcomes the user and prompts for a password.

The Sun Ray Mobile Session Login dialog box is redisplayed with the host name of the new Sun Ray server, and the user must retype the user name and password.

Disconnecting an Active NSCM or RHA Session

If an NSCM session or an RHA session exists on the current Sun Ray server, it is displayed to the user. A user who wants to move to another location can disconnect by using:



Note - NSCM and RHA sessions can be timed out if the screen lock idle time interval is exceeded. See Mass Storage Devices and Idle Sessions.



procedure icon  To Disconnect the Current Session via Hot Key

To disconnect an NSCM session, the user presses the key combination Shift-Pause.


procedure icon  To Disconnect the Current Session via utdetach

1. Type the utdetach command in a shell window:


% utdetach

2. Press the Shift and Pause keys simultaneously.

The Sun Ray Mobile Session Login dialog box is redisplayed, and the user moves to another Sun Ray DTU.

3. Login at the second Sun Ray DTU.

The session becomes active.

The user can terminate the session by selecting Exit (Logout) from the CDE Workspace Menu or by pressing the key combination Ctrl+Alt+Bksp+Bksp.


procedure icon  To Terminate the Current Session

single-step bullet  Click the Exit button on the CDE panel.
or

single-step bullet  Press the key combination Ctrl+Alt+Bksp+Bksp.



Note - There may be a momentary delay before the session terminates.



procedure icon  To Reconfigure the Disconnect Hot Key Combination

You can change the disconnect key combination (hot key) in the /etc/opt/SUNWut/utslaunch_defaults.properties file, where the site-wide default configuration of the hotkey key combination is specified. Individual users can override the default key combination by configuring the ~/.utslaunch.properties file located in their home directory.

single-step bullet  Edit the respective file and find the line with the utdetach.hotkey property.

Change the string after the equals sign to the keystrokes desired. For example, to configure the key combination of Alt + Esc, type:


% utdetach.hotkey=Alt Escape 


procedure icon  To Customize the Short Cut for Disconnecting an NSCM Session

You can disconnect the current session using the key combination (hot key) in the utslaunch.properties files.

1. To reconfigure the hot key combination, edit the file and find the line with the utdetach.hotkey property.

2. Change the string after the equals sign to the keystrokes desired.


NSCM and Failover Groups

The user login experience for NSCM sessions may be different than expected when systems are configured as part of a failover group.

The following situations may produce unfamiliar behavior:

If server A is heavily loaded when a user logs into it with the NSCM GUI, it redirects the user to server B, which may require another login with the NSCM GUI. If server B is running an earlier Solaris version than Server A, the user may have to log in a third time.

A user with a session on server A who wants to switch to a session on server B invokes the utselect GUI to access the other session. In doing so, the user is required to log in with the NSCM GUI. Users familiar with the ease of the utselect GUI might be discouraged that another login is necessary.

The user bypasses the NSCM GUI by clicking the Exit button and logs into server A using dtlogin. The user now has a standard escape token session and invokes the utselect GUI to switch to server B, causing the NSCM GUI to be presented again. The user must click Exit again to get to the escape token session on server B. Users accustomed to switching rapidly may find this behavior annoying.


Configuring the Authentication Manager for NSCM Sessions



Note - If the IP addresses and DHCP configuration data are not set up properly when the interfaces are configured, the failover feature will not work properly. In particular, if the Sun Ray server’s interconnect IP address has been configured as a duplicate of any other server’s interconnect IP address, the Sun Ray Authentication Manager may generate “Out of Memory” errors.


The Sun Ray administrator can enable the NSCM session features with the Sun Ray Admin GUI or from a command line.


procedure icon  To Enable NSCM Sessions From the Admin GUI

1. Before changing the Authentication Manager policy, inform your users that all active and detached sessions will be lost.

Use the utwall command to send the notice of policy change. For example:


# /opt/SUNWut/sbin/utwall -d -t ’System policy will change in 10 minutes.\nAll active and detached sessions will be lost.\nPlease save all data and terminate your session now.’ ALL

The following message is seen by all users in a pop-up window:


System policy will change in 10 minutes.
All active and detached sessions will be lost.
Please save all data and terminate your session now.

2. Log in to the Admin GUI.

3. Go to the System Policy tab (see FIGURE 5-4.)

FIGURE 5-4 System Policy Tab


Radio buttons and check boxes for policy settings

4. In the Non-Card Users panel, check the Enabled box next to Mobile Sessions.

5. Go to the Servers tab.

6. Click Cold Restart to restart Sun Ray services and terminate all users’ sessions.


procedure icon  To Enable NSCM Sessions From a Command Line

The Sun Ray administrator can toggle the NSCM session capability by including or excluding the -M argument in the utpolicy command. For more information, see the utpolicy man page.

1. Before changing the Authentication Manager policy, inform your users that all active and detached sessions will be lost.

You can use the utwall command to provide them the notice of policy change. For example:


# /opt/SUNWut/sbin/utwall -d -t ’System policy will change in 10 minutes.\nAll active and detached sessions will be lost.\nPlease save all data and terminate your session now.’ ALL

The following message is seen by all users in a pop-up window:


System policy will change in 10 minutes.
All active and detached sessions will be lost.
Please save all data and terminate your session now.

2. As superuser, type the utpolicy command for your authentication policy with the addition of the -M argument. For example:


# /opt/SUNWut/sbin/utpolicy -a -M -s both -r both

This example configures the Authentication Manager to allow self-registration of users both with or without smart cards, and NSCM sessions are enabled.

3. Initialize Sun Ray services.

a. Type this command to restart the Authentication Manager.


# /opt/SUNWut/sbin/utrestart -c

This command clears all active and detached sessions

b. Repeat Step a on each secondary Sun Ray server if in a failover group.


Regional Hotdesking

Regional hotdesking can be enabled by means of multiple failover groups. Multiple failover groups are useful for various reasons, such as:

It is sometimes advantageous to have multiple, geographically-separate locations, each with a failover group, so that if an outage occurs at one location, another location can continue to function.

Some sites have different administrative policies at different locations. It can be advantageous to keep separate failover groups at these locations.

Regional hotdesking, sometimes referred to as Automatic Multi-Group Hotdesking (AMGH), is useful when an enterprise has multiple failover groups and users who move from one location to another who wish to gain access to their existing session wherever they roam. The following sections describe regional hotdesking. For further technical detail, please refer to the utamghadm(1M),ut_amgh_get_server_list(3), and ut_amgh_script_interface(3) man pages.



Note - Regional hotdesking is not enabled for multihead groups.


Functional Overview

Once regional hotdesking is configured, user login information and sessions are handled as follows:

1. When a smart card is inserted or removed from the system or a user logs in via the greeter GUI, parameters such as the user name (if known at the time), smart card token, and terminal identifier are passed to a piece of site integration logic.

2. The site-integration software uses these parameters to determine to which Sun Ray servers it should direct the Sun Ray DTU.

3. If the smart card token is associated with a local session, then that session gets preference, and regional hotdesking is not invoked.

4. Otherwise, the regional hotdesking software redirects the Sun Ray DTU to connect to the appropriate Sun Ray server.

Thus, if the user has an existing session, the DTU connects to that session; if not, the regional hotdesking software creates a new session for that user.

Site Requirements

To utilize regional hotdesking, a site must provide some site integration logic that can utilize enterprise data to determine which users or Sun Ray DTUs should connect to which failover groups. This is ordinarily provided through the use of a dynamic C library or a shell script that implements a particular interface used by regional hotdesking software. SRSS provides some reference code that a site administrator can use as an example or adapt as required. An administrator must configure the regional hotdesking software to utilize a specified library or shell script, then implement the PAM stack of the login applications, as described below.



Note - To ensure continuous operation, the be sure to include enough servers in the target group to provide availability for session location and placement in the event that a particular server becomes unavailable. Two servers should be minimally sufficient for most sites; three servers provide a conservative margin of error.


Providing Site Integration Logic

To determine where given Sun Ray DTUs or users should be connected when creating or accessing sessions, the administrator must utilize enterprise data. Sun Ray Server Software 4.1 includes for this purpose:


procedure icon  To Configure a Site-specific Mapping Library

The administrator for each site must determine what mapping library to use. It may be a site-specific implementation, as described above, or one of the sample implementations provided with the SRSS software.

Use the /opt/SUNWut/sbin/utamghadm command to configure the regional hotdesking software to use this library.

1. To configure the token-based mapping implementation provided as a sample, execute the following:


# /opt/SUNWut/sbin/utamghadm -l /opt/SUNWutref/amgh/lib/libutamghref_token.so

2. To configure the user name-based mapping implementation provided as a sample, execute the following:


# /opt/SUNWut/sbin/utamghadm -l /opt/SUNWutref/amgh/lib/libutamghref_username.so

3. To configure a script-based back-end mapping (for example, the token-and-user name-combination-based mapping sample), use the -s option to this command:


# /opt/SUNWut/sbin/utamghadm -s  /opt/SUNWutref/amgh/lib/utamghref_script

4. Perform a cold restart of the SRSS services using either the utrestart CLI or the Admin GUI.

Token Readers with Regional Hotdesking

To utilize token readers with regional hotdesking based on Sun Ray pseudo-tokens, use the Site-specific Mapping Library to produce the desired behavior for them.

Configured token readers should have the following value formats:


*Key

*Value

insert_token

pseudo.<MAC_address>

token

TerminalId.<MAC_address>


If a registered policy is in place, use the insert_token key instead of the token key, which is not globally unique.



Note - The RHA security feature does not affect token readers. It is assumed that token readers are deployed in physically secure environments.



procedure icon  To Configure the Sample Data Store

Each site must configure a data store to contain site-specific mapping information for regional hotdesking. This data store is used by the site mapping library to determine whether regional hotdesking should be initiated for the parameters presented. The data store can be a simple flat file. The sample implementations included with the SRSS require a simple flat file configuration.

single-step bullet  Create the back-end database file under /opt/SUNWutref/amgh/back_end_db on the Sun Ray server:

a. For a token-based mapping, use entries of the form:


token=XXXXXXX [username=XXXXX] host=XXXXX 

b. For a user name-based mapping, use entries of the form:


username=XXXXX host=XXXXX 

c. For a combined mapping, use entries of the form:


 Any combination of TOKEN BASED and USERNAME BASED lines.

A sample line for this file would look like the following:


 token=MicroPayflex.5001436700130100 username=user1 host=ray-207



Note - Tokens for NSCM and authenticated smart cards have the form auth.<username>. These tokens cannot be affected by AMGH. Use the username key instead.



procedure icon  To Disable Regional Hotdesking

1. To disable AMGH configuration for a group, run the following command:


% /opt/SUNWut/sbin/utamghadm -d

2. Perform a cold restart of the SRSS services using either the utrestart CLI or the Admin GUI.


Remote Hotdesk Authentication (RHA)

The default behavior of the SRSS Authentication Manager now requires users to be authenticated when hotdesking, i.e., upon reconnection to an existing session.

The Authentication Manager asks the Session Manager to create a temporary new session for this purpose. After the user has been successfully authenticated, the Sun Ray DTU is connected directly to the user’s session. This authentication does not apply to anonymous Kiosk Mode, and Sun Ray Server Software can be configured to turn this security policy feature off if desired.

RHA and NSCM sessions can be timed out if the screen lock idle time interval is exceeded. See Mass Storage Devices and Idle Sessions.



Note - The RHA security feature does not affect token readers. It is assumed that token readers are deployed in physically secure environments.



procedure icon  To Disable or Re-enable RHA Using the Admin GUI

See System Policy for a description of the RHA check box.


procedure icon  To Disable RHA from a Command Line

1. To disable RHA from a command line, use the -D option to utpolicy.

For example, if your policy allows smart cards and non-smart card logins and FOGs, use the following command and options to disable RHA:


# utpolicy -a -z both -g -D

2. Perform a cold restart of the SRSS services:


# utrestart -c


procedure icon  To Re-enable RHA from a Command Line

1. To re-enable RHA from a command line, restate your policy using utpolicy without the -D option.

For example, to reinstate a policy that allows smart cards and non-smart card logins and FOGs with RHA, use the following command and options:


# utpolicy -a -z both -g

2. Perform a cold restart of the SRSS services:


# utrestart -c