NETEX NESiGate-CA User manual

MAN-REF-CASW
NESiGate-CA
NetEx/IP Host Channel-to-IP Gateway
Release 2.8.2
Reference Manual

Page ii MAN-REF-CASW
Revision Record
Revision Description
01 (Oct 2000) Initial manual release by Network Executive Software.
02 (Jan 2001) Added procedures for new CDROM distribution and software keys
03 (Jan 2002) Updated for RedHat 7.2 distribution and miscellaneous corrections and additions.
04 (Apr 2002) Miscellaneous updates to correspond with version 2.3 release.
05 (xxx 2002) Added documentation for Hitachi IBM-compatible configuration requirements.
06 (Oct 2002) Added documentation for NG_CA service
07 (Dec 2002) Removed Integration section to NESiGate Software Installation Guide
08 (Jun 2005) Added Software RAID configuration to install
09 (Aug 2005) Updated for release 2.7.2
09 (Jan 2006) Updated for release 2.7.4
10 (Jan 2006) Updated for release 2.7.5
11 (Feb 2006) Updated for release 2.7.6
12 (Oct 2006) Updated for release 2.8
13 (Dec 2006) Updated for release 2.8.1
14 (Feb 2007) Updated for release 2.8.2
© 2000-2006 Network Executive Software, Inc. Reproduction is prohibited without prior permission of
Network Executive Software. Printed in the USA. All rights reserved.
The U.S. Department of Commerce restricts the distribution of technical information contained in this
document when exported outside the U.S. Therefore, careful attention should be given to compliance
with all applicable U.S. Export Laws if any part of this document is to be exported.

MAN-REF-CASW Table of Contents Page iii
Table of Contents
Revision Record.....................................................................................................................................ii
Copyrights and Trademarks ...................................................................................................................v
Notice to the Customer..........................................................................................................................vi
NESiGate Modification Policy..........................................................................................................vi
Introduction..............................................................................................................................................1
Customization...........................................................................................................................................3
Overview................................................................................................................................................3
Configure NESiGate...............................................................................................................................3
Device Number ..................................................................................................................................3
GNA Address.....................................................................................................................................4
IP Address..........................................................................................................................................4
Using a Web Browser to Configure NESiGate......................................................................................4
Define the Channel Boards(s) ............................................................................................................4
Define the Devices.............................................................................................................................4
Add Routes (optional)........................................................................................................................5
Define IP Interface.............................................................................................................................5
Reboot NESiGate...............................................................................................................................5
Web Browser Interface............................................................................................................................7
Overview................................................................................................................................................7
Browser Considerations .....................................................................................................................7
Browser Considerations .....................................................................................................................7
Initial Screen ......................................................................................................................................7
System, Product, SNMP & Network Configuration ..........................................................................8
NESiGate Board/Channel Commands ...............................................................................................9
Display Board Config.....................................................................................................................9
Channel Define Board and Channel Undefine Board ....................................................................9
Channel Command drop-down menu...........................................................................................10
Channel Display Interface Config................................................................................................10
Channel Display ESCON Config.................................................................................................11
Channel Display Info....................................................................................................................11

Page iv MAN-REF-CASW
Channel Display Stats ..................................................................................................................12
Channel Clear Stats......................................................................................................................13
Channel Start Interface.................................................................................................................13
Channel Stop Interface.................................................................................................................13
Channel Undefine Interface..........................................................................................................13
Channel Define Interface..............................................................................................................14
Channel Set Debug.......................................................................................................................15
NESiGate Router Commands...........................................................................................................16
Command drop-down menu.........................................................................................................16
Route Display Config...................................................................................................................16
Route Display Info .......................................................................................................................16
Route Display Locals ...................................................................................................................16
Route Display Routes...................................................................................................................17
Route Display Stats......................................................................................................................17
Route Clear Stats..........................................................................................................................17
Route Set Debug...........................................................................................................................18
Help Debug ..................................................................................................................................18
Route Add Route..........................................................................................................................18
Route Delete Route ......................................................................................................................19
Route Delete All Routes...............................................................................................................19
NESiGate IP Interface Commands...................................................................................................20
Command drop-down menu.........................................................................................................20
IP Interface Display Config..........................................................................................................20
IP Interface Display Info..............................................................................................................21
IP Interface Display Stats.............................................................................................................22
IP Interface Clear Stats.................................................................................................................23
HELP Debug................................................................................................................................23
IP Interface Set Debug .................................................................................................................23
IP Interface Define Interface........................................................................................................24
Appendix A: Configuration Worksheet ...............................................................................................25
Appendix B: NESiGate Sense Bytes .....................................................................................................27

MAN-REF-CASW Page v
Copyrights and Trademarks
This document contains references to the trademarks of the following corporations.
Corporation Trademarks
International Business Machines ESCON®
Netscape Communications Corp. Netscape®
Unisys Corporation SBCON
Additional trademark references:
Linus Torvalds Linux®

