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

  1 a.dunfey 1.6.8.1 //%2006////////////////////////////////////////////////////////////////////////
  2                  //
  3                  // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
  4                  // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
  5                  // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
  6                  // IBM Corp.; EMC Corporation, The Open Group.
  7                  // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
  8                  // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
  9                  // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
 10                  // EMC Corporation; VERITAS Software Corporation; The Open Group.
 11                  // Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;
 12                  // EMC Corporation; Symantec Corporation; The Open Group.
 13                  //
 14                  // Permission is hereby granted, free of charge, to any person obtaining a copy
 15                  // of this software and associated documentation files (the "Software"), to
 16                  // deal in the Software without restriction, including without limitation the
 17                  // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 18                  // sell copies of the Software, and to permit persons to whom the Software is
 19                  // furnished to do so, subject to the following conditions:
 20                  // 
 21                  // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
 22 a.dunfey 1.6.8.1 // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
 23                  // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
 24                  // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
 25                  // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 26                  // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 27                  // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 28                  // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 29                  //
 30                  //==============================================================================
 31 schuur   1.1     
 32                  Java Manageability Programming Interface - JMPI
 33                  
 34                  Author: Adrian Schuur, schuur@de.ibm.com  - 30 Apr 2004 -
 35                  
 36                  First installment
 37                  
 38                     This installment of JMPI has been committed to the 2.4 branch.
 39                     This installment has been build and tested on Suse 9.0 with Sun's j2sdk 1.4.2_04.
 40 r.kieninger 1.3     
 41 schuur      1.1     
 42                     Environment settings
 43                     
 44                        In order to build this support a few environment variables have to used.
 45                        The following script has been proven useful for setting up the build and execution environment.
 46                        You might need to adjust this to your system layout.
 47                     
 48                        export PEGASUS_HOME=`pwd`
 49                        export PEGASUS_PLATFORM=LINUX_IX86_GNU
 50 konrad.r    1.2        export PEGASUS_ENABLE_CMPI_PROVIDER_MANAGER=1
 51                        export PEGASUS_ENABLE_JMPI_PROVIDER_MANAGER=1
 52 schuur      1.1        export PEGASUS_DEBUG=1
 53                        export JAVA_SDK=/usr/java/j2sdk1.4.2_04
 54                        export JAVA_SDKINC=$JAVA_SDK/include
 55                        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
 56                        export PATH=$JAVA_SDK/bin:$PATH
 57 r.kieninger 1.3        export CLASSPATH=$PEGASUS_ROOT/src/Pegasus/ProviderManager2/JMPI
 58 schuur      1.1        export PATH=$PEGASUS_HOME/bin:$PATH
 59                        export PEGASUS_ROOT=$PEGASUS_HOME
 60                        export LD_ASSUME_KERNEL=2.2.5
 61                        cd $PEGASUS_HOME
 62                     
 63 mark.hamzy  1.5        There is now a new variable to determine which JVM to link with.  The choices are as follows:
 64                     	PEGASUS_JVM	sun	Sun's jvm (ex: j2sdk1.4.2_07)
 65                     	PEGASUS_JVM	ibm	IBM's jvm (ex: IBMJava2-142)
 66                     	PEGASUS_JVM	bea	Suse's IBM jvm (ex: BEAJava2-1.4.2)
 67                        So, pick one and export that variable to the environment.  For example,
 68                     	export PEGASUS_JVM=sun
 69                        NOTE: This is currently listened to for Linux builds.
 70                     
 71 mark.hamzy  1.4        There are a couple of optional environment variables to determine how the JRE is initialized.  These are
 72                        as follows (the variable name and what JRE option that it corresponds to):
 73                     
 74                        PEGASUS_JMPI_MAX_HEAP               -Xmx
 75                        PEGASUS_JMPI_INITIAL_HEAP           -Xms
 76                        PEGASUS_JMPI_JAVA_THREAD_STACK_SIZE -Xss
 77                     
 78                        So, for example, you would perform the following if you want to change the maximum heap size to 128 megabytes.
 79                     
 80                        export PEGASUS_JMPI_MAX_HEAP=128m
 81                     
 82 mark.hamzy  1.6        There is a new environment variable that tells the JVM to output more debugging information.  The variable name 
 83                        is called PEGASUS_JMPI_VERBOSE.  An example usage is as follows:
 84                     
 85                        export PEGASUS_JMPI_VERBOSE="jni,class"
 86                     
 87                        This will tell the JVM to output debug information on the JNI layer and class loading.
 88                     
 89 schuur      1.1        When using this script, place a copy of this script above your PEGASUS_HOME directory.
 90                        "cd" to PEGASUS_HOME, and issue ". ../setJPeg". Then do a normal make.
 91                     
 92                     
 93 mark.hamzy  1.4     This installment has a number of restrictios:
 94 schuur      1.1     
 95                        The provider interfaces follow the SNIA OpenWBEM APIs
 96                        Only Instance and Association providers are supported at the moment.
 97                     	SetProperty and GetProperty CIM operations will crash cimserver
 98                        Jar support is not yet implemented - all classes must be accessable via the CLASSPATH variabe.
 99                        The Makefiles are not yet Pegasus conforming.
