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

Diff for /pegasus/Attic/readme.txt between version 1.6 and 1.10.4.1

version 1.6, 2001/05/22 12:48:06 version 1.10.4.1, 2003/06/18 13:29:50
Line 1 
Line 1 
 Pegasus - A Manageability Services Broker for the DMTF CIM/WBEM Standards  
  
 Author: Mike Brasher, Karl Schopmeyer  OpenPegasus - A Manageability Services Broker for the DMTF CIM/WBEM Standards
   
 Version 0.97  
 May 20 2001  
  
 ------------------------------------------------------------------------------  Author: Mike Brasher, Karl Schopmeyer
 --  
   
 $Log$  
 Revision 1.6  2001/05/22 12:48:06  karl  
 change install and ACE comments  
  
 Revision 1.5  2001/02/26 10:36:34  karl  Tagline: OpenPegasus is an object manager for DMTF CIM objects written in C++
 Clean Up Text           and supported by The Open Group
  
 Revision 1.4  2001/01/26 20:20:36  karl  STATUS: Revised June 2003 to match Pegasus release 2.2
 Clean up Readme with MB comments  Contents:
   =========
   
   1.  Overview
   2.  Availability of Pegasus
   3.  Pegasus major components
   4.  Pegasus Dependencies
   5.  The Pegasus Directory Structure
   6.  Installation
   7.  Building Pegasus
   8.  Populate the Repository
   9.  The MU Utility
   10. Notes about Building Pegasus on Linux
   11. Notes on building Pegasus with SSL
   12. Building Pegasus on Windows 2000 or Windows XP With Microsoft Visual C++
   13. Installing the Pegasus HTML Test Client
   14. Development with Pegasus and Pegasus Tools
   15. Commands
   16. Creating SSL certifications.
   17. Documentation
   18. Participate
  
 Revision 1.3  2001/01/22 15:09:29  mike  
 Reworking indentation and breaking width of lines below 80 columns (not  
 finished). Also  
 inserted comments and suggestions following "MEB:" annotations.  
  
  
 Revision 1.1  2001/01/15 04:26:04  karl  
 added Readme  
  
 -----------------------------------------------------------------------  1. Overview:
   ============
  
 Tagline: Pegasus is an object manager for DMTF CIM objects written in C++  OpenPegasus (also refered to as Pegasus):
          and supported by The Open Group  
  
 Pegasus is an open-source object manager for DMTF CIM objects. It is written Pegasus is an open-source object manager for DMTF CIM objects. It is written
 in C++ and includes the Object manager, a set of defined interfaces, and SDKs in C++ and includes the Object manager, a set of defined interfaces, and SDKs
Line 48 
Line 53 
 (LICENSE) of this release.  This licensing is intended to support as wide a (LICENSE) of this release.  This licensing is intended to support as wide a
 distribution as possible with minimal demands on the users. distribution as possible with minimal demands on the users.
  
 This distribution represnts a snapshot of the current work. Currently Pegasus  This distribution represents a snapshot of the current work. Currently Pegasus
 is in phase 1 of a multiphase development project. This snapshot is primarily is in phase 1 of a multiphase development project. This snapshot is primarily
 for developers and for evaluation of the project. for developers and for evaluation of the project.
  
