Previous Contents


Index


A

access control
login/password authentication
adaptor client,  85 to 86
HTML adaptor,  53
HTTP/SSL adaptor,  52
HTTP/TCP adaptor,  52
HTTP/UDP adaptor,  52
implementing,  59
overview,  58
overview,  58
RMI adaptor,  65
SNMP adaptor,  60

access methods
SNMP group,  237 to 239
SNMP table,  239 to 243

ACL (access control list) file
acl variable group,  60
default location,  60
example,  63 to 64
format,  60 to 62
grammar definition,  64
template,  60
trap variable group,  62

ACL (access control list) object,  65

acl variable group,  60

action
design pattern,  39
example,  16
performing
in job tool,  114
in web browser,  105
suppressing in c-bean,  69, 75
translation in c-bean,  74

activation interface,  134

adaptor
access control
HTML adaptor,  53
HTTP/SSL adaptor,  52
HTTP/TCP adaptor,  52
HTTP/UDP adaptor,  52
overview,  58
SNMP adaptor,  60
access to,  57
adding to agent,  20, 56
authentication
implementing,  59
overview,  58
HTML,  53
HTTP/SSL,  52
HTTP/TCP,  52
HTTP/UDP,  52
IIOP,  53 to 55
implementing,  65
introduced,  4
operation,  57
overview,  51
protocols supported,  51
RMI
access control,  65
multiple,  56, 84
overview,  52
SNMP
access control,  60
binding to MIB,  245
loading MIB into,  243
overview,  55, 223
port number, specifying,  244

adaptor client
access to Java manager,  57
adding,  83
API,  13, 219
authentication,  85 to 86
class loader,  87 to 88
connecting,  26, 84
deleting m-bean instance,  96 to 97
disconnecting,  28
getting properties,  90
HTTP/SSL,  83
HTTP/TCP,  82
HTTP/UDP,  82
IIOP,  83
initializing,  83
instantiating
in manager,  25
m-bean by,  26, 95 to 96
local exception,  123
mapping service,  87
operation,  79
operations on agent,  27, 88
protocols supported,  82
retrieving m-bean,  88
RMI,  82
services required,  86
setting properties,  93
transferring m-bean instances,  96

adaptorMO interface
c-bean, use of,  80
mapping rules for class names,  81
overview,  79

AdaptorServerImpl class, SNMP,  245

addDBObject method,  43, 45, 47

addMonitorListener method,  202

addObject method,  43, 45

addSchedulerListener method,  194

agent
adding adaptor,  20, 56
adding metadata service,  20
adding monitor,  200 to 201
cascading,  9, 217 to 219
connecting
to adaptor client,  84
to job tool,  108
to web browser,  102
example,  18 to 21
loading,  174
master,  217
operations by adaptor client,  27, 88
remote,  219
SNMP
access methods,  237 to 239, 239 to 243
initializing MIB in,  244
integrated,  235
integration with framework,  235
IP address, specifying,  248
loading MIB into,  245 to 246
overview,  235 to 237
port number, specifying,  248
representation to manager,  247
snmpdx,  244
standalone,  237
subagent,  217

Agent Administration web page,  105, 106

alarm clock service,  8, 192
timeout,  192 to 193

AlarmClock class,  192

AlarmClockEvent class,  192

AlarmClockListener interface,  192

asynchronous operation,  249, 251

atomic operation,  238

attribute-value pair,  42

AUGMENT construct,  223

authentication
adaptor client,  85 to 86
HTML adaptor,  53
HTTP/SSL adaptor,  52
HTTP/TCP adaptor,  52
HTTP/UDP adaptor,  52
implementing,  59
overview,  58

AuthInfo class,  59

B

base agent
default,  9
debug mode,  121 to 122
designing,  11

base services,  127 to 137
introduced,  7

BeanBox,  298

benefits,  5 to 6

Boolean property, design pattern,  35

bootstrap service,  8
loading an agent,  174
loading Java Dynamic Management Kit,  176
running,  176
use of the MLET tag,  173

C

cache
c-bean,  92, 95
m-let service,  171

cascading agent
service,  9, 217 to 219
suppressing code for in c-bean,  69

cb_newDBMO method,  96