100                     	cimmofl must be used for provider registration.
101                     
102                     	Unloading of idle providers is not supported and Java will increase the memory footprint.
103                     
104                     
105                     poststarttests
106                     
107                        This installment has a set of tests modelled after wetest/static. All tests work properly except
108                        the Property tests. I had to modify "diff" to "diff -w", why that is needed I do not understand.
109                     
110                     
111                     Building poststarttests:
112                     
113                        cd to .../src/Pegasus/ProviderManager2/JMPI/org/pegasus/jmpi/tests/Load
114                        Issue "make"
115 schuur      1.1     
116                        This will load a schema to the repository and register the provider.
117                     
118                     
119                     Running poststarttests:
120                     
121                        cd to .../src/Pegasus/ProviderManager2/JMPI/org/pegasus/jmpi/tests
122                        Issue "find -name "*.rsp" -exec rm {} \;" to clean up *.rsp files
123                        Issue "make poststarttests"
124                     
125                     
126                     Samples
127                     
128                        The provider used for posstarttest,
129                     	.../JMPI/org/pegasus/jmpi/test/JMPI_TestPropertyTypes/JMPI_TestPropertyTest.java is a working
130                     	example of how to code an JMPI tyle instance provider.
131                     	This directors also constains the required Makefile.
132                     
133                     	.../JMPI/org/pegasus/jmpi/sample contains more samples, one of which is an incomplete CIMClient
134                     	sample.
135                     
136 schuur      1.1     	Notice that all provider classes must be accessibe via the CASSPATH environment setting.
137                     
138                     
139                     Provider Registration
140                     
141                        JMPI providers are registered as usual. The Location property in P_ProviderModule has a special format.
142                     	The format is: <jar-file-name>:<provider-class-name>
143                     
144                     	Although jar support is not yet working correctly, this format must be used. You should use cimmofl
145                     	for registration untill cimmof is prepared for JMPI.
146                     
147                        instance of PG_ProviderModule
148                        {
149                           Name = "JMPI_TestPropertyTypesModule";
150                           Location = "JMPI_TestPropertyTypes.jar:"
151                     		           "org/pegasus/jmpi/tests/JMPI_TestPropertyTypes/JMPI_TestPropertyTypes";
152                           Vendor = "Pegasus Community";
153                           Version = "2.0.0";
154                           InterfaceType = "JMPI";
155                           InterfaceVersion = "1.0.0";
156                        };
157 schuur      1.1     
158                     
159                     Bug reports
160                     
161 r.kieninger 1.3        Use normal Pegasus bugzilla procedures to report malfunctions.
162                     
163 schuur      1.1     
164                     Regards, Adrian Schuur.
165                     
166                     

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2