Login

Consultor Eletrônico



Kbase 21026: 9.1x WebClient Sample Application Without IntelliStream
Autor   Progress Software Corporation - Progress
Acesso   Público
Publicação   1/28/2005
Status: Unverified

GOAL:

How to setup a Webclient Sample Application without IntelliStream

GOAL:

How to set up Webclient sports2000 demo without IntelliStream

FACT(s) (Environment):

Progress 9.1x
Windows 32 Intel

FIX:

This document assumes the Java Servlet Engine and the Progress AppServer Internet Adapter (AIA) have already been setup, and they are working properly.

Installing and Running the WebClient Sample Application
-------------------------------------------------------

To install and run the WebClient sample application, follow these instructions to set up the environment and run the application:

* Preparing Your Web server and network environment
* Setting up the application on your AppServer machine
* Setting up the application on your Web server machine
* Installing and running the application on a client machine

The following instructions use Windows pathnames and assume that the Progress installation directory is d:\progress on any machine where Progress is installed.

Preparing Your Web Server and Network Environment
-------------------------------------------------

There are instructions for setting up your Web Server and the Java Servlet Engine (JSE) on the Web server provided in Appendix F, "Configuring Web Servers and Java Servlet Engines" of " Version 9 Product Update Bulletin" Guide.

There are also some Progress solutions with guidelines to setup the JSE to work with the AppServer Internet Adapter (AIA):

20524 - How to setup Jrun 3.0 with AIA 9.1 on a UNIX Platform
20210 - Setting up Jrun 3.0 with AIA 9.1
20189 - Setting up ServletExec 3.0 with AIA 9.1 on Windows

Webclient installation files
-------------------------------------------

Progress 9.1C CDROM has a directory called WEBINSTALL which contains files to install WebClient and Sportspro application.

Create a directory under the Web Server root directory and copy all files from the WEBINSTALL\webclient\web_image (in the Progress CDROM) into it. If IIS Web Server is being used, the root directory is C:\InetPub\wwwroot, by default.
Refer to your Web Server's documentation to determine the exact location.

Also create another directory called sports2000 under the Web Server root directory and copy all the files under CDROM:\WEBINSTALL\SPORTS2000\Web_image into it.


Setting up MIME Types on the Web Server
---------------------------------------

MIME Types need to be configured on the Web server for the ProwcApp file:

File type extension : .prowcapp
MIME type : application/progress-wcapp

If Web Server IIS (or Personal Webserver) is being used, all that needs to be done is to run the 2 registry files that comes with the Webinstall installation files (from the previous section ). These files are hkclaswc.reg and hkloclwc.reg under the WEBINSTALL\web_image\webclient) directory.

For other Web servers, see manual "Progress on Web" - 7.4.4 Configuring MIME Types for Your Web Server section, for details.


Setting Up the Application on the AppServer Machine
----------------------------------------------------

Follow these steps to set up the application on the AppServer:

1. Verify that the Progress AppServer has been installed and configured on the AppServer machine. Also, verify that a Progress development product has been installed on the AppServer machine and that the person doing the installation, when presented with the Setup Type window, chose the complete installation, as opposed to the typical or custom installation.

2. Copy the sports2000 application files to the AppServer working directory (for example, d:\ASWorkDir) from the following Progress installation subdirectories. These files are installed when a COMPLETE installation of a Progress Development product is done:

d:\progress\src\sports2000\gui\*.* to ASWorkDir

3. Copy the sports2000 application images to the images subdirectory of the AppServer working directory:

d:\progress\src\sports2000\images\*.* to ASWorkDir\imag.es

4. Create a copy of the sports2000.db database on the AppServer machine. This database can be put anywhere on the machine, but note the full path, for example:

d:\wrk91b\sports20000.db

5. Using the proserve command or the Progress Explorer tool, start a database server for the sports2000 database running on the AppServer machine, for example (using proserve at a command prompt):

d:\progress\bin\proserve d:\wrk91b\sports20000.db

8. Compile the entire back-end sports2000 application that was copied in Step 2 in the working directory of your AppServer.

Start a Progress session connecting to the sports2000 database. Go to Pro*tools and add the ASWorkDir directory (with the correct path) to the PROPATH. Open the Application compiler, go to Options -> Compiler and change "Minimize R-code size" to YES (this is optional). Click on OK. At the Main screen, click on modify, and changed it to the ASWorkDir directory (the correct path). Apply this and compile the application.

9. Using the Progress Explorer Tool, configure the default asbroker1 AppServer instance as follows:

Configure asbroker1 from the Progress Explorer Tool.
1 - Under BROKER:
a)General tab: Change the broker working directory to the ASWorkDir directory;
b)Appservice Name list: Add the service name sports2000partition;

2- Under SERVER:
a) Add the database connection parameter on "Server Startup parameters", for example -db d:\wrk91b\sports2000

