Agilent E2050 LAN/GPIB Gateway Installation and Configuration Guide Manual Part Number: E2050-90003 Printed in U.S.A.
Contents E2050 LAN/GPIB Gateway User’s Guide Front Matter ............................................................................................... 5 Warranty Information .................................................................... 5 Contacting Agilent ......................................................................... 6 Safety Considerations ................................................................... 7 Radio and Television Interference ...........................................
. Administration ....................................................................................63 Using the Telnet Utility..................................................................65 Accessing the Telnet Utility ...................................................65 Exiting the Telnet Utility ........................................................68 Telnet Commands .................................................................68 Querying the Gateway.........................................
Notice The information contained in this document is subject to change without notice. Agilent Technologies shall not be liable for any errors contained in this document. Agilent Technologies makes no warranties of any kind with regard to this document, whether express or implied. Agilent Technologies specifically disclaims the implied warranties of merchantability and fitness for a particular purpose.
Trademark Information Microsoft®, Windows ® 95, Windows ® 98, Windows ® Me, Windows ® 2000, and Windows NT® are U.S. registered trademarks of Microsoft Corporation. All other brand and product names are trademarks or registered trademarks of their respective companies. This software and documentation are based in part on the Fourth Berkeley Software Distribution under license from The Regents of the University of California.
Safety Considerations Product and Documentation Labels A WARNING denotes a hazard that can cause injury or death. A CAUTION denotes a hazard that can damage equipment or cause data loss. Do not proceed beyond a WARNING or CAUTION notice until you understand the hazardous conditions and have taken appropriate steps. Grounding The power module (Agilent 0950-2546 AC/DC Adapter) is a safety class I product and has a protective earthing terminal.
If your device does cause interference to radio and television reception, you are encouraged to try to correct the interference by one or more of the following measures: n Relocate the radio or TV antenna. n Move the device away from the radio or television. n Plug the device into a different electrical outlet, so that the device and the radio or television are on separate electrical circuits. n Make sure you use only shielded cables to connect peripherals to your device.
DECLARATION OF CONFORMITY According to ISO/IEC Guide 22 and CEN/CENELEC EN 45014 Manufacturer’s Name: Manufacturer’s Address: Agilent Technologies, Incorporated 815 - 14th St. SW Loveland, Colorado 80537 USA Declares, that the product Product Name: Model Number: Product Options: LAN/GPIB Gateway E2050B This declaration covers all options of the above product(s).
1 Introduction 11
Introduction This Agilent E2050 LAN/GPIB Gateway Installation and Configuration Guide gives guidelines to install and configure the E2050 LAN/GPIB Gateway (Gateway) for use with supported, network-equipped computer systems. You can also use this guide to administer the Gateway on your network and to troubleshoot installation or configuration problems.
Introduction How to Use This Guide How to Use This Guide The information in this guide assumes you are a Network Administrator who installs, configures, and maintains a local area network (LAN), including network-related hardware like the E2050 LAN/GPIB Gateway. If you use a Series 700 HP-UX workstation with the Gateway, you must also have super-user (root) privileges on the HP-UX system. If you use a Windows NT PC with the Gateway, you must also have system administrator privileges on the Windows NT PC.
Introduction How to Use This Guide Related Software Documentation Suggested software manuals you can use for E2050 LAN/GPIB Gateway operation with the listed I/O application software products follow. The E2050 Gateway supports all I/O application operations by these software products except for parallel polling, SICL commander sessions, and asynchronous aborting. Product Related Documentation VISA To use the LAN/GPIB Gateway, you must configure the LAN Client software provided with VISA.
Introduction E2050 Hardware Description E2050 Hardware Description In addition to this guide, the E2050 product package consists of: n n n n E2050 LAN/GPIB Gateway Front Panel E2050 LAN/GPIB Gateway Rear Panel AC/DC Adapter and Standard AC Power Cord Rack Mount Kit (Optional) E2050 LAN/GPIB Gateway Front Panel As shown in the following figure, the front panel of the Gateway contains 8 light-emitting diodes (LEDs) that indicate the status of the Gateway.
Introduction E2050 Hardware Description E2050 LAN/GPIB Gateway Rear Panel This figure shows the back panel features of the Gateway. Note that the RS-232 interface is NOT supported for I/O application use..
Introduction E2050 Hardware Description AC/DC Adapter and AC Power Cord As shown in the following figure, the power module (AC/DC Adapter) (Agilent part number 0950-2546) provides 5 Vdc power to the Gateway. The 4-foot, DC cable attached to the power module connects to the power input on the back panel of the Gateway. The universal AC outlets on the power module can automatically accept and adapt to 100-240 Vac power.
Introduction E2050 Software/Firmware Architecture E2050 Software/Firmware Architecture This section describes E2050 software/firmware architecture, including: n n n n I/O Application Software Supported Typical LAN Connections Software/Firmware Overview Using Applications Software I/O Application Software Supported The E2050 LAN/GPIB Gateway supports these I/O application software products.
Introduction E2050 Software/Firmware Architecture Typical LAN Connections The E2050 LAN/GPIB Gateway combines hardware and firmware in a single box that provides a network gateway between network-equipped computer systems and GPIB based instruments. The Gateway enables users of I/O applications to obtain measurement data either locally or remotely from GPIB instrumentation. The following figure shows typical LAN connections for an E2050 Gateway.
Introduction E2050 Software/Firmware Architecture The Gateway connects the local area network (LAN) from the computer system to the GPIB bus. Network-equipped computer systems that are supported for use with the Gateway include Series 700 workstations and 32-bit PCs. Following the client/server model of computing, the computer system is the client, and the E2050 LAN/GPIB Gateway acts as the server.
Introduction E2050 Software/Firmware Architecture Software/Firmware Architecture Overview Agilent SICL contains the LAN client software needed to access the LAN/GPIB Gateway. Thus, SICL is also provided with the VISA, VEE, and HP BASIC/UX 700 I/O application software products. To use any of these software products with the LAN/GPIB Gateway, you must also install and configure SICL on the client computer system.
Introduction E2050 Software/Firmware Architecture Using Application Software This section summarizes how the software on a client computer system works with the E2050 LAN/GPIB Gateway to complete I/O application operations on attached GPIB instruments. For more information on how to use your software with the Gateway, see the applicable software documentation as listed in “Related Software Documentation”.
2 Installation 23
Installation This chapter shows how to install the E2050 LAN/GPIB Gateway on the LAN and the GPIB bus for use with network-equipped computer systems, including: n Hardware Requirements n Software Requirements n Hardware Installation 24 Chapter 2
Installation Hardware Requirements Hardware Requirements To install the Gateway, you must have the following hardware: n One or more of these network-equipped computer systems to act as the LAN client system(s): q q HP 9000 Series 700 workstation 32-bit personal computer (PC) n A local area network (LAN) to which the client system(s) and the E2050 LAN/GPIB Gateway can connect via the appropriate LAN cables. n The E2050 LAN/GPIB Gateway.
Installation Software Requirements Software Requirements Each client computer system that will access the Gateway must be running one of the following operating systems. n HP-UX Version 9 or Version 10.01 or later (for Series 700 workstations) n Microsoft Windows 95, Windows 98, Windows 2000, Windows Me, or Windows NT (for 32-bit PCs) You must also have one or more of the following I/O application products installed and configured on each client computer system that you want to use with the Gateway.
Installation Installing the Hardware Installing the Hardware This section shows how to install the LAN/GPIB Gateway hardware by connecting it to the LAN, GPIB bus, and power module. Step 1: Record LAN Hardware Address First, find the hardware address of the LAN interface in the E2050 LAN/GPIB Gateway. Turn the Gateway over and look for the label on the underside of the Gateway. The hardware address on the label will be similar to 0800XXXXXX.
Installation Installing the Hardware Step 3: Connect the Gateway to the Network CAUTION Do not connect to both the RJ-45 and the BNC connectors on the Gateway. Only one connection to the LAN interface in the Gateway can be made at a time. Data loss may occur if you try to use both connectors simultaneously. The Gateway will automatically select the active port.
Installation Installing the Hardware n ThinLAN Connections. For ThinLAN, connect the LAN cable to the BNC connector on the back panel of the Gateway using a BNC “T” connector. Make sure the ThinLAN segment is properly terminated. If the Gateway is the end node on the LAN, a 50-ohm BNC terminator must be attached to the “T” connector.
Installation Installing the Hardware Step 4: Connect GPIB Cable and Power Cords NOTE The power module and Gateway do not have power switches. Connecting the standard AC power cord to the power source (wall outlet) activates both units. The power module automatically adapts to the correct AC voltage range for your power source. n Connect the GPIB cable from the GPIB instrument(s) to the GPIB connector on the back panel of the Gateway.
Installation Installing the Hardware Step 5: Observe the Power-On Sequence n The Gateway now goes through its power-on, hardware self-test. Verify that the hardware is working properly by looking at the LEDs on the front panel of the Gateway. n The green Power LED should now be illuminated and the red Fault LED should be off. One or more of the yellow LAN LEDs may also be flashing. Ignore the LAN LEDs at this time. n The red Fault LED is illuminated briefly at power-on to verify its operation.
Installation Installing the Hardware Notes: 32 Chapter 2
3 Configuration 33
Configuration This chapter gives guidelines to configure the E2050 LAN/GPIB Gateway on your network. You can use this chapter if you are configuring the Gateway for the first time on your network or if you need to change the Gateway’s configuration. NOTE If the E2050 LAN/GPIB Gateway is already configured and you want to change the configuration, see “Configuring the Gateway” in Chapter 4 first. Then, use this chapter to reconfigure the Gateway.
Configuration Setting Configuration Values Setting Configuration Values This section gives guidelines to set E2050 configuration values, including: n n n n Steps to Set Configuration Values Configuration Values Descriptions Default Configuration Settings How Configuration Values are Used Steps to Set Configuration Values To configure an E2050 LAN/GPIB Gateway on a network, you will need to: n Know the configuration values that can be used for the Gateway, including the defaults (if any) that are prese
Configuration Setting Configuration Values NOTE IP addresses for network devices are assigned by a designated Network Administrator in your workplace. If you are not the Network Administrator, you will need to contact the designated Network Administrator who can assign the Gateway’s IP address for you. The following table describes the configuration values for the E2050 and the applicable default (factory-set) values.
Configuration Setting Configuration Values Value Default Value Description Hardware Address (MAC) (cont’d) N/A The hardware address value cannot be set or changed with Telnet configuration of the LAN/GPIB Gateway. However, the hardware address value must be specified and set when using the BOOTP or the BOOTP with TFTP configuration method. Hostname E2050 This value configures the Internet domain name for the LAN/ GPIB Gateway.
Configuration Setting Configuration Values Value IP Address Default Value Description 192.0.0.192 This value is the Internet Protocol (IP) address of the LAN/GPIB Gateway. The IP address is a required value and is used for all IP and TCP/IP communications with the LAN/GPIB Gateway. The IP address is represented in dotted decimal notation (for example, 154.140.222.201). This number is not assigned by Agilent. Rather, it is assigned by your designated Network Administrator.
Configuration Setting Configuration Values Value LAN Timeout Default Value 0 sec Description This value sets the LAN connect timeout in seconds. The Gateway may use the TCP keepalive timer of the TCP/IP protocol stack to determine if a client is still reachable. By specifying this configuration value, the Gateway turns on the keepalive timer when connecting to the client.
Configuration Setting Configuration Values Value Syslog Server Address (cont’d) Default Value 0.0.0.0 Description Typically, syslogd obtains its routing information from the / etc/syslog.conf configuration file, which you can edit to specify the log file to which you want syslog messages from the LAN/GPIB Gateway routed. See syslogd(1M) for more information on the syslogd daemon and the syslog.conf file. The syslog server’s IP address is represented in dotted decimal notation.
Configuration Setting Configuration Values How Configuration Values are Used The E2050 LAN/GPIB Gateway uses the default configuration values and/or the configuration values that you changed or set depending on certain situations, such as when the power is cycled on the Gateway or when the Config Preset button on the back panel of the Gateway is pressed. This section summarizes how configuration values are used in various situations.
Configuration Setting Configuration Values When the Config Preset Button is Pressed The recessed Config Preset button on the back panel of the Gateway is used to reset the LAN/GPIB Gateway to its default configuration values (preset at the factory). The Config Preset button has two modes of operation. n If you press the Config Preset button at the same time as you apply power to the Gateway, all previous configuration information is erased and all default configuration values are used.
Configuration Configuration Methods Configuration Methods This section describes configuration methods you can use to set the configuration values for the E2050 LAN/GPIB Gateway, including: n n n n n Configuration Methods Overview Using Telnet Configuration Method (Windows) Using Telnet Configuration Method (HP-UX) Using BOOTP Configuration (HP-UX) Using BOOTP with TFTP Configuration Method (HP-UX) Configuration Methods Overview Summary descriptions of the three methods to configure an E2050 LAN/GPIB Ga
Configuration Configuration Methods BOOTP BOOTP is a bootstrap protocol that allows critical configuration values such as the IP address and subnet mask to be set easily. With the BOOTP configuration method, you set the values for the Gateway in the /etc/bootptab file. This file is then used by the bootpd daemon running on the BOOTP server to configure the Gateway on the network.
Configuration Configuration Methods Using Telnet Configuration Method (Windows) To configure the LAN/GPIB Gateway on your network using the Telnet configuration method from a Windows 95/98/2000/Me/NT client system: 1 Power-on the Gateway by plugging the AC power cord from the power module into a power outlet (wall outlet). 2 Once the Gateway is powered on, press the Config Preset button on the back panel of the Gateway. This causes the Gateway to temporarily use its default IP address, 192.0.0.192.
Configuration Configuration Methods When you are connected to the Gateway, you will see general information about the Telnet utility commands, as well as a listing of the current configuration settings for this Gateway. For example, if you have not changed any of the configuration settings previously, you will see the default configuration settings for the Gateway as shown. In this display, the hardware-addr: value is an example. Your hardware-addr: value will be correct for your Gateway.
Configuration Configuration Methods 10 At the Telnet prompt (>), enter the configuration values you want to change or set. (You only need to specify the non-default values that you want.) The following information will help you set the values correctly. The following table lists the configuration values you can set using Telnet. The following information shows the syntax you should use and provides tips to help you to change or set the configuration values correctly.
Configuration Configuration Methods For each configuration value to change or set, use the syntax: Telnet_command: value Enter. For example, to set the IP address value of 156.140.222.201 for the Gateway, enter: ip: 156.140.222.201 Enter If you make a mistake, re-enter the correct configuration value you want. To do this, use the same syntax as before to re-enter the value (Telnet_command: value Enter).
Configuration Configuration Methods You should get a response from the ping command that is similar to the following, where each line after the PING line is an example of a packet successfully reaching the Gateway from the client system. If the ping response is similar to the following, the Gateway has been configured successfully. Pinging E2050.agilent.com[128.10.0.3] with 32 bytes of data: Reply from 128.10.0.3:bytes=32 time=10ms TTL=255 Reply from 128.10.0.3:bytes=32 time=10ms TTL=255 Reply from 128.10.
Configuration Configuration Methods Using Telnet Configuration Method (HP-UX) To configure the LAN/GPIB Gateway on your network using Telnet from an HP-UX client system, do the following: 1 Power-on the Gateway by plugging the AC power cord from the power module into a power outlet (wall outlet). 2 After the Gateway is powered on, press the recessed Config Preset button on the back panel of the Gateway. This causes the Gateway to temporarily use its default IP address, 192.0.0.192.
Configuration Configuration Methods For example, if you have not changed any of the configuration settings previously, you will see the default configuration settings for the Gateway, as follows. In this display, the hardware-addr: value is an example. Your hardware-addr: value will be correct for your Gateway. NOTE On HP-UX 10.01, you may see the string Local flow control off at the bottom of the screen. This will not affect the use of the Telnet utility to configure the E2050.
Configuration Configuration Methods The following table lists the configuration values you can set using Telnet. The information following the table explains the syntax you should use and provides reminders to help you to change or set the configuration values correctly. NOTE By using the Telnet configuration method, the LAN hardware address (hardware-addr:) value is automatically set to the correct hardware address for this LAN/GPIB Gateway. Do not change the hardware address value via Telnet.
Configuration Configuration Methods If you want to exit without saving any of the configuration values you have changed or set, enter either exit Return or quit Return. You can then re-enter the Telnet configuration utility starting with Step 5. Any time during the Telnet session, you can enter config Return to view the current configuration settings. Any time during the Telnet session, you can enter ? Return for a list of available commands you can use in the Telnet utility.
Configuration Configuration Methods PING E2050.agilent.com: 64 byte packets 64 bytes from 128.10.0.3: icmp_seq=0. time=3. ms 64 bytes from 128.10.0.3: icmp_seq=1. time=3. ms 64 bytes from 128.10.0.3: icmp_seq=2. time=2. ms . . . A response similar to the following indicates the client was unable to contact the Gateway. There may be some problem with the Gateway’s configuration or with the network itself.
Configuration Configuration Methods Using BOOTP Configuration Method (HP-UX) To configure a LAN/GPIB Gateway on your network using BOOTP from an HP-UX client system: 1 Make sure that the Gateway is powered-off. The AC power cord from the power module must be disconnected from the power outlet (wall outlet). 2 Determine which computer system is the BOOTP server on your network. Then, log into the BOOTP server system as root. Edit the /etc/bootptab configuration file.
Configuration Configuration Methods This example BOOTP entry configures a hostname (hn), a hardware address (ha), and an IP address (ip) for the LAN/GPIB Gateway. All other configuration values are “set” to (will default to) the factory defaults. E2050:\ hn:\ ht=ether:\ vm=rfc1048:\ ha=0800091A0E00:\ ip=156.140.4.
Configuration Configuration Methods 4 Test that the Gateway has received the BOOTP response and has configured itself by using the ping command. This command allows you to test general network connectivity between your client computer system and the LAN/GPIB Gateway. At the client system, type: ping hostname (or) IP_address Enter. For example, using a Gateway’s hostname: ping E2050.agilent.com Enter Or, using a Gateway’s IP address: ping 156.140.4.
Configuration Configuration Methods Using BOOTP with TFTP Configuration Method (HP-UX) To configure a LAN/GPIB Gateway on your network using BOOTP with TFTP from an HP-UX client system: 1 Make sure that the Gateway is powered OFF. The AC power cord from the power module must be disconnected from the power outlet (wall outlet). 2 Determine which computer system is the BOOTP server on your network. Then, log into the BOOTP server system as root. 3 Edit the /etc/bootptab configuration file.
Configuration Configuration Methods This example BOOTP entry configures a hostname (hn), a hardware address (ha), an IP address (ip), and the path to the TFTP configuration file (T144). In this example, the path to the TFTP configuration file is relative, with the assumption that the default TFTP mode is being used. All other configuration values are “set” to (will default to) the factory defaults. E2050:\ hn:\ ht=ether:\ vm=rfc1048:\ ha=0800091A0E00:\ ip=156.140.4.249:\ T144=”E2050/gw1.
Configuration Configuration Methods 5 Create the appropriate directory structure and TFTP configuration file for each LAN/GPIB Gateway, as noted in the T144 configuration value you set in the /etc/bootptab file. Be sure you set permissions on these directories and on the TFTP configuration file to allow access by the bootpd daemon. For example, the T144 value in the previous example /etc/ bootptab file was set to “E2050/gw1.cfg”.
Configuration Configuration Methods An example TFTP file follows. Consult your system documentation for any other steps required to complete the TFTP configuration file. # The E2050 gw1 Configuration File hostname: E2050 # Timeouts lan-timeout: 7200 io-timeout: 240 # IP allow list allow: 156.140.34.2 15.2.* # GPIB configuration hpib-addr: 17 hpib-name: hpib1 hpib-unit: 8 7 Once you have added the configuration values you want, save and close the TFTP configuration file(s).
Configuration Configuration Methods At the client system, type: ping hostname (or) IP_address Return For example, using a Gateway’s hostname: ping E2050.agilent.com Return Or, using a Gateway’s IP address: ping 156.140.4.249 Return You should get a response from the ping command that is similar to the following, where each line after the PING line is an example of a packet successfully reaching the Gateway from the client system.
4 Administration 63
Administration This chapter gives guidelines to administer the E2050 LAN/GPIB Gateway on your network, using the Telnet utility provided with the LAN/GPIB Gateway. The Telnet utility provides a command line interface for accomplishing administration tasks, including Telnet configuration of the Gateway, querying the status of the Gateway and its client connections, etc.
Administration Using the Telnet Utility Using the Telnet Utility This section explains how to access and exit the Telnet utility. It also summarizes various Telnet commands you can use to administer the E2050 LAN/GPIB Gateway.
Administration Using the Telnet Utility 3 If you do not know the IP address or hostname of the Gateway: n After the Gateway has been powered-on, press the Config Preset button on the back panel of the LAN/GPIB Gateway. This forces the Gateway to temporarily use the 192.0.0.192 default IP address without modifying any other configuration values. n If you are using an HP-UX client system, as root, type route add host 192.0.0.192 your_system_name Return.
Administration Using the Telnet Utility Welcome to the E2050 LAN/GPIB Gateway configuration utility. Commands ? Show additional commands exit, quit Exit WITHOUT saving configuration changes reboot Save configuration changes and restart status Show the LAN/GPIB Gateway connection status Configuration Parameters hostname: E2050 hardware-addr: 0800091A0E02 ip: 156.140.4.249 default-gw: 0.0.0.0 subnet-mask: 0.0.0.0 syslog-svr: 156.140.4.244 bootp: OFF lan-timeout: 7200 io-timeout: 120 allow: 156.140.4.
Administration Using the Telnet Utility Exiting the Telnet Utility To exit the Telnet utility, use these Telnet commands. n If you want to exit without saving any changes (if any) you have made to the configuration values, at the Telnet prompt (>) type bye (or) exit (or) quit. n If you want to save the changes you have made to the configuration values via the Telnet utility, at the Telnet prompt (>) type reboot.
Administration Using the Telnet Utility Command Description allow: IP_address(es) Set the IP allow list configuration value for the Gateway. bootp: ON/OFF Turn ON or OFF the use of BOOTP or BOOTP with TFTP configuration of the Gateway. bye Quit the Telnet utility without saving configuration changes. config Display the current configuration settings for the Gateway. default-gw: IP_address Set the default subnet gateway address configuration value for the Gateway.
Administration Querying the Gateway Querying the Gateway This section gives guidelines to query the E2050 LAN/GPIB gateway, including: n n n n Querying the Current Configuration Querying the Firmware Version Querying the Configuration Method Querying Gateway/Client Connections Querying the Current Configuration As soon as you access the Gateway’s Telnet utility, you see a screen of information, including a listing of the Gateway’s current configuration settings.
Administration Querying the Gateway Querying the Configuration Method If you do not know the configuration method currently used for the Gateway, you can determine the method via the bootp: ON/OFF Telnet configuration value. To do this: 1 At the Telnet prompt (>), type config. This displays the current configuration settings for the Gateway. 2 Check the bootp: configuration setting. If it is set to OFF, the current configuration method is the Telnet configuration method.
Administration Querying the Gateway The following is an example status screen of clients connected to an E2050 LAN/GPIB Gateway. Server ID Client IP Addr 0x2008f624 156.140.4.247 0x2008f40c 0x2008f1f4 190.2.49.138 156.140.4.
Administration Querying the Gateway All the sessions for a particular connection are listed together and only the first session has the Server ID, Client IP Addr, and Client ID specified. For a given client, one session at most will have an operation pending or in progress at a given time. The Client IP Addr and Client ID are both needed to uniquely identify a client connection. In the previous example, clients 1 and 3 are separate processes on the same machine (that is, they have the same Client IP Addr).
Administration Querying the Gateway 74 Operation SICL Function GETT1 igpibgett1delay HINT ihint LLO igpibllo LOCAL ilocal LOCK ilock ONINTR ionintr ONSRQ ionsrq OPEN iopen PASSCTL igpibpassctl READ iread READSTB ireadstb REMOTE iremote RENCTL igpibrenctl SENDCMD igpibsendcmd SETINTR isetintr SETT1 igpibsett1delay TRIGGER itrigger, ixtrig UNLOCK iunlock VERSION iversion WRITE iwrite Chapter 4
Administration Configuring the Gateway Configuring the Gateway This section gives guidelines to configure the E2050 LAN/GPIB Gateway, including: n n n n Setting Default Configuration Settings Changing the Configuration Method Using the Gateway’s syslog File Terminating Client Connections Setting Default Configuration Values To return the Gateway to all of its default configuration values, you can either press the Config Preset button on the back panel of the LAN/GPIB Gateway at the same time that you po
Administration Configuring the Gateway To change the configuration method used for the Gateway, you can modify the bootp: ON/OFF Telnet configuration value or you can press the Config Preset button. Once you have changed the configuration method, follow the procedures in Chapter 3 to configure the Gateway via the new method. NOTE The bootp: ON/OFF configuration value in the Telnet utility is automatically set to OFF if the IP address is changed via the Telnet utility.
Administration Configuring the Gateway To modify the configuration method by pressing the Config Preset button, press the Config Preset button on the back panel of the LAN/GPIB Gateway at the same time as you power-on the Gateway. This changes all configuration values back to the default values, including setting the bootp: ON/OFF value to the default ON value. You may now use either the BOOTP or the BOOTP with TFTP configuration method.
Administration Configuring the Gateway n Because of the limited memory area on the Gateway, only about 50 lines of syslog-display messages can be logged in the Gateway. After the limit has been reached, any new messages can not be logged. For more information, see “Maintaining the syslog File”. n Messages sent to the syslog file on the syslog server will have the date, time, and hostname prepended to the message.
Administration Configuring the Gateway Terminating Client Connections If after querying the status of the Gateway and client connections, you determine that the Gateway or a client’s I/O operation is “hung” or there is a deadlock situation between clients that are connected to the Gateway, you can reboot the Gateway to terminate all client connections.
Administration Configuring the Gateway Notes: 80 Chapter 4
5 Troubleshooting 81
Troubleshooting This chapter gives guidelines to troubleshoot problems that may occur with the E2050 LAN/GPIB Gateway, including: n n n n Gateway Failure Messages Troubleshooting Network Configuration Troubleshooting Gateway Configuration Troubleshooting Client Connections NOTE This chapter references Telnet utility commands you can use to troubleshoot problems. See Chapter 4 for E2050 LAN/GPIB Gateway Telnet utility commands. This chapter also references various configuration values.
Troubleshooting Gateway Failure Messages Gateway Failure Messages This section provides failure messages and troubleshooting explanations for the E2050 LAN/GPIB Gateway, including: n SICL Error Codes and Messages n syslog File Messages SICL Error Codes and Messages The following table lists some common SICL error codes and messages a client application may encounter when using the E2050 LAN/GPIB Gateway.
Troubleshooting Gateway Failure Messages syslog File Messages The syslog file error messages can be viewed via the Telnet syslogdisplay command or by looking in the syslog file specified via the syslog server address configuration value. Any invalid BOOTP values are detected when the file /etc/bootptab is read by the bootpd daemon. Errors will be sent to the syslog server for the BOOTP server system that is running the bootpd daemon.
Troubleshooting Troubleshooting Network Configuration Troubleshooting Network Configuration This section provides guidelines to troubleshoot network configuration problems, including: n Verifying Network Connections n Troubleshooting Network Configurations Verifying Network Connections Before attempting to communicate with the E2050 LAN/GPIB Gateway, you may want to verify that the network connection and cabling are correct.
Troubleshooting Troubleshooting Network Configuration Troubleshooting Network Configurations If some network configuration values for the E2050 LAN/GPIB Gateway are improperly configured, one or more client systems may not be able to make a connection to the Gateway. The problem may be: n Improper configuration value(s) for the default subnet gateway and/ or the subnet mask. If this is the case, the Gateway may be receiving requests from the client, but routing the replies to the wrong place.
Troubleshooting Troubleshooting Network Configuration BOOTP or BOOTP with TFTP Configuration To correct network configuration values when using the BOOTP or the BOOTP with TFTP configuration method: 1 Fix the improper value in the /etc/bootptab file or the specified TFTP configuration file. 2 Cycle the power on the Gateway or use the Telnet reboot command. This will force the Gateway to use the new configuration values.
Troubleshooting Troubleshooting Gateway Configuration Troubleshooting Gateway Configuration This section gives guidelines to troubleshoot E2050 LAN/GPIB Gateway configuration problems, including n n n n n n n Verifying Gateway Configuration Setting Default Configuration Verifying the Configuration Method Changing the Configuration Method Troubleshooting Telnet Configuration Troubleshooting BOOTP Configuration Troubleshooting BOOTP with TFTP Configuration Verifying Gateway Configuration To verify that th
Troubleshooting Troubleshooting Gateway Configuration CAUTION Any client operations in progress and client connections will be terminated by the factory-reset command when it reboots the Gateway. Verifying the Configuration Method If you have a problem configuring the LAN/GPIB Gateway (such as configuring the IP address), first verify the method of configuration for the Gateway.
Troubleshooting Troubleshooting Gateway Configuration 4 If the Gateway is powered on, configured, but you do not know the IP address: n Press the Config Preset button on the back panel of the LAN/GPIB Gateway. This forces the Gateway to temporarily use the 192.0.0.192 default IP address without modifying any other configuration values. n Make sure the route table entry for the Gateway at its default IP address is setup via the route command on the client system. n Telnet to 192.0.0.
Troubleshooting Troubleshooting Gateway Configuration Changing the Configuration Method If you want to change the configuration method used for the Gateway, you can take one of three following actions. However, for Windows 95/98/Me/ 2000/NT client systems, you must use the Telnet configuration method. Neither the BOOTP nor the BOOTP with TFTP configuration methods are available on Windows client systems. After you change the configuration method, see Chapter 3 to configure the Gateway to the new method.
Troubleshooting Troubleshooting Gateway Configuration Troubleshooting Telnet Configuration If you have trouble configuring the LAN/GPIB Gateway using Telnet with the default IP address of 192.0.0.192: 1 Verify that the route command was performed properly. Use netstat -r to display the network routing tables. 2 Verify that the Gateway is on the same local subnet as the client system from which you are Telneting.
Troubleshooting Troubleshooting Gateway Configuration 4 Verify the BOOTP server is on the same local subnet as the Gateway. If not, consult your Network Administrator to verify that your network configuration supports using a BOOTP server that is not on the same subnet. 5 When the Gateway is powered on, verify there is a fast flash on the LAN Conn LED. NOTE Your BOOTP server may support the bootpquery capability to verify your BOOTP configuration.
Troubleshooting Troubleshooting Client Connections Troubleshooting Client Connections This section gives guidelines to troubleshoot client connections to the E2050 LAN/GPIB Gateway, including: n Client Connection Problems n Client Run-time Errors Client Connection Problems Even if the E2050 LAN/GPIB Gateway has been successfully configured and the configuration has been verified, individual clients may still have problems getting a connection to the Gateway.
Troubleshooting Troubleshooting Client Connections This indicates the client was unable to contact the Gateway. The Gateway may be on a different subnet than the client (see your Network Administrator) or the Gateway may have incorrect network configuration values. n For an HP-UX client system, type: ping hostname (or) IP_address Return. For example: >ping E2050.agilent.com PING E2050.agilent.com: 64 byte packets 64 bytes from 128.10.0.3: icmp_seq=0. time=8. 64 bytes from 128.10.0.3: icmp_seq=1. time=3.
Troubleshooting Troubleshooting Client Connections n You can also try rpcinfo -t IP_address 395180 Return. This rpcinfo command gives the response: program 395180 version 1 ready and waiting. If this is not working properly, see “Troubleshooting Network Configuration”. 3 The Telnet command can be used to verify if a client has network access to the Gateway as well.
Troubleshooting Troubleshooting Client Connections Message Description iopen fails or I/O operation fails: Out of resources The Gateway was unable to open another session or perform the operation because it is out of resources. Use the Telnet status command and look in the syslog file for any error messages to determine the current Gateway status. You may need to have a client terminate its connection or you may need to reboot the Gateway to close all client connections to reclaim resources.
Troubleshooting Troubleshooting Client Connections Message Description Gateway appears to be hung There are several possible causes. For all of the following, use of client timeouts and/or Gateway timeouts (the I/O timeout and LAN timeout configuration values) can be used to ensure that the Gateway will not “hang” indefinitely.
A Specifications 99
Specifications This appendix provides specifications for the E2050 LAN/GPIB Gateway, including: n Power Requirements n Environmental n GPIB Characteristics 100 Specifications
Specifications Power Requirements E2050 AC/DC Adapter Input Voltage 5Vdc 100-240Vac Input Current ~0.8A Typical 9.75A dc 50/60Hz N/A 2.0A Maximum Frequency Range Output Current Power Consumption 4W (Typical) 10W (Maximum) Environmental Operating Temperature 0°C to +40°C Relative Humidity 15% to 80% at 40°C Non-Operating (Storage) –40°C to +70°C 90% R.H. at 60°C 24 hrs. GPIB Characteristics The GPIB connection conforms to IEEE 488.1 - 1987 specifications.
Specifications Notes: 102 Specifications
Glossary 103
Glossary address A string uniquely identifying a particular interface or a device on that interface which is interpreted at the E2050 LAN/GPIB Gateway to identify the interface or device. BOOTP requests Broadcast messages sent at power-on from the E2050 LAN/GPIB Gateway to the BOOTP server's bootpd daemon to gain configuration information for the LAN/GPIB Gateway. The BOOTP request contains the LAN/GPIB Gateway 's LAN hardware address.
Glossary gateway Hardware that permits a network connection between the LAN that your computer understands, and the instrument specific interface that your device understands. instrument A device that accepts commands and performs a test or measurement function. interface A connection and communication media between devices and controllers, including mechanical, electrical, and protocol connections. LAN Local Area Network. The E2050 LAN/GPIB Gateway can be used on either Ethertwist or ThinLAN networks.
Glossary one interface on the controller or gateway, each interface must have a unique symbolic name. TFTP The Trivial File Transfer Protocol, which is an extension to BOOTP. VEE The Agilent Visual Engineering Environment, which is software used for I/O application programming. VISA The Agilent Virtual Instrument Software Architecture library, which is software used for I/O application programming.
Index A C (continued) AC/DC adapter, 17 administration, 64 Agilent telephone numbers, 6 Agilent web site, 6 allow, 69 application software supported, 18 using, 22 B BNC connector, 16 bootp command, 69 BOOTP ON/OFF command, 36 BOOTP configuration configuration values, 55 default values, 55 definition, 44 method (HP-UX), 55 troubleshooting, 92 BOOTP with TFTP definition, 58 troubleshooting, 93 bootpd daemon, 41 bootpquery, 93 bootptab configuration file, 58 bye, 69 C changing configuration method, 75, 91
G gateway configuration, verifying, 88 gateway failure messages, 83 gateway/client connections, 71 glossary, 104 GPIB Address, 37 GPIB connector, 16 GPIB Interface Name, 37 GPIB Logical Unit, 37 guide, using, 13 H hardware address, 36 description, 15 failure, 85 installing, 27 requirements, 25 hardware-addr command, 69 help, 69 hostname, 37, 69 hpib-address, 69 hpib-name, 69 hpib-unit, 69 I I/O timeout, 37 installation, 24 installing hardware, 27 Internet Protocol (IP) address, 35 io-timeout, 69 IP addres
S T (continued) safety, 7 server/client model, 20 setting configuration values, 35 setting default configuration, 75, 88 SICL LAN error codes, 83 SICL LAN protocol, 21 software requirements, 26 software/firmware architecture, 21 specifications, 100 status, 69 subnet mask, 39 subnet-mask, 69 super-user privileges, 13 syslog file description, 40 file messages, 84 server address, 39 using, 77 syslog-clear, 69 syslog daemon, 40 syslog-display, 69 syslog-svr, 69 T TCP/IP instrument protocol, 21 telephone numb
T (continued) troubleshooting (cont’d) gateway configuration, 88 hardware failure, 85 network configurations, 85–86 network configurations BOOTP with TFTP, 87 BOOTP, 87 Telnet, 86 setting default configuration, 88 Telnet configuration, 92 verifying config method, 89 verifying gateway config, 88 verifying network conn, 85 110 U using the syslog file, 77 V verifying configuration method, 89 verifying gateway configuration, 88 verifying network connections, 85 version, 69 W warranty, 5 web site, Agilent, 6