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

  1 dudhe.girish 1.20 
  2                   OpenPegasus - A Manageability Services Broker for the DMTF CIM/WBEM Standards
  3                   
  4                   Author: Mike Brasher, Karl Schopmeyer
  5                   
  6                   Tagline: OpenPegasus is an object manager for DMTF CIM objects written in C++
  7                            and supported by The Open Group
  8                   
  9                   STATUS: Revised March 10 to match Pegasus release 2.3
 10                   
 11                   NOTE: Obsolete. See readme.html
 12                   Contents:
 13                   =========
 14                   
 15                   1.  Overview
 16                   2.  Availability of Pegasus
 17                   3.  Pegasus major components
 18                   4.  Pegasus Dependencies
 19                   5.  The Pegasus Directory Structure
 20                   6.  Installation
 21                   7.  Building Pegasus
 22 dudhe.girish 1.20 8.  Populate the Repository
 23                   9.  The MU Utility
 24                   10. Notes about Building Pegasus on Linux
 25                   11. Notes about Building Pegasus on Mac OS X/Darwin
 26                   12. Notes on building Pegasus with SSL
 27                   13. Building Pegasus on Windows 2000 or Windows XP With Microsoft Visual C++
 28                   14. Installing the Pegasus HTML Test Client
 29                   15. Development with Pegasus and Pegasus Tools
 30                   16. Commands
 31                   17. Creating SSL certifications.
 32                   18. Configuring Pegasus to use SSL
 33                   19. Configuring Pegasus to use PAM
 34                   20. Testing with ICU enabled
 35                   21. Documentation
 36                   22. Participate
 37                   
 38                   
 39                   
 40                   
 41                   1. Overview:
 42                   ============
 43 dudhe.girish 1.20 
 44                   OpenPegasus (also refered to as Pegasus):
 45                   
 46                   Pegasus is an open-source object manager for DMTF CIM objects. It is written
 47                   in C++ and includes the Object manager, a set of defined interfaces, and SDKs
 48                   for both client, providers, and services extensions.  It is maintained
 49                   consistent with the DMTF CIM and WBEM specifications except for any exceptions
 50                   noted in the documentation.
 51                   
 52                   This distribution represents a work in progress towards building a Pegasus
 53                   release. Pegasus is open source and is covered under the following license.
 54                   This version is incomplete and is directed towards evaluators and developers
 55                   of the Pegasus Architecture.
 56                   
 57                   Pegasus is being developed and maintained under the auspices of The Open
 58                   Group. Pegasus is maintained under the license defined in the doc directory
 59                   (LICENSE) of this release.  This licensing is intended to support as wide a
 60                   distribution as possible with minimal demands on the users.
 61                   
 62                   This distribution represents a snapshot of the current work. Currently Pegasus
 63                   is in phase 1 of a multiphase development project. This snapshot is primarily
 64 dudhe.girish 1.20 for developers and for evaluation of the project.
 65                   
 66                   More information on this project, access to the CVS, and documentation on
 67                   Pegasus are available from the OpenGroup WEB site.
 68                   
 69                   There are separate files in the release for
 70                   
 71                   		 History of releases - HISTORY
 72                   		 What's new for this release - WHATSNEW
 73                   		 What's Broken - BUGS
 74                   
 75                   In addition, the roadmap for Pegasus and further information on the project is
 76                   available on The Opengroup Pegasus WEB Site.
 77                   
 78                   http://www.openpegasus.org
 79                   
 80                   
 81                   2. Availability of Pegasus:
 82                   ============================
 83                   
 84                   Pegasus is distributed as open source.  The distribution is available via 
 85 dudhe.girish 1.20 CVS and snapshot images in tar and zip file formats.
 86                   
 87                   The source code from CVS can be found at the following Open Group CVS server;
 88                   
 89                            cvs.opengroup.org:/cvs/MSB 
 90                   
 91                   using the password authenticating server option (pserve).
 92                   
 93                   Anonymous access for read is with the name and password "anon" as follows:
 94                   
 95                   	%export CVSROOT=:pserver:anon@cvs.opengroup.org:/cvs/MSB
 96                   	%cvs login
 97                   	  
 98                            When requested, enter the password "anon"
 99                   