10. Using the Progress Explorer Tool, configure and start up the
controlling NameServer instance for the asbroker1 AppServer.

11. Start up the asbroker1 AppServer instance.

Setting Up the Application to Launch from Your Web Server Machine
-----------------------------------------------------------------

Follow these steps to set up the application to launch from the Web
Server (c:\inetpub\wwwroot represents your web server root directory):

1. In c:\inetpub\wwwroot\webclient, edit webclient.htm to automatically install the application after installing the WebClient. file (On Windows, use Wordpad, not Notepad to edit the files below referenced.)

Uncomment the lines in this file to use the second (2nd) method and
launch the application install. Change <URL to your One-Click app
installer directory> to http://MyWebServer/sports2000, and change <URL to the .prowcapp file> to http://MyWebServer/sports2000/sports2000.prowcapp, where MyWebServer is the domain name /IP address of the Web server.

For example:
ether.SetProperty("ApplicationURL", "http://pctest/sports2000");
ether.SetProperty("ProwcappURL", "http://pctest/sports2000/sports2000.prowcapp");

These changes allow the installation of the WebClient and the Sportspro
sample application on the client machine.

2. Under the same directory, edit bootstrap.htm - Wherever MyWebServer appears in the file, replace it with the domain name / IP address of the Web server.

For example:
document.location.href = "http://pctest/sports2000/sports2000.prowcapp";
window.location = "http://pctest/webclient/webclient.htm";

3. In the Web server document root directory's sports2000 subdirectory, edit the sports2000.htm file, uncommenting the line containing the prowcapc entry, and including the domain name or IP address of the Web server and the name of the application configuration file.

For example:
ether.SetProperty("ProwcappURL", "http://pctest/sports2000/sports2000.prowcapc");

4. Start a Progress session, run Pro*Tool and select the WebClient Application Assembler to generate a customized sports2000.prowcapp file. To do this:

a) Copy WEBINSTALL\sports2000\sports2000.wcp from the CDROM to any directory.
b) Open the file with the Application Assembler.
c) Modify the f.ollowing URLS:
- the URL of your configuration file specified in the Configuration File Locator Window. For example,
http://pctest/sports2000

- the URL of the WebClient install on the WebClient tab. For example:
http://pctest/webclient/webclient.htm;

- the URL for your application install specified on the Options tab. For example, http://pctest/sports2000/sports2000.htm

d) From the Application Assembler's main menu, choose Deployment> Generate. Enter an output directory and a version name (for example, v1) and click OK to generate a new configuration
file.

e) Copy the sports2000.prowcapc configuration file from the output directory specified to the sports2000 directory under the Web server document root directory.

5. Make sure that an instance of the AppServer Internet Adapter (AIA) has been configured and started to run as a Java servlet in your JSE and access your asbroker1 AppServer.
For more information, see Appendix F, " AppServer Internet Adapter" of " Version 9 Product Update Bulletin" Guide.


Installing and Running the Application on a Client Machine
----------------------------------------------------------

Follow these steps to install and launch the application on a client machine:

1. Open a Web browser (IE or Netscape 4.x or newer) and go to the following URL, replacing YourDomainName with the domain name of the Web server:

http://YourDomainName/webclient/bootstrap.htm

OR

http://YourDomainName/webclient/sports2000.prowcapc

For example:
http://pctest/webclient/bootstrap.htm


2. Follow the instructions and accept the defaults to install the WebClient and the Sports2000 application. The application then attempts to launch but fails because the application does not yet know the connection URL to your AppServer.

3. Specify the connection URL to the AppServer in the appsrvtt.d file that is installed with the application. (Note: The user does not normally have to do this step for a typical application that is built and deployed by themselves because the correct connection URL has already been coded prior to installation.) To modify the file, complete these tasks:

* Locate the application installation folder by running the WebClient Application Manager:

* Start->Programs->PSC WebClient 9.1C->Progress WebClient Application Manager.

* Click the Applications tab, select the application in the list, and click the Edit button. The Application Folder field displays the folder where the application is installed and where the appsrvtt.d file can be found.

* Edit the appsrvtt.d file and change yourservername in the following string to the domain name of the Web server where the AIA is run:

"http://yourservername/aia/Aia?AppService=sports2000partition"

After changing this string, appsrvtt.d looks like this, where pctest is the domain name of the Web server used:
"jms1" "localhost" "5162" yes yes "localhost:2506"
"adapter.progress.jms" "J" "" "sports2000partition"
"localhost" "5162" no no "" "asbroker1" "A"
"http://pctest/aia/Aia?AppService=sports2000partition"

* Save the file.

4. In the client Web browser, enter the following URL to launch the application:
http://YourDomainName/webclient/bootstrap.htm

OR

http://YourDomainName/webclient/sports2000.prowcapc

For example:
http://pctest/webclient/bootstrap.ht.m

The Sportspro sample application should now run on the client machine..