-A P P E N D I X

Log Files

For information about installation problems, view the log files. The following log files can be helpful in debugging installation problems:

/var/dt/Xerrors /var/dt/dzlog /tmp/dz_daemon_out /var/dt/dz/master.* /var/adm/messages

The file /tmp/dzdaemon_out on each computer might contain the output and errors from the local dzdaemon.

General Troubleshooting Information

If dzstartup reports problems, review the log file /var/dt/dzlog. Try running /usr/sbin/dzstartup start on the master.

X startup errors are logged in /var/dt/Xerrors. If X fails to start, try starting from the command line using Xsun -dev /dev/fbs/dzfb0. Since X takes control of the local keyboard run this test from a shell that you log on to remotely from the administration workstation. Test out each dzfb device independently in this manner.

If the slave needs to be rebooted, the system administrator might have to start and - reset the Sun Fire Visual Grid system from the master as shown below (preferably from a shell window on the administration workstation using rlogin to communicate to the master computer).

# /usr/sbin/dzstartup start

# /usr/dt/bin/dtconfig -reset

When installing a system from scratch, start without using Xinerama mode. When the installation is complete, you can switch to Xinerama mode using the dzadmin tool.

Running /usr/sbin/dzstatus returns the current status of dzdaemon. This should return DESIGNATED_MASTER on the master machine, and DESIGNATED_SLAVE on the slave machine. If not, either reboot the machine with the improper designation, or preferably, run dzstartup start from the master.

A keyboard and mouse must always be plugged into the USB ports on the Sun Fire V880z slave, otherwise the X server fails to come up properly.

If you are using a trustedhosts file on the slave, make sure that the file contains at least a "localhost" entry and the hostname of the master system Gigabit Ethernet connection (not the master system 100 Mbit/sec connection). See Chapter 6 for more details.

A Sun Fire 4800 or Sun Fire 6800 often requires a -r flag to the boot command (boot -r) in order to recognize the USB card, and to recognize the keyboard and mouse. This flag, however, causes the X server to fail to start. You can discover if this is the problem by:

Looking for an error message in the /var/dt/Xerrors file that contains the string VUIDGFORMAT.

Confirming that there is no keyboard or mouse entry in the /dev/usb directory, as there should be with properly functioning USB card software.

Verifying the Myrinet Software

The Myrinet software is installed in three packages (SUNWmyril, SUNWmyrir, and SUNWmryix) as part of the overall Sun Fire Visual Grid software installation. The Myrinet cards should appear in the "Primary 3D Network" panel the first time that the dzadmin tool is run. To manually verify the installation after the Sun Fire Visual Grid software has been installed, type:

# cd /opt/SUNWmyri/bin

# ./gm_board_info

The output should list each of the boards installed in the local server.