Setup and Configuration › Install Web Option › Upgrade Web Option older than r8.5

Upgrade Web Option older than r8.5

If you are running a version of Web Option that is older than r8.5, follow these steps.

To upgrade a Web Option installation older than r8.5

1. Save your existing copy of the /WEBOPT directory in the IFS; WEBOPT81, for example.
2. Restore the new copy of /WEBOPT from the WEBOPT save file in Y2WEB and then copy any user-defined objects from WEBOPT81 into WEBOPT:

   RNM OBJ('/webopt') NEWOBJ('webopt81')
   RST DEV('/qsys.lib/y2web.lib/webopt.file') OBJ(('/webopt'))
   MOV OBJ('/webopt81/<object-name>') TODIR('/webopt') (repeat as required)
   

   Ensure that you do not accidentally overwrite the YSCRIPT.JS file, or any other files required by the Web Option runtime.

3. Use the Initialize Web Option (YINZW2E) command to upgrade your version of Web Option and create an initial Web Option environment library.
4. Specify the name of your existing Web Option product library (which you just renamed) for the current Web Option library (CURW2ELIB) parameter:

   YINZW2E CURW2ELIB(Y2WEBSAV) W2ELIB(Y2WEB)
   

5. Specify *COPY for the Data option (DTAOPT) parameter when you are prompted to create an environment library (the Create Web Option environment (YCRTW2EENV) command is automatically prompted and run as part of the upgrade process):

   YCRTW2EENV W2EENV(MYWEBENV) W2ELIB(Y2WEB) LDOLIB(Y2WEBVENG) DTAOPT(*COPY)
   

6. Change the YDBFCCS control value Code page from DSPSYSVAL QCHRID when you are prompted.
7. Delete the Y2WEB and Y2WEBVENG libraries and re-restore them after the YINZW2E processing has completed and you have created an environment library:

   RMVLIBLE LIB(Y2WEB)
   RMVLIBLE(Y2WEBVENG)
   DLTLIB LIB(Y2WEB)
   DLTLIB(Y2WEBVENG)
   RSTLIB SAVLIB(Y2WEB) DEV(device-name) RSTLIB(*SAVLIB)
   RSTLIB SAVLIB(Y2WEBVENG) DEV(device-name) RSTLIB(*SAVLIB)
   

   As part of the upgrade process, the old versions of the shipped skeletons such as YSIGNON, YERROR, and so on, are copied into the new environment library.

8. Perform the following steps if you previously made any changes to the skeletons (such as changing the background or links):
   1. Rename the old Y* skeletons in MYWEBENV to e.g. Z* (for instance, change YSIGNON to ZSIGNON)
   2. Copy the r8.6 YSIGNON skeleton from Y2WEBVENG into MYWEBENV
   3. Make any required changes to this new copy of YSIGNON in MYWEBENV

   Note: If you did not make any changes to the Y* skeletons in r8.1, delete these skeletons from YMLSSRC in MYWEBENV. By default, the shipped Y* skeletons in Y2WEB are used.

   Following the upgrade process, the copy of the Web Option Control Values file YW2EVALRFP in the environment library is empty. If you changed any of the control values at the previous release, you need to run the YWRKW2EVAL command and change the displayed default values to match the previous values you used. Your previous values are still available in the copy of YW2EVALRFP in Y2WEBSAV.

9. Change the HTTP server configuration to point to the YROUTER program in the environment library rather than in Y2WEB:
   1. End the Web Option HTTP server instance using the ENDTCPSVR command.
   2. Run the Edit File (EDTF command) to edit the HTTP configuration file:

      EDTF STMF('/www/y2websvr/conf/httpd.conf')
      

   3. Page down until you find the following lines:

      <Directory /QSYS.LIB/Y2WEB.LIB/>
      

   4. Change it to reference the environment library:

      <Directory /QSYS.LIB/MYWEBENV.LIB/>
      

   5. Page down until you locate this line:

      ScriptAliasMatch ^/WEB2E$ /QSYS.LIB/Y2WEB.LIB/YROUTER.PGM
      

   6. Change this line to reference the environment library:

      ScriptAliasMatch ^/WEB2E$ /QSYS.LIB/MYWEBENV.LIB/YROUTER.PGM
      

   7. Press F2 to save your changes and press F3 to exit and restart the Web Option HTTP server instance using the STRTCPSVR command.

      Note: If you are upgrading an r8.1 SP1 PTF1 Web Option library, you need to change any HTTP server configurations that are used with Web Option to remove Y1SY8111 from the following line:

      SetEnv QIBM_CGI_LIBRARY_LIST "Y1SY8111;Y1SY"
      

10. Change any 2E models so that the YW2ELIB model value refers to the environment library rather than the product library:

    CHGMDLVAL MDLVAL(YW2ELIB) VALUE(MYWEBENV)
    

11. Change any CA 2E model job descriptions and library lists so that they include the environment library in the library list above the new LDO and product libraries.