This is a document that describes the steps to test the Pegasus 
CIMOM, and its providers on AIX.  

This file is written based on Pegasus CIMOM version 1.09. 

All of the following steps need to be run as root.

A. Install pegasus-1.0-9.aix5.1.ppc.rpm in the /opt/freeware/cimom/pegasus-1.0/
--> rpm -ivh pegasus-1.0-9.aix5.1.ppc.rpm


B. Running Pegasus on AIX

1. Set the Pegasus environment variables on the machine you are
installed Pegasus CIMOM: 
 
export PEGASUS_HOME=/opt/freeware/cimom/pegasus-1.0/
export PEGASUS_ROOT=$PEGASUS_HOME

2. Modify /usr/HTTPServer/conf/httpd.conf according to the README file
   under $PEGASUS_HOME/cgi/:
 
To use this demonstration, you must add definitions to your web server. For
example, in Apache, the following defintions in httpd.conf would word as
follows if $PEGASUS_ROOT is /opt/freeware/cimom/pegasus-1.0/

    ScriptAlias /pegasus/cgi-bin "/opt/freeware/cimom/pegasus-1.0/cgi/cgi-bin"
    Alias /pegasus/icons "/opt/freeware/cimom/pegasus-1.0/cgi/icons"
    Alias /pegasus "/opt/freeware/cimom/pegasus-1.0/cgi/htdocs"

    <Directory "/opt/freeware/cimom/pegasus-1.0/cgi/cgi-bin">
    AllowOverride None
    Options ExecCGI
    allow from all
    </Directory>

3. Restart the Http server:
/usr/HTTPServer/bin/apachectl restart

4. Test the Pegasus CIMOM:
   a. Start cimserver
   > cimserver

   b. Start the browser as root, start CGIClient on the browser:
   go to your browser and type in this URL:

   http://<yourhost>/pegasus

   This demonstration can be used either locally or from a remote browser.
   
5. Please find details about the Pegasus CIMOM design and build information 
   from /usr/doc/pegasus-1.0/readme.txt.


C. Test Pegasus sample CIM providers and AIX providers.

Once the pegasus rpm is installed, pegasus sample providers and AIX 
providers are created under the $PEGASUS_HOME/lib/ directory. Pegasus
sample providers are: libSampleInstanceProvider.so, libSampleMethodProvider.so,
libSamplePropertyProvider.so, libSampleQueryProvider.so. AIX providers
are: libAIXOSProvider.so.  
 
At the time this document is written, only the Instance Provider 
is successfully tested with both the CGIClient and the test tool 
TestClient. Method Provider is not implemented in CGIClient, but can 
be tested with TestMethod, TestClient, InvokeMethod and InvokeMethod2 
tools. All of these test tools are provided by Pegasus and can be found 
in $PEGASUS_HOME/bin/. Association and Property providers are not 
implemented at this time in the Pegasus CIMOM.

1. Populate the CIM repository. 
   The Pegasus standard mof files are located under 
   $PEGASUS_HOME/Schemas/CIM26Prelim/ directory. The Pegasus CIM sample 
   provider mofs are located under $PEGASUS_HOME/Schemas/sample/, and 
   AIX provider mofs are located under $PEGASUS_HOME/Schemas/AIX/. Run the 
   /opt/freeware/cimom/pegasus-1.0/bin/loadmof.bat script, and ignore
   any warnings. 
 
   These commands create $PEGASUS_HOME/repository/ where all of the
   CIM classes are loaded under the namespaces: root, root#cimv2, 
   root#PG_Internal, root#PG_InterOp, root#SampleProvider, root#AIXProvider.
   Issue cimmofl with -h option to see the usage of cimmofl.

2. Running Instance Providers on CGIClient:
   a. start cimserver:
   b. on the browser, type in this URL:
    
   http://<yourhost>/pegasus
     
   c. Under Instance, select "Get Instance", 
      input "root/SampleProvider" for NameSpace, 
      "Sample_InstanceProviderClass.Identifier=1" for InstanceName

      Under Instance, select "Enum Names", 
      input "root/SampleProvider" for NameSpace,
      "Sample_InstanceProviderClass" for ClassName 

3. Test sample AIX provider.

To test the AIX_OperatingSystem instance provider on CGIClient:

1. select Class->Get Class, root/AIXProvider for NameSpace and 
   AIX_OperatingSystem for ClassName. 
2. Instance->Get Instance and input "AIX_OperatingSystem" for 
   InstanceName, then click submit button. This will create and 
   load all of the instances of the class. 
3. Select Instance->Enum Names and input "root/AIXProvider" for 
   NameSpace, and "AIX_OperatingSystem" for ClassName, and click 
   on "Submit Request". 


D. Trouble-shooting and notes

1. In modifying the CIM class repository or the providers, the 
   cimserver need to be restarted for the change to take effect. 
