A P P E N D I X A

Additional Information

This appendix provides additional information regarding your installation or upgrade to Sun Ray Server Software 3.1.

Topics covered in this appendix include:

Installing the SunMC Software

Mounting a CD-ROM Remotely

Modified System Files

utinstall Error Messages

Installing the SunMC Software

Note - The Sun Management Center is not currently available for Linux implementations.

Sun Ray Server Software includes a module for interfacing with Sun Management Center software. If Sun Ray Server Software and Sun Management Center software are to run on the same server, different procedures are used, depending on the order in which the software is installed. If Sun Ray Server Software and Sun Management Center server component are configured on separate servers, then the module must be installed on both servers. This section describes the installation procedures. For more detail on SunMC functionality, see of the Sun Ray Server Software 3.1 Administrator's Guide.

If you are doing a clean installation of Sun Management Center software and Sun Ray Server Software on the same server, it is easier to install Sun Management Center software first.

When you install Sun Management Center software, you are given the option of installing any of the three components on the selected server. If you want to add only the agent to a Sun Ray server, just choose to add the agent component.

After the appropriate hardware configuration product is installed on the server, you can choose to run the setup now or later. When you run the setup, you are prompted for a host name of Sun Management Center server, a seed to generate security keys, a base URL for the console, and, if there is a conflict, a different port for the agent.

Tip - To monitor all the servers in a failover group, make sure every server runs Sun Ray Server Software 3.1. In addition, all servers must run the Sun Management Center agent component.

Note - Administration of the SunMC software is documented in the Sun Ray Server Software 3.1 Administrator's Guide.

SunMC Software Requirements

The Sun Ray system monitoring feature has the following software requirements:

For SPARC platforms:

Sun Ray Server Software 2.0, 3, or 3.1 for Solaris

Sun Management Center 3.0 or 3.5 Update 1a software.

For x86 platforms:

Sun Ray Server Software 3.1 for Solaris

Sun Management Center 3.5 update 1a

Note - Any SunMC server collecting data from a Solaris 10 system must run Sun Management Center 3.5 update 1a.

The Sun Ray module adds the following requirements when added to either the Sun Management Center server or agent component:

TABLE A-1 Additional Requirements for the Server
Component	Size
RAM	8 KB
`/opt/SUNWut`	153 KB
`/opt/SUNWsymon`	12 KB

TABLE A-2 Additional Requirements for the Agent
Component	Size
RAM	1 MB
Swap	1 MB
`/opt/SUNWut`	602 KB
`/opt/SUNWsymon`	12 KB
`/var/opt/SUNWsymon`	0.5 KB

The Sun Ray module adds the following requirements to the Sun Management Center server and agent components:

TABLE A-3 Additional Requirements to the Server and Agent Components
Component	Size
RAM	1008 KB
Swap	1 MB
`/opt/SUNWut`	602 KB
`/opt/SUNWsymon`	12 KB
`/var/opt/SUNWsymon`	.5 KB

Caution - The Sun Management Center server component has very high resource requirements. Do not install the complete Sun Management Center software on a Sun Ray server, especially if the Sun Ray server is configured for failover.

To Install Sun Ray Server Software After Installing the Sun Management Center Software

1. Start the Sun Management Center software:

# /opt/SUNWsymon/sbin/es-start -c &

Check to see if the Sun Management Center works. If not, reinstall the Sun Management Center software. Use the Sun Management Center 3.5 Software Installation Guide and the Sun Management Center 3.5 Software User's Guide to install the Sun Management Center software.

2. Use the standard Sun Ray installation script to add the Sun Ray module:

# utinstall

If the Sun Management Center agent software is running, the standard Sun Ray install script automatically stops it, adds the Sun Ray module, and restarts the Sun Management Center agent software.

If the Sun Management Center agent software is not running, the Sun Ray install script adds the Sun Ray module but does not start the Sun Management Center agent software.

To Install Sun Management Center Software After Installing Sun Ray Server Software

1. Use the standard Sun Ray installation script:

# utinstall

The Sun Ray module for SunMC is installed automatically on the server when utinstall installs Sun Ray Server Software.

