Upgrading CyberSource Toolkit for i

Note:

  • ### is the simple version number of the target/new version level (example: 381 for v3.8.1)
For clarity, you may wish to copy these instructions to a text editor and then perform a scan and replace for the above values before beginning the upgrade.

  1. Unzip the downloaded file to C:\temp (or the directory of your choice).
  2. Create the *SAVF to upload to on your IBM i:
    CRTSAVF FILE(QGPL/CTI###) AUT(*ALL)
  3. FTP the file CTI.SAVF from your PC to the IBM i. Open a DOS prompt (Start → Run → enter 'cmd' and hit enter). Type the following into the DOS prompt, replacing the IP address with that of your IBM i. When prompted, enter your IBM i username and password.
    1. ftp 123.456.789.123
    2. binary
    3. lcd c:\temp
    4. quote site namefmt 0
    5. cd QGPL
    6. put CTI.savf CTI###.savf
    7. quit
  4. Perform a full backup of your CTI library.
  5. Execute the following IBM i command to upgrade the CTI library (this is all one command):
    RSTOBJ OBJ(*ALL) SAVLIB(CTI) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) OMITOBJ((LICP) (CTICFGENV) (CTICFGMCH) (CTICFGRPT) (CTIUNQ)) RSTLIB(CTI) DEV(*SAVF) SAVF(QGPL/CTI###)

    After running the RSTOBJ command, use DSPJOBLOG and press F10 to view the results of the RSTOBJ. Make a note of any objects that failed to restore, and either delete or rename the corresponding objects from the CTI library.

    Once you have renamed or deleted any conflicting objects, run the RSTOBJ command again and confirm that there are no further errors.

  6. Execute the following steps to rename your existing CTI configuration files:
    1. Rename your current CTICFGMCH file:
      RNMOBJ OBJ(CTI/CTICFGMCH) OBJTYPE(*FILE) NEWOBJ(OLDCFGMCH)
    2. Rename your current CTICFGENV file:
      RNMOBJ OBJ(CTI/CTICFGENV) OBJTYPE(*FILE) NEWOBJ(OLDCFGENV)
    3. Rename your current CTICFGRPT file:
      RNMOBJ OBJ(CTI/CTICFGRPT) OBJTYPE(*FILE) NEWOBJ(OLDCFGRPT)
  7. Execute the following IBM i command to restore the new version of the CTI configuration files to your CTI library (this is all one command):
    RSTOBJ OBJ(CTICFGMCH CTICFGENV CTICFGRPT) SAVLIB(CTI) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) RSTLIB(CTI) DEV(*SAVF) SAVF(QGPL/CTI###)
  8. Execute the following steps to copy the data from your existing CTI configuration files into the new version of the files:
    1. Copy data from OLDCFGMCH to your new CTICFGMCH file:
      CPYF FROMFILE(CTI/OLDCFGMCH) TOFILE(CTI/CTICFGMCH) MBROPT(*UPDADD) FMTOPT(*MAP *DROP)
    2. Copy data from OLDCFGENV to your new CTICFGENV file:
      CPYF FROMFILE(CTI/OLDCFGENV) TOFILE(CTI/CTICFGENV) MBROPT(*UPDADD) FMTOPT(*MAP *DROP)
    3. Copy data from OLDCFGRPT to your new CTICFGRPT file:
      CPYF FROMFILE(CTI/OLDCFGRPT) TOFILE(CTI/CTICFGRPT) MBROPT(*UPDADD) FMTOPT(*MAP *DROP)
  9. Execute the following IBM i command to restore updates to necessary files in the IFS (this is all one command):
    RST DEV('/QSYS.LIB/CTI.LIB/IFS.FILE') OBJ(('/ktprod/cti' *INCLUDE '/ktprod/cti')) CRTPRNDIR(*YES) PRNDIROWN(QSYS) ALWOBJDIF(*ALL)
  10. Once you have validated the upgrade and confirmed that you are not experiencing any issues, you should remove the old versions of the CTI configuration files:
    1. Delete the old CTICFGMCH which was renamed to OLDCFGMCH:
      DLTF FILE(CTI/OLDCFGMCH)
    2. Delete the old CTICFGENV which was renamed to OLDCFGENV:
      DLTF FILE(CTI/OLDCFGENV)
    3. Delete the old CTICFGRPT which was renamed to OLDCFGRPT:
      DLTF FILE(CTI/OLDCFGRPT)