c-bean
action,  74
suppressing,  69, 75
cache,  92, 95
cascading, suppressing,  69
definition,  4
event, suppressing,  69, 190
example,  22 to 23
flattened,  68 to 69, 72 to 74
generating from m-bean,  11
inheritance,  71
listener, suppressing,  69, 190
mapping from m-bean,  71 to 76
methods not present in m-bean,  76
performance enhancement,  76
property, from m-bean,  74
read-only,  68
use by adaptorMO interface,  80

cipher suite,  53

class
in object name,  42, 116
Java, to be instantiated,  117

class and library server
implementing,  149
retrieving and updating search paths,  149
starting,  148

class loader,  7, 95
adaptor client,  87 to 88
dynamically adding,  151
for instantiating m-bean,  118
implementing,  142
object name,  150
statically adding,  152
types of,  139

CLASSPATH environment variable,  122, 283, 284, 285

client bean, See c-bean

com.sun.jaw.impl.agent.services.jawdiscovery,  292

com.sun.jaw.impl.agent.services.persistent,  291

communications protocols
adaptor clients,  82
adaptors,  51

community, SNMP,  61, 248

comparison level, counter monitor,  204

components, of product,  6 to 10

connection states,  231

CORBA (common object request brokerage architecture),  53 to 55

core management framework, See framework

Counter,  233

counter monitor
comparison level,  204
differences,  206
modulus value,  199, 206
offset,  205
overview,  199
parameters,  204
restrictions,  199

Counter64,  233

CounterMonitor class,  200

CounterMonitorMO class,  200

CRAM-MD5 (Challenge-Response Authentication Mechanism using MD5),  58

D

datagram socket,  212

Debug class,  119

debug messages,  119 to 120

debugging tools,  101

default base agent
debug mode,  121 to 122
overview,  9

deleteCmf method,  39

deleting, m-bean
by adaptor client,  96 to 97
in job tool,  116
in web browser,  105 to 106
method for,  37, 39

design patterns, for m-bean,  33 to 39

development process, overview,  10 to 14

difference monitoring,  206, 208

discovery response object,  210

discovery service,  9
client,  210
job tool,  108
monitor,  215
overview,  209
responder,  211
listener interface,  214, 215
scope,  211
search service,  210
starting,  214
support service,  214

Discovery Setup window,  109

Discovery window,  108

DiscoveryClient class,  210

DiscoveryMonitor class,  214, 215

DiscoveryResponder class,  211

DiscoveryResponderListener interface,  214, 215

dispatcher,  249

Display String,  232

domain
in object name,  41, 42, 116
specifying in job tool,  112

dynamic loading services,  139

E

Enumerated class,  231

Enumerated List,  233

enumerated types, SNMP,  231

EnumtcpConnState class,  231

environment variables,  283 to 286

error handling, SNMP PDU,  249

event
from monitor,  202
listener,  36
listener, adding,  191
reception by manager,  187
scheduler,  194 to 196, 198
service,  185
source, design patterns,  36 to 37
suppressing code generation in c-bean,  69, 190
value change,  123

event handler, defining,  191

event object,  186

EventHandlerIf interface,  191

EventObject class,  186

example
action,  16
agent,  18 to 21
c-bean,  22 to 23
Java Beans Development Kit,  295
manager, Java,  24 to 28
m-bean development,  16 to 17
MLET tag,  163
property,  16
Simple,  15

extensibility,  5

external application, access to an agent,  4

F

filter,  48

filtering service,  136

flattened c-bean,  68 to 69, 72 to 74

framework
initializing,  19
initializing MIB in,  244
instantiating m-bean,  44 to 46
integration with SNMP agent,  235
introduced,  2
registering m-bean using,  45

G

gauge monitor
differences,  208
hysteresis mechanism,  200, 207
overview,  199
parameters,  207
restrictions,  200
threshold values,  207
multiple,  209

GaugeMonitor class,  200

GaugeMonitorMO class,  200

Get request,  250

GetBulk request,  250

GetNext request,  250

getObject method,  90

getOnlyNames method,  90

getter method
design pattern,  34, 35
restrictions,  123

getting, property,  49

grammar definition, ACL file,  64

