Quick installation guide for WebsydianExpress for iSeries

This guide provides everything you need to do in order to install WebsydianExpress for iSeries, quickly.

Important! Make sure that you have the following software options with the latest PTF levels installed, and requirements.

• QShell (5722SS1)
• Java Developer Kit 1.5 (5722JVA)
• FTP configured on your iSeries (for transferring required objects to your iSeries)

Step 1: Obtain the latest version of the WebsydianExpress for iSeries installation program

Current version and build is "WebsydianExpress v3.0.4 for iSeries"

Step 2: Install and set up your iSeries HTTP Server (powered by Apache)

WebsydianExpress for iSeries requires that the iSeries HTTP Server (powered by Apache) have been installed and is running.

For the WebsydianExpress installation guide to be completed you will also need the "IBM Web Administration for i5/OS interface".

For more information on "Getting started with the IBM Web Administration for i5/OS interface" please follow information available from IBM at:

• i5/OS version 5R3 - http://publib.boulder.ibm.com/infocenter/iSeries/v5r4/topic/rzaie/rzaiegetstarted.htm
• i5/OS version 5R4 - http://publib.boulder.ibm.com/infocenter/iSeries/v5r3/topic/rzaie/rzaiegetstarted.htm
• i5/OS version 6R1 - http://publib.boulder.ibm.com/infocenter/iSeries/v6r1/topic/rzaie/rzaiegetstarted.htm

Step 3: Configure and transfer installation program to your iSeries

Once the iSeries HTTP Server is up and running you are ready to configure WebsydianExpress and transfer the installation program to your iSeries.

1. Start the WebsydianExpress installation program Express_v3.0.4_iSeries.exe. At any point during the installation feel free to press a Help button if you need further information.
2. On the 'Welcome' page press Next
3. As this is a quick installation guide select the Default installation type on the 'Select Type of Installation' page.
4. Press Next to accept the location used on your PC for objects required during installation.
5. Read and accept the license agreement and press Next
6. On the 'iSeries Information' page enter the following information and press Next
   • iSeries host name, enter the host name or IP address of your iSeries
   • User name, enter the user profile to be used for uploading objects to your iSeries
   • Password, enter the password of the user profile.
7. On the 'Regional Settings' page choose the formats you want and pres Next
8. Press Transfer to transfer installation objects to your iSeries
   Note! The transfer operation can be a long running task, please wait for the next dialog to appear before continuing.

Step 4: Run iSeries installation program

Step 5: Configure the iSeries HTTP Server (powered by Apache)

Step 6: Start WebsydianExpress service jobs

In order to start the WebsydianExpress issue the following iSeries command.
 

Step 7: Access the WebsydianExpress demosite and administration interface

After starting WebsydianExpress the available sites can be accessed by entering the following web address in your browser:

http://<iSeriesHostName>/express30/site/demosite

Make sure that you replace the '<iSeriesHostName>' with the host name of your iSeries

Login with user Customer and password Customer to login to one of the sites and access the administration interface.

In order to access the administration part of the demosite append /admin to the url

http://<iSeriesHostName>/express30/site/demosite/admin

Make sure that you replace the '<iSeriesHostName>' with the host name of your iSeries

Login with user WSADMIN and password ADMIN in order to access the administration interface of the demosite.

What is next

We recommend that you read the following document in order to secure your WebsydianExpress installation before going into production

Stopping WebsydianExpress service jobs

In order to stop the WebsydianExpress issue the following iSeries command.
 

Improving performance using WebsydianExpress Web Server Component for iSeries WebSphere

For improved performance in a production environment we recommend using the Websydian Web Server Component for iSeries WebSphere.

For further information please contact support@websydianexpress.com

Obtain a license for the Websydian Server

By default the WebsydianExpress is installed with an unregistered license of the Websydian Server providing 10 concurrent sessions.

You have the option to obtain a registered version for 10 concurrent sessions for free that enables you to find a starting point on the number of concurrent sessions required by your applications.

For pricing on concurrent sessions please contact info@websydian.com.

Uninstalling WebsydianExpress for iSeries

These are the steps in order to uninstall WebsydianExpress from your iSeries

1. Run the stop command to stop WebsydianExpress
2. Stop your HTTP server instance to release the WXP30WEB library for deletion
3. Remove the libraries WXP30*
4. Remove the IFS directory /Websydian/EXPRESS30 and all subdirectories
5. In your HTTP Configuration file remove alias and scriptalias information about WebsydianExpress

Troubleshooting WebsydianExpress installation

If you are having problems installing WebsydianExpress please contact Websydian support at support@websydianexpress.com and attach the following information:

• The URL used to access the WebsydianExpress basicsite and/or WebsydianExpress demosite
• The Websydian Server log file.
  This file is located in the iSeries IFS directory of WebsydianExpress. Default location is '/Websydian/EXPRESS30/logs'.
• A screen dump of the default parameters of the commands STRWS and STRAS in the 'WebsydianExpress program library' default named 'WXP30PGM'.
• Your iSeries HTTP server configuration file
• The Websydian Web Server Component for iSeries configuration file
  This file is located in the iSeries IFS directory of WebsydianExpress. Default location is '/Websydian/EXPRESS30/WebComponent/WebComponent.ini'
• The IBM HTTP server log file
  Located in the IFS directory /www/your_server_name/logs.
  Note! Make sure to send the latest error_log.xxxxx file.