Difference between revisions of "Configure Enterprise Extender"

From MidrangeWiki
Jump to: navigation, search
(Creating the controller description)
(+external links)
 
(6 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
==Background==
 
==Background==
  
Enterprise Extender is used to encapsulate SNA traffic over an IP link.  This negates the use of special SNA routers and controllers.  It is only available from V5R4 on the iSeries.
+
Enterprise Extender is used to encapsulate SNA traffic over an IP link.  This negates the use of special SNA routers and controllers.  It is only available from V5R4 on the iSeries. By configuring SNA to run over IP, you can also use the SAVRSTOBJ and SAVRSTLIB commands between iSeries systems (if you do not have devices on your system that will be able to allow SNA communications).
 
 
  
 
==Configuring the different aspects==
 
==Configuring the different aspects==
Line 19: Line 18:
 
==Making changes to Network attributes==
 
==Making changes to Network attributes==
  
The following items need to be set in the network attributes, using the CHGNETA command:
+
The following items need to be set in the network attributes, using the '''CHGNETA''' command:
  
 
  APPN node type . . . . . . . . . . . . . . . . . . . . . :  '''*NETNODE'''
 
  APPN node type . . . . . . . . . . . . . . . . . . . . . :  '''*NETNODE'''
Line 25: Line 24:
 
  Allow HPR transport tower support  . . . . . . . . . . . :  '''*YES'''             
 
  Allow HPR transport tower support  . . . . . . . . . . . :  '''*YES'''             
  
NB: Changing the node type will require you to vary off ALL APPC controllers and devices before changes are made.
+
'''NB:''' Changing the node type will require you to vary off ALL APPC controllers and devices before changes are made.
  
  
Line 59: Line 58:
 
  APPN CP session support  . . . .  *YES          *YES, *NO   
 
  APPN CP session support  . . . .  *YES          *YES, *NO   
 
  APPN transmission group number    1            1-20, *SAME, *CALC
 
  APPN transmission group number    1            1-20, *SAME, *CALC
 +
 +
  
 
==Creating the devices descriptions==
 
==Creating the devices descriptions==
Line 72: Line 73:
 
  Mode: Using *NETATR should be sufficient, otherwise define the mode you wish to use.
 
  Mode: Using *NETATR should be sufficient, otherwise define the mode you wish to use.
 
  APPN-Capable:         *YES
 
  APPN-Capable:         *YES
 
  
  
Line 90: Line 90:
 
  Mode . . . . . . . . . . . . . . > *NETATR      Name, *NETATR                 
 
  Mode . . . . . . . . . . . . . . > *NETATR      Name, *NETATR                 
 
  APPN-capable . . . . . . . . . . > *YES          *YES, *NO                     
 
  APPN-capable . . . . . . . . . . > *YES          *YES, *NO                     
 +
  
  
Line 106: Line 107:
 
  Mode . . . . . . . . . . . . . . > *NETATR      Name, *NETATR                 
 
  Mode . . . . . . . . . . . . . . > *NETATR      Name, *NETATR                 
 
  APPN-capable . . . . . . . . . . > *YES          *YES, *NO
 
  APPN-capable . . . . . . . . . . > *YES          *YES, *NO
 +
 +
  
 
==Changes to system values==
 
==Changes to system values==
Line 113: Line 116:
 
  QAUTOCFG: Set value to 1 (Auto-configuring of devices is on)
 
  QAUTOCFG: Set value to 1 (Auto-configuring of devices is on)
 
  QAUTORMT: Set value to 1 (Allow auto-configure of remote controllers)
 
  QAUTORMT: Set value to 1 (Allow auto-configure of remote controllers)
  QAUTOVRT: Set value to *NOMAX (There will not be a limit on the amount of  
+
  QAUTOVRT: Set value to *NOMAX (There will not be a limit on the amount of virtual devices to be created)
virtual devices to be created)
 
 
 
 
 
  
 
==Changes to Configuration lists==
 
==Changes to Configuration lists==
Line 126: Line 126:
  
 
                         Work with Configuration Lists
 
                         Work with Configuration Lists
                                                            System:  SYSNAME Position to  . . . . .                Starting characters
+
 
+
System:  '''SYSNAME'''  Position to  . . . . .                 
 +
 
  Type options, press Enter.
 
  Type options, press Enter.
 
   1=Create  2=Change  3=Copy  4=Delete  5=Display  6=Print  7=Rename  8=Work with entries
 
   1=Create  2=Change  3=Copy  4=Delete  5=Display  6=Print  7=Rename  8=Work with entries
 
+
 
  Opt  List        Type        Text
 
  Opt  List        Type        Text
 
+
 
   _  QAPPNLCL    *APPNLCL    Local APPN location entries       
 
   _  QAPPNLCL    *APPNLCL    Local APPN location entries       
 
   _  QAPPNRMT    *APPNRMT    Remote APPN location entries'
 
   _  QAPPNRMT    *APPNRMT    Remote APPN location entries'
  
  
                                                                        Bottom Parameters or command
 
===> F3=Exit  F4=Prompt  F5=Refresh  F9=Retrieve  F12=Cancel
 
  
 +
===Local APPN Location Entries===
  
 +
Add the local device name to the QAPPNLCL configuration list.  This will be the name of the APPN device that the remote system will use to connect to on the iSeries.  As an example, we have used SNADEVLCL.
  
Add the local device name to this list.  This will be the name of the APPN device that the remote system will use to connect to on the iSeriesAs an example, we have used SNADEVLCL.
+
                          Change Configuration List                  SYSNAME 
 +
                                                            09/02/05  16:30:49
 +
Configuration list . . :  QAPPNLCL                                         
 +
Configuration list type :  *APPNLCL                                         
 +
Text . . . . . . . . . :  Local APPN location entries                     
 +
                                                                             
 +
Type changes, press Enter.                                                  
 +
                                                                             
 +
-----APPN Local Locations-----          -----APPN Local Locations-----     
 +
Local                                    Local                               
 +
Location  Text                          Location  Text                     
 +
  SNADEVLCL Local SNA entry
  
*APPNRMT (Remote APPN List):
+
 
 +
 
 +
===Remote SNA APPN Entries===
  
 
Add the following information to the remote list:
 
Add the following information to the remote list:
  
Remote location: Type in the name of the remote device you will use to connect to the remote system.
+
* Remote location:       Type in the name of the remote device you will use to connect to the remote system.
Remote network ID: Type in the name of the remote network ID
+
* Remote network ID:     Type in the name of the remote network ID
Local Location: Type in the name of the local device to which the remote network will connect to.
+
* Local Location:       Type in the name of the local device to which the remote network will connect to.
Remote control point: Type in the System name of the remote machine
+
* Remote control point: Type in the System name of the remote machine
Control point net ID: Type in the name of the remote network ID here again.
+
* Control point net ID: Type in the name of the remote network ID here again.
  
  
 +
                          Change Configuration List                  SYSNAME 
 +
                                                            09/02/05  16:32:35
 +
Configuration list  . . :  QAPPNRMT                                         
 +
Configuration list type :  *APPNRMT                                         
 +
Text  . . . . . . . . . :  Remote APPN location entries'                   
 +
                                                                             
 +
Type changes, press Enter.                                                   
 +
                                                                             
 +
----------------------------APPN Remote Locations-----------------------------
 +
          Remote              Remote    Control                             
 +
Remote    Network  Local    Control  Point    Location          Secure   
 +
Location  ID        Location  Point    Net ID    Password          Loc     
 +
RMTSYSN  ZANET001  SYSNAME  RMTSYSN  ZARMTN001                  *NO
  
 
==Opening of firewall ports==
 
==Opening of firewall ports==
Line 194: Line 221:
  
 
To print the info from the trace, TRCCNN SET(*OFF) TRCTBL(MyTraceCNN)
 
To print the info from the trace, TRCCNN SET(*OFF) TRCTBL(MyTraceCNN)
 +
 +
 +
 +
===Transmission groups===
 +
 +
Ensure that the transmission group is configured correctly on both systems.  If the communication still does not work, change the transmission group on both sides to another number.
 +
 +
== External links ==
 +
 +
* [[Wikipedia:IBM Advanced Peer-to-Peer Networking]]
 +
* [[Wikipedia:IBM Systems Network Architecture]]
 +
 +
 +
  
 
[[Category:Configuration]]
 
[[Category:Configuration]]

Latest revision as of 15:09, 5 February 2009

Background

Enterprise Extender is used to encapsulate SNA traffic over an IP link. This negates the use of special SNA routers and controllers. It is only available from V5R4 on the iSeries. By configuring SNA to run over IP, you can also use the SAVRSTOBJ and SAVRSTLIB commands between iSeries systems (if you do not have devices on your system that will be able to allow SNA communications).

Configuring the different aspects

The following changes need to be implemented on the iSeries system, in order to communicate with another system running EE:

  • Network attributes
  • Create the APPC Controller description
  • Create the two APPC devices
  • Change system values
  • Change configuration lists
  • Change ports on the firewalls


Making changes to Network attributes

The following items need to be set in the network attributes, using the CHGNETA command:

APPN node type . . . . . . . . . . . . . . . . . . . . . :   *NETNODE
Allow APPN virtual support . . . . . . . . . . . . . . . :   *NO 
Allow HPR transport tower support  . . . . . . . . . . . :   *YES            

NB: Changing the node type will require you to vary off ALL APPC controllers and devices before changes are made.


Creating the controller description

Use the CRTCTLAPPC command. Press F4, and define the following parameters:

Controller Description:                 Name of the controller 
Link type:                              *HPRIP
APPN-Capable:			        *YES
Remote internet address:		The IP address of the remote system
Local internet address:                 The IP address your (local) system
Remote network identifier:		The SNA network name of the remote system
Remote control point:		        The system name of the remote system
APPN CP Session Support:		*YES
APPN transmission group number:         Specify the TGN Number. Must the same on both 
                                        systems.

Example:

                     Create Ctl Desc (APPC) (CRTCTLAPPC)                    
                                                                            
Type choices, press Enter.                                                   
                                                                            
Controller description . . . . .   SNAHOST       Name                        
Link type  . . . . . . . . . . . > *HPRIP        *ANYNW, *FAX, *FR, *HPRIP...
APPN-capable . . . . . . . . . . > *YES          *YES, *NO                   
Remote internet address  . . . . > ‘196.1.1.2’                          
Local internet address . . . . . > ‘196.1.1.3’                            
Remote network identifier  . . . > APPN  
Remote control point . . . . . . > MAINFRAME     Name, *ANY                   
APPN CP session support  . . . .   *YES          *YES, *NO   
APPN transmission group number     1             1-20, *SAME, *CALC


Creating the devices descriptions

You have to use the CRTDEVAPPC command twice, first to setup the name of the device to connect to on the remote system, and secondly a device with the same name as the remote system. Press F4 and define the following parameters:

Device description:		Name of the device / remote system name
Remote location:	        Name of the device as defined on the other system / remote system name
Local location:                 Name of local device / local system name.  This device does not need to exist locally, but it  
                                must look exactly as it is defined on the remote system pointing to you.
Remote network identifier:	The SNA network name of the remote system
Attached controller:		Name of the controller under which this device will be located
Mode:				Using *NETATR should be sufficient, otherwise define the mode you wish to use.
APPN-Capable:		        *YES


Example – Remote device name

                   Create Device Desc (APPC) (CRTDEVAPPC)                     
                                                                              
Type choices, press Enter.                                                     
                                                                              
Device description . . . . . . .   SNADEVRMT     Name                          
Remote location  . . . . . . . . > SNADEVRMT     Name                          
Online at IPL  . . . . . . . . . > *YES          *YES, *NO                     
Local location . . . . . . . . . > SNADEVLCL     Name, *NETATR                 
Remote network identifier  . . . > APPN          Name, *NETATR, *NONE          
Attached controller  . . . . . . > SNAHOST       Name                          
Mode . . . . . . . . . . . . . . > *NETATR       Name, *NETATR                 
APPN-capable . . . . . . . . . . > *YES          *YES, *NO                     


Example – Remote system name

                   Create Device Desc (APPC) (CRTDEVAPPC)                     
                                                                              
Type choices, press Enter.                                                     
                                                                              
Device description . . . . . . .   MAINFRAME     Name                          
Remote location  . . . . . . . . > MAINFRAME     Name                          
Online at IPL  . . . . . . . . . > *YES          *YES, *NO                     
Local location . . . . . . . . . > AS400NAME     Name, *NETATR                 
Remote network identifier  . . . > APPN          Name, *NETATR, *NONE          
Attached controller  . . . . . . > SNAHOST       Name                          
Mode . . . . . . . . . . . . . . > *NETATR       Name, *NETATR                 
APPN-capable . . . . . . . . . . > *YES          *YES, *NO


Changes to system values

Enterprise Extender will create and use a controller QAPEND0001 on the iSeries when it communicates with remote EE systems. It will also create APPC devices under this controller when the communication is established the first time. In order for the system to automatically create the necessary controller and devices the first time, the following system values need to be changed (These values can be set back to their original settings as soon as Enterprise Extender is up and running):

QAUTOCFG: 	Set value to 1 (Auto-configuring of devices is on)
QAUTORMT:	Set value to 1 (Allow auto-configure of remote controllers)
QAUTOVRT:	Set value to *NOMAX (There will not be a limit on the amount of virtual devices to be created)

Changes to Configuration lists

In order for the SNA component to work, the following changes need to be implemented on the SNA configuration lists. Use command WRKCFGL. If the *APPNLCL or *APPNRMT list do not exist, create them first.

WRKCFGL (ENTER)


                       Work with Configuration Lists

System:   SYSNAME   Position to  . . . . .                

Type options, press Enter.
  1=Create   2=Change   3=Copy   4=Delete   5=Display   6=Print   7=Rename   8=Work with entries

Opt  List        Type        Text

 _   QAPPNLCL    *APPNLCL    Local APPN location entries      
 _   QAPPNRMT    *APPNRMT    Remote APPN location entries'


Local APPN Location Entries

Add the local device name to the QAPPNLCL configuration list. This will be the name of the APPN device that the remote system will use to connect to on the iSeries. As an example, we have used SNADEVLCL.

                          Change Configuration List                   SYSNAME  
                                                            09/02/05  16:30:49
Configuration list  . . :   QAPPNLCL                                          
Configuration list type :   *APPNLCL                                          
Text  . . . . . . . . . :   Local APPN location entries                       
                                                                              
Type changes, press Enter.                                                    
                                                                              
-----APPN Local Locations-----           -----APPN Local Locations-----       
Local                                    Local                                
Location  Text                           Location  Text                       
SNADEVLCL Local SNA entry


Remote SNA APPN Entries

Add the following information to the remote list:

  • Remote location: Type in the name of the remote device you will use to connect to the remote system.
  • Remote network ID: Type in the name of the remote network ID
  • Local Location: Type in the name of the local device to which the remote network will connect to.
  • Remote control point: Type in the System name of the remote machine
  • Control point net ID: Type in the name of the remote network ID here again.


                          Change Configuration List                   SYSNAME  
                                                            09/02/05  16:32:35
Configuration list  . . :   QAPPNRMT                                          
Configuration list type :   *APPNRMT                                          
Text  . . . . . . . . . :   Remote APPN location entries'                     
                                                                              
Type changes, press Enter.                                                    
                                                                              
----------------------------APPN Remote Locations-----------------------------
          Remote              Remote    Control                               
Remote    Network   Local     Control   Point     Location          Secure    
Location  ID        Location  Point     Net ID    Password          Loc       
RMTSYSN   ZANET001  SYSNAME   RMTSYSN   ZARMTN001                   *NO

Opening of firewall ports

Enterprise Extender utilizes UDP ports 12000 to 12004. These ports have to be opened on all firewalls between the two systems to function.


Troubleshooting

Control-point-to-Control-point (CPCP) Sessions

If the setup has been completed, and the controllers show active on both sides, you can check to see if the sessions (CPCP) are up and running as well. Do the following:

  • WRKCFGSTS *CTL QAP* (press enter)
  • Take option 9 (display mode status) next to the device created for the remote system

You should see 2 modes listed. Press F11 to view the current sessions:

Example

          Mode              --Sessions-- 
Mode      Status            Total  Local 
SNASVCMG  Started              0      0  
CPSVCMG   Started              2      1  


Use DSPAPPINF

You can also use DSPAPPNINF command to see if the system is able to communicate with the remote server. It should show whether the link is active, and if routing is valid.


Performing a communications trace

You can run a TCP/IP communications trace to see if your system is utilizing the correct ports to the remote system.

TRCCNN SET(*ON) TRCTYPE(*IP) TRCTBL(MyTraceCNN) SIZE(1000 *MB) TCPDTA(*UTP () () *N '169.202.xxx.xxx')  

To print the info from the trace, TRCCNN SET(*OFF) TRCTBL(MyTraceCNN)


Transmission groups

Ensure that the transmission group is configured correctly on both systems. If the communication still does not work, change the transmission group on both sides to another number.

External links