This procedure uses the utsetup command to install and configure a Sun Ray server for both the Linux or Solaris operating system.
The utsetup command configures a Sun Ray
server to use a shared network (LAN) and it generates a set of
.parms
files in the
/tftpboot
directory for managing Sun Ray
client firmware (DHCP is not configured to manage firmware
downloads). This configuration is detailed in Planning
a Sun Ray Environment.
Make sure the server targeted to become the Sun Ray server meets the Sun Ray Software product requirements.
Create a dedicated UNIX group for the sole use of the
Windows connector feature. By default, the
utwc
group is created and used. The
first character of the name must be alphabetic. Do not add
users to this group.
A Sun Ray server requires both a fixed host name and a static IP address. A Sun Ray server cannot be a DHCP client.
Download and unzip the Sun Ray Software 5.2 Media Pack and make it accessible to the Sun Ray server.
Become superuser on the Sun Ray server.
To avoid installation script errors that can occur if user environment settings are carried forward, use the following command:
% su - root
Change directory to the downloaded media pack image.
Install Sun Ray Software on the Sun Ray server.
# ./utsetup
See the Examples section below for an example of the utsetup output.
When the script ends, the log files are available at:
Linux:
/var/log/utinstall.year
_month
_date
_hour
:minute
:second
.log /var/log/SUNWut/utconfig.year
_month
_date
_hour
:minute
:second
.log
Solaris:
/var/adm/log/utinstall.year
_month
_date
_hour
:minute
:second
.log /var/adm/log/utconfig.year
_month
_date
_hour
:minute
:second
.log
The values in the file names reflect a time stamp of when the command was started. Check these files for notices of problems.
See Section 4.9, “Installation (utinstall) Error Messages” for a listing of utinstall error messages.
Repeat steps 2 through 4 for each secondary server if in a failover group.
If you choose the HA group (failover group) configuration
during the utsetup installation of the
primary server, you can copy the generated response file
to each secondary server and use the
utsetup command to replicate the
failover group configuration. For example, you can save
the response file to the secondary's server's
/tmp
directory and then use the
utsetup -a -D /tmp command.
This strategy reduces the time needed to re-enter the same configuration information and can minimize configuration errors. See Section 4.6, “How to Clone a Sun Ray Server” for details.
Add the Sun Ray server's host name or IP address to the
sunray-config-servers
and
sunray-servers
DNS entries, which will
make the server available to clients for firmware updates
and Sun Ray sessions, respectively.
See Chapter 3, Planning a Sun Ray Network Environment for details.
Reboot the Sun Ray clients to download and install the new firmware provided by the Sun Ray server.
When installing the Sun Ray Software 5.2 firmware on Sun Ray 3 Series Clients, the smart card LED will blink for approximately 40 seconds as the smart card controller firmware is being updated. This is normal.
If you plan to use the Windows connector, install the Windows Connector Components on your designated Windows Server. See Section 4.5, “How to Install the Windows Connector Components on a Windows System” for details.
To use the enhanced multi-monitor support on Sun Ray 2FS and Sun Ray 3 Plus Clients running Linux, you must install RandR 1.2 on the Linux Sun Ray server.
Become superuser on the Sun Ray server.
Change to the
Supplemental/UTrandr/Linux
directory
in the downloaded media pack.
Install the RandR 1.2 RPM:
For 32-bit:
# rpm -i utXrandr-1.2.3-1.i686.rpm
For 64-bit:
# rpm -i utXrandr-1.2.3-1.x86_64.rpm
Once installed, the new 1.2 version of the xrandr command is
available in the /opt/SUNWut/bin
directory. The default version remains in the
/usr/bin
directory.
The Java Desktop System (JDS) integration package, which delivers a CLI called uttscwrap that improves integration of the Windows connector with the JDS desktop on Solaris 10.
Change to the Supplemental
directory
in the downloaded media pack.
Install the JDS integration package
(SUNWuttscwrap
).
# pkgadd -d .
The uttscwrap command is installed in
the /opt/SUNWuttscwrap/bin
directory.
For more information about the
uttscwrap command, see the
Sun Ray Clients chapter in the
Administration Guide.
The utinstall script asks about installing the available locale support for the Admin GUI. If you choose to install additional Admin GUI locale support after the installation, you can use the rpm command to install the Admin GUI locale packages provided on the installation image:
media_pack_directory
/srss_4.3/Components/10-SRSS/Content/Sun_Ray_Core_Services_4.3/Linux/Packages
The utinstall script asks about installing the available locale support for the Admin GUI. If you choose to install additional Admin GUI locale support after the installation, you can always use the pkgadd command to install the Admin GUI locale packages provided on the installation image:
media_pack_directory
/srss_4.3/Components/10-SRSS/Content/Sun_Ray_Core_Services_4.3/Solaris_10+/sparc/Packagesmedia_pack_directory
/srss_4.3/Components/10-SRSS/Content/Sun_Ray_Core_Services_4.3/Solaris_10+/i386/Packages
If you plan to use a headless Sun Ray server running Linux and Sun Ray clients using Gnome Display Manager (GDM), then this configuration will generate errors on the Sun Ray client and consume CPU processes. The errors occur because GDM assumes that the console display is present and GDM will continually attempt to (and fail to) service a non-existent console device.
The workaround is to add the -no-console
option to the preadm command in the Sun Ray
server's /etc/inittab
file:
x:5:respawn:/etc/X11/prefdm --nodaemon --no-console
This workaround is not required for Oracle servers, since they have the Integrated Lights Out Manager (ILOM) Service Processor that provides a virtual console.
The following code output shows an example installing a Linux-based Sun Ray server using the utsetup -d command, which installs all the default settings:
# ./utsetup -d ================================================================== === Installing Sun Ray Software - utinstall === License Agreement Accept? (Y/N) Y # utinstall-srss Version: 4.3 Fri Apr 22 16:46:54 EDT 2011 Sun Ray Server Software 4.3 not installed Sun Ray Data Store 3.3 not installed Kiosk Mode 4.3 not installed Enter Java v1.6 (or later) location: [/usr/java] (AUTORESPONSE) /usr/java About to Install Sun Ray Server Software 4.3 Continue? (Y/N) [Y] (AUTORESPONSE) Y About to carry out the following operations: Install [ Sun Ray Server Software 4.3 ] Install [ Sun Ray Data Store 3.3 ] Install [ Sun Ray Server Software 4.3 French Admin GUI ] Install [ Sun Ray Server Software 4.3 Japanese Admin GUI ] Install [ Sun Ray Server Software 4.3 Simplified Chinese Admin GUI ] Install [ Sun Ray Server Software 4.3 ] Install [ Kiosk Mode 4.3 ] Install [ Kiosk Mode 4.3 localized files ] Install [ data for utslaunch ] Install [ Service Tags 1.1 ] Installing Sun Ray Server Software version 4.3 ... +++ SUNWuti-4.3-49.i386.rpm +++ SUNWutid-4.3-49.i386.rpm +++ SUNWuto-4.3-49.i386.rpm +++ SUNWutfw-4.3-49.i386.rpm +++ SUNWutr-4.3-49.i386.rpm +++ SUNWutu-4.3-49.i386.rpm +++ SUNWuta-4.3-49.i386.rpm +++ SUNWutsto-4.3-49.i386.rpm +++ SUNWutstr-4.3-49.i386.rpm +++ SUNWutps-4.3-49.i386.rpm +++ SUNWutkau-4.3-49.i386.rpm +++ SUNWutio-4.3-49.i386.rpm +++ SUNWutdsk-4.3-49.i386.rpm +++ SUNWutgsm-4.3-49.i386.rpm +++ SUNWutref-4.3-49.i386.rpm +++ SUNWlibusbut-4.3-49.i386.rpm Installing Sun Ray Data Store version 3.3 ... +++ SUNWutdso-3.3-03.i386.rpm +++ SUNWutdsr-3.3-03.i386.rpm Installing Sun Ray Server Software version 4.3 Admin GUI ... +++ SUNWutwa-4.3-49.i386.rpm +++ SUNWutwar-4.3-49.i386.rpm +++ SUNWutwh-4.3-49.i386.rpm +++ SUNWutwl-4.3-49.i386.rpm Installing Sun Ray Server Software version 4.3 manpages ... +++ SUNWutm-4.3-49.i386.rpm Installing Sun Ray Server Software version 4.3 French Admin GUI ... +++ SUNWfuta-4.3-05.i386.rpm +++ SUNWfutwa-4.3-05.i386.rpm +++ SUNWfutwl-4.3-49.i386.rpm +++ SUNWfutwh-4.3-05.i386.rpm Installing Sun Ray Server Software version 4.3 Japanese Admin GUI ... +++ SUNWjuta-4.3-05.i386.rpm +++ SUNWjutwa-4.3-05.i386.rpm +++ SUNWjutwl-4.3-49.i386.rpm +++ SUNWjutwh-4.3-05.i386.rpm Installing Sun Ray Server Software version 4.3 Simplified Chinese Admin GUI ... +++ SUNWcuta-4.3-05.i386.rpm +++ SUNWcutwa-4.3-05.i386.rpm +++ SUNWcutwl-4.3-49.i386.rpm +++ SUNWcutwh-4.3-05.i386.rpm Installing Sun Ray Server Software version 4.3 Localized files ... +++ SUNWcuto-4.3-05.i386.rpm +++ SUNWduto-4.3-05.i386.rpm +++ SUNWeuto-4.3-05.i386.rpm +++ SUNWfuto-4.3-05.i386.rpm +++ SUNWhuto-4.3-05.i386.rpm +++ SUNWiuto-4.3-05.i386.rpm +++ SUNWjuto-4.3-05.i386.rpm +++ SUNWkuto-4.3-05.i386.rpm Installing Kiosk Mode version 4.3 ... +++ SUNWkior-4.3-49.i386.rpm +++ SUNWkio-libs-4.3-49.i386.rpm +++ SUNWkio-4.3-49.i386.rpm +++ SUNWkiom-4.3-49.i386.rpm Installing Kiosk Mode version 4.3 localized files ... +++ SUNWckio-4.3-05.i386.rpm +++ SUNWdkio-4.3-05.i386.rpm +++ SUNWekio-4.3-05.i386.rpm +++ SUNWfkio-4.3-05.i386.rpm +++ SUNWhkio-4.3-05.i386.rpm +++ SUNWikio-4.3-05.i386.rpm +++ SUNWjkio-4.3-05.i386.rpm +++ SUNWkkio-4.3-05.i386.rpm Installing Service Tags version 1.1 ... +++ SUNWutsvt-1.1-02.i386.rpm Installation of Sun Ray Server Software has completed. +++ Installing 'Sun Ray Connector 2.4' +++ Adding 'SUNWuttsc' +++ Adding 'SUNWuttscr' +++ Adding 'SUNWuttscd' +++ Adding 'SUNWuttsc-kiosk' Please check for errors/warnings in /var/log/utinstall.2011_04_22_16:46:46.log +++ Done. ================================================================== === Creating directory structure - utacleanup ================================================================== === Performing basic configuration - utconfig Activating product Product activation output being logged at /var/log/SUNWut/utctl.2011_04_22_16:47:28.log Configuration of Sun Ray Server Software This script automates the configuration of the Sun Ray Server Software and related software products. Before proceeding, you should have read the Installation and Configuration Guide for planning purposes. For your convenience, default values (where applicable) are shown in brackets. Continue? (Y/N) [Y] (AUTORESPONSE) Y Enter new UT admin password: Again: Enter new UT admin password: Configure Sun Ray Web Administration? (Y/N) [N] (AUTORESPONSE) N Configure Sun Ray Kiosk Mode? (Y/N) [N] (AUTORESPONSE) N Configure this server for a failover group? (Y/N) [N] (AUTORESPONSE) N About to configure the following software products: Sun Ray Data Store 3.3 Hostname: vzsrstb25 Sun Ray root entry: o=utdata Sun Ray root name: utdata Sun Ray utdata admin password: (not shown) SRDS 'rootdn': cn=admin,o=utdata Sun Ray Server Software 4.3 Failover group: no Sun Ray Kiosk Mode: no Continue? (Y/N) [Y] (AUTORESPONSE) Y Updating Sun Ray Data Store schema ... Updating Sun Ray Data Store ACL's ... Creating Sun Ray Data Store ... Restarting Sun Ray Data Store ... . Fri Apr 22 16:47 : utdsd starting Loading Sun Ray Data Store ... Executing '/usr/bin/ldapadd -h vzsrstb25 -x -p 7012 -D cn=admin,o=utdata' ... adding new entry "o=utdata" adding new entry "o=v1,o=utdata" adding new entry "utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=desktops,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=users,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=logicalTokens,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=rawTokens,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=multihead,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=container,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=properties,utname=vzsrstb25,o=v1,o=utdata" adding new entry "cn=utadmin,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=smartCards,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utordername=probeorder,utname=smartCards,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=policy,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=resDefs,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=prefs,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utPrefType=resolution,utname=prefs,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utPrefClass=advisory,utPrefType=resolution,utname=prefs,utname=vzsrstb25,o=v1,o=utdata" Added 18 new LDAP entries. Creating Sun Ray Server Software Configuration ... Unique "/etc/opt/SUNWut/gmSignature" has been generated. Restarting Sun Ray Data Store ... . Fri Apr 22 16:47 : utdsd starting Adding user admin ... User(s) added successfully! *********************************************************** The current policy has been modified. You must restart the authentication manager to activate the changes. *********************************************************** Enter groupname for Windows Connector [utwc] (AUTORESPONSE) utwc The group 'utwc' already exists. A dedicated group should be used for SRWC. Use existing group anyway (Y/N) [Y] (AUTORESPONSE) Y Creating required LDAP schema ... adding new entry "utname=remoteclient,utname=vzsrstb25,o=v1,o=utdata" adding new entry "utname=users,utname=remoteclient,utname=vzsrstb25,o=v1,o=utdata" Done. ***************************************************************************** A restart of Sun Ray services is required before the Sun Ray Connector for Windows Operating Systems is used. Please run : /opt/SUNWut/sbin/utstart Note that this will *NOT* terminate any sessions. ***************************************************************************** Configuration of Sun Ray Server Software has completed. Please check the log file, /var/log/SUNWut/utconfig.2011_04_22_16:47:28.log, for errors. ================================================================== === Configuring access policy - utpolicy Enter policy specification as if on utpolicy command line: [-a -g -z both] (AUTORESPONSE) -a -g -z both The authentication manager must be restarted for changes to take effect. If a significant policy change has been made then a cold restart must be initiated with the following command, note that all existing sessions will be terminated: /opt/SUNWut/sbin/utstart -c If a minor policy change was made then it is not necessary to terminate existing sessions and a warm restart is sufficient by executing the following command: /opt/SUNWut/sbin/utstart ================================================================== === Configuring firmware downloads - utfwadm Do you want to configure Firmware downloads for Sun Ray clients? (Y/N) [Y] (AUTORESPONSE) Y CoronaP1 4.3_49_2011.04.15.08.51 SunRayP10 4.3_49_2011.04.15.08.51 CoronaP2 4.3_49_2011.04.15.08.51 CoronaP3 4.3_49_2011.04.15.08.51 CoronaP4 4.3_49_2011.04.15.08.51 CoronaP5 4.3_49_2011.04.15.08.51 CoronaP6 4.3_49_2011.04.15.08.51 CoronaP7 4.3_49_2011.04.15.08.51 SunRayP8 4.3_49_2011.04.15.08.51 SunRayP9 4.3_49_2011.04.15.08.51 ================================================================== === Enabling LAN access - utadm Do you want to enable LAN access for Sun Ray clients at this time? (Y/N) [N] (AUTORESPONSE) N ================================================================== === Starting Sun Ray Software - utstart A cold restart has been initiated... messages will be logged to /var/opt/SUNWut/log/messages.