100                   The source tree is in the directory pegasus. To check out the complete Pegasus  
101                   source tree just type:
102                   
103                            cvs co pegasus
104                   
105                   A Pegasus directory will be created under the current directory and populated
106 dudhe.girish 1.20 with the complete source tree and documentation. To get the latest updates 
107                   after a checkout just type this from Pegasus root:
108                   
109                            cvs update -d
110                   
111                   
112                   Active contributors to Pegasus have write access to the CVS repository.
113                    If you are interested in contributing back to the Pegasus project, 
114                   (i.e. write (checkin) access to CVS) please request access from either
115                   Martin Kirk (m.kirk@opengroup.org) or Karl Schopmeyer (k.schopmeyer@opengroup.org).
116                   
117                   
118                   3. Pegasus Major Components:
119                   =============================
120                   
121                   The major components of Pegasus are:
122                   
123                   Pegasus Server - WBEM/CIM Server with interfaces for providers and clients
124                   
125                   Pegasus Repositories - Today Pegasus provides a defined class repository
126                       interface and a simple file based class repository. It also includes
127 dudhe.girish 1.20     an instance repository. Note that these repository were created for
128                       functionality, not efficieny. It is expected that they will be replaced
129                       with other implementations of the respository function as the need arises.
130                   
131                   Pegasus Client SDK - Tools for building Pegasus clients based on the Pegasus
132                       C++ interfaces and using the WBEM HTTP/XML protocols or directly
133                       interfacing with Pegasus.
134                   
135                   Pegasus Test Clients - Simple test clients being developed as part of the
136                       Pegasus development process
137                   
138                   Pegasus HTML Test Client - To aid in testing we created a test client for
139                       Pegasus that uses a WEB server (ex. Apache) with a set of CGI modules and
140                       HTML to allow the entry of Pegasus operations from a WEB browser as forms
141                       and the receipt of the response as WEB pages. This has proven useful as a
142                       test tool and can be used for a wide variety of demonstrations.
143                   
144                   Pegasus Provider SDK - Tools for building Pegasus providers using the Pegasus
145                       C++ interfaces.
146                   
147                   Pegasus Providers - Providers to illustrate the use of Pegasus services including 
148 dudhe.girish 1.20 providers for test and demonstration.
149                   
150                   Pegasus Service Extensions -  Common services for use by other Pegasus 
151                   components to extend Pegasus capabilites. 
152                   
153                   Pegasus MOF Compiler - FA standalone compiler for MOF files that can be used
154                   to install MOF into the Pegasus schema repository and also to check syntax. 
155                   There is also a tool to extract the MOF from the repository.
156                   
157                   
158                   4. Pegasus Dependencies:
159                   =========================
160                   
161                   We have worked to minimize the dependence of Pegasus on other software
162                   packages and tools. Currently Pegasus has the following dependencies:
163                   
164                   1.  GNUMAKE - To simplify the building of Pegasus across multiple platforms we 
165                       have standardized on a set of build tools including: GNUMAKE. We are using 
166                       GNUMAKE 3.79.1 successfully both in Windows and Linux environments.
167                   
168                       GNUMAKE is available from
169 dudhe.girish 1.20 
170                       http://www.gnu.org
171                   
172                   
173                   2.  MU.EXE - To minimize the difference between Linux and Windows for GNUMAKE,
174                       we have created a utility called MU.exe.  This utility is required for 
175                       Pegasus make with ONLY Windows environment. It is provided as an alternative to 
176                       requiring a number of UNIX utilities (SH, RM, etc.) on the windows platform
177                       and effectively provides the functions of these utilities that GNUMAKE 
178                       needs. MU is not required on UNIX or LINUX platforms.
179                   
180                       NOTE: The binary for MU.EXE is not distributed in the Pegasus bin directory.
181                       You must build it separately.  MU source code is part of the distribution
182                       in the directory src/utils/MU with its own make file.  You must compile MU
183                       before you initiate the Pegausu make.
184                   
185                       NOTE: A copy of the binary is made available as a zip file on the Pegasus
186                       WEB site.
187                   
188                       Again, MU is used ONLY if you are using Windows.
189                   
190 dudhe.girish 1.20 
191                   3.  FLEX and BISON - These tools were used to develop the MOF compiler and WQL 
192                       parser. Anybody intending to recompile the compiler or parser from scratch 
193                       will be required to have these tools. They are only required if changes need 
194                       to be made to the files for parsing and compiling.
195                   
196                   
197                   4.  DLCOMPAT - dlcompat is a dlopen(3) et.al. compatibility library for 
198                       Mac OS X/Darwin.
199                    
200                       NOTE: The dlcompat is not distributed with pegasus source.
201                      
202                       dlcomapt is available from 
203                   
204                       http://www.opendarwin.org/projects/dlcompat/ 
205                   
206                       Again, dlcomapt needs to be installed ONLY if you are using Mac OS X/Darwin. 	
207                   
208                   
209                   5.  DOC++ - The Pegasus documentation is taken from a combination of text files
210                       and the Pegasus header files themselves.  This documentation is formatted 
211 dudhe.girish 1.20     with DOC++ and GAWK.  These tools are required if the documentation is to 
212                       be recreated but we expect that only the core team will be recreating 
213                       documentaiton.
214                   
215                   
216                   5. The Pegasus Directory Structure
217                   ===================================
218                   
219                   Pegasus is distributed as a complete directory structure that should be
220                   installed either from one of the snapshots or from CVS.
221                   
222                   This structure is generally as follows
223                   
224                   Pegasus                     Pegasus Root directory
225                   
226                       cgi                     Source for the Pegasus WEB Based Test client
227                           cgi-bin             CGI Directories for WEB demonstration.
228                                                   This directory is normally empty but can
229                                                   be populated from the runtime with the make
230                                                   from cgi.
231                           htdocs              HTML Pages for Pegasus WEB emonstration
232 dudhe.girish 1.20     doc                     Miscellaneous Pegasus Documents.
233                       DevManual               Source and build files for developers' manual
234                       mak                     General make files (used by other makes)
235                       src                     All Pegasus Source Files
236                           ACEExample          Test directrory with examples of the use of ACE (obsolete). 
237                           Clients             Source for various test clients and client SDK
238                               CGICLIENT       Pegasus test client that uses a WEB browser
239                           JAVA                Java Client support modules
240                           Pegasus
241                               Client          Pegasus Client API Tests
242                                   depends
243                                   tests
244                               Common          Pegasus Common Functions (C++ source and headers
245                                   tests       Test programs for the common functions
246                               Compiler        Pegasus MOF compiler
247                               Config          TBD
248                               Consumer        TBD
249                               ControlProvidersImplementation of Pegasus internal providers
250                               ExportClient    TBD
251                               ExportServer    TBD
252                               Handler         TBD
253 dudhe.girish 1.20             HandlerService  TBD
254                               IndicationService TBD
255                               Listener        TBD
256                               Protocol        Pegasus Client HTTP/XML Protocol Modules
257                                   depends
258                               Provider        Pegasus Provider interface functions
259                               ProviderManager Provider Manager service that manages providers
260                               ProviderManager2Pluggable Provider Manager service
261                               Repository      Pegasus Repository Interfaces and Simple Repository
262                                   tests       Tests for Repository Functions
263                               Security        TBD
264                               Server          Pegasus Server Modules
265                               WQL             TBD
266                           Providers           Pegasus test and required providers
267                               generic         TBD this and following
268                               IndicationConsumer
269                               Linux
270                               ManaedSystem
271                               slp
272                               statistic
273                               sample
274 dudhe.girish 1.20             testproviders
275                               
276                           Server              Pegasus executable build
277                           slp
278                           StandardIncludes
279                           tools               MU and other utilities written for Pegasus support
280                           Unsupported         Code that is made available but is not supported or included
281                                               in the normal make.
282                           WMIMapper           Pegasus implementation that implements mapping to Microsoft
283                                               WMI objects.
284                   
285                   Runtime Directories
286                        $PEGASUS_HOME$         Home directory for runtime.  All compiler, linker
287                                               documentation creation, etc. is put here.
288                        bin                    Destination for executable and DLL modules from
289                                                   Pegasus build
290                        Manual                 HTML output of the Pegasus Manual
291                        lib                    Destination for Pegasus LIB modules
292                        obj                    Destination for object modules
293                        repository             This Directory contains the created repository
294                   
295 dudhe.girish 1.20 
296                   6. Installation
297                   ================
298                   
299                   Pegasus today is provided only as a source distribution. 
300                   
301                   To install Pegasus, you must check it out using CVS (Common Version System)
302                   or download the snapshot. You download, compile, and use it. 
303                   
304                   For the snapshot, the installation of Pegasus involves expanding the snapshot 
305                   distribution files, building the runtime, the test files and test clients, and 
306                   building the repository.
307                   
308                   
309                   7. Building Pegasus
310                   =====================
311                   
312                   1.  Check that you have requisite programs (listed in Pegasus Dependencies).
313                   
314                       These include GNU Make, MU.EXE (if using Windows), Flex, and Bison (Flex 
315                       and Bison only required if changes will be made to the MOF compiler or WQL 
316 dudhe.girish 1.20     parser),dlcompat (if using Mac OS X/Darwin).
317                   
318                       Be sure these are on your path.
319                   
320                   
321                   2.  Define the following three environment variables:
322                   
323                       PEGASUS_ROOT - this should be the "pegasus" directory you've pulled from CVS
324                   
325                       PEGASUS_HOME - to point to a directory to contain output binary files
326                       (e.g., set it to $HOME/pegasus_home). Then the output will go into
327                       $HOME/pegasus_home/bin and $HOME/pegasus_home/lib
328                   
329                       PEGASUS_PLATFORM - this must be set to a supported platform identifier.
330                   
331                       This identifier has the following form:
332                   
333                   		 <Operating-System>_<Architecture>_<Compiler>
334                   
335                       For example (Linux on IA32 platform using the GNU Compiler):
336                                    LINUX_IX86_GNU
337 dudhe.girish 1.20 
338                       For a complete list, refer to the platform_ make files found in directory 
339                       pegasus/mak
340                   
341                   
342                       Note: if you plan on doing parallel builds, you might consider setting
343                       PEGASUS_HOME to something like this:
344                   
345                   		 $HOME/pegasus_home_LINUX_IX86_GNU
346                   
347                       That way, the output of each build will be placed in its own directory.
348                   
349                   3.  Now place $PEGASUS_HOME/bin on your path
350                   
351                       and
352                   
353                       Place $PEGASUS_HOME/lib on your LD_LIBRARY_PATH (for Unix only).
354                       For RedHat/SuSE/UL, edit /etc/ld.so.conf and add $PEGASUS_HOME/lib
355                   
356                   4.  Change to the root of the Pegasus distrubution and type "make"
357                       (where make refers to GNU make).
358 dudhe.girish 1.20 
359                   5.  Then create the repository, which is needed to serve data.
360                       "make repository"
361                   
362                   6.  To test the build type "make tests".
363                   
364                   The following make targets are supported:
365                   
366                       <default> - Build everything.
367                       clean - Clean out all objects, libs, and executables.
368                       depend - Create the dependencies.
369                       repository - Create the repository in $PEGASUS_HOME/repository
370                       tests  - Execute all tests (except client server tests).
371                       rebuild - clean, depend, <default>
372                       world - depend, <default>
373                   
374                   The Pegasus Client server tests are executed separately from the above because
375                   they require the initiation of separate process for the Pegasus server and
376                   Pegasus client. To execute these tests please refer to the scripts in 
377                   pegasus/mak/BuildMakefile - refer to the prestarttests and poststarttests.
378                   
379 dudhe.girish 1.20 For information on particular installation characteristics, tools, etc. for
380                   each platform see the appropriate sections below:
381                   
382                   Generally the build commands are as follows:
383                   
384                       1. There is a Makefile in the Pegasus root directory.   Simply executing
385                       make in the Pegasus root directory will make everything. "make rebuild"
386                       will clean and rebuild everything. The "make rebuild" will also populate
387                       the repository with the current CIM Schemas.
388                   
389                       2. To test a fresh release, go to the pegasus root and type
390                   
391                   		 		 "make world".
392                   
393                   
394                       This will build dependencies, build binaries, and then run all
395                       tests except the Client/Server tests.
396                   
397                       3. To execute the basic test suite that is shipped with pegasus type
398                   
399                   		    "make tests". This also reintalls the repository.
400 dudhe.girish 1.20 
401                       Running "make -s tests" suppresses extraneous output such as the
402                       enter/leave directory messages.
403                   
404                       4. "make clean" removes all object and library files from the structure.
405                   
406                   
407                       5. A new build system has been added to Pegasus where a new CVS checkout is done,
408                          built, and tests are run. Do it by: "make -f mak/BuildMakefile cleanbuild"
409                   
410                   
411                   8. Populate the Repository
412                   ===========================
413                   
414                   Before using Pegasus you must populate the repository with the providers. The makefile 
415                   does it all for you, but in case you are wondering what it does or how to do it 
416                   manually:
417                   
418                   1. Register the MOF (Managed Object Format) file describing the skeleton of the object.
419                   2. Register a second MOF which only points out which lib*.so file to be loaded when a 
420                      specific object is activated.
421 dudhe.girish 1.20 
422                   This is done automatically for the providers included in Pegasus by doing:
423                   make repository.
424                   
425                   The 'make repository' in pegasus/Schemas does three things
426                   Runs MOF compiler (cimmofl) on:
427                   -Schema v2.7
428                       Generates the CIM Schema v2.7 in the repository  (skeleton of CIM objects)
429                   -PG_InterOp
430                       Internal to Pegasus schema for operating (shutdown, add users, etc)
431                       CIM_Indication’s (SNMP, Events, Alert, Threshold, etc)
432                   -PG_ManagedSystem
433                       Registers included CIM Providers (libOSProvider.so, libDNSProvider.so, … ) 
434                       in Pegasus (which are located in src/Providers)
435                   
436                   For more information about using the MOF compiler, refer to user's manual on the 
437                   openpegasus.org.  
438                   
439                   
440                   9. The MU Utility
441                   ===================
442 dudhe.girish 1.20 
443                   In order to provide a consistent build structure across multiple platforms, we
444                   developed a small utility to provide a consistent set of small utilities
445                   across these platforms. The MU utilityis a simple utility that contains many
446                   commands. For example:
447                   
448                   
449                       C:\> mu rm myfile.cpp yourfile.cpp
450                   
451                   
452                   You may type "mu" to get a list of valid commands. Here are some
453                   of them:
454                   
455                   
456                       rm, rmdirhier, mkdirhier, echo, touch, pwd, copy, move, compare depend
457                   
458                   
459                   The MU utility supports globing (expansion of wildcards) so
460                   you can do things like this:
461                   
462                   
463 dudhe.girish 1.20     C:\> mu rm *.obj *.exe
464                   
465                   MU is required to build under the Windows environment.MU is available as part
466                   of the distribution of Pegasus.
467                   
468                   
469                   10. Notes about Building Pegasus on Linux
470                   ===========================================
471                   
472                   No problem. Just make sure you have the environment variables set.
473                   
474                   
475                   11. Notes about Building Pegasus on Mac OS X/Darwin
476                   =====================================================
477                   
478                   No problem. Just make sure you have the environment variables set.
479                   
480                   
481                   12. Notes about Building Pegasus with SSL
482                   ==========================================
483                   
484 dudhe.girish 1.20 To build with SSL you need the OpenSSL libraries and header files. Make sure 
485                   you have them in a standard directory so Pegasus can find them. If that's not 
486                   the case, set the environment varialble OPENSSL_HOME= to point where your OpenSSL
487                   installation is.
488                   
489                   Also have the PEGASUS_HAS_SSL=yes variable set. Then just run 'make' in Pegasus
490                   directory and you will have Pegasus with SSL enabled. See section "Creating SSL 
491                   certificates" for more information of how to use SSL.
492                   
493                   
494                   13. Building Pegasus on Windows 2000 (SP3 or later recommended) or Windows XP
495                       With Microsoft Visual C++
496                   ======================================================================
497                   
498                   Today we build Pegasus on Windows using a set of make files contained
499                   in the source distribution, the Microsoft compilers (DevStudio 5.x is not 
500                   supported, Visual Studio 6.0, SP5 supported) and the GNUMAKE make utility.The 
501                   following is the basic setup steps for the environment.
502                   
503                    
504                   Setup the environment variables and path for the Micrososft Visual C compiler. 
505 dudhe.girish 1.20 Typically this can be done by running the VCVARS32.BAT file supplied with 
506                   Microsoft Visual C++. (contained in the same directory as cl.exe).
507                   
508                   For Windows, try the following for an example environment:
509                   
510                       REM call the standard Microsoft .bat for VC 6 setup. 
511                       call 'C:/Program Files/Microsoft Visual Studio/VC98/Bin/Vcvars32.bat' 
512                       REM Set debug to something if you want compile in debug mode 
513                       set PEGASUS_DEBUG=true 
514                       REM set PEGASUS_ROOT to top of source tree 
515                       set PEGASUS_ROOT=C:/cimom/pegasus 
516                       REM set PEGASUS_HOME to where you want repository and executables
517                       set PEGASUS_HOME=%PEGASUS_ROOT% 
518                       REM setup the path to the runtime files. 
519                       set path=%path%;%PEGASUS_HOME%/bin 
520                   
521                   14. Installing the Pegasus HTML Test Client:
522                   =============================================
523                   
524                   This is a separate test tool that allows Pegasus requests to be initiated from
525                   any WEB browser and that uses a WEB browser, CGI scritps and HTML pages for
526 dudhe.girish 1.20 the formating and connections. It requires a WEB server, etc.  The
527                   instructions for setting up this environment are maintained in a separate
528                   readme in the CGI directory.
529                   
530                   
531                   15. Development with Pegasus and Pegasus Tools:
532                   ================================================
533                   
534                   ATTN: This section needs to be completed.  It should reference the more
535                   complete documentation
536                   ATTN: Write about providers?
537                   
538                   
539                   16. Commands:
540                   =============
541                   
542                   The manpages for each of the commands are in rpm/manLinux/man1.Z directory (on CVS)
543                   
544                   To see simple help for each of the commands, use the "-h" flag.
545                   Examples:
546                   bin/cimserver –s (Shuts it down)
547 dudhe.girish 1.20 bin/cimserver traceLevel=4 traceComponents=ALL (starts server with config flags)
548                   bin/cimprovider –l –s (lists providers and their status)
549                   bin/cimprovider –e –m OperatingSystemModule (enables the OperatingSystem provider)
550                   bin/cimuser –a –u guest –w ThePassword
551                   bin/cimuser –l (lists the users)
552                   bin/tomof CIM_Config (extract CIM_Config from repository and present it in MOF type)
553                   
554                   
555                   17. Creating SSL certifications
556                   ================================
557                   
558                   Please follow section 11, titled "Notes about Building Pegasus with SSL" 
559                   before embarking on this endeavour.
560                   
561                   Type these commands in your shell to create the SSL certifications. The PEGASUS_ROOT 
562                   and PEGASUS_HOME have to be set to your respective installation and source directory. 
563                   
564                   CN="Common Name"
565                   EMAIL="test@email.address"
566                   HOSTNAME=`uname -n`
567                   sed -e "s/$CN/$HOSTNAME/"  \
568 dudhe.girish 1.20     -e "s/$EMAIL/root@$HOSTNAME/" $PEGASUS_ROOT/src/Server/ssl.cnf \
569                       > $PEGASUS_HOME/ssl.cnf
570                   chmod 644 $PEGASUS_HOME/ssl.cnf
571                   chown bin $PEGASUS_HOME/ssl.cnf
572                   chgrp bin $PEGASUS_HOME/ssl.cnf
573                   
574                   /usr/bin/openssl req -x509 -days 365 -newkey rsa:512 \
575                    -nodes -config $PEGASUS_HOME/ssl.cnf \
576                      -keyout $PEGASUS_HOME/key.pem -out $PEGASUS_HOME/cert.pem 
577                   
578                   cat $PEGASUS_HOME/key.pem $PEGASUS_HOME/cert.pem > $PEGASUS_HOME/server.pem
579                   cp $PEGASUS_HOME/cert.pem $PEGASUS_HOME/client.pem
580                   rm $PEGASUS_HOME/key.pem $PEGASUS_HOME/cert.pem
581                   
582                   18. Configuring Pegasus to use SSL
583                   ================================
584                   
585                   Please follow section 11 and 16 before reading this section.
586                   
587                   To configure Pegasus to take advantage of SSL, configure
588                   CIMserver to have the following configuration options set to:
589 dudhe.girish 1.20 
590                   	sslTrustFilePath=client.pem
591                   	sslCertificateFilePath=server.pem
592                   	sslKeyFilePath=file.pem
593                   	httpsPort=5989
594                   	enableHttpsConnection=true
595                   
596                   using the 'cimconfig' utility:
597                    
598                   	cimconfig -p -s enableHttpsConnection=true
599                   
600                   (The client.pem and server.pem are the certifications
601                   files created per the steps in the earlier section).
602                   
603                   For good riddance you might consider closing down
604                   the cleartext 5988 port. Modify your CIMserver to 
605                   (using 'cimconfig') to have the option:
606                   
607                   	enableHttpConnection=false
608                   
609                   19.PAM Authentication
610 dudhe.girish 1.20 ===================
611                   
612                   In order to use PAM Authentication you have to compile Pegasus
613                   with one extra enviroment flags:
614                   
615                   	PEGASUS_PAM_AUTHENTICATION=1
616                   
617                   You can also set the PEGASUS_ALWAYS_USE_PAM=1 flag to disable
618                   Pegasus password authentication using a flag text-file (recommended).
619                   
620                   After compiling (refer to section 17 for details), follow these two
621                   important steps:
622                   
623                    a).  Copy the rpm/wbem file in-to /etc/pam.d directory.
624                         This notifies PAM what kind of libraries to use when authenticating
625                         Pegasus.
626                    b).  Modify CIMserver configuration options:
627                   
628                   	usePAMAuthentication=true
629                   	enableAuthentication=true
630                   
631 dudhe.girish 1.20       And if you want to allow 'root' (*not recommended*)
632                   	enableRemotePrivilegedUserAccess=true
633                   
634                         using the 'cimconfig' operation, such as:
635                   
636                   	cimconfig -p -s usePAMAuthentication=true
637                   
638                   The user is authenticated using HTTP Basic method, thererfore it is
639                   strongly suggested you use SSL connection instead of normal HTTP connection.
640                   Refer to section 16 for more details on creating and using SSL keys.
641                   
642                   20. Testing with ICU enabled:
643                   ==============================
644                   
645                   ICU (International Compoments for Unicode) refers to the set of libraries that
646                   Pegasus uses to run globalized.  For example: these libraries are used to
647                   load messages in different languages, format currency and numbers according to
648                   a specific locale etc.  In order to enable globalization in Pegasus, Pegasus
649                   must be built with ICU enabled, ie. the right environment variables must be
650                   set prior to running "make". Refer to the GlobalizationHOWTO.htm in the docs
651                   directory for details.  That said, when users run "make poststarttests" 
652 dudhe.girish 1.20 to verify the integrity of a Pegasus download, a series of tests are run that 
653                   require the cimserver to be running. These tests currently depend on specific 
654                   messages returned from the server. When ICU is enabled, all messages come 
655                   from the resource bundles and these usually do not match the hardcoded 
656                   default messages within Pegasus.  These hardcoded default messages 
657                   are what the various test programs expect in order to complete 
658                   successfully.  If the ICU enabled server is started without
659                   disabling message loading from the bundles, "make poststartests" will fail.
660                   In order to run "make poststarttests" successfully with ICU enabled, an
661                   environment variable called PEGASUS_USE_DEFAULT_MESSAGES must exist prior to
662                   starting the server.  Once this is defined, when the cimserver starts, all
663                   messages generated will be the default hardcoded messages.  This will enable
664                   "make poststarttests" to complete successfully.  Once "make poststarttests" is
665                   complete, you should stop the cimserver and then undefine PEGASUS_USE_DEFAULT_MESSAGES. 
666                   If this variable is left defined, Pegasus will not be able to load messages
667                   using ICU resource bundles. 
668                   
669                   21. Documentation:
670                   ===================
671                   
672                   The documentation is currently in preperation. The preliminary documentation
673 dudhe.girish 1.20 is not provided with this snapshot but is avialable from the OpenGroup Pegasus
674                   WEB pages. The current documentation is maintained both as a manual created
675                   under the tool DOC++ in the runtime subdirectory manual/html and as other
676                   miscelaneous documentation in the doc directory.
677                   
678                   Note that the Pegasus WEB site at The Open Group will be the source of most
679                   documentation in the future and today is the source of most discussion and
680                   design documentation.
681                   
682                   
683                   22. Participate!
684                   =================
685                   
686                   We are looking for people who want to join the Pegasus work group and
687                   contribute to effort of getting this Pegasus off the ground. Please join 
688                   the mailing list by visiting www.openpegasus.org, and click on Mailing Lists.

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2