granularity period, of monitor,  203

group, SNMP
access methods,  237 to 239
generated code,  229
m-bean,  229, 232
metadata,  230

H

handleAlarmClock method,  192

handleMonitor method,  202

handleScheduler method,  198

HTML adaptor,  53

HTTP/SSL
adaptor,  52
adaptor client,  83

HTTP/TCP
adaptor,  52
adaptor client,  82

HTTP/TCP adaptor
adding to agent,  20

HTTP/UDP
adaptor,  52
adaptor client,  82

hysteresis mechanism,  200, 207

I

icons, job tool,  111

IDL (Interface Definition Language),  55

IIOP (Internet Inter-ORB Protocol)
adaptor,  53 to 55
adaptor client,  83

implementation packages,  289
com.sun.jaw.impl.adaptor,  293
com.sun.jaw.impl.agent.services,  290
com.sun.jaw.impl.agent.services.alarm,  292
com.sun.jaw.impl.agent.services.bootstrap,  291
com.sun.jaw.impl.agent.services.light,  291
com.sun.jaw.impl.agent.services.loader,  291
com.sun.jaw.impl.agent.services.mlet,  291
com.sun.jaw.impl.agent.services.monitor,  291
com.sun.jaw.impl.agent.services.scheduler,  292
com.sun.jaw.impl.agent.services.security,  292
com.sun.jaw.impl.base,  292
com.sun.jaw.impl.common,  290
com.sun.jaw.impl.mapper,  292
com.sun.jaw.impl.server,  293
com.sun.jaw.impl.server.tools,  293

index, SNMP,  242

indexed property, design pattern,  35

inheritance
m-bean design,  5
translation in c-bean,  71

initCmf method
registering m-bean using,  45
signature,  37
SNMP MIB object,  243

initializing
adaptor client,  83
m-bean,  37 to 38
metadata,  243
MIB,  229, 244

in-line definition,  231

instantiating, m-bean
by adaptor client,  26, 95 to 96
by framework,  44 to 46
in job tool,  115
in web browser,  105 to 106
parameters,  116 to 118

Integer,  233

Integer64,  233

InvalidPropertyValueException exception,  195

IP address,  232
of agent,  248

IPAclSrvIf interface,  65

isActive method,  196

isPersistent method,  47

isQuerySrv method,  48

J

Java application, managing,  5

Java Dynamic Management Kit
benefits,  5 to 6
loading,  176
overview,  1

Java manager
access to adaptor,  57
access to m-bean,  80
adding adaptor client,  83
adding monitor,  200
developing with code from mogen,  76 to 77
developing, overview,  13
event reception,  187
example,  24 to 28

Java Reflection API,  71

JAVA_HOME environment variable,  284

JavaBeans component
management by Java Dynamic Management agents,  295
model,  3, 33

jaw.acl file,  60

jaw.env script,  284

jaw.env.bat batch file,  286

JAW_HOME environment variable,  283, 284, 285

job tool,  12
connecting to an agent,  108
deleting m-bean,  116
discovering agents,  108
domain, specifying,  112
icons,  111
instantiating m-bean,  115
listing available classes,  117
m-bean property, modifying,  113
overview,  102, 107
performing action on m-bean,  114
starting,  107
viewing m-beans as a list,  111
window,  110

K

key concepts,  2 to 4

keys, in object name,  42, 117

L

launcher service,  8

LD_LIBRARY_PATH environment variable,  283, 284

library
loading,  142
location,  144
security management,  145

library loader,  7

listener,  36
adding,  191
implementing,  190 to 191
interface definition,  186
methods in m-bean,  187
monitor,  202
scheduler,  194
suppressing code generation in c-bean,  69, 190

loading
agent,  174
classes,  139
Java Dynamic Management Kit,  176
library,  142
metadata,  252
MIB
into agent,  245 to 246
into SNMP adaptor,  243

local exception, adaptor client,  123

logging, debug messages,  120

login/password authentication
adaptor client,  85 to 86
HTML adaptor,  53
HTTP/SSL adaptor,  52
HTTP/TCP adaptor,  52
HTTP/UDP adaptor,  52
implementing,  59

M

managed bean, See m-bean

ManagedObject interface,  76

