(file) Return to readme.txt CVS log (file) (dir) Up to [Pegasus] / pegasus / Attic

Diff for /pegasus/Attic/readme.txt between version 1.18 and 1.21

version 1.18, 2004/03/10 17:52:07 version 1.21, 2004/07/16 07:50:42
Line 22 
Line 22 
 8.  Populate the Repository 8.  Populate the Repository
 9.  The MU Utility 9.  The MU Utility
 10. Notes about Building Pegasus on Linux 10. Notes about Building Pegasus on Linux
 11. Notes on building Pegasus with SSL  11. Notes about Building Pegasus on Mac OS X/Darwin
 12. Building Pegasus on Windows 2000 or Windows XP With Microsoft Visual C++  12. Notes on building Pegasus with SSL
 13. Installing the Pegasus HTML Test Client  13. Building Pegasus on Windows 2000 or Windows XP With Microsoft Visual C++
 14. Development with Pegasus and Pegasus Tools  14. Installing the Pegasus HTML Test Client
 15. Commands  15. Development with Pegasus and Pegasus Tools
 16. Creating SSL certifications.  16. Commands
 17. Configuring Pegasus to use SSL  17. Creating SSL certifications.
 18. Configuring Pegasus to use PAM  18. Configuring Pegasus to use SSL
 19. Testing with ICU enabled  19. Configuring Pegasus to use PAM
 20. Documentation  20. Testing with ICU enabled
 21. Participate  21. Documentation
   22. Participate
  
  
  
Line 192 
Line 193 
     will be required to have these tools. They are only required if changes need     will be required to have these tools. They are only required if changes need
     to be made to the files for parsing and compiling.     to be made to the files for parsing and compiling.
  
 4.  DOC++ - The Pegasus documentation is taken from a combination of text files  
   4.  DLCOMPAT - dlcompat is a dlopen(3) et.al. compatibility library for
       Mac OS X/Darwin.
   
       NOTE: The dlcompat is not distributed with pegasus source.
   
       dlcomapt is available from
   
       http://www.opendarwin.org/projects/dlcompat/
   
       Again, dlcomapt needs to be installed ONLY if you are using Mac OS X/Darwin.
   
   
   5.  DOC++ - The Pegasus documentation is taken from a combination of text files
     and the Pegasus header files themselves.  This documentation is formatted     and the Pegasus header files themselves.  This documentation is formatted
     with DOC++ and GAWK.  These tools are required if the documentation is to     with DOC++ and GAWK.  These tools are required if the documentation is to
     be recreated but we expect that only the core team will be recreating     be recreated but we expect that only the core team will be recreating
Line 299 
Line 313 
  
     These include GNU Make, MU.EXE (if using Windows), Flex, and Bison (Flex     These include GNU Make, MU.EXE (if using Windows), Flex, and Bison (Flex
     and Bison only required if changes will be made to the MOF compiler or WQL     and Bison only required if changes will be made to the MOF compiler or WQL
     parser).      parser),dlcompat (if using Mac OS X/Darwin).
  
     Be sure these are on your path.     Be sure these are on your path.
  
Line 458 
Line 472 
 No problem. Just make sure you have the environment variables set. No problem. Just make sure you have the environment variables set.
  
  
 11. Notes about Building Pegasus with SSL  11. Notes about Building Pegasus on Mac OS X/Darwin
   =====================================================
   
   No problem. Just make sure you have the environment variables set.
   
   
   12. Notes about Building Pegasus with SSL
 ========================================== ==========================================
  
 To build with SSL you need the OpenSSL libraries and header files. Make sure To build with SSL you need the OpenSSL libraries and header files. Make sure
Line 471 
Line 491 
 certificates" for more information of how to use SSL. certificates" for more information of how to use SSL.
  
  
 12. Building Pegasus on Windows 2000 (SP3 or later recommended) or Windows XP  13. Building Pegasus on Windows 2000 (SP3 or later recommended) or Windows XP
     With Microsoft Visual C++     With Microsoft Visual C++
 ====================================================================== ======================================================================
  
Line 498 
Line 518 
     REM setup the path to the runtime files.     REM setup the path to the runtime files.
     set path=%path%;%PEGASUS_HOME%/bin     set path=%path%;%PEGASUS_HOME%/bin
  
 13. Installing the Pegasus HTML Test Client:  14. Installing the Pegasus HTML Test Client:
 ============================================= =============================================
  
 This is a separate test tool that allows Pegasus requests to be initiated from This is a separate test tool that allows Pegasus requests to be initiated from
Line 508 
Line 528 
 readme in the CGI directory. readme in the CGI directory.
  
  
 14. Development with Pegasus and Pegasus Tools:  15. Development with Pegasus and Pegasus Tools:
 ================================================ ================================================
  
 ATTN: This section needs to be completed.  It should reference the more ATTN: This section needs to be completed.  It should reference the more
