Kbase P79561: Step-by-step document to help you configure the WebClient 9.1x
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
5/6/2004 |
|
Status: Unverified
GOAL:
Step-by-step document to help you configure the WebClient 9.1x
FIX:
This is a step-by-step document to help you configure the WebClient 9.1x for the sports2000 application.
This document assumes you have already set up the Java Servlet Engine and the Progress AppServer Internet Adapter (AIA), and they are working properly.
Installing and Running the WebClient Sample Application
The Sports 2000 WebClient sample application provides instructions in a file (sports2000directions.txt) that are not complete. To install and run the WebClient sample application, follow these instructions to set up your 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 your Progress installation directory is d:\progress on any machine where you have Progress installed.
Preparing Your Web Server and Network Environment
There are instructions for setting up your Web Server and the Java Servlet Engine (JSE) on your Web server provided in Appendix C, "Steps to Deploy a WebClient Application," of "Progress on the Web" guide.
There are also some Progress Solutions with guidelines to setup the JSE to work with the AppServer Internet Adapter (AIA):
How to setup Jrun 3.0 with AIA 9.1 on a Unix Platform
Setting up Jrun 3.0 with AIA 9.1
Setting up ServletExec 3.0 with AIA 9.1 on Windows
Installing the Webclient installation files
To complete the configuration, you have to install the Webclient installation files. These is NOT the Webclient installation itself, but a group of files installed by webinst.exe (from the PROGRESS installation CD). These files are not installed automatically and include both the WebClient and the Sports 2000 WebClient sample application installation images. The instructions will assume you have installed it under d:\WebInstallDir.
Run webinst.exe from a PROGRESS installation CD to install the files.
Setting up MIME Types on the Web Server
You have also to configure MIME Types on your Web server for the ProwcApp file:
File type extension : .prowcapp
MIME type : application/progress-wcapp
If you are using Web Server IIS (or Personal Webserver), all you need to do 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
WebInstallDir\web_image\webclient).
For other Web servers, see manual Progress on web - 2.7.2 Setting the
ProwcApp File MIME Type, for details.
Setting Up the Application on Your AppServer Machine
Follow these steps to set up the application on your AppServer:
1. Verify that you have installed and configured the Progress AppServer on your AppServer machine.
2. Copy the sports2000 application files to the working directory of your AppServer (for example, d:\ASWorkDir) from the following Progress installation subdirectories. These files are installed when you do a COMPLETE installation of a Progress Development product:
d:\progress\src\sports2000\gui\*.* to ASWorkDir
3. Copy the sports2000 application images to the images subdirectory of your AppServer working directory:
d:\progress\src\sports2000\images\*.* to ASWorkDir\images
4. Create a copy of the sports2000.db database on the AppServer machine. You can put this database 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 App.Server 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 you 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 your 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 your Web server:
1. Copy the following files to the document root directory on your Web server: ( WebInstallDir is the directory where you have installed the WebClient installation files (from webinst.exe) and c:\inetpub\wwwroot is your Web server document root (Web server dependent)):
* WebInstallDir\web_image\sports2000\*.* to c:\inetpub\wwwroot\sports2000
* WebInstallDir\web_image\webclient\*.* to c:\inetpub\wwwroot\webclient
2. In c:\inetpub\wwwroot\webclient, set up the webclient.htm file to automatically install the application after installing the WebClient.
The comments in this file describe two methods for installing the application:
1) Using the WebClient Initializer or
2) Running the One-Click application install directly.
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 your .prowcapp file> to
http://MyWebServer/sports2000/sports2000.prowcapp, where MyWebServer is the domain name / IP address of your Web server.
For example:
ether.SetProperty("ApplicationURL", "http://pctest/sports2000");
ether.SetProperty("ProwcappURL", "http://pctest/sports2000/sports2000.prowcapp");
These changes allow you to install the WebClient and the Sports2000 sample application on the client machine.
3. In c:\inetpub\wwwroot\sports2000, make the following changes:
* bootstrap.htm - On Windows, use Wordpad, not Notepad to edit this file. Wherever MyWebServer appears in the file, replace it with the domain name / IP address of your Web server.
For example:
document.location.href =
"http://pctest/sports2000/sports2000.prowcapp";
window.location = "http://pctest/webclient/webclient.htm";
* sports2000.prowcapp - Use the ProwcApp Editor PRO*Tool in the Progress ADE to change this file. Wherever YourDomainName appears in the Application and WebClient tabs, replace it with the domain name / IP address of your Web server. In the WebClient tab, replace progresswebclient with webclient.
These changes allow you to launc.h the application once it is installed on a client machine.
4. Make sure that you have configured and started an instance of the AppServer Internet Adapter (AIA) to run as a Java servlet in your JSE and access your asbroker1 AppServer. For more information, see Appendix C, "Steps to Deploy a WebClient Application," and Chapter 3, "AppServer Internet Adapter," of Progress on the Web.
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 your Web server:
http://YourDomainName/sports2000/bootstrap.htm
OR
http://YourDomainName/sports2000/sports2000.prowcapp
For example:
http://pctest/sports2000/bootstrap.htm
2. Follow the instructions and accept the defaults to install the WebClient and the Sports 2000 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: You do not normally have to do this step for a typical application that you build and deploy yourself because you have already coded the correct connection URL 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.1B->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 you can find the appsrvtt.d file.
* Edit the appsrvtt.d file and change yourservername in the following string to the domain name of the Web server where you run the AIA:
"http://yourservername/aia/Aia?AppService=sports2000partition"
After changing this string, appsrvtt.d looks like this, where pctest is the domain name of your Web server:
"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 your client Web browser, enter the following URL to launch the application:
http://YourDomainName/sports2000/bootstrap.htm
OR
http://YourDomainName/sports2000/sports2000.prowcapp
For example:
http://pctest/sports2000/bootstrap.htm
The Sports 2000 sample application should now run on your client machine..