Installation Instructions

This step is required if you have not yet downloaded the WebSmart installation 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:

The 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.

Log on to an iSeries session as QSECOFR and run the command BCDINSTALL/BCDINSTALL. At the panel presented, select the product WebSmart and press Enter. Follow the on-screen instructions. The iSeries libraries installed are XL_WEBLIB, XL_WEBSPT, XL_WEBDEMO, XL_EXODUS and BCDSUPPT.

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.

If you are at V6R1, the default EXODUS connection port number (2015) won't work, as IBM took over using that port. To address this, prompt the XL_EXODUS/ZCFGTCP [F4] command on your iSeries and change the default port number to 7015 or another port you know is available. Then press enter to run the command.

When the iSeries install concludes, run the command WRKACTJOB and verify that the EXODUS subsystem is active and contains a job called EXSERVER:

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

Then continue with the next step.

As part of your WebSmart iSeries install we create, configure and start an Apache HTTP server instance named WEBSMART, running on port 8150. This allows you to start running your programs as soon as you install the software. To verify that the WEBSMART HTTP server instance was started, 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, 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.]

The installation includes test programs you can run for WebSmart ILE and PHP. Click the links below to verify your iSeries installs and HTTP configuration:

These tests build a URL that combines the IP address you entered, the WEBSMART HTTP Server's port number (8150) and the WebSmart library or IFS directory where the programs reside. If the test program(s) run it means that you have successfully installed the iSeries side of WebSmart ILE and/or PHP, and have started a functioning HTTP server instance. If the programs don't run, verify the URLs generated in your browser window when you ran the test.

Now you're ready to install the WebSmart IDE on your PC.

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. If you are running Vista, the operating system will impose less limitations on your install if you don't put the program in Program Files; you can use C:/ESDI/ as an alternative.

Once the IDE is installed, continue with the instructions below.

After completing the PC install, launch WebSmart from Start/All Programs/WebSmart 7.0/WebSmart. If this is a new install WebSmart will detect that you haven't configured your server connection and ask you to do that. This prompt is presented (shown here with example values):

Enter your system name and IP (or DNS). If you are NOT at V6R1 or higher, accept the default port number of 2015. At V6R1, change the port to 7015 (or the value you used on the iSeries install).

From the window above you can also set default values for a number of options that you need to specify every time you create a new WebSmart ILE program. These include your RPG source file and object libraries. Note that the program object library XL_WEBAPPS will work in conjunction with the standard WEBSMART HTTP server instance configuration.

For the default web path to object, type http://your_ip_address:8150/webapps/ where ‘your_ip_address’ is the IP address of your iSeries (make sure you don’t forget the port number and final slash shown above).

To confirm your configuration click the Test Connection button. When you do this WebSmart prompts you to sign on to your iSeries and then displays a confirmation message.

Now continue with the next step.

This step is only required for PHP. If you do not plan to create PHP applications, skip to the next step.

WebSmart PHP requires at least one FTP connection. Your FTP connections allow you retrieve and work with files related to your application, as well as set defaults for the PHP programs you create. In WebSmart IDE, open the Tools/Options window and click the FTP entry to present these options:

Click the Add button to create an FTP Site:

Configure your options as described here:

After entering the required values, click the Test Connection button to verify that you have entered your configuration details correctly. If the confirmation window tells you that the connection is working, press OK to create the site and continue with the next section.

This step is only required for WebSmart ILE or PHP programs running over databases other than DB2. If you will not create programs over non-DB2 tables, skip to the next step.

If you intend to use WebSmart to create programs over other databases (such as MySQL in PHP, and MySQL, MsSQL or Oracle in ILE) you need to create an ODBC connection to your target database so the WebSmart IDE can load the file layouts. To create a new ODBC connection, launch the WebSmart IDE and go to the Tools/Options menu. Select the Servers/Databases section and click Add to present these options:

Click the Add button to create an ODBC Connection:

Configure your options as described here:

After entering the required values, click the Test Connection button to verify that you have entered your configuration details correctly. If the confirmation window tells you that the connection is working, press OK to create the connection and continue with the next section.

This step is only required for WebSmart PHP. If you will not use WebSmart PHP, skip to the next step.

After installing WebSmart PHP you need to set a number of connection defaults so your programs can access your iSeries and database. While there are a few ways to handle this requirement, the WebSmart PHP program templates are set up to retrieve the connection values from a file on your IFS. When you execute WebSmart PHP programs, the first thing they attempt to do is load a preferences file, xl_functions001.php, by executing this statement at the top of the code:

require('/esdi/websmart/v7.0/include/xl_functions001.php');

This file includes a section where you can specify default user profiles and system names (among other things). However, because this file is overwritten when you upgrade, it in turn attempts to load some defaults from another file, xl_user_preferences.php, which you need to create (see WebSmart PHP KB article 6998 for additional details).

@include('xl_user_preferences.php');

Leave the ?> at the end of the file. In the section that remains in xl_user_preferences.php enter default values for the connections you will be using, as described here:

When you create your own application you may want to load your User IDs another way (for example, by prompting the user to enter one), but this approach will get you started.

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.