Line 516 
Line 536 
 ATTN: Write about providers? ATTN: Write about providers?
  
  
 15. Commands:  16. Commands:
 ============= =============
  
 The manpages for each of the commands are in rpm/manLinux/man1.Z directory (on CVS) The manpages for each of the commands are in rpm/manLinux/man1.Z directory (on CVS)
Line 532 
Line 552 
 bin/tomof CIM_Config (extract CIM_Config from repository and present it in MOF type) bin/tomof CIM_Config (extract CIM_Config from repository and present it in MOF type)
  
  
 16. Creating SSL certifications  17. Creating SSL certifications
 ================================ ================================
  
 Please follow section 11, titled "Notes about Building Pegasus with SSL" Please follow section 11, titled "Notes about Building Pegasus with SSL"
Line 559 
Line 579 
 cp $PEGASUS_HOME/cert.pem $PEGASUS_HOME/client.pem cp $PEGASUS_HOME/cert.pem $PEGASUS_HOME/client.pem
 rm $PEGASUS_HOME/key.pem $PEGASUS_HOME/cert.pem rm $PEGASUS_HOME/key.pem $PEGASUS_HOME/cert.pem
  
 17. Configuring Pegasus to use SSL  18. Configuring Pegasus to use SSL
 ================================ ================================
  
 Please follow section 11 and 16 before reading this section. Please follow section 11 and 16 before reading this section.
  
 To configure Pegasus to take advantage of SSL, configure To configure Pegasus to take advantage of SSL, configure
 cimserver_planned.conf to have:  CIMserver to have the following configuration options set to:
  
         sslTrustFilePath=client.pem         sslTrustFilePath=client.pem
         sslCertificateFilePath=server.pem         sslCertificateFilePath=server.pem
Line 573 
Line 593 
         httpsPort=5989         httpsPort=5989
         enableHttpsConnection=true         enableHttpsConnection=true
  
   using the 'cimconfig' utility:
   
           cimconfig -p -s enableHttpsConnection=true
   
 (The client.pem and server.pem are the certifications (The client.pem and server.pem are the certifications
 files created per the steps in the earlier section). files created per the steps in the earlier section).
  
 For good riddance you might consider closing down For good riddance you might consider closing down
 the cleartext 5988 port. Modify your cimserver_planned.conf  the cleartext 5988 port. Modify your CIMserver to
 to include:  (using 'cimconfig') to have the option:
  
         enableHttpConnection=false         enableHttpConnection=false
  
 18.PAM Authentication  19.PAM Authentication
 =================== ===================
  
 In order to use PAM Authentication you have to compile Pegasus In order to use PAM Authentication you have to compile Pegasus
Line 599 
Line 623 
  a).  Copy the rpm/wbem file in-to /etc/pam.d directory.  a).  Copy the rpm/wbem file in-to /etc/pam.d directory.
       This notifies PAM what kind of libraries to use when authenticating       This notifies PAM what kind of libraries to use when authenticating
       Pegasus.       Pegasus.
  b).  Edit  cimserver_planned.conf to include:   b).  Modify CIMserver configuration options:
  
         usePAMAuthentication=true         usePAMAuthentication=true
         enableAuthentication=true         enableAuthentication=true
Line 607 
Line 631 
       And if you want to allow 'root' (*not recommended*)       And if you want to allow 'root' (*not recommended*)
         enableRemotePrivilegedUserAccess=true         enableRemotePrivilegedUserAccess=true
  
         using the 'cimconfig' operation, such as:
   
           cimconfig -p -s usePAMAuthentication=true
   
 The user is authenticated using HTTP Basic method, thererfore it is The user is authenticated using HTTP Basic method, thererfore it is
 strongly suggested you use SSL connection instead of normal HTTP connection. strongly suggested you use SSL connection instead of normal HTTP connection.
 Refer to section 16 for more details on creating and using SSL keys. Refer to section 16 for more details on creating and using SSL keys.
  
 19. Testing with ICU enabled:  20. Testing with ICU enabled:
 ============================== ==============================
  
 ICU (International Compoments for Unicode) refers to the set of libraries that ICU (International Compoments for Unicode) refers to the set of libraries that
Line 638 
Line 666 
 If this variable is left defined, Pegasus will not be able to load messages If this variable is left defined, Pegasus will not be able to load messages
 using ICU resource bundles. using ICU resource bundles.
  
 20. Documentation:  21. Documentation:
 =================== ===================
  
 The documentation is currently in preperation. The preliminary documentation The documentation is currently in preperation. The preliminary documentation
Line 652 
Line 680 
 design documentation. design documentation.
  
  
 21. Participate!  22. Participate!
 ================= =================
  
 We are looking for people who want to join the Pegasus work group and We are looking for people who want to join the Pegasus work group and

Legend:
Removed from v.1.18  
changed lines
  Added in v.1.21
No CVS admin address has been configured
 Powered by
ViewCVS 0.9.2