IBM i OS agent enterprise edition upgrade

IBM i OS agent main page.

Upgrade LPAR2RRD IBM i agent

  • Download the latest OS agent for IBM i (R6.1.0+) from the link provided by LPAR2RRD support
    After unzipping you get LPAR2RRD_F.savf in save file format.
    All below under LPAR2RRD user.

  • Stop IBM i OS agent:
    ADDLIBLE LPAR2RRD
    LPAR2RRD/END_SYSSTS
    GO MENU --> 50
      Subsystem LPAR2RRD is not active
    
  • Set LPAR2RRD password from *NONE to <password> and change user profile to JOBD job description.
    CHGUSRPRF USRPRF(LPAR2RRD) PASSWORD(<password>)
    CHGUSRPRF USRPRF(LPAR2RRD) JOBD(QGPL/QDFTJOBD)   
    
  • Clear install library and all object in library
    CLRSAVF FILE(QGPL/LPAR2RRD) 
    CLRLIB LIB(LPAR2RRD)
    
  • Transfer LPAR2RRD_F.savf to IBM i system from your PC via ftp in binary mode.
    ftp <as400.server.com>
      Connected to as400.
      220-QTCP at 192.168.177.50.
      220 Connection will close if idle more than 5 minutes.
      Name (as400.server.com:lpar2rrd): lpar2rrd
      431 Requested security mechanism not available at this time.
      331 Enter password.
      Password:
      230 LPAR2RRD logged on.
      Remote system type is .
    ftp> bin
    ftp> cd qgpl
    ftp> put LPAR2RRD_F.savf LPAR2RRD
      local: LPAR2RRD_F.savf remote: LPAR2RRD
      200 PORT subcommand request successful.
      150 Sending file to member LPAR2RRD in file LPAR2RRD in library QGPL.
      226 File transfer completed successfully.
      3590400 bytes sent in 0.41 secs (9007.2 kB/s)
    
    Do not forget to logoff from ftp session to do not lock it out.

  • Display library
    DSPSAVF FILE(QGPL/LPAR2RRD_F) OUTPUT(*) 
         LPAR2RRD    *LIB      PROD        LPAR2RRD            152  YES 
         ACCEPTFREE  *PGM      CLE         LPAR2RRD            176  YES 
         ...
    
  • Restore Library
    RSTLIB SAVLIB(LPAR2RRD) DEV(*SAVF) SAVF(QGPL/LPAR2RRD_F)  
         MBROPT(*ALL) ALWOBJDIF(*ALL)
     34 object restored from LPAR2RRD to LPAR2RRD.
    
    CHGJOBD JOBD(LPAR2RRD/LPAR2RRD) JOBQ(LPAR2RRD/LPAR2RRD)
         TEXT('RTV_SYSSTS') USER(LPAR2RRD) RQSDTA(*NONE) INLLIBL(LPAR2RRD QGPL QTEMP)
    
    After this command see LPAR2RRD *JOBD object in restored LPAR2RRD library.

  • In the "initial user part of the library list" specify LPAR2RRD library. Parameter INLLIBL in *JOBD object.
    See LPAR2RRD *JOBD object into restored LPAR2RRD library.
    CHGUSRPRF USRPRF(LPAR2RRD) JOBD(LPAR2RRD/LPAR2RRD)   
    
  • Configuration
    Change Monitor Server Name or IP addr (IPADR) to your running LPAR2RRD server
    This step must be done again as it has been cleared out. Use same name(IP) as before.
    For example if hostname is LPAR2RRD-SERVER.SERVER.COM.
    Network connectivity verification via ping at first:
    PING RMTSYS('LPAR2RRD-SERVER.SERVER.COM') 
      Verifying connection to host system LPAR2RRD-SERVER.SERVER.COM at address 192.168.1.2.
      Connection verification statistics: 5 of 5 successful (100 %). 
    CHGCMDDFT CMD(LPAR2RRD/RTV_SYSSTS) NEWDFT('IPADR(LPAR2RRD-SERVER.SERVER.COM)')
    
    Using IP address instead of hostname example:
    CHGCMDDFT CMD(LPAR2RRD/RTV_SYSSTS) NEWDFT('IPADR(''192.168.1.2'')')
    
  • Recommendation: Change User profile LPAR2RRD PASSWORD to *NONE to forbid remote LPAR2RRD user access.
    CHGUSRPRF USRPRF(LPAR2RRD) PASSWORD(*NONE)
    
  • Accept license agreement
    Licensing details. You need to do it once, expiration will be set to 2099.
    ADDLIBLE LPAR2RRD 
    GO MENU 
      Select: 14 Accept Software Licensing Agreement ➞ page down ➞ F14 Accept
      OK:CL_ACCEPT Expiration date of this client is 2099-01-01
    
    In the case that the start LPAR2RRD agent is executed without acceptance, then an error message appears.
    ER: RTV_SYSSTS: frp.HASH512not not correct.
    ER: RTV_SYSSTS: Please revalidate i5/OS client from MENU option F14.
    ER: RTV_SYSSTS: i5/OS client ended.
    
    You can see expiration dates of all agents in the LPAR2RRD UI ➞ menu ➞ LPAR2RRD ➞ Data check ➞ IBM i

  • Start of the agent
    AS400 screenshot go menu

    You can start LPAR2RRD agent in two ways.
    • As a command RTV_SYSSTS.
      CHGJOBD JOBD(LPAR2RRD/LPAR2RRD) TEXT('RTV_SYSSTS') RQSDTA(*NONE) 
      RMVAJE SBSD(LPAT2RRD/LPAR2RRD) JOB(LPAR2RRD)
      ADDLIBLE LPAR2RRD
      GO MENU         
        Option 1. Set up parameters to start client as RTV_SYSSTS (opt.10)
          Accept all default parameters for command CHGJOBD and RMVAJE.
        Option 10. RTV_SYSSTS 
      
    • As an autostart job entry in LPAR2RRD subsystem.
      CHGJOBD JOBD(LPAR2RRD) TEXT('STRSBS SBSD(LPAR2RRD/LPAR2RRD)') RQSDTA('RTV_SYSSTS')  
      ADDAJE  SBSD(LPAR2RRD/LPAR2RRD) JOB(LPAR2RRD) JOBD(LPAR2RRD/LPAR2RRD)
      ADDLIBLE LPAR2RRD 
      GO MENU         
        Option 2. Set up parameters to start client as STRSBS LPAR2RRD (option 11)
          Accept all default parameters for command CHGJOBD and ADDAJE.
        Option 11. STRSBS LPAR2RRD
      
    You can start LPAR2RRD agent from command line or from your CL program as a command RTV_SYSSTS or STRSBS LPAR2RRD.
    Option 1 and Option 2 is used only once or when you decide to change the way the program starts.
    Use F1 as a help for RTV_SYSSTS command.

  • Status of the agent.
    GO MENU  
      Select: Option 50 
    
    AS400 screenshot 1

    On the SND_SYSSTS line ➞ type 5 ➞ type 10 ➞ F10 and you have to see:
    AS400 screenshot 2


    You have to see this message after 20 - 30 minutes from the agent start:
    It says that connection to LPAR2RRD server has been established and some data has been already sent out.
    IF: C_SNDSTS  - connection Established() 
    
  • Communication problem AS400 screenshot 1
    If you see this message into joblog SND_SYSSTS then there is a communication problem.
    • Address or port is wrong.
    • IP connection between LPAR2RRD monitor server and AS400 not correct.

  • LPAR2RRD server UI
    You should see new data in graphs 20 - 30 minutes after the agent starts.
    Go to the UI, follow the server and LPAR. (Ctrl-F5 is necessary to refresh the UI)

  • Start/Stop LPAR2RRD agent
    ADDLIBLE LPAR2RRD
    GO MENU
      start: 10. RTV_SYSSTS  ➞ Enter ➞ Enter									                
      stop:  13. END_SYSSTS  ➞ Enter ➞ Enter
    
  • Troubleshooting