Line 64 
Line 69 
 In addition, the roadmap for Pegasus and further information on the project is In addition, the roadmap for Pegasus and further information on the project is
 available on The Opengroup Pegasus WEB Site. available on The Opengroup Pegasus WEB Site.
  
 http://www.opengroup.org/MSB  http://www.openpegasus.org
   
   
   2. Availability of Pegasus:
   ============================
   
   Pegasus is distributed as open source.  The distribution is available via
   CVS and snapshot images in tar and zip file formats.
   
   The source code from CVS can be found at the following Open Group CVS server;
   
            cvs.opengroup.org:/cvs/MSB
   
   using the password authenticating server option (pserve).
   
   Anonymous access for read is with the name and password "anon" as follows:
   
           %export CVSROOT=:pserver:anon@cvs.opengroup.org:/cvs/MSB
           %cvs login
   
            When requested, enter the password "anon"
  
 Availability of Pegasus  The source tree is in the directory pegasus. To check out the complete Pegasus
 =======================  source tree just type:
  
 Pegasus is distributed as open source.  Today the distribution is limited           cvs co pegasus
 because we want to reach a predefined level of development before making the  
 project publically available. The move from limited to open distribution will  
 be a decision of the Pegasus development team and The Open Group and should  
 occur before March 2001.  
  
 To get on the distribution list for Pegasus today, send an email to  A Pegasus directory will be created under the current directory and populated
   with the complete source tree and documentation. To get the latest updates
   after a checkout just type this from Pegasus root:
  
         m.kirk@opengroup.org           cvs update -d
  
         or  
  
         k.schopmeyer@opengroup.org  Active contributors to Pegasus have write access to the CVS repository.
    If you are interested in contributing back to the Pegasus project,
   (i.e. write (checkin) access to CVS) please request access from either
   Martin Kirk (m.kirk@opengroup.org) or Karl Schopmeyer (k.schopmeyer@opengroup.org).
  
 Pegasus Major Components  
 ========================  3. Pegasus Major Components:
   =============================
  
 The major components of Pegasus are: The major components of Pegasus are:
  
Line 94 
Line 120 
     interface and a simple file based class repository. It also includes     interface and a simple file based class repository. It also includes
     an instance repository. Note that these repository were created for     an instance repository. Note that these repository were created for
     functionality, not efficieny. It is expected that they will be replaced     functionality, not efficieny. It is expected that they will be replaced
     with other implementations of the respository function as the need arrses.      with other implementations of the respository function as the need arises.
  
 Pegasus Client SDK - Tools for building Pegasus clients based on the Pegasus Pegasus Client SDK - Tools for building Pegasus clients based on the Pegasus
     C++ interfaces and using the WBEM HTTP/XML protocols or directly     C++ interfaces and using the WBEM HTTP/XML protocols or directly