2. Follow the installation instructions found in the Sun Management Center Software Installation Guide to install the Sun Management Center software.

3. Type the following to enable Sun Ray monitoring:

# /opt/SUNWut/sbin/utsunmc

4. Start the Sun Management Center software:

# /opt/SUNWsymon/sbin/es-start -c &

Check to see if Sun Management Center works. If not, reinstall the Sun Management Center software.

To Install the SunMC Agent on Separate Servers

1. Verify that the Sun Management Center agent, SUNWesagt, is installed on the Sun Ray server:

# pkginfo -l SUNWesagt

2. Perform a standard installation of Sun Ray Server Software:

# utinstall

If the Sun Management Center agent is running, the installation process stops and restarts the SunMC software.

Note - You can install Sun Management Center agents after Sun Ray Server Software installation; however, you must then enable the Sun Ray module by typing /opt/SUNWut/sbin/utsunmc to register the Sun Ray module with the SunMC.

3. Install the Sun Ray interface package on the Sun Management Center server:

If you have already mounted the Sun Ray Server Software 3.1 CD-ROM on the SunMC server or from a remote server, or if you have extracted the ESD files to an image directory, begin at Step c.

a. As superuser, open a shell window on the SunMC server.

b. Insert the Sun Ray Server Software 3.1 CD-ROM

If a File Manager window opens, close it. The File Manger CD-ROM window is not necessary for installation.

c. Change to the image directory. For example:

# cd /cdrom/cdrom0

d. Install the Sun Ray module:

# ./utsunmcinstall

The installation process begins. The utsunmcinstall script:

Verifies that the SunMC software is installed.

Verifies that Sun Ray Server Software is not installed.

Installs the parts of the Sun Ray module needed on the SunMC server.

Mounting a CD-ROM Remotely

If you purchased the Sun Ray Server Software 3.1 CD-ROM but your Sun Ray server does not have a CD-ROM drive, follow these instructions to mount the Sun Ray Server Software CD-ROM from a remote server.

To Mount the CD-ROM From a Remote Server

1. As superuser of the remote system, open a shell window.

2. Insert the Sun Ray Server Software 3.1 CD-ROM into the CD-ROM drive.

If a file manager window opens, close it. The file manager CD-ROM window is not necessary for installation.

3. Share the Sun Ray CD-ROM file system:

# share -o ro /cdrom/cdrom0

4. Use the rlogin command to log into the Sun Ray server as the root user:

# rlogin sunray-server-name -l root

Password:

Where sunray-server-name is the host name of the Sun Ray server.

Tip - If you receive an error that you are not on the system console, comment out the line CONSOLE=/dev/console in the /etc/default/login file on the Sun Ray server.

5. Create the CD-ROM file system mount point:

# mkdir -p /cdrom/cdrom0

6. Mount the remote CD-ROM drive:

# mount -o ro cd-server-name:/cdrom/cdrom0 /cdrom/cdrom0

Where cd-server-name is the host name of the server with the Sun Ray CD-ROM.

7. Return to the point where you referenced this procedure.

To Unmount the CD-ROM From a Remote Server

1. From the shell window where you mounted the CD-ROM, unmount the CD-ROM file system:

# cd /

# umount /cdrom/cdrom0

2. Close the rlogin session:

# exit

3. Unshare the CD-ROM file system:

Note - This procedure is for Solaris only.

# unshare /cdrom/cdrom0

Restoring `utadm` Functionality

If you issue the command <CTRL>C while performing utadm configuration, utadm may not function correctly the next time you invoke it. To correct this condition, type:

# dhtadm -R

Modified System Files

The following files are modified during utadm:

/etc/inet/hosts

/etc/inet/networks

/etc/inet/netmasks

/etc/inet/dhcpsvc.conf # including all DHCP related files

/etc/nsswitch.conf

/etc/hostname.<intf>

/etc/notrouter

The following files are modified during SR service startup:

/etc/inet/services

/etc/inet/inetd.conf

The following files are modified during utconfig:

/etc/passwd

/etc/shadow

/etc/group

After installation, the following files are updated upon reboot:

/etc/syslog.conf

/etc/pam.conf

`utinstall` Error Messages

