Installation Instructions

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

The WebSmart IDE (the design tool) uses a communications middleware component called EXODUS to transfer data between the iSeries and PCs at different times while you are creating your programs. For example, EXODUS is used to retrieve iSeries file layouts, or upload code to be compiled. EXODUS is also used by BCD’s Catapult, Presto and Spool-Explorer/400.

Before installing WebSmart you need to make sure that there are no EXODUS jobs running, to ensure there are no locks on objects that need to be updated or replaced.

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

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 have no plans to use or evaluate WebSmart PHP, skip to the next step. However, if you think you might at some time try out WebSmart PHP, you should install Zend Core or Zend Server first so the WebSmart install can automatically detect it and adjust the WEBSMART HTTP server instance accordingly. If you install the Zend components afterward, you’ll need to make these adjustments manually.

To verify whether you have one of these installed, follow these steps:

• At an iSeries session, run the command GO LICPGM.
• Select option 10.
• Check that either the licensed program 1ZCORE5 (Zend Core) or 2ZSVRPI (Zend Server) are listed with a status of *INSTALLED.

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

This step is required for all installs.

1. Go to the Download Free Software page and fill out the form to download WebSmart.

2. Download and save both the iSeries and PC installation files to a new folder on your PC.

3. When the download finishes, double-click the iSeries install executable file WebSmart8.2.exe (the version number may vary) to unpack the files and transfer them to your iSeries.

When the download finishes, double-click the iSeries install executable file WebSmart8.2.exe (the version number may vary) to unpack the files and transfer them to your iSeries.

4. After the file is decompressed, BCD's FTP upload utility is presented. Enter your iSeries IP address and the QSECOFR password (as shown below). Then click the Upload button:

When the Activity Log reports that the file upload is complete, you can close this window.

5. Log on to an iSeries session as QSECOFR and execute the command BCDINSTALL/BCDINSTALL.

6, 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.

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

8. When the iSeries install concludes, prompt the command XL_EXODUS/ZCFGTCP [F4] and ensure that the IP address shown at this screen is the correct local IP address for your iSeries. Also, if you are at V6R1, the default EXODUS connection port number (2015) won't work, as IBM took over using that port. Change the default port number to 7015 or another port you know is available. Then press Enter to run the command.

9. If you changed any of the values displayed when you initially prompted the ZCFGTCP command you need to restart the EXODUS subsystem to apply the new values. Run the command: ENDSBS SBS(EXODUS) OPTION(*IMMED). Ignore any messages.

10. Run the command STRSBS XL_EXODUS/EXODUS to start the EXODUS subsystem. After a few moments, run WRKACTJOB to verify that the EXODUS subsystem is active and contains a job called EXSERVER.

If the subsystem is started, continue with the next step.

The WEBSMART HTTP Server Instance
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.

You can use the WEBSMART HTTP server instance however you want, but we recommend that once you start creating production applications you create your own server instances and use those. In our own internal development projects we have caused the HTTP server instances to go down due to malformed SQL and other programmatic issues, so we recommend that you create at least two separate server instances, for your development and production environments.

If you need assistance with creating your own server instances, please call Technical Support and we can help you out.

This step is recommended for all installs.

The installation includes test programs you can run for WebSmart ILE and PHP. To verify that the WEBSMART HTTP server instance was started, enter your iSeries IP address below and click the button to test your WebSmart ILE and PHP installs:

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.

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

Background Information: The HTTP Server Admin Interface
As you start creating web applications you'll want to familiarize yourself with the IBM Web Administration for i interface.

To work with it go to the browser window where you ran the testcfg.pgm program and change the url to http://xxx.xxx.xxx.xxx:2001/HTTPAdmin, (where the x's represent the IP address of your iSeries).

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

From here you can see the status of this server instance, and start, stop or restart it.

If it's currently stopped you can click the green button to start it.

Note that from here you can also change the port number that the WEBSMART HTTP server instance is running on, or make other changes to the configuration.

This step is required for all installs.

You can install the WebSmart IDE (the PC design tool) on any number of PCs that connect to the same server. Follow the steps below to install the WebSmart IDE:.

1. If you haven’t yet done so, go to the Download Free Software page and fill out the form to download WebSmart.

2. When the download finishes double-click the downloaded file to unpack the install files and initiate the install. The PC install file is named websmart820-pc.exe [this may vary slightly].

3. Follow the instructions to install the WebSmart executables to your PC.

You should be able to accept all the default install options. When it’s done, the install will prompt you to launch the software. You can also launch WebSmart from your Start menu.

1. If you haven't done so already, launch WebSmart from Start/All Programs/WebSmart/WebSmart.

2. 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):

3. 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).

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

Note: If this is a new install and you choose to use a different library, you will also need to adjust the default configuration for the WEBSMART HTTP server instance or create your own HTTP server instance to use instead.

5. 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). This assumes that you are using the default configuration and the WEBSMART HTTP server instance.

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

7. Click OK to add the configuration entry.

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.

1. In the 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.

1. 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, where you will be running PHP programs on your iSeries and/or MySQL server. If you will not use WebSmart PHP, skip to the next step.

When you are in a Portable Application Solutions Environment (PASE) environment each time you launch your PHP program you have to establish a connection to either the iSeries or a relational database to access information. 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/v8.2/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 of the defaults from another file, xl_user_preferences.php, which you should create. We strongly recommend that you create your own user preference files so you don't lose your settings on upgrade.

2. Save the file as xl_user_preferences.php (or copy and rename xl_functions.php).

3. In the new, copied file delete everything from (and including) this line up to the end of the file:

@include('xl_user_preferences.php');

Note: Leave the ?> at the end of the file!

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