management operations
Java manager,  80
performing
with adaptor client,  27
with job tool,  113
with web browser,  103

manager
Java
access to adaptor,  57
access to m-bean,  80
adding adaptor client,  83
adding monitor,  200
developing with code from mogen,  76 to 77
developing, overview,  13
event reception,  187
example,  24 to 28
SNMP
API,  224
asynchronous operation,  249, 251
code generation,  226, 229
MIB representation,  229
overview,  247
representation of remote agent,  247
synchronous operation,  251

managing
agent, with web browser,  102
Java application,  5

mapping
class names,  81
m-bean to c-bean,  71 to 76
SNMP to Java syntax,  232

mapping service,  87

master agent,  9, 217

m-bean
access by Java manager,  80
action
design pattern,  39
example,  16
performing in job tool,  114
performing in web browser,  105
translation in c-bean,  74
definition,  3
deleting
by adaptor client,  96 to 97
in job tool,  116
in web browser,  105 to 106
method for,  37, 39
design patterns,  33 to 39
developing, example,  16 to 17
event source design patterns,  36 to 37
implementation of SNMP MIB,  235
inheritance,  5
translation in c-bean,  71
initializing,  37 to 38
instantiating
by adaptor client,  26, 95 to 96
by framework,  44 to 46
in job tool,  115
in web browser,  105 to 106
parameters,  116 to 118
remotely,  141
listener methods,  187
management operations
performing with job tool,  113
performing with web browser,  103
mapping to c-bean,  71 to 76
object name
definition,  41 to 43
persistent,  44, 47
property
design patterns,  34 to 35
example,  16
reading and writing,  49 to 50, 90 to 95, 103, 113
translation in c-bean,  74
registering
existing,  43 to 44
in persistent storage,  47
instantiating simultaneously,  44 to 46
using framework,  45
using initCmf method,  45
retrieving,  47 to 49
by adaptor client,  88
skeletal,  229, 230
SNMP group,  229, 232
SNMP table,  230
testing,  10, 12
transferring,  96
volatile,  44

m-bean properties web page,  103, 104

metadata
initializing,  243
loading into MibStore object,  252
MIB,  229
MIB II,  243
MIB II system group,  237
SNMP group,  230
SNMP table,  230
SNMP table entry,  240

metadata service,  134
adding to agent,  20

method
in c-bean only,  76
translation in c-bean,  74

MIB (management information base)
binding to SNMP adaptor,  245
generation of Java code from, See mibgen compiler
initializing,  229, 244
loading
into agent,  245 to 246
into SNMP adaptor,  243
m-bean implementing,  235
metadata,  229
representation as Java class,  229
SNMP versions supported,  223, 225

MIB II
Java class for,  243
metadata,  237, 243
system group,  237
TCP connection states,  231
TCP group,  239

mibgen compiler
command for starting,  225 to 227
mapping rules,  232
output
enumerated types,  231
example,  228
group,  229
overview,  227
table,  230
whole MIB,  229
overview,  223, 225
special characters,  229

MibStore class,  229
loading metadata into,  252

m-let document file
loading,  164

m-let service,  8, 159
adding,  163
caching and version control,  171
error checking,  168
instantiating an m-bean from another m-bean,  170
instantiating and running an m-bean,  171
object name of class loader,  168
specifying m-bean object names,  169

MLET tag
example,  163
syntax,  160
use,  160

MO interface,  70, 80

modulus value,  199, 206

mogen compiler
action, suppressing,  69, 75
cascading agent, suppressing,  69
command for starting,  68 to 70
event, suppressing,  69, 190
inheritance,  71
listener, suppressing,  69, 190
mapping rules,  71 to 76
methods,  74
modifying generated code,  77
output,  70 to 76
overview,  67
properties,  74
using generated code,  76 to 77
listeners and events,  190 to 191

monitor
adding,  200 to 201
counter
comparison level,  204
differences,  206
modulus,  199, 206
offset,  205
overview,  199
restrictions,  199
counter parameters,  204
discovery service,  215
event,  202
gauge
differences,  208
hysteresis mechanism,  200, 207
overview,  199
parameters,  207
restrictions,  200
threshold values,  207
threshold values, multiple,  209
granularity period, setting,  203
listener interface,  202
property to be monitored, specifying,  203
starting and stopping,  209
types,  199

