|
|
This document describes how to deploy, tune, and troubleshoot the Websydian server on the iSeries.
It is required that the user deploying the Websydian Server has knowledge of the iSeries. Especially with reference to job management.
Before starting the Websydian Server please make sure the following prerequisites have been performed or verified.
Make sure that the following software are available on the IBM i:
Make sure the Websydian runtime objects are installed, including the latest PTFs on the IBM i including the java runtime files for the DWA environment which are to be placed in the integrated file system (IFS).
For further information on installing the Websydian runtime on the IBM i read this document.
The Websydian Server is started by issuing the command STRWS that is located in the Websydian runtime library.
Add the Websydian runtime libraries to the library list, making sure that the library WSYD610PTF is located before the library WSYD610.
===>ADDLIBLE WSYD610 [Enter]
===>ADDLIBLE WSYD610PTF [Enter]
Submit the Websydian Server using the STRWS command followed by F4.
===>STRWS [F4]
Check each of the parameters, for a description check below. Press PgDn to see all parameters
Online documentation - Websydian v6.1
Start Websydian Server (Java) (STRWS)
Type choices, press Enter.
Websydian home directory . . . . '/websydian/wsyd610'
Websydian Server IP Address . . *LOCALHOST
Websydian Server TCP Port . . . 08189 Number
Websydian Server Password . . . SECRET Character value
Log level . . . . . . . . . . . ERROR TRACE, INFO, WARN, ERROR...
Log filename . . . . . . . . . . '/websydian/wsyd610/logs/ws.log'
License file path and name . . . '/websydian/wsyd610/license/license.key'
Java version . . . . . . . . . . 1.5 Character value
Job name . . . . . . . . . . . . DWAWSSVR Character value
Job description . . . . . . . . WSYDJOBD Name
Library . . . . . . . . . . . WSYD610 Name
Job queue . . . . . . . . . . . QINTER Name
Library . . . . . . . . . . . QGPL Name
Init library list . . . . . . . *JOBD Name, *CURRENT, *JOBD...
User . . . . . . . . . . . . . . *CURRENT Name, *CURRENT, *JOBD
Optional press the F10 for Additional parameters
Additional Parameters
DWA Protocol Encoding (WS) . . . *DFT
Mail recipient . . . . . . . . . *NONE
Mail sender . . . . . . . . . . *NONE
Mail subject . . . . . . . . . . *NONE
SMTP host name . . . . . . . . . *NONE
Log roll interval . . . . . . . *DAILY Character value, *DAILY...
Name of Script to use . . . . . STRWS.SH
Parameters described
| Parameter | Default Value | Description |
|---|---|---|
| Websydian home directory | /websydian/wsyd610 | Directory in the IFS where required Websydian runtime objects are located |
| Websydian Server IP Address | *LOCALHOST | The IP address of the machine where the Websydian Server is
started. This address together with the TCP port is used by the Web
Server Component to connect to the Websydian Server.
Valid values are:
|
| Websydian Server TCP Port | 08189 | The TCP port of the Websydian Server. The port is used together with the IP address by the Web Server Component to connect to the Websydian Server. |
| Websydian Server Password | SECRET | A password for used in order to operate the Websydian Server e.g. required in case sending the end command to the Websydian Server |
| Log level | ERROR | The log level affects how much the Websydian Server will write
to the log file. The following values can be used:
Use ERROR in a deployment environment whereas TRACE should be used in debug situations only. |
| Log filename | /websydian/wsyd610/logs/ws.log | The file to which the log is written. |
| License file path and name | /websydian/wsyd610/license/license.key | The path and file name of the license file. |
| Java version | 1.5 | The version of the Java JVM to be used |
| Job name | DWAWSSVR | Job name to be used for the Websydian Server |
| Job description | WSYD610/WSYDJOBD | Job description used for submitting the Websydian Server to batch |
| Job queue | QGPL/QINTER | Job queue used for submitting the Websydian Server to batch |
| Init library list | *JOBD | Initial library list to be used |
| User | *CURRENT | The user to be used for submitting the Websydian Server to batch |
| DWA Protocol Encoding (WS) | *DFT | Encoding used by internal DWA protocols (DO NOT CHANGE) |
| Mail recipient | *NONE | The receiver of log mails. |
| Mail sender | *NONE | If SMTP host name is specified, this parameter is mandatory and must contain the sender name to use when sending log mails. |
| Mail subject | *NONE | The subject of the log mails. |
| SMTP host name | *NONE | If this parameter is specified all log messages of type FATAL will be sent in an e-mail to an administrator. This parameter specifies the host name of the SMTP server. |
| Log roll interval | *DAILY | The frequency to be used by the log system to roll the log:
Valid values are:
|
| Name of Script to use | STRWS.SH | The name of the Shell script used to execute the Websydian Server Java runtime. Located in the 'bin' sub directory of the Websydian home directory. |
After starting the Websydian Server verify that the Websydian Server is listening on the port specified.
The main location to verify the state of the Websydian Server is in the log.
Using the command WRKLNK you are able to view the log file of the Websydian Server
WRKLNK '/Websydian/WSYD610/logs/*' [Enter]
Work with Object Links
Directory . . . . :
/websydian/WSYD610/logs
Type options, press Enter.
2=Edit 3=Copy 4=Remove
5=Display 7=Rename 8=Display attributes
11=Change current directory ...
Opt Object
link
Type Attribute
Text
wsydsrv.log
STMF
Slut
Parameters or command
===>
F3=Exit F4=Prompt
F5=Refresh F9=Retrieve
F12=Cancel F17=Position to
F22=Display entire field F23=More options
Select option 5 in front of the wsydsrv.log file for view and press enter.
Edit File: /websydian/WSYD610/logs/wsydsrv.log
Record : 1 of 3 by 8 Column : 30 99 by 74
Control :
CMD 3....+....4....+....5....+....6....+....7....+....8....+....9....+....0....
a**************
ead-0:INFO] - License info: Websydian Server Unregistered Basic expires at
ead-0:INFO] - DWA protocol: Version 2.1.
ead-0:INFO] - Waiting for connection on 127.0.0.1:3871...
***************
F2=Save F3=Save/Exit F12=Exit F15=Services F16=Repeat find
F17=Repeat change F19=Left F20=Right
Input 30 in column and press enter.
The log file shows all communication with the Websydian Server, note this is only the case when log level is set to TRACE. Make sure that the statement "Waiting for connection on xxx.xxx.xxx.xxx:yyyy" is located in the log. xxx.xxx.xxx.xxx is the IP address used by the Websydian Server and the yyyy is the port tn which the Websydian Server is listening.
If the information is not in the log file or the log file is not available please proceed to the Troubleshooting Websydian Server section of this document.
The Websydian Server is stopped by issuing the command ENDWS which is located in the Websydian runtime library.
Add the Websydian runtime libraries to the library list, making sure that the library WSYD610PTF is located before the library WSYD610.
Submit the Websydian Server using the STRWS command followed by F4.
Check each of the parameters, for a description check below.
End Websydian Server (Java) (ENDWS)
Type choices, press Enter.
Websydian home directory . . . . '/websydian/wsyd610'
Websydian Server IP Address . . *LOCALHOST
Websydian Server TCP Port . . . 08189 Number
Websydian Server Password . . . SECRET Character value
| Parameter | Default Value | Description |
|---|---|---|
| Websydian home directory | /websydian/wsyd610 | Directory in the IFS where required Websydian runtime objects are located |
| Websydian Server IP Address | *LOCALHOST | The IP address of the machine where the Websydian Server is
started.
Valid values are:
|
| Websydian Server TCP Port | 08189 | The TCP port of the Websydian Server. |
| Websydian Server Password | SECRET | The password as specified when issuing the STRWS command. |
First step in order to troubleshoot the deployment of the Websydian Server is trying to use the command RUNWS.
The RUNWS will start the Websydian Server interactively enabling the user to view any error messages produced by the java environment. The command interface of the RUNWS command differs only with regards to submit job information.
Next step in Troubleshooting the start of Websydian Server on the iSeries is primarily based on information found in the log file.
If the log file is not created make sure the path is correct and that the user starting the Websydian Server, specified on the job description, has the correct authority to the directory where the log file is to be located.
Errors pertaining the start of the Websydian Server which is based on job description problems or other iSeries related problems can be identified by doing the following.
Use the command WRKOUTQ to view the contents of the output queue QEZJOBLOG
===>WRKOUTQ QEZJOBLOG [Enter]
The most common errors found in the log file and their solutions are:
The error indicates that the port to which the Websydian Server is trying to listen is already used by another program. Change the port number used and try starting the Websydian Server again..
Use the command NETSTAT to view the list of used IP addresses on the iSeries and select the menu option 3 - Work with TCP/IP connection status
===>NETSTAT [Enter]
Work with TCP/IP Connection Status
System: DKSOFT00
Type options, press Enter.
3=Enable debug 4=End 5=Display details 6=Disable debug
8=Display jobs
Remote Remote Local
Opt Address Port Port Idle Time State
* * ftp-con > 000:52:39 Listen
* * telnet 000:29:57 Listen
* * smtp 238:56:17 Listen
* * www-http 002:36:49 Listen
* * pop3 238:56:19 Listen
* * netbios > 238:56:19 Listen
* * netbios > 000:00:36 *UDP
* * netbios > 000:00:21 *UDP
* * netbios > 000:29:07 Listen
* * cifs 001:27:59 Listen
* * drda 238:57:26 Listen
* * ddm 238:57:26 Listen
Mere...
F3=Exit F5=Refresh F9=Command line F11=Display byte counts F12=Cancel
F15=Subset F22=Display entire field F24=More keys
The error indicates that the IP address specified does not exist on the iSeries. Change the IP address and try starting the Websydian Server again.
Use the command CFGTCP followed by selection of the menu option 1 - Work with TCP/IP interfaces to view a list of available IP addresses on the iSeries.
CFGTCP [Enter]
Work with TCP/IP Interfaces
System: DKSOFT00
Type options, press Enter.
1=Add 2=Change 4=Remove 5=Display 9=Start 10=End
Internet Subnet Line Line
Opt Address Mask Description Type
127.0.0.1 255.0.0.0 *LOOPBACK *NONE
192.168.1.1 255.255.255.0 ETHLAN1 *ELAN
192.168.1.2 255.255.255.0 ETHLAN2 *ELAN
192.168.100.1 255.255.255.0 ETHLAN3 *ELAN
Slut
F3=Exit F5=Refresh F6=Print list F11=Display interface status
F12=Cancel F17=Top F18=Bottom