Line 106 
Line 132 
 Pegasus HTML Test Client - To aid in testing we created a test client for Pegasus HTML Test Client - To aid in testing we created a test client for
     Pegasus that uses a WEB server (ex. Apache) with a set of CGI modules and     Pegasus that uses a WEB server (ex. Apache) with a set of CGI modules and
     HTML to allow the entry of Pegasus operations from a WEB browser as forms     HTML to allow the entry of Pegasus operations from a WEB browser as forms
     and the recept of the response as WEB pages. This has proven useful as a      and the receipt of the response as WEB pages. This has proven useful as a
     test tool and can be used for a wide variety of demonstrations.     test tool and can be used for a wide variety of demonstrations.
  
 Pegasus Provider SDK - Tools for build Pegasus clients based on the Pegasus  Pegasus Provider SDK - Tools for building Pegasus providers using the Pegasus
     C++ interfaces.     C++ interfaces.
  
 Pegasus Providers - A sampling of key providers to make the environment  Pegasus Providers - Providers to illustrate the use of Pegasus services including
 complete as well as test providers and demonstration providers for the  providers for test and demonstration.
 Pegasus.  
  
 Pegasus Service Extensions -  Future (version 1.0)  Pegasus Service Extensions -  Common services for use by other Pegasus
   components to extend Pegasus capabilites.
  
 Pegasus MOF Compiler - FA standalone compiler for MOF files that can be used Pegasus MOF Compiler - FA standalone compiler for MOF files that can be used
 to install MOF into the Pegasus schema repository and also to check syntax  to install MOF into the Pegasus schema repository and also to check syntax.
   There is also a tool to extract the MOF from the repository.
   
  
 Pegasus Dependencies  4. Pegasus Dependencies:
 ====================  =========================
  
 We have worked to minimize the dependence of Pegasus on other software We have worked to minimize the dependence of Pegasus on other software
 packages and tools. Currently Pegasus has the following dependencies  packages and tools. Currently Pegasus has the following dependencies:
  
 1. To simplify the building of Pegasus across multiple platforms we have  1.  GNUMAKE - To simplify the building of Pegasus across multiple platforms we
 standardized on a set of build tools including: GNUMAKE. We are using GNUAKE      have standardized on a set of build tools including: GNUMAKE. We are using
 4.79.1 successfully both in Windows and Linux environments.      GNUMAKE 4.79.1 successfully both in Windows and Linux environments.
  
 GNUMAKE is available from GNUMAKE is available from
  
     http://www.gnu.org     http://www.gnu.org
  
 ATTN: I think we need to make our version available on the TOG site.  
   
 COMMENT: Unless other users of Pegasus demand it, we will NOT create any build  
 environment for Pegasus that does not require GNUMAKE (e.g., Visual C++). We  
 are open to other developers who want to contribute other build structures for  
 particular environments.  
  
   2.  MU.EXE - To minimize the difference between Linux and Windows for GNUMAKE,
 2. MU.EXE - To minimize the difference between Linux and Windows for GUNMAKE,      we have created a utility called MU.exe.  This utility is required for
 we have created a utility called MU.exe.  This utility is required for Pegasus      Pegasus make with ONLY Windows environment. It is provided as an alternative to
 make with Windows environment. It is provided as an alternative to requiring a      requiring a number of UNIX utilities (SH, RM, etc.) on the windows platform
 number of UNIX utilities (SH, RM, etc.) on the windows platform and      and effectively provides the functions of these utilities that GNUMAKE
 effectively provides the functions of these utilities that GNUMAKE needs.      needs. MU is not required on UNIX or LINUX platforms.
 MU is not required on UNIX or LINUX platforms.  
  
 NOTE: The binary for MU.EXE is not distributed in the Pegasus bin directory. NOTE: The binary for MU.EXE is not distributed in the Pegasus bin directory.
 You must build it separately.  MU source code is part of the distribution You must build it separately.  MU source code is part of the distribution
 in the directory src/utils/MU with its own make file.  You must compile MU in the directory src/utils/MU with its own make file.  You must compile MU
 before you initiate the Pegausu make. before you initiate the Pegausu make.
  
 NOTE: We will make a copy of the binary available on the MSB WEB site to      NOTE: A copy of the binary is made available as a zip file on the Pegasus
 eliminate the requirement to build this utility.      WEB site.
   
       Again, MU is used ONLY if you are using Windows.
  
 3. FLEX and BISON - These tools were used to develop the compiler, anybody  
 intending to recompile the compiler from scratch will be required to have  3.  FLEX and BISON - These tools were used to develop the MOF compiler and WQL
 these tools.      parser. Anybody intending to recompile the compiler or parser from scratch
       will be required to have these tools. They are only required if changes need
       to be made to the files for parsing and compiling.
  
 4. DOC++ - The Pegasus documentation is taken from a combination of text files 4. DOC++ - The Pegasus documentation is taken from a combination of text files
 and the Pegasus header files themselves.  This documentation is formatted with      and the Pegasus header files themselves.  This documentation is formatted
 DOC++ and GAWK.  These tools are required if the documentation is to be      with DOC++ and GAWK.  These tools are required if the documentation is to
 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
 documentaiton. documentaiton.
  
 5. ACE_Wrappers communication package (NOTE: The ACE Wrappers dependency has  
 been removed. Effective version 0.9 Pegasus is not dependent on ACE Wrappers)  
 - The ACE Wrappers package is used for  
 communication and some low level functions within the MSB, the Pegasus client  
 SDK, and the Pegasus Provider SDK.  ACE is available from the following site.  
   
     http://ace.cs.wustl.edu/cvsweb/ace-cvs.cgi/ACE_wrappers/  
   
 Currently we are using version 5.1 of ACE_Wrappers both in Linux and Windows.  
   
     http://www.cs.wustl.edu/~schmidt/ACE_wrappers/ACE-5.1.tar.gz  
   
 COMMENTS: Pegasus only uses limited facilities from ACE. We actively  
 discourage the Pegasus team from using other functions of ACE.  We expect to  
 eliminate our dependence on ACE as the only TCP tool in the near future.  
 However, today Pegasus demands the installation of the complete ACE library.  
 One of the action items for the future is to provide a more limited ACE  
 library and possibly even to provide an environment independent of ACE.  
  
 The Pegasus Directory Structure  5. The Pegasus Directory Structure
 ===============================  ===================================
  
 Pegasus is distributed as a complete directory structure that should be Pegasus is distributed as a complete directory structure that should be
 installed either from one of the snapshots or from CVS. installed either from one of the snapshots or from CVS.
