Upgrade Instructions

Note that in the following instructions and illustrations the version number may not always exactly match the most current release available for download from our web site. If you have any doubts or questions, please contact Technical Support.

1. Go to the Download Free Software page and fill out the form to download WebSmart. You can also log in to mybcdsoftware.com to download without having to fill out the form.

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

3. When the download finishes double-click the IBM i install executable file WebSmart9.1.exe to unpack the files and transfer them to your IBM i.

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

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

The IBM i upgrade should take about 5-10 minutes, depending on the model of your IBM i.

Check for Locks on XL_WEBLIB

To ensure that the upgrade proceeds as smoothly as possible run the following command to check for object locks on the WebSmart product library:

WRKOBJLCK OBJ(XL_WEBLIB) OBJTYPE(*LIB)

This may be locked by developers working with the software. After verifying that all the object locks are cleared, continue with the next step.

Check for Active Exodus Jobs
WebSmart 9.1 uses EXODUS51 to transfer data between the IBM i and PCs. EXODUS51, and its precursor, EXODUS, are also used by other BCD products including Spool-Explorer, Catapult and Presto. Versions of WebSmart earlier than 9.0 also used EXODUS (in library XL_EXODUS).

To ensure that Exodus doesn’t have locks on any objects that need to be replaced or upgraded, check the following before upgrading:

• At an IBM i session run the WRKACTJOB command and check whether the EXODUS or EXODUS51 subsystems are active. If the subsystems are not active, continue with the next section.
• If the EXODUS or EXODUS51 subsystems are active someone at your site may be working with an application using these. To see a list of these jobs run the commands WRKOBJLCK XL_EX51 *LIB and/or WRKOBJLCK XL_EXODUS *LIB. Contact the owners of these jobs to request that they end their connections, or you can end them yourself.

After ending all EXODUS and/or EXODUS51 jobs you can use the ENDSBS command to end the subsystem(s).

After verifying that all the object locks are cleared, continue with the next step.

You should now be ready to begin installing the IBM i components. To upgrade WebSmart you may need up to 150Mb of available space during the install.

1. Start the Install.
To begin the install log on to an IBM i session as QSECOFR and execute the command BCDINSTALL/BCDINSTALL.

At the initial panel review the instructions and press Enter to continue.

2. Select a Library to Install To
The install will prompt you to specify a library to install to.

The default library for the WebSmart development environment is XL_WEBLIB. However, if you want to have multiple development environments (to run WebSmart at different versions, for example) you can specify a different library.

If you specify a new library name the installation will immediately proceed and you can skip the step immediately below.

3. Upgrading an Existing Library.
If in Step 2 you selected the name of an existing WebSmart environment library (typically XL_WEBLIB) the install will prompt you for a library name to which to back up your current version. Enter a name for a new library to be created as your current release backup.

Press Enter to continue.

4.Finish the installation.
In addition to the development library you install the installation will also update XL_WEBSPT (shared by all active versions of the software) and restore or update the libraries XL_WEBDEMO, XL_EX51 and BCDSUPPT. Press Enter to continue and follow the on-screen instructions.

5. License Key
If a valid license key is not detected, the installation will prompt you to enter one. You can also enter a license key after the install using the command XL_WEBLIB/UNLOCK.

6. Verify your Exodus51 Configuration and Start the Exodus51 Subsystem
When the server install concludes prompt the command XL_EX51/ZCFGTCP [F4] and verify the IP address and port number are correct. Make any required changes and press Enter.

To start the EXODUS51 subsystem run the command STRSBS XL_EX51/EXODUS51.

After a few moments, run WRKACTJOB to verify that the EXODUS51 subsystem is active and contains a job called EXSERV51. Once the subsystem is started continue with the next step.

To install or upgrade your WebSmart IDE, follow these steps:

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 websmart91-pc.exe [the version number may vary].

Option 1: Upgrading Your Existing IDE
The install will by default overwrite your existing version of WebSmart (in esdi/websmart/). Your custom templates and any other changes are retained.

If you intend to only run the current (new) version of WebSmart on your PC you can accept the installation defaults and proceed.