MonitorEvent class,  202

monitoring service,  8

MonitorListener interface,  202

MonitorListenerMO interface,  202

MoRepSrvIf interface,  47, 48

MOStub stub object,  70, 80

multicast discovery response,  211, 213

multicast event source, design pattern,  36

multicast group,  109

multicast port,  109

multicasting,  9

multiplexing,  249, 251

multithreading,  122

N

name server,  53

nameserv script,  53

native library
debugging,  122
loading,  142
location,  144
security management,  145

newDBObject method,  44, 45

newObject method,  44, 45

notifyPastEvents flag,  193, 197

O

Object identifier,  232

object name
class,  116
class loader,  87, 95, 150
default,  46
definition,  41 to 43
domain,  116
keys,  117
retrieving m-bean using,  47
syntax,  42

ObjectName class,  41

offset, counter monitor,  205

Opaque string,  232

P

packages
implementation,  289
reference,  287

parseDebugProperties method,  120

PATH environment variable,  283, 284, 285

peer, SNMP,  247

performAddEvent method,  195

performance enhancement, of c-bean,  76

performFindAdaptors method,  214

performFindHosts method,  214

performRemoveEvent method,  196

persistent m-bean,  44, 47

persistent repository,  129

PersistentRepSrv class,  47

polling, SNMP,  255

port allocations
IIOP adaptor,  53
RMI adaptor,  56, 84
SNMP adaptor,  244, 248

product components,  6 to 10

properties window,  114

property
accessor methods,  34
restrictions,  123
design patterns,  34 to 35
example,  16
setting with the BeanBox,  298

protocol adaptor, See adaptor

protocols
adaptor clients,  82
adaptors,  51

proxy server,  52

R

reading, property,  49

read-only c-bean,  68

reference packages,  287
com.sun.jaw.reference.agent.cmf,  288
com.sun.jaw.reference.agent.services,  288
com.sun.jaw.reference.client.adaptor,  289
com.sun.jaw.reference.client.mo,  289
com.sun.jaw.reference.common,  288
com.sun.jaw.reference.mapper,  289
com.sun.jaw.reference.query,  289

registering, m-bean
existing,  43 to 44
in persistent storage,  47
instantiating simultaneously,  44 to 46
using framework,  45
using initCmf method,  45

relationship service,  137

reload period, web page,  104

remote agent,  219

remote m-bean, instantiating,  141

RemoteAgent class,  219

repository
evaluation of filters,  48
interface definition,  47
registering m-bean,  43 to 46
in persistent storage,  47
using framework,  45
using initCmf method,  45

repository service,  128

RepositorySrv class,  47

request, SNMP,  250
creating,  249
packet size, specifying maximum,  248

response handler, SNMP,  251

retries, specifying maximum for SNMP requests,  248, 249

retrieving, m-bean,  47 to 49

RFC1945,  58

RFC2104,  58

RFC2195,  58

RMI (remote method invocation)
adaptor
access control,  65
multiple,  56, 84
overview,  52
adaptor client,  82

rmiregistry command,  56, 84

S

scalability,  5

scheduler
creating,  193
event,  194 to 196, 198
listener interface,  194
overview,  8, 193
starting and stopping,  196

SchedulerEvent class,  194

SchedulerListener interface,  194

scope, discovery service,  211

search key, in object name,  42

search service, discovery,  210

security, See access control,  58

services
alarm clock,  192
bootstrap,  173
discovery,  209
dynamic loading,  139
event handling,  185
filtering,  136
m-let,  159
monitoring,  199
relationship,  137
repository,  128

session, SNMP,  249 to 250

Set request,  250

setComparisonLevel method,  204

setCounterDifferenceOnOff method,  206

setGaugeDifferenceOnOff method,  208

setGranularityPeriod method,  203

setModulusValue method,  206

setNotifyHighOnOff method,  208

setNotifyLowOnOff method,  208

setNotifyOnOff method,  204

setObservedObject method,  203

setObservedProperty method,  203

setPointToPointResponsePort method,  212, 213