Line 197 
Line 204 
  
 Pegasus                     Pegasus Root directory Pegasus                     Pegasus Root directory
  
   
     build                   Default destination for runtime if PEGASUS_HOME  
                             is not specified.  Does not exist if PEGASUS_HOME  
                             is specified  
   
   
     cgi                     Source for the Pegasus WEB Based Test client     cgi                     Source for the Pegasus WEB Based Test client
         cgi-bin             CGI Directories for WEB demonstration.         cgi-bin             CGI Directories for WEB demonstration.
                             This directory is normally empty but can                             This directory is normally empty but can
Line 210 
Line 211 
                             from cgi.                             from cgi.
         htdocs              HTML Pages for Pegasus WEB emonstration         htdocs              HTML Pages for Pegasus WEB emonstration
     doc                     Miscellaneous Pegasus Documents.     doc                     Miscellaneous Pegasus Documents.
         DevManual           Source and build files for developes manual      DevManual               Source and build files for developers' manual
     mak                     General make files (used by other makes)     mak                     General make files (used by other makes)
     src                     All Pegasus Source Files     src                     All Pegasus Source Files
         ACEExample         Test directrory with examples of the use of ACE         ACEExample         Test directrory with examples of the use of ACE
Line 225 
Line 226 
             Protocol        Pegasus Client HTTP/XML Protocol Modules             Protocol        Pegasus Client HTTP/XML Protocol Modules
                 depends                 depends
             Provider        Pegasus Provider interface functions             Provider        Pegasus Provider interface functions
             Repository      Pegasus Repository Interfaces and Simple              Repository      Pegasus Repository Interfaces and Simple Repository
                             Repository  
                 tests       Tests for Repository Functions                 tests       Tests for Repository Functions
             Server          Pegasus Server Modules             Server          Pegasus Server Modules
         Providers           Pegasus test and required providers         Providers           Pegasus test and required providers
