Automated Testing

Automated Testing

Automated Testing

Build an automated testing process to enable continuous integration of your hybrid cloud applications including z/OS

 View Only
Expand all | Collapse all

ZD&T new install question

Discussion Topic

Discussion TopicTue November 28, 2017 11:54 AM

  • 1.  ZD&T new install question

    Posted Fri November 03, 2017 04:06 AM

    Hello

    We just received the license to ZD&T PE and downloaded following files:

    RIT_CONTROL_PANEL_9.1.zip

    Z_SYSTEMS_DEVELOPMENT_AND_TEST_EN.x86_64"

    RLKS_8.1.5_FOR_LINUX_X86_ML.zip

    RLKS_ADM_AND_REPTOOL8.1.5PART1.zip

    RLKS_ADM_AND_REPTOOL8.1.5PART2.zip

    RLKS_ADM_AND_REPTOOL8.1.5SETUP.zip

     

    Can someone provide a link to the installation guide so we can figure out how to proceed with the installation on an Ubuntu machine ?

    Should we first extract the ZIP files ?

     

    Thanks...Dani Kalmar

     

    danik1956


  • 2.  Re: ZD&T new install question



  • 3.  Re: ZD&T new install question

    Posted Sat November 04, 2017 02:45 AM

    Thanks for the info.

    In the TCP/IP configuration scenarios on page 130 of the IBM zPDT Reference and Guide, which scenario would be appropriate if I want Z/OS to use a dedicated LAN adapter different than the one used by the Linux

    host system ?

    danik1956


  • 4.  Re: ZD&T new install question

    Posted Wed November 08, 2017 08:33 AM

    Scenario 4.

    It requires a fixed and dedicated IP address to z/OS.

    In the  TCPPARMS profile, you will need to make definitions seemed to the following:

    ;                                                               
    DEVICE PORTA  MPCIPA                                            
    LINK TAP0  IPAQENET PORTA                                       
    HOME 10.1.1.2 TAP0                                              
    ;                                                               
    ; This second device is optional                                
    ;                                                               
    DEVICE PORTB    MPCIPA                                          
    LINK ENO1 IPAQENET  PORTB                                       
    HOME 9.26.158.211   ENO1                                        
    ;                                                               
    BEGINRoutes                                                     
    ;     Destination   SubnetMask    FirstHop       LinkName  Size
    ROUTE 10.0.0.0    255.0.0.0           =        TAP0 MTU 1492    
    ROUTE 9.26.158.0  255.255.254.0       =        ENO1 MTU 1492    
    ROUTE DEFAULT                     9.26.158.1   ENO1 MTU 1492    
    ENDRoutes                                                      

    AdilsonColombo


  • 5.  Re: ZD&T new install question

    Posted Sat November 25, 2017 01:44 AM

    The doc states for Scenario 4:

     

    This scenario provides a direct connection from z/OS to the external LAN. A NAT function is
    not used. Only a single physical LAN adapter is needed and is used by both Linux and z/OS.

     

    So how this apply to a setup with 2 Lan adapters ?

    Can z/os connect to the external LAN without going via the tunnel ? I can configure the router to open any unique port that z/os listens on.

    danik1956


  • 6.  Re: ZD&T new install question

    Posted Mon November 27, 2017 01:26 AM

    In the above example, the IP address defined to device PORTB (9.26.158.211)  is this the IP address assigned to the dedicated ethernet adapter ?

    In the above example what is does IP address 9.26.158.1 represent ?

    danik1956


  • 7.  Re: ZD&T new install question

    Posted Mon November 27, 2017 12:35 PM

    First, It works with 2 lan adapters.

    It requires the tunnel to connect to external LAN. Using scenario 44, for your network configuration you can make any definition/restriction as if the z/OS IP address was a real z machine.

    Second, no, the IP address 9.26.158.211 is able to share the ethernet adapter using the tunnel definitions. It will find the way out using this definition:

    ROUTE 10.0.0.0    255.0.0.0           =        TAP0 MTU 1492  

    AdilsonColombo


  • 8.  Re: ZD&T new install question

    Posted Thu November 09, 2017 02:33 PM

    Thanks so much. I will review and try to setup this scenario.

    At the moment I can't continue the install as we didn't receive the USB hardware key.

    PAO does not allow OEM users to order the Hardware Media online.

    Following message is displayed:

     

    "The ability to request media for OEM entitled software is not available at this time. We are currently working to provide media ordering for the OEM program offering in the future. IBM OEM Software is only available electronically, through this site. Please note: You will still continue to receive your OEM software media shipments in the same manner you have in the past.           "

     

    Can anyone suggest how an OEM client is supposed to obtain this hardware USB device ?

    danik1956


  • 9.  Re: ZD&T new install question

    Posted Fri November 10, 2017 10:02 AM

    if you are planning to use Hardware Based License, you need to order Hardware device (USB) separately. What zD&T version and what kind of license you are using? To order the USB, please contact IBM Sales, they should be able to help you or open the PMR, they should be able to help you

    Neeraj Kumar


  • 10.  Re: ZD&T new install question

    Posted Fri November 10, 2017 10:27 AM

    When we placed the order originally with IBM sales the USB hardware device part number was included in the order.

    When the contract for the order was approved and signed we received the POE for the product and the link for downloading the software.

    We did not receive the USB hardware device, and contacting IBM eCare support did not resolve the issue.

    No one seems to know the procedure for providing us with the USB hardware device which we already ordered.

    danik1956


  • 11.  Re: ZD&T new install question

    Posted Fri November 10, 2017 12:56 PM

    We are working on your issue and will contact you soon.
     

    AdilsonColombo


  • 12.  Re: ZD&T new install question

    Posted Mon November 20, 2017 01:47 AM

    It is Nov 20 and still no sign of the USB key.

    It seems IBM can't handle a simple issue of providing a client with a USB device that is essential for running the product.

    We contacted local sales and opened a PMR but still nothing.

    This is amazing. 

    danik1956


  • 13.  Re: ZD&T new install question

    Posted Mon November 20, 2017 02:39 PM

    Our support team is investigating why it's happening particularly to your POE.

    AdilsonColombo


  • 14.  Re: ZD&T new install question

    Posted Tue November 21, 2017 12:20 AM

    So 11 days into the investigation, no conclusions and no solution ?

    danik1956


  • 15.  Re: ZD&T new install question

    Posted Wed November 22, 2017 11:16 AM

    You must be getting your license today. it's now with the courier company.
     

    AdilsonColombo


  • 16.  Re: ZD&T new install question

    Posted Tue November 28, 2017 11:54 AM

    Additional info on the current setup:

     

    1. DEVMAP OSA definitions:

    [manager]  # tap0 define network adapter (OSA) for communication with Linux
    name awsosa 0009 --path=A0 --pathtype=OSD --tunnel_intf=y   # QDIO mode
    device 400 osa osa --unitadd=0
    device 401 osa osa --unitadd=1
    device 402 osa osa --unitadd=2

    [manager]  # eth2 define network adapter (OSA) for communication with external networks  
    name awsosa 1234 --path=F1 --pathtype=OSD --interface=enp5s0
    device 404 osa osa
    device 405 osa osa
    device 406 osa osa

     

    2. TCPIP profile definitions:

    ;                                                                
    ;This device defines the tunnel to Linux host                    
    ;                                                                
    DEVICE PORTA  MPCIPA                                             
    LINK ETH1  IPAQENET PORTA                                        
    HOME 10.1.1.2 ETH1                                               
    ;                                                                
    ; This second device is a dedicated Ethernet adapter             
    ;                                                                
    DEVICE PORTB    MPCIPA                                           
    LINK ETH2 IPAQENET  PORTB                                        
    HOME 192.168.1.249  ETH2                                         
    ;                                                                
    BEGINRoutes                                                      
    ;     Destination   SubnetMask    FirstHop       LinkName  Size  
    ROUTE 192.168.0.0 255.255.255.0       =        ETH2 MTU 1492     
    ROUTE 10.0.0.0    255.0.0.0           =        ETH1 MTU 1492     
    ROUTE DEFAULT                    192.168.1.254 ETH2 MTU 1492     
    ENDRoutes                                                        
    ;                                                                    
    START PORTA                                                      
    START PORTB    

     

    I am trying to connect into z/OS from a remote system outside the local network and unable to do so.

    I have FTP server in z/OS configured to listen on port 1021.

    The z/OS HOME IP address is 192.168.1.249

    From any machine inside my network I can FTP to 192.168.1.249:1021

    In my router I defined a rule to port forward 1021 to 192.168.1.49 which is the LAN adapter defined to zPDT as an OSA device (real LAN adapter)

    From z/OS I can FTP to external servers outside my network.

    I can't FTP from outside my network into z/OS. It fails with "connection refused".

    The Linux UFW log does not show any input request blocking. Same error happens if the UFW firewall is disabled.       

    I suspect the FTP request is not forwarded correctly from the LAN adapter to the z/OS internal IP address when the request arrives from the outside.

    Maybe it is sent to the Linux host where port 1021 is not opened.

    How can port forwarding be configured in Linux to allow input request for port 1021 forwarded to the z/OS internal IP address (192.168.1.249)                                            

    danik1956


  • 17.  Re: ZD&T new install question

    Posted Wed November 29, 2017 08:58 AM

    We don't support network configuration, but must agree to your suspect.

    Anyway, did you check if the devices 0404,0405,0406 are allocated by VTAM? You may have something incorrect on the relationship of OSATRLx and ATCCON00.

    From the z/OS side, those address must be showed as allocated when you issue the console command "D U,,,0404,3".

    Pls, copy here the ATCCON00, OSATRL2 and the answer for this console command above.

     

    AdilsonColombo


  • 18.  Re: ZD&T new install question

    Posted Wed November 29, 2017 10:51 AM

    The OSA devices are allocated:

    IEE457I 17.45.03 UNIT STATU
    UNIT TYPE STATUS        VOL
    0403 OSA  OFFLINE          
    0404 OSA  A-BSY            
    0405 OSA  A                
    0406 OSA  A-BSY 

     

    As I have mentioned earlier, I can FTP from another PC on my network using the actual z/OS IP address:

    FTP 192.168.1.249 1021

    so obviously the OSA device is active and operational.

     

    There is a routing issue when the request is coming from a remote client outside my network:

    FTP mydomain:1021   <== This fails with connection refused

     

    I suspect Linux does not know what do do with packets arriving into the LAN adapter at IP 192.168.1.49 designated to port 1021

    Those packets are not forwarded to 192.168.1.249

            

     

    danik1956


  • 19.  Re: ZD&T new install question

    Posted Wed November 29, 2017 11:40 AM

    danik1956,

    If you are using LAN scenario four as you state above, the linux network and the z/OS network are essentially two different networks, sharing one physical network adapter on your machine.  While you could set them up to use different physical adapters by using the find_io command and assigning them accordingly, (as you have done,) in most situations, that is not needed since the network traffic will not likely exceed the capacity of most modern adapters. 

     

    Both the linux and the z/OS networks are exposed on your LAN.  The linux network uses whatever IP address was assigned by your linux admin; either DHCP or by static IP.  The z/OS network uses the IP address specified in your TCPIP.PROFILE dataset, 192.168.1.249 above.  zPDT introduces a separate, dedicated network connection to allow communication from the host linux to the hosted z/OS on the same machine.  This is the so called "tunnel" or TAP connection, your 10. address assigned above.  The tunnel network is only used to allow host linux to talk to hosted OS on the same machine.

     

    Some simple guidelines to live by when using TCP/IP on z/OS:

    - if you can communicate inbound to z/OS, your HOST address is good. 

    - If you can communicate outbound from z/OS, your ROUTE statements are correct.

    - If you have an application, (like FTP or RSED, or DRDA,) which does both, and your setup is not complete/ correct, you will likely see strange results.

     

    Debug hints:

    - If you are having problems, first step is to run the TSO HOMETEST command.  This command will verify the HOSTNAME, DOMAINORIGIN, SEARCH, and NSINTERADDR TCPIP.DATA statements. HOMETEST will use the z/OS resolver to obtain the IP addresses assigned to the HOSTNAME and compare them to the HOME list specified in PROFILE.TCPIP. A warning message will be issued if any HOSTNAME IP addresses are missing from the HOME list.  For details on the HOMETEST command, see IP System Administrator's Commands - SC27-3661.

    - To verify valid ROUTE statements, the TSO TRACERTE command is useful for debugging various network problems. The TRACERTE command sends UDP requests with varying TTL (time-to-live) or hop count values and then waits for the routers between the local and remote hosts to send TTL-exceeded messages.  If you hit an unknown or unverifiable host while traversing the routes, TRACERTE will issued an error message.  Note there are many options for the TRACERTE command. Refer to IP System Administrator's Commands - SC27-3661 for details.

     

    The above commands will not necessarily tell you exactly where the problems lie, however, they will offer some clues.

     

    After reviewing your configuration above, I see one definite error and two things I would suggest you change.

    - In your PROFILE.TCPIP, your ROUTE statement for the 192 network is incorrect.  It should be:  ROUTE 192.168.1.0 255.255.255.0       =        ETH2 MTU 1492 

    -Again, in your PROFILE.TCPIP, your ROUTE statement for the 10. network, while technically correct, should probably be changed to avoid potential network conflicts.  I recommend changing this:

    ROUTE 10.0.0.0    255.0.0.0           =        ETH1 MTU 1492 to this:  ROUTE 10.1.1.0    255.255.255.0           =        ETH1 MTU 1492

    I have seen the above cause multiple conflicts. 

    - In your PROFILE.TCPIP you have ip address 192.168.1.254 assigned to your router.  In general, host addresses in the 240-254 range are considered "experimental" and should not be used.  192.168.1.1 is a much better, and more standard choice.

     

    RDzJohn (soon to be retired John)

     

    RDzJohn


  • 20.  Re: ZD&T new install question

    Posted Thu November 30, 2017 01:55 AM

    Thanks John for your comments.

     

    I already changed the ROUTE statements as suggested but it did not help.

    I can communicate from zOS to external servers, but not inbound from the outside (meaning outside my network)

    I can communicate into z/OS via the 192 subnet from other machines on my network and also from Linux via the 10.x subnet.

     

    My router IP has been set to this address for years and never had any issues.

     

    I suspect there must be an inbound routing issue where Linux does not forward packets from the outside to z/os on the 192 subnet.

    danik1956


  • 21.  Re: ZD&T new install question

    Posted Thu November 30, 2017 08:53 AM

    For this scenario 4, with a fixed IP to z/OS, in general we don't use subnet 192. or 127.*.


     

    AdilsonColombo


  • 22.  Re: ZD&T new install question

    Posted Thu November 30, 2017 09:00 AM

    danik1956,

    When using network scenario 4 as you are, the z/OS network appears on the same subnet that your linux does.  No packets bound for z/OS flow through linux, so its not likely that linux is the problem.  Just to make sure, try turning the iptables service off.  If you've previously issued any iptables commands you may have a route active that you aren't aware of.  You also might have a site specific policy active that is blocking packets from outside your network.  This isn't common in my experience, but its good to eliminate the possibility.  If all else fails, you'll need to put a packet sniffer on the network so you can see where the packets are being dropped.

     

    RDzJohn (soon to be retired John)

    RDzJohn


  • 23.  Re: ZD&T new install question

    Posted Fri December 01, 2017 12:38 AM

    There are no IPTABLES rules involving 192.168.1.249 or 192.168.1.49. I have verified that.

    Further more, if I add NAT rules to PREROUTE tcp ports 1020-1021 to z/OS IP 192.168.1.249, the FTP request from the out side no longer fails with "connection refused" but rather it times out.

    So it seems to me that Linux does see the packets coming in via the LAN adapter and IPTABLES does perform the NAT function when I define it.

    Is there a way in z/os to turn on some trace to see if indeed the FTP request is seen or not ?

    danik1956


  • 24.  Re: ZD&T new install question

    Posted Fri December 01, 2017 07:52 AM

    danik1956,

    I don't recall if z/OS FTP has a trace function.  Certainly, z/OS TCP/IP has tracing that you could try.  You might also try an external sniffer such as Wireshark to trace where the packets are being dropped.

     

    RDzJohn (soon to be retired John)

    RDzJohn