Progress
on the Web


Customizing the WebClient Installation

To customize a Web-enabled WebClient installer, you modify certain lines in the default One-Click Install Web page to run WebClient Initializer or to invoke your application installer directly if you are using an external installer. Running WebClient Initializer leads your user through the next installation step to automatically install your WebClient application.

CAUTION: Any modifications that you make to the WebClient One-Click Install must not interfere with the original operation of the installer. Your modifications can only add functionality to the operations that it performs by default or change the appearance of the page. Any other changes can lead to a WebClient installation with unpredictable results.

You can find a copy of the default WebClient Web page (webclient.htm) in the following location on your Progress installation CD:

webinstall\webclient\web_image\webclient.htm 

To implement one of the supported customizations, you must modify the following webclient.htm fragment. The portions of the fragment you must change appear in bold:

function startInstall(){ 
    // TODO: To run the WebClient Initializer after the WebClient install completes, you 
    // must provide the location (including the file name) of your prowcapc file. To do this, 
    //       remove the "//" at the beginning of the last line of this comment (to uncomment it). 
    //		 Then customize that line by replacing <URL...> with the location and name of your 
    //		 prowcapc file as in this example: 
    // 
    //       ether.SetProperty("ProwcappURL", 
"http://server1/webclient/app_installer/yourapp.prowcapc"); 
    // 
    // ether.SetProperty("ProwcappURL", "<URL to your .prowcapc file>"); 
  	 
    // OR:   If you are using a One-Click application install (implemented using InstallShield 
    //		 V6 or later) you can run it directly after the WebClient install completes by  
    //       providing the location (directory only) of your installer image plus the location  
    //       (including the file name) of your prowcapc file. To do this, remove the "//"  
    //       at the beginning of the last 2 lines of this comment (to uncomment them). 
    //       Then customize those lines by replacing <URL...> with the directory  
    //       containing your application installer image and the location and name of your  
    //       prowcapc file as in this example: 
    // 
    //  		 ether.SetProperty("ApplicationURL", "http://server1/webclient/app_installer"); 
    //  		 ether.SetProperty("ProwcappURL", 
"http://server1/webclient/app_installer/yourapp.prowcapc"); 
    //  
    // ether.SetProperty("ApplicationURL", "<URL to your One-Click app installer 
directory>"); 
    // ether.SetProperty("ProwcappURL", "<URL to your .prowcapc file>"); 
	ether.LegacyMode = true; 
	ether.Play(); 

}

To run WebClient Initializer after the WebClient install, you might customize the startInstall() function to look like this:

function startInstall(){ 
   ether.SetProperty("ProwcappURL", 
      "http://NSSWeb:81/webclient/BakeWare_installer/BakeWareV10.prowcapc"); 
   ether.LegacyMode = true; 
   ether.Play(); 
} 

This customization invokes the Initializer and passes it the specified BakeWareV10.prowcapc file, which will perform the task necessary to install the application.

To directly run your application One-Click Install, if you have one, from the WebClient install, you might customize the startInstall() function to look like this:

function startInstall(){ 
   ether.SetProperty("ApplicationURL",  
      "http://NSSWeb:81/webclient/BakeWare_installer"); 
   ether.SetProperty("ProwcappURL",  
      "http://NSSWeb:81/webclient/BakeWare_installer/BakeWareV10.prowcapc"); 
   ether.LegacyMode = true; 
   ether.Play(); 
} 

This customization first executes your application One-Click Install from the specified BakeWare_installer directory on your Web server at host NSSWeb. It also passes the location of the application configuration file (the specified BakeWareV10.prowcapc file) to the application installer. The application installer can then invoke WebClient Initializer to launch the installed application after completing the application installation.


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