Progress
on the Web


Setting Up the Application on the AppServer Machine

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

NOTE: This example assumes that the AppServer machine is the same as the development machine on which you prepare the front-end and back-end application code. For this reason, this machine must be a Windows machine.

  1. 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 installation or the custom installation.
  2. Verify that a Progress AppServer has been installed and configured on the AppServer machine.
  3. Create the WebClient application root directory, the symbol for which is %APPROOTDIR%. The application root directory can reside anywhere, but note its path.
  4. Recursively copy the source-code files of the Sports2000 application from the %DLC%\src\sports2000\gui directory to %ASWORKDIR%.
  5. NOTE: The gui directory contains both back-end and front-end application files. %ASWORKDIR% is where the entire application will be compiled, though only the back-end r-code (.r) files will be run from this directory.

  6. Create a copy of the Sports2000 database on the AppServer machine. The copy can reside anywhere, but be sure to note its path.
  7. Start a Progress session. Within the Progress session:
    1. Connect to the Sports2000 database, entering its path, which you noted in Step 5.
    2. Use the PROPATH Editor to add the AppServer work directory to the PROPATH.
    3. In the Application Compiler, go to Options Compiler, change “Minimize R-code size” to YES, change Generate MD-5 to YES, and click OK. In the main window, click Modify. In the File Specification window, enter the AppServer’s working directory, click OK, and compile the application.
  8. Recursively copy the following directories as specified below, creating the destination subdirectory as necessary:
    Recursively Copy This Directory
    To This Location
    %ASWORKDIR%\gui 
    
    %APPROOTDIR%\appl  
    
    %DLC%\gui\adm2  
    
    %APPROOTDIR%\gui\adm2 
    
    %DLC%\jms  
    
    %APPROOTDIR%\jms 
    
    %DLC%\src\sports2000\images 
    
    %APPROOTDIR%\appl\images 
    
  9. Copy the following files as specified below, creating the destination subdirectory as necessary:
    Copy This File
    To This Location
    %DLC%\src\samples\webclient\dynappdel\sportspro.ini 
    
    %APPROOTDIR% 
    
    %DLC%\src\samples\webclient\dynappdel\appsrvtt.d 
    
    %APPROOTDIR% 
    
    %DLC%\src\samples\webclient\dynappdel\sportspro.wcp  
    
    %APPROOTDIR% 
    
    %DLC%\gui\adecomm.pl  
    
    %APPROOTDIR%\gui 
    
    %DLC%\gui\adeicon.pl  
    
    %APPROOTDIR%\gui 
    
    %DLC%\gui\adexml.pl  
    
    %APPROOTDIR%\gui 
    
    %DLC%\gui\adeicon\progress.ico  
    
    %APPROOTDIR% 
    
    %DLC%\bin\system\csspin32.ocx  
    
    %APPROOTDIR% 
    
  10. Use a text editor to modify the appsrvtt.d file, which you copied in Step 8, as follows:
    1. In appsrvtt.d, search for the following string:
    2. http://yourservername/aia/Aia?AppService=sports2000partition

    3. In the string, change yourservername to the domain name of the Web server running the AIA. For example, if the domain name of the Web server running the AIA is http://testhost, modify the string to appear as follows:
    4. http://testhost/aia/Aia?AppService=sports2000partition

    5. Save appsrvtt.d.
  11. Use the WebClient Application Assembler as follows:
    1. From the main menu, select File Open, and open %APPROOTDIR%\sportspro.wcp.
    2. On the General tab, change the path of the application root directory to its actual path on the AppServer machine. The default value is d:\demo91c\sportspro.
    3. On the same tab, click on the Locator button. The Configuration File Locator Definition window appears. In this window, change the URL to the host name of the server hosting the configuration file, which defaults to http://yourhostname.
    4. In the Codebase Locator Definition window
      (main menu Deployment Locators Codebase), change the URL to the
      host name of the server hosting the codebase, which defaults to http://yourhostname.
    5. On the Options tab, check the System Tasks toggle box and click the System Tasks Definition button. The System Tasks Definition window appears.
    6. On the Shortcut tab, check the Application Shortcut toggle box and click
      the ellipsis (...) button next to the Icon field. The Open window appears.

      Manipulate the Open window to select the progress.ico file, which you copied to %APPROOTDIR% in Step 7.

      On the Files tab, select the file d:\demo91c\sportspro\csspin32.ocx and click the Remove button. Then, add the file %APPROOTDIR\csspin32.ocx. Finally, confirm that the Application Specific toggle box is checked.

    7. Save sportspro.wcp.
    8. In the Generate window (main menu Deployment Generate), then choose Regenerate Latest Version. In the Output Directory field, enter the name of the directory where you want the generated files to be placed — that is, the value of %OUTDIR%. Finally, click OK.
    9. The Application Assembler creates the application configuration file and the cabinet files and places them into the output directory you specified.

  12. Use the proserve command or the Progress Explorer to start a database server for the Sports2000 database running on the AppServer machine. For example, if the Sportspro2000 database resides at %APPROOTDIR%\databases, use a command similar to the following:
    %DLC%\bin\proserve %APPROOTDIR%\databases\sports20000.db  
    
  13. Use the Progress Explorer to configure the default asbroker1 AppServer instance as follows:
    1. In the General Options for Broker tab:
    2. Change the broker working directory to the AppServer work directory (%ASWORKDIR%).

      In the Appservice Name list, add the service name sports2000partition.

    3. In the General Options for Server tab:
    4. Add the database connection parameter to Server Startup Parameters. For example if the Sports2000 database resides at %ASWORKDIR%\databases, enter the following string:

      -db %ASWORKDIR%\databases\sports2000

  14. Use the Progress Explorer or the asbman command to start the asbroker1 AppServer instance. For example (using the asbman command):
    %DLC%\bin\asbman -name asbroker1 -start 
    

Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095