Running the sample application

Web Direct 2.0 comes with a sample web application. This chapter explains how to deploy and run the sample application.

1. Build the war

1.	Change to the wd2 folder of isCOBOL samples

Windows

cd %ISCOBOL%\sample\eis\wd2\widget

Linux/Unix

cd $ISCOBOL/sample/eis/wd2/widget

2.	Add zk.jar, zul.jar and zcommons.jar to the CLASSPATH

Windows

set CLASSPATH=%CLASSPATH%;..\..\..\..\eis\wd2\lib\zk.jar;..\..\..\..\eis\wd2\lib\zul.jar;..\..\..\..\eis\wd2\lib\zcommon.jar

Linux/Unix

export CLASSPATH=$CLASSPATH:../../../../eis/wd2/lib/zk.jar:../../../../eis/wd2/lib/zul.jar:../../../../eis/wd2/lib/zcommon.jar

3.	Compile the programs

Windows

iscc -sp=../../../isdef;copylib -wd2 *.cbl

Linux/Unix

iscc -sp=../../../isdef:copylib -wd2 *.cbl

4.	Create the "wd2" webapp folder structure as follows:

Windows

mkdir wd2 mkdir wd2\arc mkdir wd2\pdf mkdir wd2\upload mkdir wd2\resources mkdir wd2\resources\css mkdir wd2\WEB-INF mkdir wd2\WEB-INF\classes mkdir wd2\WEB-INF\lib mkdir wd2\WEB-INF\programs

Linux/Unix

mkdir wd2 mkdir wd2/arc mkdir wd2/pdf mkdir wd2/upload mkdir wd2/resources mkdir wd2/resources/css mkdir wd2/WEB-INF mkdir wd2/WEB-INF/classes mkdir wd2/WEB-INF/lib mkdir wd2/WEB-INF/programs

5.	Copy the compiled programs and the sample files to the webapp folder as follows:

Windows

copy css\custom.css wd2\resources\css copy images\* wd2\WEB-INF\programs copy snippet\* wd2\arc copy index.html wd2 copy iscobol.properties wd2\WEB-INF\classes copy *.class wd2\WEB-INF\programs

Linux/Unix

cp css/custom.css wd2/resources/css cp images/* wd2/WEB-INF/programs cp snippet/* wd2/arc cp index.html wd2 cp iscobol.properties wd2/WEB-INF/classes cp *.class wd2/WEB-INF/programs

6.	Copy the isCOBOL runtime and WD2 libraries to the webapp lib folder as follows:

Windows

copy %ISCOBOL%\eis\wd2\lib\*.jar wd2\WEB-INF\lib copy %ISCOBOL%\lib\commons-logging.jar wd2\WEB-INF\lib copy %ISCOBOL%\lib\commons-codec-1.9.jar wd2\WEB-INF\lib copy %ISCOBOL%\lib\javassist.jar wd2\WEB-INF\lib copy %ISCOBOL%\lib\iscobol.jar wd2\WEB-INF\lib copy %ISCOBOL%\lib\poi-*.jar wd2\WEB-INF\lib copy %ISCOBOL%\lib\xmlbeans-2.6.0.jar wd2\WEB-INF\lib copy %ISCOBOL%\eis\wd2\lib\iswd2.jar wd2\WEB-INF\lib copy %ISCOBOL%\lib\itext-2.1.7v3.jar wd2\WEB-INF\lib

Linux/Unix

cp $ISCOBOL/eis/wd2/lib/*.jar wd2/WEB-INF/lib cp $ISCOBOL/lib/commons-logging.jar wd2/WEB-INF/lib cp $ISCOBOL/lib/commons-codec-1.9.jar wd2/WEB-INF/lib cp $ISCOBOL/lib/javassist.jar wd2/WEB-INF/lib cp $ISCOBOL/lib/iscobol.jar wd2/WEB-INF/lib cp $ISCOBOL/lib/poi-*.jar wd2/WEB-INF/lib cp $ISCOBOL/lib/xmlbeans-2.6.0.jar wd2/WEB-INF/lib cp $ISCOBOL/eis/wd2/lib/iswd2.jar wd2/WEB-INF/lib cp $ISCOBOL/lib/itext-2.1.7v3.jar wd2/WEB-INF/lib

7.	Copy deployment descriptors and the standard css file from the isCOBOL distribution to the webapp folders as follows:

Windows

copy %ISCOBOL%\eis\wd2\css\iscobol.css wd2\resources\css copy %ISCOBOL%\eis\wd2\xml\*.xml wd2\WEB-INF

Linux/Unix

cp $ISCOBOL/eis/wd2/css/iscobol.css wd2/resources/css cp $ISCOBOL/eis/wd2/xml/*.xml wd2/WEB-INF

8.	Create the "wd2.war" with the following commands:

cd wd2 jar -cf wd2.war *

2. Deploy the war

The following instructions are applicable to Apache Tomcat. However, your webapp could be executed also by other servlet containers.

Download Tomcat from http://tomcat.apache.org/ and install it, if you haven't installed it yet. Start the Tomcat service.

Note: if you're running Tomcat on Unix/Linux, ensure that the working directory is the Tomcat home directory. If you start the process from another directory (e.g. the Tomcat bin directory), then relative paths in the sample will not work.

When Tomcat service is started, open a browser and navigate to "http://127.0.0.1:8080/" . The browser displays something like:

Select Tomcat Manager link in order to application administration pages. You will be prompted for username and password. By default Tomcat has the user "admin" with no password. You can refer to tomcat-users.xml.

Using the Tomcat Web Application Manager, scroll down to the Deploy dialog and use the Browse button to select the Web Application Archive file (wd2.war)

An item called "wd2" will be added to the Applications list.

Edit the file iscobol.properties in classes' folder to insert valid license codes. The following licenses are required:

•	isCOBOL Runtime license (iscobol.license.2017)

•	isCOBOL EIS license (iscobol.eis.license.2017)

To run the sample, open a browser and navigate to "http://127.0.0.1:8080/wd2".