1 schuur 1.1 
  2            Java Manageability Programming Interface - JMPI
  3            
  4            Author: Adrian Schuur, schuur@de.ibm.com  - 30 Apr 2004 -
  5            
  6            First installment
  7            
  8               This installment of JMPI has been committed to the 2.4 branch.
  9               This installment has been build and tested on Suse 9.0 with Sun's j2sdk 1.4.2_04.

 10 konrad.r 1.2    

 11 schuur   1.1 
 12              Environment settings
 13              
 14                 In order to build this support a few environment variables have to used.
 15                 The following script has been proven useful for setting up the build and execution environment.
 16                 You might need to adjust this to your system layout.
 17              
 18                 export PEGASUS_HOME=`pwd`
 19                 export PEGASUS_PLATFORM=LINUX_IX86_GNU

 20 konrad.r 1.2    export PEGASUS_ENABLE_CMPI_PROVIDER_MANAGER=1
 21                 export PEGASUS_ENABLE_JMPI_PROVIDER_MANAGER=1

 22 schuur   1.1    export PEGASUS_DEBUG=1
 23                 export JAVA_SDK=/usr/java/j2sdk1.4.2_04
 24                 export JAVA_SDKINC=$JAVA_SDK/include
 25                 export LD_LIBRARY_PATH=$PEGASUS_HOME/lib:$JAVA_SDK/jre/lib/i386/server:$JAVA_SDK/jre/lib/i386/native_threads:$JAVA_SDK/jre/lib/i386
 26                 export PATH=$JAVA_SDK/bin:$PATH
 27                 export CLASSPATH=$PEGASUS_HOME/src/Pegasus/ProviderManager2/JMPI
 28                 export PATH=$PEGASUS_HOME/bin:$PATH
 29                 export PEGASUS_ROOT=$PEGASUS_HOME
 30                 export LD_ASSUME_KERNEL=2.2.5
 31                 cd $PEGASUS_HOME
 32              
 33                 When using this script, place a copy of this script above your PEGASUS_HOME directory.
 34                 "cd" to PEGASUS_HOME, and issue ". ../setJPeg". Then do a normal make.
 35              
 36              
 37              This installent has a number of restrictios:
 38              
 39                 The provider interfaces follow the SNIA OpenWBEM APIs
 40                 Only Instance and Association providers are supported at the moment.
 41              	SetProperty and GetProperty CIM operations will crash cimserver
 42                 Jar support is not yet implemented - all classes must be accessable via the CLASSPATH variabe.
 43 schuur   1.1    The Makefiles are not yet Pegasus conforming.
 44              	cimmofl must be used for provider registration.
 45              
 46              	Unloading of idle providers is not supported and Java will increase the memory footprint.
 47              
 48              
 49              poststarttests
 50              
 51                 This installment has a set of tests modelled after wetest/static. All tests work properly except
 52                 the Property tests. I had to modify "diff" to "diff -w", why that is needed I do not understand.
 53              
 54              
 55              Building poststarttests:
 56              
 57                 cd to .../src/Pegasus/ProviderManager2/JMPI/org/pegasus/jmpi/tests/Load
 58                 Issue "make"
 59              
 60                 This will load a schema to the repository and register the provider.
 61              
 62              
 63              Running poststarttests:
 64 schuur   1.1 
 65                 cd to .../src/Pegasus/ProviderManager2/JMPI/org/pegasus/jmpi/tests
 66                 Issue "find -name "*.rsp" -exec rm {} \;" to clean up *.rsp files
 67                 Issue "make poststarttests"
 68              
 69              
 70              Samples
 71              
 72                 The provider used for posstarttest,
 73              	.../JMPI/org/pegasus/jmpi/test/JMPI_TestPropertyTypes/JMPI_TestPropertyTest.java is a working
 74              	example of how to code an JMPI tyle instance provider.
 75              	This directors also constains the required Makefile.
 76              
 77              	.../JMPI/org/pegasus/jmpi/sample contains more samples, one of which is an incomplete CIMClient
 78              	sample.
 79              
 80              	Notice that all provider classes must be accessibe via the CASSPATH environment setting.
 81              
 82              
 83              Provider Registration
 84              
 85 schuur   1.1    JMPI providers are registered as usual. The Location property in P_ProviderModule has a special format.
 86              	The format is: <jar-file-name>:<provider-class-name>
 87              
 88              	Although jar support is not yet working correctly, this format must be used. You should use cimmofl
 89              	for registration untill cimmof is prepared for JMPI.
 90              
 91                 instance of PG_ProviderModule
 92                 {
 93                    Name = "JMPI_TestPropertyTypesModule";
 94                    Location = "JMPI_TestPropertyTypes.jar:"
 95              		           "org/pegasus/jmpi/tests/JMPI_TestPropertyTypes/JMPI_TestPropertyTypes";
 96                    Vendor = "Pegasus Community";
 97                    Version = "2.0.0";
 98                    InterfaceType = "JMPI";
 99                    InterfaceVersion = "1.0.0";
100                 };
101              
102              
103              Bug reports
104              

105 konrad.r 1.2    Use normal Pegasus bugzilla procedures to report malfunctions. 

106 schuur   1.1 
107              	
108              Regards, Adrian Schuur.
109              
110