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 r.kieninger 1.3 

 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 r.kieninger 1.3    export CLASSPATH=$PEGASUS_ROOT/src/Pegasus/ProviderManager2/JMPI

 28 schuur      1.1    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 mark.hamzy  1.4    There are a couple of optional environment variables to determine how the JRE is initialized.  These are
 34                    as follows (the variable name and what JRE option that it corresponds to):
 35                 
 36                    PEGASUS_JMPI_MAX_HEAP               -Xmx
 37                    PEGASUS_JMPI_INITIAL_HEAP           -Xms
 38                    PEGASUS_JMPI_JAVA_THREAD_STACK_SIZE -Xss
 39                 
 40                    So, for example, you would perform the following if you want to change the maximum heap size to 128 megabytes.
 41                 
 42                    export PEGASUS_JMPI_MAX_HEAP=128m
 43                 

 44 schuur      1.1    When using this script, place a copy of this script above your PEGASUS_HOME directory.
 45                    "cd" to PEGASUS_HOME, and issue ". ../setJPeg". Then do a normal make.
 46                 
 47                 

 48 mark.hamzy  1.4 This installment has a number of restrictios:

 49 schuur      1.1 
 50                    The provider interfaces follow the SNIA OpenWBEM APIs
 51                    Only Instance and Association providers are supported at the moment.
 52                 	SetProperty and GetProperty CIM operations will crash cimserver
 53                    Jar support is not yet implemented - all classes must be accessable via the CLASSPATH variabe.
 54                    The Makefiles are not yet Pegasus conforming.
 55                 	cimmofl must be used for provider registration.
 56                 
 57                 	Unloading of idle providers is not supported and Java will increase the memory footprint.
 58                 
 59                 
 60                 poststarttests
 61                 
 62                    This installment has a set of tests modelled after wetest/static. All tests work properly except
 63                    the Property tests. I had to modify "diff" to "diff -w", why that is needed I do not understand.
 64                 
 65                 
 66                 Building poststarttests:
 67                 
 68                    cd to .../src/Pegasus/ProviderManager2/JMPI/org/pegasus/jmpi/tests/Load
 69                    Issue "make"
 70 schuur      1.1 
 71                    This will load a schema to the repository and register the provider.
 72                 
 73                 
 74                 Running poststarttests:
 75                 
 76                    cd to .../src/Pegasus/ProviderManager2/JMPI/org/pegasus/jmpi/tests
 77                    Issue "find -name "*.rsp" -exec rm {} \;" to clean up *.rsp files
 78                    Issue "make poststarttests"
 79                 
 80                 
 81                 Samples
 82                 
 83                    The provider used for posstarttest,
 84                 	.../JMPI/org/pegasus/jmpi/test/JMPI_TestPropertyTypes/JMPI_TestPropertyTest.java is a working
 85                 	example of how to code an JMPI tyle instance provider.
 86                 	This directors also constains the required Makefile.
 87                 
 88                 	.../JMPI/org/pegasus/jmpi/sample contains more samples, one of which is an incomplete CIMClient
 89                 	sample.
 90                 
 91 schuur      1.1 	Notice that all provider classes must be accessibe via the CASSPATH environment setting.
 92                 
 93                 
 94                 Provider Registration
 95                 
 96                    JMPI providers are registered as usual. The Location property in P_ProviderModule has a special format.
 97                 	The format is: <jar-file-name>:<provider-class-name>
 98                 
 99                 	Although jar support is not yet working correctly, this format must be used. You should use cimmofl
100                 	for registration untill cimmof is prepared for JMPI.
101                 
102                    instance of PG_ProviderModule
103                    {
104                       Name = "JMPI_TestPropertyTypesModule";
105                       Location = "JMPI_TestPropertyTypes.jar:"
106                 		           "org/pegasus/jmpi/tests/JMPI_TestPropertyTypes/JMPI_TestPropertyTypes";
107                       Vendor = "Pegasus Community";
108                       Version = "2.0.0";
109                       InterfaceType = "JMPI";
110                       InterfaceVersion = "1.0.0";
111                    };
112 schuur      1.1 
113                 
114                 Bug reports
115                 

116 r.kieninger 1.3    Use normal Pegasus bugzilla procedures to report malfunctions.
117                 

118 schuur      1.1 
119                 Regards, Adrian Schuur.
120                 
121