Option 2: Installing a Second (Separate) Version of the IDE
If you installed WebSmart 9.1 in a new library on the IBM i and intend to continue using the previous release you need to specify a new unique installation path to leave your previous version of the IDE intact.

Here is the step at which you can do this (your version may be slightly different):

In the illustration above we have appended a ‘9.1’ to the default installation directory name so this version of the IDE doesn't overwrite our existing one.

When you finish the installation you can add separate shortcuts for this IDE.

After installing the updated IDE you should confirm your server connections. If you installed a brand new instance of the IDE for version 9.1 you will need to configure a connection to the new library you specified during the installation. Follow the steps below.

Launch the WebSmart 9.1 IDE
If this is a new install or an installation to a new location, WebSmart will detect that you haven't configured your server connection and ask you to do that. Then this prompt is presented (shown here with example values):

Enter your system name and IP (or DNS). The default port number is 4015. You may need to confirm this in your EXODUS51 configuration (as noted at the end of Step 3).

Set Any Required Defaults
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 are documented in the User Guide, but shouldn't change unless you have installed a new version of WebSmart to a separate library.

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.

For the default web path to object, enter http://your_ip_address:8150/webapps/ where ‘your_ip_address’ is the IP address of your IBM i (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. The Program Attributes are described in the Reference Guide.

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

Click OK to add the configuration entry.

Add Any Additional Systems Required
If you will be working with multiple systems you can add them all now.

WebSmart is designed to be extensible, allowing you to do things ranging from template customizations to adding new functions. At the time you upgrade you should review any additions you have made to the tool in your current release and, if necessary, make them available in the new version.

Custom Template Families
If you have customized the default templates or added new templates of your own you should confirm that those are still available at the expected locations.

WebSmart template families are installed in version-specific directories, so you should see a new directory: ESDI/WebSmart/Templates v9.0. If you have a custom template family you can copy it to this directory so it is available by default when you click the New Program button.

Custom Templates
With each version of WebSmart we make improvement to the templates. If you normally use our standard templates and have made any changes to them you have a couple of options:

• You can continue to use your older templates. Note that we are continually improving our templates and if you choose this option it may limit your access to new WebSmart features designed to work with the newest templates.
• You can re-apply your changes to the new templates (recommended).

Hopefully you documented any changes!

At this time you may also want to consider whether the enhancements to the templates in the new version supersede changes you’ve made on your own.

Custom PML Functions
When you upgrade your WebSmart installation the software automatically picks up any custom PML functions from the server regardless of the directory to which you install the IDE.

However, if you install WebSmart 9.0 as a separate version on both the server and the client (this release supports installing to a new library), you need to manually copy the file PW_USRC (normally in XL_WEBLIB) to your new installation library. This will work best if you do this BEFORE launching the WebSmart IDE on your PC.

Contact Technical Support if you have any questions.

Custom PHP Functions
If you have created any custom PHP functions and wish to migrate them to the newly installed version follow the instructions in Knowledge Base Article 9136.

These configuration settings that may be relevant to you depending on the type of applications you intend to build.

Set up the PHP Debugger
A major new feature in WebSmart 8.90 was the PHP debugger. If you are developing PHP applications and haven’t yet configured the debugger, please review that step in the installation instructions in the User Guide.

Setting up Time Zones for PHP on the IBM i
If you will use time functions in your PHP programs at some point you need to set up times zones (if you haven’t already). You can find information on this on Zend’s web site at:

http://kb.zend.com/index.php?View=entry&EntryID=320

Unless you set up your time zone PHP scripts return the wrong time of day.

Configuring the UTC Offset for Sending Email from WebSmart ILE Programs
The UTC offset for your SMTP server is used to correctly timestamp emails that you build and send out using the WebSmart ILE sendmailex function.

For instructions on how to configure this setting, please review Knowledge Base article 8054.

‘Priming’ PDF Generation in Clover and WebSmart
Before you can run any programs that generate PDFs using the new features in WebSmart 9.0 (and higher), you need to run the following IBM i command:

WRKENVVAR LEVEL(*SYS)

At the Work with Environment Vars (*SYS) panel, use the first line and option 1 to add this entry:

JAVA_HOME '/QOpenSys/QIBM/ProdData/JavaVM/jdk50/32bit'

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.