08/21/96, 4FAX# 1306 Xstation Problem Solving Hints SPECIAL NOTICES Information in this document is correct to the best of our knowledge at the time of this writing. Please send feedback by fax to "AIXServ Information" at (512) 823-4009. Please use this information with care. IBM will not be responsible for damages of any kind resulting from its use. The use of this information is the sole responsibility of the customer and depends on the customer's ability to eval- uate and integrate this information into the customer's operational environment. +----------------------------------------------------------+ | | | NOTE: The information in this document has NOT been | | verified for AIX 4.1. | | | +----------------------------------------------------------+ ABOUT THIS DOCUMENT This document contains tips for determining Xstation booting problems. For more details, refer to AIX Xstation Manager/6000 Version 1.4.1 System Management Guide (SC23-2264-05). HOW TO READ THE LAN STATISTICS SCREEN The LAN statistics screen appears on the Xstation terminal as it boots. Copyright and Xstation Manager information appear at the top of the screen followed by relevant LAN information. Also displayed will be the network adapter's hardware address and relevant information about the adapt- er's connection mode. Two lines are displayed for each working LAN adapter. Lines labeled "BOOTP:" give information about the transmission/reception of bootp packets. Lines labeled "TFTP:" give information about the transmission/reception of tftp packets. Reading from left to right in either the BOOTP or TFTP line, interpret the fields as follows: 1. Bootp or tftp packets sent by the Xstation 2. Bootp or tftp packets received by the Xstation 3. Total number of packets (any type) received by the Xstation 4. Packets sent but received "no response" 5. TFTP error field: 66XX numbers indicate token ring errors 77XX numbers indicate SLIP errors 88XX numbers indicate Ethernet errors Xstation Problem Solving Hints 1 08/21/96, 4FAX# 1306 ETHERNET CONSIDERATIONS Ethernet connector type selection is done by jumper settings on the PCB. The default setting is usually "thin". To select "thick" or "10BaseT", consult the appropriate Setup and Operator's Guide for the Xstation. Compliance with IEEE802.3 standards are required for proper operation. Ensure that only 50-ohm IEEE802.3 cables, con- nectors, and terminators are used throughout the network. Just one section of 90-ohm cable can cause "dead" spots in the network. For "thin" net (coaxial) Ethernets, do not use more than 30 stations per segment and ensure the the length of each segment is less than 185 meters. | For "thick" net Ethernets, use only IBM approved | transceivers or the IBM cable adapter which ships with | Xstation 140s, 150s and 160s. PROBLEM DETERMINATION o Boot failure (general) An unsuccessful boot may have an underlying cause, espe- cially if the Xstation had previously been operating satisfactorily. Check: 1. Basic connectivity: Can the Xstation be pinged (with the "ping" command) by the boot host during the boot process? If the ping hangs, interrupt it (C) and run "arp -a". Does the Xstation show up in the arp table? Does it give the Xstation name, IP address, then "at "? If so, a physical path to the Xstation has been broken or a possible Xstation hardware problem exists. Check routers, gateways, concentrators, etc. between the boot host and the Xstation. 2. Host name resolution: Is DNS or NIS being used? If so, can the DNS server be pinged? Do forward and reverse name resolution still work for both the boot server and Xstation host name/IP address? If not, take appropriate action to ensure proper name resolution to the network. 3. NIS services map: If you are using NIS, does "ypcat services" show these: bootps 67/udp bootpc 68/udp x_st_mgrd 7000/tcp (if x_st_mgr 1.3 or below) or x_st_mgrd 9000/tcp (if x_st_mgr 1.4 or above) Xstation Problem Solving Hints 2 08/21/96, 4FAX# 1306 If not, modify the NIS master server to provide these services in its NIS services map by editing the /etc/services file and remaking the maps. o Bootp failure Bootp is a broadcast mechanism the Xstation uses to find its server. If bootp is enabled but the packets are not answered, the Xstation LAN statistics screen will show field 1 (bootp packets sent) incrementing, field 2 (packets received) at 0 and not incrementing, and field 4 (packages sent with no reply received) incrementing. If bootp is enabled but the packets are not answered, perform the following checks: 1. Check the server process table for bootpd: ps -ef | fgrep bootpd If no bootpd process is running, check inetd for "active" bootps: lssrc -ls inetd If the bootps subserver is not "active", then enable it via smit or the command line: Via smit: a. Start smit with "smit inetd". b. Choose "inetd Subservers" and then "Add an inetd Subserver". Via the command line: a. Edit /etc/inetd.conf and uncomment the bootps line. b. Run the following commands to activate the change: inetimp refresh -s inetd 2. If bootpd still does not run, check the permissions on bootpd: ls -l /usr/sbin/bootpd If the permissions are not "-r-xr-xr-x bin bin", change them so that they are. 3. If bootpd is running in the process table, check the system date with the command "date". If the time and date do not appear to be correct, enter the following, replacing MMDDHHmmYY with the current time and date: Xstation Problem Solving Hints 3 08/21/96, 4FAX# 1306 date MMDDHHmmYY Then enter touch /etc/bootptab to make its date/time current and to enable a new bootpd to be spawned the next time a bootp request is received. 4. Check the permissions and contents of the /etc/bootptab file. To check the permissions, run "ls -l /etc/bootptab". It should return "-rw-r--r-- root system". If not, correct the permissions and run "touch /etc/bootptab" and "refresh -s inetd". Then retry the boot. Check the contents of the /etc/bootptab file and verify that there are no blank lines, that there is a network type line, and that there is an Xstation line with the proper entries for the topology and configuration. If necessary, correct the file. 5. Finally, if everything looks good and bootpd is being kicked off but is not responding to the Xstation requests, initiate bootpd with debugging by doing the following: a. Edit /etc/inetd.conf and comment out the "bootps..." line. b. Run "inetimp" and "refresh -s inetd". c. Start bootpd manually, sending the output mes- sages to the console or to a file: To run bootpd with output to the console: bootpd -d -d -d -d -s & To run bootpd with output to a file: bootpd -d -d -d -d -s > /tmp/bootpd.out 2>&1 o TFTP failure If bootp succeeds, a handoff is made to request tftp download of the Xserver code. (Note: Certain Xstation models can load locally from FLASH memory and may not need a tftp download.) A symptom seen at the Xstation may be that the tftp packet counts increment slowly and eventually timeout. Error codes 66XX for token ring or 88XX for Ethernet may be posted in the fifth tftp field. If tftp fails, do the following: | 1. Run "lssrc -ls inetd" and check for tftp "active". | If it is not active, check that the /etc/inetd.conf | file contains the following line and that it is not | commented out; Xstation Problem Solving Hints 4 08/21/96, 4FAX# 1306 | tftp dgram udp wait nobody /etc/tftpd tftpd -n | 2. Check tftpd permissions (try tftp manu- | ally). 3. Check for an active "nobody" account. The tftp sub- server is "owned" by the "nobody" user in inetd.conf. If the account has expired or its home directory (/) has the wrong permissions or owner- ship, tftpd will not work correctly. Add the "nobody" account, or (alternatively) change the own- ership of tftp in the /etc/inetd.conf file to "root", run "inetimp" and "refresh -s inetd", and then try the boot again. | 4. Check that the /etc/services file contains the fol- | lowing line: | tftp 69/udp 5. If an /etc/tftpaccess.ctl file exists, verify that /etc/x_st_mgr and /usr/lpp/x_st_mgr/bin have "allow:" lines in the file. o Booting through gateways and routers If you are booting through a gateway, router, or bridge, the Xstation IP address, host IP address, and gateway IP address, and subnet mask must be entered into the | Xstation's Network Setup menus. If you have a bridge or router with no IP address, use the boot host's IP | address as the gateway address. Additionally, you should | change bootp mode to "direct" or disable it completely. o Xstation Manager problems If the Xstation tftp works (the first two tftp counters quickly increment to about 500) but error messages or a white screen with no error messages appears on the Xstation, check the x_st_mgrd process. Examples of error messages include: Could not connect to fileserver Could not read configuration file Cannot load X server code 1. Check to see that the x_st_mgrd process is running: ps -ae | grep x_st_mgrd | If it is not running, start it from the command line | by running: | /etc/rc.tcpip 2. If x_st_mgrd is running, check /etc/services (or "ypcat services" if running NIS) and verify that x_st_mgrd is assigned a port: Xstation Problem Solving Hints 5 08/21/96, 4FAX# 1306 9000/tcp (if running x_st_mgr 1.4 or above) 7000/tcp (if running x_st_mgr 1.3 or below) If the entry for x_st_mgrd is not found, edit the /etc/services file and add the entry; then configure the change into the ODM by running "inetimp" and "refresh -s inetd". (Note: If you are using NIS, be sure to make the change on the NIS master; then run "make" from /var/yp.) Finally, kill the x_st_mgrd process and restart it using the command in the last step (the first step | for Xstation Manager problems). Also, verify the | Xstation name and that it does not begin with an x. 3. If x_st_mgrd is running and its port is registered, check the /etc/bootptab file and verify that the x_st_mgr line ends with: T170=2328 (if x_st_mgr 1.4 or above) or T170=1b58 (if x_st_mgr 1.3 or below) If the tag is missing, add it and reboot the Xstation. o If the Xstation displays "Could not read configuration file" or "Cannot load Xserver code", check permissions: cd /usr/lpp/x_st_mgr/bin ls -l * Check for 644 ("-rw-r--r--") on the following files: bootfile X140serv (if applicable) X150serv (if applicable) x11xor3.out x11xor4.out Then run: cd /etc/x_st_mgr ls -l * Check for 644 ("-rw-r--r--") on the following files: bootfile.cf X140serv.cf (if applicable) X150serv.cf (if applicable) x_st_mgrd.cf x_st_mgrd.tmty (Where may be 1 and 2 or 3 and 4, depending on x_st_mgr version.) If any of the above files have the wrong permissions or ownership (root/system), then change to the proper per- missions and ownership and restart x_st_mgrd using the command in the first step under "Xstation Manager prob- lems" above. Xstation Problem Solving Hints 6 08/21/96, 4FAX# 1306 | o If the screen appears grey and the mouse pointer cursor | looks like a white rectangle, it means that the Xstation | cannot load the cursor font file. In this case, check | the Xstation font path. Xstation Problem Solving Hints 7 08/21/96, 4FAX# 1306 READER'S COMMENTS Please fax this form to (512) 823-4009, attention "AIXServ Informa- tion". You may also e-mail comments to: elizabet@austin.ibm.com. These comments should include the same customer information requested below. Use this form to tell us what you think about this document. If you have found errors in it, or if you want to express your opinion about it (such as organization, subject matter, appearance) or make sug- gestions for improvement, this is the form to use. If you need technical assistance, contact your local branch office, point of sale, or 1-800-CALL-AIX (for information about support offer- ings). These services may be billable. Faxes on a variety of sub- jects may be ordered free of charge from 1-800-IBM-4FAX. Outside the U.S. call 415-855-4329 using a fax machine phone. When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate without incurring any obligation to you. NOTE: If you have a problem report or item number, supplying that number may help us determine why a procedure did or did not work in your specific situation. Problem Report or Item #: Branch Office or Customer #: Be sure to print your name and fax number below if you would like a reply: Name: Fax Number: ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ END OF DOCUMENT (xstation.lxp, 4FAX# 1306) Xstation Problem Solving Hints 8