WebSmart Support

Installation Instructions

These instructions are for new installs of WebSmart 11.3 ILE, PHP (on IBM i) and Clover (or higher) only. Please log in to myFreschesolutions.com to access the New Features and Upgrade Guide as well as the User Guide. If you don't have an IBM i, use these instructions to install WebSmart PHP on your PC.

Step 3c: Install the WebSmart IBM i Components from an IBM i session.

The following step is only relevant if you choose NOT to install using BCD Setup Express

You can install the WebSmart IBM i Components either from BCD Setup Express or an IBM i session. If you choose to install from BCD Setup Express go to the step 3a "Installing the IBM i Components from BCD Setup Express". Follow the instructions below to install the IBM i components to an iASP:

  1. Check the status of the iASP using the IBM command line.
    WRKCFGSTS CFGTYPE(*DEV) CFGD(*ASP)

    The iASP should have a status of "Available". If it does not, you can vary it on by taking an option 1 on the iASP in WRKCFGSTS. This operation can take up to several minutes.
  2. After the installer uploads the save file, you'll be prompted for the installation information which includes the iASP and IFS path. For the iASP, put the name of the iASP you want to install into. To install the IFS files to the iASP (e.g. /iasp1/esdi/websmart/), check the box for Install IFS files to iASP.

  3. Once the installation is done, you need to update the job description for Exodus so that it will start jobs in the ASP group. To get the job description you'll be updating, run WRKACTJOB, take a 5 on the job EXSERV55 under the subsystem EXODUS55 and enter option 2.
  4. Run the following command replacing the job description with the job description you got in the previous step and the IASP with the IASP you installed WebSmart to.
    CHGJOBD JOBD(XL_EX55/EXODUS) INLASPGRP(IASP1)
  5. Restart Exodus with the following commands:
    ENDSBS SBS(EXODUS55)
    STRSBS SBSD(XL_EX55/EXODUS55)

Once the installation is done, the library XL_WEBLIB (or what you entered for the install library) will be in the iASP and the libraries XL_WEBSPT, XL_EXODUS, XL_WEBAPPS and XL_WEBDEMO will be on *SYSBAS.


Optional Steps

Moving additional libraries to the iASP.

It is not recommended to move XL_WEBSPT or XL_EXODUS. Both should be installed into *SYSBAS on the system and also into *SYSBAS on the high-availability/backup system.

In addition, XL_EX55 CANNOT live on an iASP. It will only work if installed to *SYSBAS.

  1. Moving a library to the iASP can be done do with the following commands. This example will move XL_WEBAPPS to IASP1.
    CRTSAVF (XL_WEBAPPSF/TEMPSF)
    SAVLIB LIB(XL_WEBAPPS) DEV(*SAVF) SAVF(XL_WEBAPPSF/TEMPSF) PVTAUT(*YES)
    RNMOBJ OBJ(XL_WEBAPPS) OBJTYPE(*LIB) NEWOBJ(XL_WS_BK)
    RSTLIB SAVLIB(XL_WEBAPPS) DEV(*SAVF) SAVF(WEBAPPSF/TEMPSF) PVTAUT(*YES) RSTLIB(*SAVLIB) RSTASPDEV(IASP1)
  2. If any of the libraries you moved are being used by Apache, you will need to update the path for them in the Apache config file. e.g. /QSYS.LIB/XL_WEBAPPS.LIB would be changed to /iasp1/QSYS.LIB/XL_WEBAPPS.LIB.
  3. If you made any changes to the Apache config, you need to restart Apache for the changes to take effect. This can be done with the following commands:
    ENDTCPSVR SERVER(*HTTP) HTTPSVR(WEBSMART)
    STRTCPSVR SERVER(*HTTP) HTTPSVR(WEBSMART)

Moving additional IFS folders to an iASP.

  1. Moving IFS folders to the iASP can be done with the following commands in QSH. This example will prepend the /isasp name to the path and move /www/websmart/htdocs/wsphp to IASP1.
    in QSH
    mkdir -p /iasp1/www/websmart/htdocs/
    mv /www/websmart/htdocs/wsphp /iasp1/www/websmart/htdocs/wsphp/
  2. If any of the folders you moved are being used by Apache, you will need to update the path for them in the Apache config file.
  3. If you made any changes to the Apache config, you need to restart Apache for the changes to take effect. This can be done with the following commands:
    ENDTCPSVR SERVER(*HTTP) HTTPSVR(WEBSMART)
    STRTCPSVR SERVER(*HTTP) HTTPSVR(WEBSMART)