Sun Microsystems, Inc.  Sun System Handbook - ISO 3.4 June 2011 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-71-1011918.1
Update Date:2011-03-16
Keywords:

Solution Type  Technical Instruction Sure

Solution  1011918.1 :   Sun Ray[TM]: How to find the MAC address of the Sun Ray[TM] appliance to which currently logged in  


Related Items
  • Sun Ray Hardware
  •  
  • Sun Ray Hardware
  •  
  • Sun Ray Software
  •  
  • Sun Ray Hardware
  •  
  • Sun Ray Hardware
  •  
  • Sun Ray Hardware
  •  
Related Categories
  • GCS>Sun Microsystems>Desktops>Desktop Virtualization>Sun Ray Hardware
  •  
  • GCS>Sun Microsystems>Desktops>Desktop Virtualization>Sun Ray Software
  •  

PreviouslyPublishedAs
216314


Description
Sun Ray[TM]: How to find the MAC address of the Sun Ray[TM] appliance to which currently logged in

This document describes several methods to find the MAC address of a Sun Ray[TM] appliance where the user is currently logged in.



Steps to Follow
The MAC address of a Sun Ray[TM] appliance is a 12 hex digits string. The leading 3 bytes of the MAC address can be "080020", "0003BA", or 00144F . Other Sun OUIs which might be used for future Sun Ray[TM] appliances are 00007D, 00015D, and 0020F2.

Below are  several methods to identify the MAC address of a Sun Ray[TM] appliance.

1.) Obtaining a Sun Ray[TM] appliance's MAC address using the keyboard

Simultaneously press all three audio keys on the upper right-hand corner of the keyboard to obtain its MAC address.
Note:  The audio keys have a speaker symbol on them.

See also technical solution <Document: 1003324.1> Sun Ray[TM]: Which Hot Keys are available in a Sun Ray Environment  

With Sun Ray[TM] appliances running 1.2 firmware, the firmware puts up an icon showing the last 3 bytes or the appliance's MAC address, i.e., b58ffc.

With Sun Ray[TM] appliances running 1.3 firmware, the firmware puts up an icon  showing the complete six bytes of the appliance's MAC address, i.e., 080020b58ffc.

With Sun Ray[TM] appliances running 2.0 or 3.x firmware, the appliance will put up an icon which lists the complete six bytes of the appliance's MAC address in the top line.

2.) Employing utwho(1M) to determine a Sun Ray[TM] appliance's MAC address

Sun Ray Server Software 3.x provides the utwho(1M) command, which can be used in determining a Sun Ray[TM] appliance's MAC address. Here's how:

  % /usr/bin/id
uid=12345(user12345) gid=12345
% /opt/SUNWut/bin/utwho -c | /usr/bin/grep user12345
5.0 JavaBadgeNP.1234567890a          user12345 192.168.128.169 P7.0003ba5b5df6

Above, 5 is the display number, 192.168.128.169 is the Sun Ray[TM] appliance's current DHCP address, and 0003ba5b5df6 is its MAC address.

Note:  A user might have simultaneous sessions for different tokens.

3.) Extracting a Sun Ray[TM] appliance's MAC address from $UTDEVROOT with ls(1)

With Sun Ray[TM] Server Software 2.0 and earlier, a Sun Ray[TM] appliance's MAC address may be extracted from $UTDEVROOT using the ls(1) utility. For instance:

  % /usr/bin/ls -l $UTDEVROOT
lrwxrwxrwx 1 root other 38 Apr 11 12:09 /tmp/SUNWut/sessions/
3

-> /tmp/SUNWut/units/IEEE802.
080020xxxxxx

Above, 3 is the display number and  080020xxxxxx  is the MAC address of the current Sun Ray[TM] appliance. Get the MAC address also with

  % /usr/bin/ls -l $UTDEVROOT | /usr/bin/sed 's/.*\.//'

Note: UTDEVROOT is set in /usr/dt/config/Xsession.d/0100.SUNWut, which is run during session startup.

4.) Deriving a Sun Ray[TM] appliance's MAC address from its case

The MAC address of a Sun Ray appliance appears on its physical shell. Examine each side of the case for it. Consider other options if it is scratched or has been removed.

5.) Determining the MAC address of a Sun Ray[TM] using utuser(1M)

Employ utuser(1M) to find a Sun Ray appliance's MAC address:

  % /opt/SUNWut/sbin/utuser -lc | /usr/bin/grep -i "John Smith"
