Running the sample application
webDirect 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\excel 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/excel 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 %ISCOBOL%\sample\eis\wd2\widget\css\custom.css wd2\resources\css copy %ISCOBOL%\sample\eis\wd2\widget\images\* wd2\WEB-INF\programs copy %ISCOBOL%\sample\eis\wd2\widget\snippet\* wd2\arc copy %ISCOBOL%\sample\eis\wd2\widget\index.html wd2 copy %ISCOBOL%\sample\eis\wd2\widget\iscobol.properties wd2\WEB-INF\classes copy %ISCOBOL%\sample\eis\wd2\widget\*.class wd2\WEB-INF\programs |
Linux/Unix
cp $ISCOBOL/sample/eis/wd2/widget/css/custom.css wd2/resources/css cp $ISCOBOL/sample/eis/wd2/widget/images/* wd2/WEB-INF/programs cp $ISCOBOL/sample/eis/wd2/widget/snippet/* wd2/arc cp $ISCOBOL/sample/eis/wd2/widget/index.html wd2 cp $ISCOBOL/sample/eis/wd2/widget/iscobol.properties wd2/WEB-INF/classes cp $ISCOBOL/sample/eis/wd2/widget/*.class wd2/WEB-INF/programs |
6. Copy the isCOBOL runtime and webDirect 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 can also be executed 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.2019)
• isCOBOL EIS license (iscobol.eis.license.2019)
To run the sample, open a browser and navigate to "http://127.0.0.1:8080/wd2".