Page vi MAN-REF-CASW
Notice to the Customer
Comments about this manual may be submitted via mailto:[email protected] or by visiting our website:
http://www.netex.com
Always include the complete title of the document with your comments.
Information on Network Executive Software’s general software support policy (e.g., alternate contact
methods, support severity level descriptions, and service status definitions) may be found at
http://www.netex.com/services/supportpolicy.html.
Details on Network Executive Software’s warranty and support policies specific to NESiGate may be
found at http://www.netex.com/services/warrantyNG.html.
NESiGate Modification Policy
NESiGate is an appliance that contains proprietary software and firmware. Modifications to the soft-
ware, firmware, or hardware platform that are not specifically authorized by NESi are prohibited.
Examples of prohibited activities include (but are not limited to) the following items:
•Installing other software on NESiGate
•Modifying the file system (including adding, deleting, or moving files and/or directories, or
changing permission levels, ownership, or other attributes of files and/or directories)
•Adding or deleting user accounts
•Starting or stopping system services
•Adding or removing hardware components
Any unauthorized modifications to NESiGate may affect its operation and/or obstruct NESi’s ability to
diagnose problems and provide corrections. Any work resulting from unauthorized modifications shall
be paid by the customer at NESi’s then-current support rates and may result in the immediate termina-
tion of warranty/support coverage.

MAN-REF-CASW Page 1
This manual provides an overview of the procedures used to integrate and customize the NetEx/IP com-
ponents onto a NESiGate-CA host channel platform, and to provide a description of the command and
web browser interfaces.
This manual is divided into four sections:
1) Integration: Integration of NESiGate software on the hardware platform is covered in the NESi-
Gate Software Installation Guide. Refer to that guide, then return to this manual to complete the
configuration of NESiGate as an Channel Adapter (CA) type device
2) Customization: this section is targeted to the end-user who is responsible for customizing NESi-
Gate for use as a host-based NetEx/IP channel device. It is assumed the NESiGate already has the
appropriate NESiGate-OS installed. To complete the customization, the reader must be familiar
with channel device and network addressing concepts.
3) Web Browser Interface: this section is targeted to the end-user who is responsible for customizing
the NESiGate for use as a host-based NetEx/IP channel device, and who is responsible for configur-
ing and controlling operational aspects of the device.
Introduction

Page 2Introduction MAN-REF-CASW

MAN-REF-CASW Customization Page 3
Overview
This section provides an overview of the procedures used to complete the customization of the NESi-
Gate-CA for use with Host-Based NetEx/IP products. This section is targeted to the end-user responsi-
ble for customization. The reader must be familiar with channel device and network addressing con-
cepts.
Configure NESiGate
There are three important addressing elements involved in delivering NetEx/IP channel data that is not
IP-aware, and transferring it over an IP network to the correct destination:
• Device Number
• GNA Address
• IP Address
Device Number
The Device Number on the host and Device Index on the NESiGate channel board are numeric repre-
sentations of the same unique "device". On the Host operating system, a "Device Number" is defined as
a Unit Address on a Logical Control Unit (a physical control unit may consist of from 1-16 logical con-
trol units). The Physical Control Unit may be connected to a Port on an ESCON Director. Multiple
inbound Host channels may be connected to the ESCON Director and provide connectivity to the device
from multiple partitions (LPARs) across multiple hosts.
Similarly, on the NESiGate ESCON board, a "Device Index" is defined as a Unit Address on a Logical
Control Unit (up to 16 may exist). The Physical Control Unit may be connected to a Port on an ESCON
Director, which may provide connectivity to multiple LPARs across multiple hosts.
Since both the Device Number and Device Index represent the same unique device (from different per-
spectives), the same addressing components must be specified exactly the same in both definitions.
Failure to do so will prevent the NESiGate devices from functioning properly.
When defining devices on the ESCON channel board, the following items are specified: Device Unit
Address, Logical Control Unit, the Director port to which the host channel is connected, and Partition-id
(LPAR). The Device Index values are not specified by the user. They are automatically generated
when the channel configuration is defined.
A maximum of 64 devices are supported on each ESCON interface.
Refer to the “Channel Define Interface” button on page 66614 for a description of defining the channel de-
vices.
Customization

Page 4Customization MAN-REF-CASW
GNA Address
The GNA address represents a NetEx/IP network address that is associated with a given device. It is
specified in the NetEx/IP Network Configuration Table (NCT). It is also specified during the customi-
zation of the NESiGate Channel Driver. At that time, an association is established between a particular
GNA address and a Device Index.
IP Address
The IP address represents a NetEx/IP network node address. There is no channel device awareness in-
herent in an IP address. However, during the NESiGate customization task, IP host names are defined,
each having a format based on its GNA address. This enables NESiGate to perform a direct mapping
between GNA and IP addresses. This mapping is transparent to the NetEx/IP running on the host, as
well as to all NetEx/IP applications.
Using a Web Browser to Configure NESiGate
The NESiGate Web Browser Interface may be used to configure NESiGate. Before configuring the
NG-CA specific items, the common System and Network configuration should be completed. See the
“Installation Guide” (NG-SW) manual for details.
Refer to the "Web Browser Interface" section on page 7 for a complete description of the commands
used in this section.
Define the Channel Boards(s)
The channel board(s) are automatically configured by the NESiGate initialization software. Normally,
no re-configuration of the board config is required.
Define the Devices
This step is required. If this step is not performed, the ESCON devices will respond as the correct de-
vice without regard to LPAR or ESCON director port affinity. If this does not match the real configura-
tion, incorrect results will occur.
Select the Board/Channel link in the navigation menu. This will open the page that is titled: NESiGate
CA Board/Channel.
Using the device configuration data from a completed worksheet provided in “Appendix A: Configura-
tion Worksheet” on page 25, use the "Channel Define Interface" button to define the devices. Refer to
page 14 for a description of this command.
Repeat this step as many times as necessary until all required channel interfaces are defined.