Installation Instructions

This step is required if you have not yet downloaded the WebSmart install files to your PC. If you have already downloaded the software, continue with Step 2.

To download WebSmart, visit the Free Downloads page on our website and then return to this page.

Save both the files to a new folder on your PC:

Note that the actual file names may change slightly as new releases of the software are made available.

This step is required if you are upgrading from a previous release of WebSmart, and if you have BCD’s Catapult or Spool-Explorer installed. If this is a new install, and you know you don’t have Catapult or Spool-Explorer running, skip to the next step.

WebSmart uses a communications middleware component called EXODUS to transfer data between the iSeries and PCs. EXODUS is also be used by BCD's Catapult and Spool-Explorer/400. To verify whether you are ready to install WebSmart sign on to an iSeries session as QSECOFR and run the WRKACTJOB command. Check whether there is an active subsystem called EXODUS:

If the subsystem is not active, you can proceed directly to Step 3.

If the EXODUS subsystem is active, then someone at your site may be working with an application that uses EXODUS for communications. To see a list of these jobs, run the command WRKOBJLCK XL_EXODUS *LIB. You can then contact the users associated with these jobs to request that they end their connections, or if you know what the jobs are, you can end them yourself.

After ending all EXODUS jobs, run the following command to end the EXODUS subsystem: ENDSBS SBS(EXODUS) OPTION(*IMMED). Then continue with the next step.

This step is required for WebSmart PHP only. If you will never use or evaluate WebSmart PHP, skip to the next step. If you think you might at some time try out WebSmart PHP, install Zend Core first so the WebSmart install can automatically detect it, and adjust the WEBSMART HTTP server instance accordingly. If you install Zend Core afterwards, you’ll need to make some manual changes to the server instance configuration.

Before you can create and run programs with WebSmart PHP you need to install Zend Core. To verify whether you have Zend Core installed, follow these steps:

• At an iSeries session, run the command GO LICPGM.
• Select option 10.
• Verify that licensed program 1ZCORE5 is installed.

from the Zend website

system requirements

After installing Zend Core you can continue with the next step.

Double-click the iSeries install (websmartxxx.exe) to transfer the libraries to your iSeries.

After the file is decompressed, BCD's FTP upload utility is presented. Type your iSeries IP address and the QSECOFR password, then click the Upload button:

When the Activity Log reports that the file upload is complete, you can close this window and continue with the next step.

After closing the upload utility, log on to an iSeries session as QSECOFR. Run the command BCDINSTALL/BCDINSTALL. At the panel presented, select the product WebSmart and press Enter. Follow the on-screen instructions.

When prompted, enter your WebSmart License Key:

If you don't have a valid WebSmart license key, contact BCD at (630) 986-0800 to request one. You can also press F3 to Exit (and complete) the installation process, and add the license key afterwards using the command XL_WEBLIB/UNLOCK. If you are upgrading, pressing F3 will cause the install to retain your existing license key.

When the iSeries install concludes, run the command STRSBS XL_EXODUS/EXODUS to start the EXODUS subsystem. Then run the command WRKACTJOB and verify that the EXODUS subsystem is active and contains a job called EXSERVER:

Then continue with the next step.

If the EXODUS subsystem isn't running, you can attempt to start it manually using the command STRSBS XL_EXODUS/EXODUS.

To run any WebSmart programs you will need to start the WEBSMART Apache HTTP server instance. The server instance configuration was installed with the software.

To start the WEBSMART HTTP server instance, enter your iSeries IP address below and click the Manage HTTP Servers button. When prompted, log on as QSECOFR, and then continue with the instructions below:

When you click the Manage HTTP Servers button, it attempts to load the page http://xxx.xxx.xxx.xxx:2001/HTTPAdmin, (where the x's represent the IP address of your iSeries). If the button doesn't work for you, or you have printed these instructions, you can enter this address manually in your browser.

When prompted, log in using your iSeries user profile. At the page presented go the Manage tab and select the WEBSMART server instance from the drop down list:

After selecting the server instance, verify its status. If it's stopped (as shown above), click the green button to start it. [The WEBSMART server instance runs on port 8150; if you wish to change this value you can edit the configuration file before starting the server instance.]

WebSmart ILE Only: Once the server instance is shown as running, click the button below to try running the Test Config program on your system:

For WebSmart PHP see the bottom of this page.

This test uses the IP address you entered above, and attempts to load this URL: http://xxx.xxx.xxx.xxx:8150/webapps/testcfg.pgm. If the program isn't found, verify your system IP address in the new browser window.

At the page presented, take note the URL of the page that opens: the WEBSMART HTTP Server's port number (8150) is appended to your iSeries IP address, as well as the mapping for the library XL_WEBAPPS (/webapps) and the test program name (testcfg.pgm).

If the test program runs it means that you have successfully installed the iSeries side of WebSmart ILE, and have started a functioning HTTP server instance. Now you're ready to install the WebSmart IDE on your PC.

For WebSmart PHP installs to test your server side installation continue with the installation of the WebSmart IDE on your PC and create a WebSmart PHP program, submit a compile and launch it. Chapter 4 from the WebSmart PHP User Guide walks you through creating a simple PHP program and the User Guide can be found from the WebSmart IDE from the Help menu.

The WebSmart IDE can be installed on any number of PCs that connect to the same iSeries. To install the WebSmart IDE (and supporting files) on your PC, start by double-clicking the PC install file and follow the on-screen instructions:

You should be able to accept all the default install options. Once the IDE is installed, continue with the instructions in the next step.

After installing WebSmart you need to configure communications between the PC and iSeries components. To do this, go to Programs/WebSmart 6/Communication Configuration:

When you first install, one default system is created. Select this entry and click the Properties button to adjust the Port and IP Address (if necessary).

The window below is presented:

Edit the values as required. The System Name is only for documentation purposes, and is not used in the actual connection.

Once you have set up your default connection, click OK to save your changes. Then open WebSmart (Programs/WebSmart 6/WebSmart) and when the IDE appears, select the Help/Test Connection option to verify that the connection has been successfully configured.

Then continue with the next step.

At this point you should be ready to try running the software and start learning how to use it.

Continue with Step 2 of the 5 Steps to Success for:

• WebSmart,
• Clover or
• WebSmart PHP.

If at any point in this process you would like to have an informal chat with someone to get some suggestions on how to address your particular needs, then by all means get in touch with our Sales or Technical Support teams.

We look forward to hearing from you soon.