Line 241 
Line 241 
         Manual              HTML output of the Pegasus Manual         Manual              HTML output of the Pegasus Manual
         lib                 Destination for Pegasus LIB modules         lib                 Destination for Pegasus LIB modules
         obj                 Destination for object modules         obj                 Destination for object modules
         Repository          This Directory containes the created repository       repository             This Directory contains the created repository
  
  
 In the near future we will add directories for:  6. Installation
   ================
  
     Service Extensions  Pegasus today is provided only as a source distribution.
     Servers - Today the server executable is built from /server/test.  
  
 Installation  To install Pegasus, you must check it out using CVS (Common Version System)
 ============  or download the snapshot. You download, compile, and use it.
  
 Pegasus today is provided only as a source distribution.  You download compile  For the snapshot, the installation of Pegasus involves expanding the snapshot
 and use it. Pegasus currently compiles and runs under both Linux and Windows  distribution files, building the runtime, the test files and test clients, and
 NT environments.  building the repository.
   
 The installation of Pegasus involves expanding the snapshot distribution  
 files, building the runtime, the test files and test clients, and building the  
 repository.  
   
 Building from a Distribution --- General  
 ========================================  
   
 Pegasus is buildable and runnable on either Linux or WIndows Platforms today.  
 It uses a common build system for the two platforms based on build files in  
 each directory, a recursive build strucutre to execute the multiple makes and  
 GUNMAKE.  
   
 Generally we support the followingtargets in our make system:  
   
   
             C:\> make clean - Clean out all objects, libs, and executables  
             C:\> make depend - Create the dependencies  
             C:\> make  
             C:\> make tests  - Execute all tests except client server tests  
             C:\> make rebuild - Clean and rebuild including the respository  
             C:\> make world  
  
 The Pegasus Client server tests are executed separately from the above because  
 they require the initiation of separate process for the Pegasus server and  
 Pegasus client. These tests can be executed as follows:  
  
     ATTN: Add the procedure for Client/Server Test start here.  7. Building Pegasus
   =====================
   
   1.  Check that you have requisite programs (listed in Pegasus Dependencies).
   
       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
       parser).
  
       Be sure these are on your path.
   
   
   2.  Define the following three environment variables:
   
       PEGASUS_ROOT - this should be the "pegasus" directory you've pulled from CVS
   
       PEGASUS_HOME - to point to a directory to contain output binary files
       (e.g., set it to $HOME/pegasus_home). Then the output will go into
       $HOME/pegasus_home/bin and $HOME/pegasus_home/lib
   
       PEGASUS_PLATFORM - this must be set to a supported platform identifier.
   
       This identifier has the following form:
   
                    <Operating-System>_<Architecture>_<Compiler>
   
       For example (Linux on IA32 platform using the GNU Compiler):
                    LINUX_IX86_GNU
   
       For a complete list, refer to the platform_ make files found in directory
       pegasus/mak
   
   
       Note: if you plan on doing parallel builds, you might consider setting
       PEGASUS_HOME to something like this:
   
                    $HOME/pegasus_home_LINUX_IX86_GNU
   
       That way, the output of each build will be placed in its own directory.
   
   3.  Now place $PEGASUS_HOME/bin on your path
   
       and
   
       Place $PEGASUS_HOME/lib on your LD_LIBRARY_PATH (for Unix only).
       For RedHat/SuSE/UL, edit /etc/ld.so.conf and add $PEGASUS_HOME/lib
   
   4.  Change to the root of the Pegasus distrubution and type "make"
       (where make refers to GNU make).
   
   5.  Then create the repository, which is needed to serve data.
       "make repository"
   
   6.  To test the build type "make tests".
   
   The following make targets are supported:
   
       <default> - Build everything.
       clean - Clean out all objects, libs, and executables.
       depend - Create the dependencies.
       repository - Create the repository in $PEGASUS_HOME/repository
       tests  - Execute all tests (except client server tests).
       rebuild - clean, depend, <default>
       world - depend, <default>
   
   The Pegasus Client server tests are executed separately from the above because
   they require the initiation of separate process for the Pegasus server and
   Pegasus client. To execute these tests please refer to the scripts in
   pegasus/mak/BuildMakefile - refer to the prestarttests and poststarttests.
  
 For information on particular installation characteristics, tools, etc. for For information on particular installation characteristics, tools, etc. for
 each platform see the appropriate sections below: each platform see the appropriate sections below:
Line 291 
Line 333 
 Generally the build commands are as follows: Generally the build commands are as follows:
  
     1. There is a Makefile in the Pegasus root directory.   Simply executing     1. There is a Makefile in the Pegasus root directory.   Simply executing
     make in the Pegasus root directory will make everything. "Make rebuild"      make in the Pegasus root directory will make everything. "make rebuild"
     will clean and rebuild everything. The "make rebuild" will also populate     will clean and rebuild everything. The "make rebuild" will also populate
     the repository with the current CIM Schemas.     the repository with the current CIM Schemas.
  