JavaBadgeNP.1234567890a   John Smith          080020b5d41f

In this example, 080020b5d41f is the Sun Ray[TM] appliance's MAC address.

Note: The above is possible only if the user is registered. Also, a user might have simultaneous sessions for different tokens.

Abbreviations:

Related documents:

Technical Instruction <Document: 1004977.1> Sun Ray[TM]: OSD Icons on Sun Ray[TM] Server Software (SRSS) 2.0, 3.0 and 3.1



Product
Sun Ray Server Software 2.0
Sun Ray Server Software 1.3
Sun Ray Server Software 1.2
Sun Ray Server Software 1.1
Sun Ray Server Software 3.0
Sun Ray Server Software 3.1
Sun Ray 1g Ultra-Thin Client
Sun Ray 100 Ultra-Thin Client
Sun Ray 150 Ultra-Thin Client
Sun Ray 1 Ultra-Thin Client
Sun Ray 170 Ultra-Thin Client

Internal Comments
The following is strictly for the use of Sun employees:

Another way to determine a Sun Ray client's MAC address is with
the ut_mac script, which provides a
programmatic way to identify the MAC
address of a Sun Ray[TM] appliance.


This script uses several undocumented internal interfaces, but
it can be provided to customers. The current version runs only on
every release up to 2.0. The script will definitely not work on
Linux. Refer to the  status7010  code in ut_gather for
information how to implement such a script for Linux.




6.) Log in the Sun Ray[TM] appliance (with
or without a smart card) and execute the



ut_mac



script below:


  #!/bin/ksh 
exec 8<> /dev/tcp/0.0.0.0/7010
print -u8 status
nawk "/terminalId=/ { tid = \$1; sub(\".*\\\.\", \"\", tid) }
/tokenName=$CORONA_TOKEN/ { print tid }" </dev/fd/8

You will receive the MAC address of the Sun Ray appliance. If a
pseudo terminal session is used, the
display file corresponding to the session will also contain the MAC
address as part of the token id. Only
the root user can read the display files.


Extract the display number, for example from the user's Xsun
process. For instance:


  % /usr/bin/ps -ef | /usr/bin/grep Xsun | /usr/bin/grep testuser
testuser 21955 1158 0 Dec 01 1:43 /usr/openwin/bin/Xsun :2 -nobanner [...]

or from within the user's session:


  % /usr/bin/echo $DISPLAY
:2.0

Then look up the token id in the
corresponding displays file (this requires root access rights):


  # cat /tmp/SUNWut/config/displays/2
SESSION=labhost:7007:7983316984740130946
TOKEN=pseudo.0003ba141958 <-----
SESSION_TYPE=default
TOKEN_SET=pseudo.0003ba141958 <-----
CALLBACK_COOKIE=4764685105025776506
DISPLAY=2
INSERT_TOKEN=pseudo.0003ba141958 <-----
#

If it is a smartcard token, such as display 3 here,


  # cat /tmp/SUNWut/config/displays/3
SESSION=labhost:7007:6587269088071468446
TOKEN=MicroPayflex.5000f8ac00130100 <-----
SESSION_TYPE=default
TOKEN_SET=MicroPayflex.5000f8ac00130100 <-----
CALLBACK_COOKIE=4238035439401877124
DISPLAY=3
INSERT_TOKEN=MicroPayflex.5000f8ac00130100 <-----

Next, extract the MAC address from utdesktop output as
follows:


  # /opt/SUNWut/sbin/utdesktop -l -c | /usr/bin/grep
MicroPayflex.5000f8ac00130100

  0003ba141958                      MicroPayflex.5000f8ac00130100




Source of
information:




Most of the information in this document is from the RSD
software Sun Ray page http://rsd-software.sfbay/twiki/bin/view/Products/ProdInfoSunRayServerSoftware


Sun Ray, sunray, address, MAC, MAC address, ethernet address, OUI
Previously Published As
26428

Change History
Date: 2007-12-19
User Name: 91286
Action: Update Canceled
Comment: *** Restored Published Content *** I did not make changes to this doc, mostly because of technical issues related to soffice. Thus, review delayed until IBIS rollout, resp. the next delay of the IBIS rollout.
Version: 0

Attachments
This solution has no attachment
  Copyright © 2011 Sun Microsystems, Inc.  All rights reserved.
 Feedback