4.9. Installation (utinstall) Error Messages

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

4.9.1. All Installations

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.

xxxxxx not successfully installed

Might occur for the installation of any application or patch if relevant packages have not been properly installed.

Verify that he component xxxxxx is present in the installation media directory path and has the correct permissions, then run the utinstall script 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 Software are compatible only with certain versions of other applications.

Compatible and necessary applications are included with Sun Ray Software. Remove older versions, then run the utinstall script again.

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.

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.

Partition Name Space Required Space Available
-------------- -------------- ---------------
partition      xxx             yyy

Not enough disk space was allocated for partition. Repartition the disk and run utinstall again.

 

4.9.2. Linux Installations

Message

Meaning

Resolution

The following packages were not successfully removed xxxxxx ...

The packages listed have not been properly removed.

Use the rpm -e command to remove each listed rpm manually, then run utinstall -u again.

Removal of product was not successfully completed. See log file for more details.

Removal of Sun Ray Software was incomplete.

Check the log file for the package that started the problem and manually remove it with the rpm -e command, then run utinstall -u again.

4.9.3. Solaris Installations

Message

Meaning

Resolution

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: 10

You are attempting to install Sun Ray Software onto a Solaris software version that does not support the Sun Ray Software release.

Upgrade to the supported version 10 of the Solaris OS before installing Sun Ray 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 the supported version 10 of the Solaris OS before installing Sun Ray Software.

Please clean up the directory /var/tmp/SUNWut.upgrade before rerunning utinstall.

Other unrelated files were found in the preserve directory.

Remove unrelated files from 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 running utinstall again.

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.

The following packages were not successfully removed xxxxxx ...

The packages listed have not been properly removed.

Use the pkgrm command to remove each listed package manually, then run utinstall -u again.

Removal of product was not successfully completed. See log file for more details.

Removal of Sun Ray Software was incomplete.

Check the log file for the package that started the problem and manually remove it with the pkgrm command, then run utinstall -u again.

4.9.4. Modified System Files (Solaris)

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

The following files are modified during Sun Ray 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

4.9.5. Modified System Files (Linux)

The following files are modified during utadm:

  • /etc/dhcpd.conf

  • /etc/nsswitch.conf

  • /etc/opt/SUNWut/net/dhcp/SunRay-options

  • /etc/opt/SUNWut/net/dhcp/SunRay-interface-eth1

  • /etc/opt/SUNWut/net/hostname.eth1

  • /etc/opt/SUNWut/net/networks

  • /etc/opt/SUNWut/net/netmasks

  • /etc/hosts

The following files are modified during utconfig:

  • /etc/passwd

  • /etc/shadow

  • /etc/group

In addition, display files are created for each Sun Ray Client in the following directories:

  • PreSession

  • PostSession

  • Init

  • PostLogin