If during an installation, upgrade, or uninstall the utinstall script returns an error, refer to the following table for assistance.

TABLE A-4 `utinstall` Error Messages
Message	Meaning	Resolution
utinstall: fatal, media-dir is not a valid directory.	You called the `-d` option, but media-dir is incomplete.	The media-dir directory requires relevant patches and packages for installation. The media-dir directory includes the Sun Ray directory.
Cannot open for read admin-file	The `admin_default` file is unreadable, or you called the `-a` option and the admin-file is unreadable.	Verify that the installation administration file exists (admin_default or other) and the permissions are correct.
For SPARC platforms: SunOS release is x.x, valid releases are: 8 and 9	You are attempting to install Sun Ray Server Software onto Solaris software version 2.7 (5.7) or older.	Upgrade to version 8, 9, or 10 of the Solaris operating environment before installing Sun Ray Server Software.
For x86 platforms: SunOS release is x.x, valid releases are: 10	You are not running a valid OS release for this platform.	Upgrade to version 10 of the Solaris operating environment before installing Sun Ray Server Software.
Please clean up the directory /var/tmp/SUNWut.upgrade before rerunning utinstall.	Other unrelated files are found in the preserve directory.	Clean up the directory.
Please remove the existing preserved file <preserved_tarfilename> before rerunning utinstall.	You decided not to restore from the indicated tar file.	Remove the tar file before rerunning utinstall.
utpreserve: unable to preserve data. Error while creating archive file	The `utinstall` script failed to preserve existing configuration files.	Either exit and manually preserve these files or just continue.
xxxxxx not successfully installed	Might occur for the installation of any application or patch, xxxxxx, if relevant packages have not been properly installed.	Verify the component xxxxxx is present in the installation media directory path and has the correct permissions, then re-run the utinstall script.
The following packages were not successfully removed xxxxxx ...	The packages listed have not been properly removed.	Use the pkgrm command to remove each package listed manually, then run utinstall -u again.
A different version x.x of product has been detected. The other-product Software is only compatible with product y.y. You must either upgrade or remove the current product installation before proceeding. Exiting ...	Some of the applications provided with Sun Ray Server Software are only compatible with certain versions of other applications.	Compatible and necessary applications are included with Sun Ray Server Software. Remove older versions, then re-run the `utinstall` script.
error, no Sun Ray software packages installed.	None of the Sun Ray components are installed on this system.	No action is required as the product is not installed.
packages have not installed correctly. All data saved during the upgrade 'Save & Restore' has been retained at the following location:	Upgrade of Sun Ray Server Software was incomplete.	1. Run `utinstall` again. 2. If message appears again, type: # `pkginfo -p\|grep SUNWut` 3. Use `pkgrm` to remove packages listed. 4. Type the following sequence: `#` `pkginfo\|grep SUNWut` If output, go to step 5. If no output, type (on one line): a. For SPARC platforms: `#` `cd /cdrom/cdrom0/Sun_Ray_Core_Services_3.1/Solaris_8+/sparc/Packages` `#` `pkgadd -d . SUNWuta` b.For x86 platforms: `cd /cdrom/cdrom0/Sun_Ray_Core_Services_3.1/Solaris_10+/i386/Packages` `#` `pkgadd -d . SUNWuta` 5. Run `utinstall` again.
The following files were not successfully replaced during this upgrade. The saved copies can be found in <directory>	Some files were not properly replaced as part of the upgrade.	Manually copy the listed files from the directory overwriting the newer files if applicable.
Removal of product was not successfully completed. See log file for more details.	Removal of Sun Ray Server Software was incomplete.	Check logfile for the package that started the problem and manually remove it with the `pkgrm` command, then run `utinstall -u` again.
Partition Name Space Required Space Available -------------- -------------- ----------------- partition xxx yyy		Not enough disk space was allocated for partition. Repartition the disk and run `utinstall` again.

This table explains error messages, although they're fairly obvious.For instance, the error message, "Removal of product was not successfully completed. See log file for more details." is explained in the "meaning" column as "Removal of Sun Ray Server Software was incomplete."The notation in the Resolution column says, "Check logfile for the package which started the problem and manually remove it with the pkgrm command, then run utinstall -u again."