Line 310 
Line 352 
     Running "make -s tests" suppresses extraneous output such as the     Running "make -s tests" suppresses extraneous output such as the
     enter/leave directory messages.     enter/leave directory messages.
  
     4. "Make Clean" removes all object and library files from the structure.      4. "make clean" removes all object and library files from the structure.
   
  
 Build Variables      5. A new build system has been added to Pegasus where a new CVS checkout is done,
 ===============         built, and tests are run. Do it by: "make -f mak/BuildMakefile cleanbuild"
  
 The build system depends on the following environment variables build set.  
 These variables must be set as part of the installation of the Pegasus source  
 tree before you can compile or run Pegasus.  
  
     PEGASUS_OS_TYPE - optional. The is currently set to windows.  If you build  8. Populate the Repository
     on any platform except windows you must change this before initiating  ===========================
     make.  
  
     PEGASUS_ROOT - Root directory of the Pegasus source tree.  Before using Pegasus you must populate the repository with the providers. The makefile
   does it all for you, but in case you are wondering what it does or how to do it
   manually:
  
     PEGASUS_HOME - Home directory for all of the Pegasus runtime elements.  1. Register the MOF (Managed Object Format) file describing the skeleton of the object.
     If this does not exist, $PEGASUS_ROOT$/build is assumed.  2. Register a second MOF which only points out which lib*.so file to be loaded when a
      specific object is activated.
  
  COMMENTS: In the future, we will probably automate this more.  However,  This is done automatically for the providers included in Pegasus by doing:
  setting these variables today is manual.  make repository.
  
   The 'make repository' in pegasus/Schemas does three things
   Runs MOF compiler (cimmofl) on:
   -Schema v2.7
       Generates the CIM Schema v2.7 in the repository  (skeleton of CIM objects)
   -PG_InterOp
       Internal to Pegasus schema for operating (shutdown, add users, etc)
       CIM_Indication’s (SNMP, Events, Alert, Threshold, etc)
   -PG_ManagedSystem
       Registers included CIM Providers (libOSProvider.so, libDNSProvider.so, … )
       in Pegasus (which are located in src/Providers)
  
 The MU Utility  For more information about using the MOF compiler, refer to user's manual on the
 ==============  openpegasus.org.
   
   
   9. The MU Utility
   ===================
  
 In order to provide a consistent build structure across multiple platforms, we In order to provide a consistent build structure across multiple platforms, we
 developed a small utility to provide a consistent set of small utilities developed a small utility to provide a consistent set of small utilities
