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.

Topics covered in this appendix include:

Mounting a CD-ROM Remotely

Modified System Files

utinstall Error Messages

Mounting a CD-ROM Remotely

If you purchased the Sun Ray Server Software 3 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 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 - To enable remote login, comment out the line containing pam_security.so in the /etc/pam.d/login file.

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

Modified System Files

The following files are modified during utadm:

/etc/dhcpd.conf

/etc/nsswitch.conf

The following files are modified during utconfig:

/etc/passwd

/etc/shadow

/etc/group

The following file is modified during utinstall:

/etc/syslog.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-1 `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.
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 `rpm` command to remove each `rpm` 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: # `rpm -qa\|grep SUNWut` 3. Use rpm to remove packages listed. 4.Type: `rpm -q SUNWut` If output, go to step 5. If no output, type (on one line): `#` `/cdrom/cdrom0 /Sun_Ray_Core_Services_3.0/Linux /Packages` # `rpm -i 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 `rpm -e` 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."

Mounting a CD-ROM Remotely

To Mount the CD-ROM From a Remote Server

To Unmount the CD-ROM From a Remote Server

Modified System Files

utinstall Error Messages

`utinstall` Error Messages