Upgrading RPG-XML Suite 3.0x

The upgrade process for RPG-XML Suite is dependent on how many libraries contain RPG-XML Suite objects. You can determine if RPG-XML Suite is installed in multiple libraries with this command:

WRKOBJ OBJ(*ALL/RXS*) OBJTYPE(*SRVPGM)

If the WRKOBJ command lists only library RXS, you should use the upgrade instructions for Single Library Installation below.

If the WRKOBJ command lists libraries other than RXS, please use the upgrade instructions for Multiple Library Installation below.

Single Library Installation

Note:

  • @@ is the version number of the source/current version level (example: 22)
  • ### is the version number of the target/new version level (example: 310)
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 upgrade file to C:\temp (or the directory of your choice).
  2. Issue the IBM i command:
    CRTSAVF FILE(QGPL/RXS###) AUT(*ALL)
  3. FTP the file rxs.savf from your PC to the IBM i in BINARY mode into the save file just created.
    1. Open a DOS prompt (Start Run enter 'cmd' and hit enter)
    2. Type the following into the DOS prompt, replacing the IP address with that of your iSeries:
      ftp 172.29.134.41
    3. When prompted enter user profile and password
      1. binary
      2. lcd c:\temp (where c:\temp is the location of the rxs.savf on your local computer)
      3. quote site namefmt 0
      4. cd QGPL
      5. put rxs.savf rxs###.savf
      6. quit
  4. End all RPG-XML Suite Apache instances. Note that this will mean your web services are NOT accessible! Execute the following IBM i command:
    ENDTCPSVR SERVER(*HTTP) HTTPSVR(RXS)
    Note: Be sure to execute this command for any custom instances that also use RPG-XML Suite.
  5. Perform a full backup of library RXS.
  6. Execute the following IBM i command to upgrade the library RXS (this is all one command):
    RSTOBJ OBJ(*ALL) SAVLIB(RXS) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) OMITOBJ((RXSUNQ) (RXSCFG) (LICP) (RXSRTRCTL) (RXSRTRLOG)) RSTLIB(RXS) DEV(*SAVF) SAVF(QGPL/RXS###)
    Note: If any of the objects listed in OMITOBJ do NOT already exist in library RXS, then remove them from the OMITOBJ parameter. This is most common if your pre-upgrade version is previous to 2.80.
  7. Execute the following IBM i commands when files RXS/RXSRTRCTL and RXS/RXSRTRLOG do NOT already have a RXSRTR member:
    1. RNMM FILE(RXS/RXSRTRCTL) MBR(RXSRTRCTL) NEWMBR(RXSRTR)
    2. RNMM FILE(RXS/RXSRTRLOG) MBR(RXSRTRLOG) NEWMBR(RXSRTR)
    3. CHGPF FILE(RXS/RXSRTRCTL) MAXMBRS(32)
    4. CHGPF FILE(RXS/RXSRTRLOG) MAXMBRS(32)
  8. Execute the following IBM i commands when your pre-upgrade version was previous to version 2.80 and if you do not have a library named KTLIC on your IBM i:
    1. RMVLIBLE LIB(RXS)
    2. ADDLIBLE LIB(RXS) POSITION(*FIRST)
    3. APYLIC LICKEY(<<insert key that was provided during your upgrade planning>>) PRODUCT(RXS)
    If you have a library named KTLIC on your IBM i, the commands above do not apply. Please contact support for further instructions.
  9. Restart all RPG-XML Suite Apache instances:
    STRTCPSVR SERVER(*HTTP) HTTPSVR(RXS)
    Note: Be sure to execute this command for any custom instances that also use RPG-XML Suite.

Multiple Library Installation

If you haven't yet, run the following command:
WRKOBJ OBJ(*ALL/RXS*) OBJTYPE(*SRVPGM)
Using the libraries output by the WRKOBJ command, please make a list of the libraries which need to be upgraded, but do not include RXS library on the list. There should be an Apache instance for each library and the instance name should be the same as the library. As you continue with these instructions, this list will be referred to as the “Upgrade List”. The library and Apache instance named MYRXS will be referenced in the instructions as you continue, but MYRXS may, or may not, be on your Upgrade List. If MYRXS is not on the Upgrade List, please substitute all libraries which do appear on the list in place of references to MYRXS. If MYRXS is on the Upgrade List, please follow the instructions that reference MYRXS and then also duplicate those instructions for any other libraries/instances on the list in addition to MYRXS.

Note:

  • @@ is the version number of the source/current version level (example: 22)
  • ### is the version number of the target/new version level (example: 310)
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 upgrade file to C:\temp (or the directory of your choice).
  2. Issue the IBM i command:
    CRTSAVF FILE(QGPL/RXS###) AUT(*ALL)
  3. FTP the file rxs.savf from your PC to the IBM i in BINARY mode into the save file just created.
    1. Open a DOS prompt (Start Run enter 'cmd' and hit enter)
    2. Type the following into the DOS prompt, replacing the IP address with that of your iSeries:
      ftp 172.29.134.41
    3. When prompted enter user profile and password
      1. binary
      2. lcd c:\temp (where c:\temp is the location of the rxs.savf on your local computer)
      3. quote site namefmt 0
      4. cd QGPL
      5. put rxs.savf rxs###.savf
      6. quit
  4. End all RPG-XML Suite Apache instances. Note that this will mean your web services are NOT accessible! Execute the following IBM i command to end the Apache instances, while substituting the instance names from the Upgrade List for MYRXS:
    ENDTCPSVR SERVER(*HTTP) HTTPSVR(MYRXS)
    Note: Be sure to execute this command for any custom instances that also use RPG-XML Suite.
  5. Perform full backups of library RXS and all libraries on the Upgrade List.
  6. Execute the following IBM i command to upgrade the library RXS (this is all one command):
    RSTOBJ OBJ(*ALL) SAVLIB(RXS) DEV(*SAVF) SAVF(QGPL/RXS###) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) RSTLIB(RXS) OMITOBJ((RXSUNQ) (RXSCFG) (LICP)(RXSRTRCTL)(RXSRTRLOG))
    Note: If any of the objects listed in OMITOBJ do NOT already exist in library RXS, then remove them from the OMITOBJ parameter. This is most common if your pre-upgrade version is previous to 2.80.
  7. Execute the following IBM i commands when file RXS/RXSRTRCTL does NOT already exist:
    RSTOBJ OBJ(RXSRTRCTL RXSRTRLOG) SAVLIB(RXS) DEV(*SAVF) SAVF(QGPL/RXS###) RSTLIB(RXS)
  8. Execute the following IBM i commands when files RXS/RXSRTRCTL and RXS/RXSRTRLOG do NOT already have a RXSRTR member:
    1. RNMM FILE(RXS/RXSRTRCTL) MBR(RXSRTRCTL) NEWMBR(RXSRTR)
    2. RNMM FILE(RXS/RXSRTRLOG) MBR(RXSRTRLOG) NEWMBR(RXSRTR)
    3. CHGPF FILE(RXS/RXSRTRCTL) MAXMBRS(32)
    4. CHGPF FILE(RXS/RXSRTRLOG) MAXMBRS(32)
  9. Execute the following IBM i commands when your pre-upgrade version was previous to version 2.80 and if you do not have a library named KTLIC on your IBM i:
    1. RMVLIBLE LIB(RXS)
    2. ADDLIBLE LIB(RXS) POSITION(*FIRST)
    3. APYLIC LICKEY(<<insert key that was provided during your upgrade planning>>) PRODUCT(RXS)
    If you have a library named KTLIC on your IBM i, the commands above do not apply. Please contact support for further instructions.
  10. Execute the following IBM i commands to upgrade all the libraries on the Upgrade List, while substituting the names from the Upgrade List for MYRXS:
    1. RSTOBJ OBJ(*ALL) SAVLIB(RXS) DEV(*SAVF) SAVF(QGPL/RXS###) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) RSTLIB(MYRXS) OMITOBJ((RXSUNQ) (RXSCFG) (LICP) (INSTALL) (NEWENV) (HTTP*) (DSPMCH*) (CRTRXS*) (QTXT) (REGRXSBASE) (VER*) (RXSRTR* *FILE) (*ALL *PNLGRP) (RXSURI*) (DSPVER) (RXSMENU*) (INZ*) (WRK*) (CRT*))
    2. CPYF FROMFILE(RXS/LICP) TOFILE(MYRXS/LICP) MBROPT(*REPLACE) CRTFILE(*YES)
  11. Restart all RPG-XML Suite Apache server instances by executing the following command, while substituting the names from the Upgrade List for MYRXS:
    STRTCPSVR SERVER(*HTTP) HTTPSVR(MYRXS)
    Note: Be sure to execute this command for each instance name on the Upgrade List.