1 mike  1.1 

 2 karl  1.3 The Pegasus WEB Demonstration

 3 mike  1.1 

 4 karl  1.4 $Log: README,v $
 5           Revision 1.3  2001/02/19 21:43:30  karl
 6           namespace creation
 7           
 8           $Author: karl $

 9 karl  1.3 
10           This directory contains the HTML CGI interface to Pegasus. It is used as part
11           of a demonstration of the Pegasus environment through a WEB browser
12           
13           
14           It consists of two subdirectories
15           
16           htdocs - Contains the HTML forms that form the basis of the demonstration. The
17           starting point for the demo is index.html
18           
19           cgi - This directory contains the CGI executables.  This consists of the
20           Pegasus CGIClient.exe program and supporting .DLLs.  We have placed them in
21           this directory despite the fact that they also exist in the PEGASUS_HOME/bin
22           directory to limit exposure to other executables through CGI and to avoid
23           having to have a permanent path the the $PEGASUS_HOME$/bin directory when
24           Apache is executing.
25           
26           This demonstrations uses the HTML pages in htdocs as forms to generate CGI

27 karl  1.4 requests through the WEB Server.  These requests are serviced by the Pegasus
28           CGIClient.exe program (copied to cgi-bin with the Makefile in this directory).
29           CGIClient, in turn converts the CGI forms input to Pegasus CIM Operations C++
30           calls. The Pegasus client library converts the calls to XML conformant with
31           the DMTF CIM Operations over HTTP defintions and passes them to the Pegasus
32           CIM Server.
33           
34           The CIM server responses in XML are converted back to C++ responses at the CGI
35           client (part of the SDK code) and CGI client then make HTML pages out of the
36           responses and passes them back to the WEB server.

37 karl  1.3 
38           NOTE: Today, the Pegasus CIM server and the WEB server must be in the same
39           machine because CGIClient fixes the address and port of the CIM server as
40           
41           	URL - localhost
42           	Port - 8888
43           
44           This will be modified in the future.
45           

46 karl  1.4 To use this demonstration, you must  add definitions to your web server. For
47           example, in Apache, the following defintions in httpd.conf would word if the
48           %PEGASUS_ROOT% was D:/tog/pegasus.

49 mike  1.1 
50               ScriptAlias /pegasus/cgi-bin "D:/tog/pegasus/cgi/cgi-bin"
51               Alias /pegasus/icons "D:/tog/pegasus/cgi/icons"
52               Alias /pegasus "D:/tog/pegasus/cgi/htdocs"
53           
54               <Directory "D:/tog/pegasus/cgi/cgi-bin">
55               AllowOverride None
56               Options ExecCGI
57               allow from all
58               </Directory>

59 mike  1.2 
60           To use the CGI interface, type "make" in this directory. Next run the

61 karl  1.3 Server like this:
62           
63               C:\> Server <pegasus-run-directory>

64 mike  1.2 

65 karl  1.3     where <pegasus-run-directory> is required only if PEGASUS_HOME environment
66               variable is not defined.

67 mike  1.2 
68           Then go to your browser and type in this URL:
69           
70               http://<yourhost>/pegasus

71 karl  1.3 
72               Thus if the browser is on the same machine, enter localhost/pegasus
73           
74           This demonstration can be used either locally or from a remote browser

75 karl  1.4 

76 karl  1.3