setter method
design pattern,  34, 35
restrictions,  123

setThresholdHighValue method,  207

setThresholdLowValue method,  207

setTimeout method,  192

setting, property,  50

Simple example,  15

simple property, design pattern,  34

singleton,  42, 43

skeletal m-bean,  229, 230

smart agent,  6

SNMP (simple network management protocol)
adaptor
access control,  60
binding MIB to,  245
loading MIB into,  243
overview,  55, 223
port number, specifying,  244
agent
access methods,  237 to 239, 239 to 243
initializing MIB in,  244
integrated,  235
integration with framework,  235
IP address, specifying,  248
loading MIB into,  245 to 246
overview,  235 to 237
port number, specifying,  248
representation to manager,  247
snmpdx,  244
standalone,  237
community,  61, 248
enumerated types,  231
error handling,  249
group
access methods,  237 to 239
generated code,  229
m-bean,  229, 232
metadata,  230
variable,  238
index,  242
manager
API,  10, 224
asynchronous operation,  249, 251
code generation,  226, 229
MIB representation,  229
overview,  247
representation of remote agent,  247
synchronous operation,  251
MIB compiler, See mibgen compiler
multiplexing,  249, 251
peer,  247
polling,  255
request,  250
creating,  249
packet size, specifying maximum,  248
response handler,  251
retries, specifying maximum,  248, 249
session,  249 to 250
socket,  249
special characters in MIB,  229
table
access methods,  239 to 243
adding and removing entries,  241
generated code,  230
m-bean,  230
metadata,  230
table entry,  240
time-out, specifying maximum,  248
trap,  62, 253 to 255
variable,  232
variable bindings,  250
versions supported,  223, 225

SnmpAdaptorName property,  246

snmpdx agent,  244

SnmpHandlerIf interface,  251

SnmpMib class,  229, 243, 245

SnmpMibTableRemCreate class,  242

SnmpOptions class,  249

SnmpParameter class,  248

SnmpPeer class,  247

SnmpPollRequest class,  255

SnmpRequest class,  250, 255

SnmpSession class,  249

SnmpSocket class,  249

SnmpTableEntryEvent class,  241, 242

SnmpTableEntryListener interface,  241

SnmpTrapAgent class,  253, 254

SnmpTrapListener interface,  253

SnmpV2TrapListener interface,  254

SnmpVar class,  250

SnmpVarbindList class,  250

socket
datagram,  212
SNMP,  249
TCP/IP,  53

special characters, in SNMP MIB,  229

SSL (Secure Sockets Layer),  52

state property, discovery monitor,  215

stub object,  4

subagent,  9, 217

SunScreen SKIP,  65

support service, discovery,  214

synchronization, See atomic operation

synchronous operation,  251

system group,  237

system properties, for debugging,  120

T

table entry, SNMP,  240

table, SNMP
access methods,  239 to 243
generated code,  230
m-bean,  230
metadata,  230

TCP connection states,  231

TCP group,  239

TCP/IP (transmission control protocol/Internet protocol),  52
socket,  53

template.acl file,  60

thread, debugging,  122

threshold values, gauge monitor,  207
multiple,  209

time to live,  109, 211

timeout, alarm clock service,  192 to 193

time-out, specifying maximum for SNMP requests,  248

TimeTicks,  233

TooManyListenersException exception,  37

trace level,  119 to 120

trace messages, See debug messages

trap variable group,  62

trap, SNMP,  62, 253 to 255

troubleshooting,  119 to 123

Truth value,  233

type definition,  231

U

UDP (user datagram protocol),  52

UnauthorizedSecurityException exception,  85

unicast discovery response,  211, 212

unicast event source, design pattern,  37

V

VALUE_CHANGE_EVT event,  123

variable
SNMP group,  238
SNMP table,  232

variable bindings,  250

version control,  171

volatile m-bean,  44

volatile repository,  129

W

web browser
connecting to agent,  10, 102
deleting m-bean,  105 to 106
instantiating m-bean,  105 to 106
managing agents,  102
m-bean property, modifying,  103
performing action on m-bean,  105
reload period,  104

writing, property,  50


Copyright 1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California 94303 U.S.A.
Copyright in French


Previous Contents