i2Rest installation instructions

From i2Rest
Jump to: navigation, search

i2Rest package (Server and Client) can be installed on IBM i V7R1M0 and higher. Installation on V6R1M0 is updated from time to time, and does not always contain the latest code changes. Installation on lower OS versions is available by request at contacts@i2rest.com

  1. Check IBM ASCII Runtime is installed and properly configured. In emulator session:
    1. CALL PGM(QSYS/QADRTCINF) parm('list')
      Make sure there is an entry for your job CCSID(s) in the list. If needed, create/update conversion tables:
    2. CALL PGM(QSYS/QADRTCINF) parm('update')
      It will create/update conversion pages on your IBM i server
  2. Download file i2Rest_Install.ZIP. Archive versions can be found here.
  3. Put it to your home directory or to any other folder on IFS
  4. Open emulator session and run following commands:
    1. CHGCURDIR <directory_where_ZIP_copied>
      you'll see message "Current directory changed."
    2. QSH CMD('jar xMvf i2Rest_Install.ZIP')
      It will extract SAVF from zipped file, you'll see message "inflated: I2REST.SAVF"
    3. CRTSAVF FILE(QTEMP/I2REST)
      File I2REST created in library QTEMP.
    4. CPYFRMSTMF FROMSTMF(i2rest.savf) TOMBR('/qsys.lib/qtemp.lib/i2rest.file') MBROPT(*REPLACE)
      "Stream file copied to object."
    5. RSTLICPGM LICPGM(0AI2R07) DEV(*SAVF) SAVF(QTEMP/I2REST)
      *PGM objects for product 0AI2R07 option *BASE release *FIRST restored.
  5. Verify i2Rest installed:
    1. WRKLICINF PRDID(0AI2R07)
      i2Rest IBM i Services should be displayed
    2. WRKOBJPDM I2REST
      You'll see objects in I2REST product library

Install completed, you can define basic implementation settings and try to call IBM i based APIs