Line 360 
Line 416 
 MU is required to build under the Windows environment.MU is available as part MU is required to build under the Windows environment.MU is available as part
 of the distribution of Pegasus. of the distribution of Pegasus.
  
 Building Pegausu on Linux  
 =========================  
   
 1.      Obtain, unpack and build the ACE_Wrappers package for Linux.  
  
 2.      Define an environment variable called ACE_ROOT  that points to the  10. Notes about Building Pegasus on Linux
         root of the ACE_WRAPPERS distribution. For example  ===========================================
  
                 IMPORT PEGASUS_ACE_ROOT=\local\ACE_Wrappers  No problem. Just make sure you have the environment variables set.
  
         ATTN: Mike.  what is a viable directory for Linux (what do you use)  
  
 3.      Define an environment variable PEGASUS_ROOT that points to the  11. Notes about Building Pegasus with SSL
         root of the Pegasus Distribution  ==========================================
   
   
 4.      Define the environment variable PEGASUS_HOME where you want the  
         runtime elements (executables, objects, libraries, etc.) to go.  
 5.      Unpack the ace distribution.  
   
   
 6.      Append %PEGASUS_ROOT%/bin to your path  
   
 7.      From the %PEGASUS_ROOT% directory build using the make commands  
         defined in the section on General Build.  
   
                 make world  
                 make tests  
   
 Building Pegasus on NT or Windows 2000 With Microsoft Visual C++  
 ================================================================  
   
 Today we build Pegasus on Windows NT using a set of make files contained  
 in the source distribution, the Microsoft compilers (tested so far with  
 versions 5 and 6) and the GNUMAKE make utility. The following is the basic  
 set up steps for the  
   
   
 1.      Setup the environment variables and path for the Micrososft Visual C  
         compiler. Typically this can be done by running the VCVARS32.BAT file  
         supplied with Microsoft Visual C++. (contained in the same directory  
         as cl.exe).  
   
 2.      Define an environment variable called ACE_ROOT that points to the  
         root of the ACE_Wrappers distribution. For example:  
   
                 C:\> set PEGASUS_ACE_ROOT=c:/ACE_wrappers  
   
         Now append %ACE_ROOT%/bin to the path like this:  
   
                 C:\> set path=%path%;%PEGASUS_ACE_ROOT%/bin  
   
 3.      Define an environment variable called PEGASUS_ROOT that points to  
         the root of the Pegasus distribution. For example:  
   
                 C:\> set PEGASUS_ROOT=c:/pegasus  
   
   
 4.      Setup the PEGASUS_HOME environment variable  
                 set PEGASUS_HOME=c:/PegasusRun  
   
         Now append %PEGASUS_HOME%/bin to your path like this:  
  
   To build with SSL you need the OpenSSL libraries and header files. Make sure
   you have them in a standard directory so Pegasus can find them. If that's not
   the case, set the environment varialble OPENSSL_HOME= to point where your OpenSSL
   installation is.
   
   Also have the PEGASUS_HAS_SSL=yes variable set. Then just run 'make' in Pegasus
   directory and you will have Pegasus with SSL enabled. See section "Creating SSL
   certificates" for more information of how to use SSL.
   
   
   12. Building Pegasus on Windows 2000 (SP3 or later recommended) or Windows XP
       With Microsoft Visual C++
   ======================================================================
   
   Today we build Pegasus on Windows using a set of make files contained
   in the source distribution, the Microsoft compilers (DevStudio 5.x is not
   supported, Visual Studio 6.0, SP5 supported) and the GNUMAKE make utility.The
   following is the basic setup steps for the environment.
   
   
   Setup the environment variables and path for the Micrososft Visual C compiler.
   Typically this can be done by running the VCVARS32.BAT file supplied with
   Microsoft Visual C++. (contained in the same directory as cl.exe).
   
   For Windows, try the following for an example environment:
   
       REM call the standard Microsoft .bat for VC 6 setup.
       call 'C:/Program Files/Microsoft Visual Studio/VC98/Bin/Vcvars32.bat'
       REM Set debug to something if you want compile in debug mode
       set PEGASUS_DEBUG=true
       REM set PEGASUS_ROOT to top of source tree
       set PEGASUS_ROOT=C:/cimom/pegasus
       REM set PEGASUS_HOME to where you want repository and executables
       set PEGASUS_HOME=%PEGASUS_ROOT%
       REM setup the path to the runtime files.
                 set path=%path%;%PEGASUS_HOME%/bin                 set path=%path%;%PEGASUS_HOME%/bin
  
 5.      Unpack and build the ACE_Wrappers distribution for windows.  13. Installing the Pegasus HTML Test Client:
   =============================================
         As an example, we created a file called %ACE_ROOT%/ace/config.h  
         containing the following:  
   
                 #include "ace/config-win32.h"  
   
         and then opened this DSW file in MSVC++ IDE:  
   
                 %ACE_ROOT%/ace/ace.dsw  
  
         From the build menu we picked "ace.dll". For me it built without  This is a separate test tool that allows Pegasus requests to be initiated from
         complaint.  any WEB browser and that uses a WEB browser, CGI scritps and HTML pages for
   the formating and connections. It requires a WEB server, etc.  The
         The ACE package can be built in several configurations:  instructions for setting up this environment are maintained in a separate
   readme in the CGI directory.
                 ace.dll - The basic package without debugging  
                 aced.dll - debugging added to the basic package  
                 acemfc.dll - ACE with Microsoft MFC support  
                 acemfcd.dll - The ACE MFC version with debugging.  
   
         ace.dll is used for the server build  acemfc is used for the client  
         builds.  
  
         NOTE: In the near future we will be building debugging options into  
         Pegasus and at that time the aced and acemfcd libraries will also be  
         required.  
  
         Each library can be built separately from Microsoft Visual C++.  14. Development with Pegasus and Pegasus Tools:
   ================================================
  
 6.      Unpack the Pegasus distribution.  On Windows systems, PKzip25 or  ATTN: This section needs to be completed.  It should reference the more
         WINZIP can be used. Be certain to use the option that expands the  complete documentation
         directory tree of the files. This expansion will create a directory  ATTN: Write about providers?
         called ./pegasus  
  
         If you are using pkzip25.exe do this:  
                 C:\> pkzip25 -extract -recurse -directories pegasus.zip  
  
         This will create a directory tree called ./pegasus under the  15. Commands:
         current directory.  =============
  
   The manpages for each of the commands are in rpm/manLinux/man1.Z directory (on CVS)
  
 7.      Change directory  to %PEGASUS_ROOT% and type "make world". See the  To see simple help for each of the commands, use the "-h" flag.
         general build section for the full set of make commands.  Examples:
   bin/cimserver –s (Shuts it down)
   bin/cimserver traceLevel=4 traceComponents=ALL (starts server with config flags)
   bin/cimprovider –l –s (lists providers and their status)
   bin/cimprovider –e –m OperatingSystemModule (enables the OperatingSystem provider)
   bin/cimuser –a –u guest –w ThePassword
   bin/cimuser –l (lists the users)
   bin/tomof CIM_Config (extract CIM_Config from repository and present it in MOF type)
  
         This builds Pegasus and all of its examples.  
  
 7.      To verify that it built okay, run the tests  16. Creating SSL certifications
   ================================
  
                 make tests  Type these commands in your shell to create the SSL certifications. The PEGASUS_ROOT
   and PEGASUS_HOME have to be set to your respective installation and source directory.
  
 Installing the Pegasus HTML Test Client  CN="Common Name"
 =======================================  EMAIL="test@email.address"
   HOSTNAME=`uname -n`
   sed -e "s/$CN/$HOSTNAME/"  \
       -e "s/$EMAIL/root@$HOSTNAME/" $PEGASUS_ROOT/ssl.cnf \
       > $PEGASUS_HOME/ssl.cnf
   chmod 644 $PEGASUS_HOME/ssl.cnf
   chown bin $PEGASUS_HOME/ssl.cnf
   chgrp bin $PEGASUS_HOME/ssl.cnf
  
 This is a separate test tool that allows Pegasus requests to be initiated from  /usr/bin/openssl req -x509 -days 365 -newkey rsa:512 \
 any WEB browser and that uses a WEB browser, CGI scritps and HTML pages for   -nodes -config $PEGASUS_HOME/ssl.cnf \
 the formating and connections. It requires a WEB server, etc.  The     -keyout $PEGASUS_HOME/key.pem -out $PEGASUS_HOME/cert.pem
 instructions for setting up this environment are maintained in a separate  
 readme in the CGI directory.  
  
 Development with Pegasus and Pegasus Tools  cat $PEGASUS_HOME/key.pem $PEGASUS_HOME/cert.pem > $PEGASUS_HOME/server.pem
 ==========================================  rm $PEGASUS_HOME/key.pem $PEGASUS_HOME/cert.pem
   cp $PEGASUS_HOME/cert.pem $PEGASUS_HOME/client.pem
  
 ATTN: This section needs to be completed.  It should reference the more  
 complete documentation  
  
   17. Documentation:
 =================== ===================
 Documentation  
  
 The documentation is currently in preperation. The preliminary documentation The documentation is currently in preperation. The preliminary documentation
 is not provided with this snapshot but is avialable from the OpenGroup Pegasus is not provided with this snapshot but is avialable from the OpenGroup Pegasus
Line 504 
Line 535 
 documentation in the future and today is the source of most discussion and documentation in the future and today is the source of most discussion and
 design documentation. design documentation.
  
 Participate!  
 ============  
 We are looking for people who want to join the Pegasus work group and  
 contribute to effort of getting this Pegasus off the ground.  Please send  
 email for details to k.schopmeyer@opengroup.org or m.kirk@opengroup.org or  
 m.brasher@opengroup.org  
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
  
   18. Participate!
   =================
  
   We are looking for people who want to join the Pegasus work group and
   contribute to effort of getting this Pegasus off the ground. Please join
   the mailing list by visiting www.openpegasus.org, and click on Mailing Lists.


Legend:
Removed from v.1.6  
changed lines
  Added in v.1.10.4.1

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2