Adobe 38000382 JRun Guide - Page 3

iii

CONTENTS

ABOUT THIS BOOK . . . . . . . . . . . . . . . . . . . . . . . . . . . VII

Developer resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

About JRun documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Printed and online documentation set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Accessing online documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Other resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x

Contacting Macromedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

CHAPTER 1

Introduction to the SDK . . . . . . . . . . . . . . . . . . . . . . . . . . 1

About the JRun SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

Getting the SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

SDK/retail differences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

Software requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

SDK file group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Core components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

JRun components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

JRun source code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

JRun installers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

SDK documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

CHAPTER 2

JRun Installer Overview . . . . . . . . . . . . . . . . . . . . . . . . 9

Installer overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

Configuring JRun during installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Custom software requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

User input during installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Setting ports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Setting the JMC username and password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Working with JRun licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Installing multiple instances of JRun . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Building a customized version of JRun . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Building JRun . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Choose components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Setting the language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Setting the platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Setting the destination directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

CHAPTER 3

Windows JRun Installers. . . . . . . . . . . . . . . . . . . . . . . .17

Section	Page
JRun SDK Guide	1
Contents	3
About This Book	7
Developer resources	8
About JRun documentation	9
Printed and online documentation set	9
Accessing online documentation	9
Other resources	10
Contacting Macromedia	13
Introduction to the SDK	15
About the JRun SDK	16
Getting the SDK	16
SDK/retail differences	16
Software requirements	17
SDK file group	18
Core components	18
JRun components	19
JRun source code	20
JRun installers	20
SDK documentation	21
JRun Installer Overview	23
Installer overview	24
Configuring JRun during installation	25
Custom software requirements	25
User input during installation	25
Setting ports	26
Setting the JMC username and password	27
Working with JRun licenses	27
Installing multiple instances of JRun	27
Building a customized version of JRun	28
Building JRun	28
Choose components	28
Setting the language	29
Setting the platform	29
Setting the destination directory	29
Windows JRun Installers	31
Overview of Windows installations	32
Windows Installer environments	32
Non-Windows Installer environments	32
Customizing JRun installers with Windows Installer	33
About merge modules	33
Working with merge modules	33
Merge module list	34
Working with InstallShield Developer 7	35
Determining merge module location	35
Connecting a merge module	36
Using Windows Installer on the command line	38
Using the Windows Installer wrapper	39
Platform-Independent JRun Installers	41
About files for custom installations	42
Using BIN files	42
BIN file list	42
BIN file properties	43
Embedding JRun	45
Connecting to external web servers	46
Silently running the Web Server Configuration tool	46
Including the Web Server Configuration tool in the installer	47
Working with web applications	48
Hiding JSP source code	48
Adding web applications	49
Removing web applications	49
Hiding the JMC	50
Rebranding JRun tools	51
Rebranding the Web Server Configuration tool	51
Rebranding the JRun Launcher	54
Rebranding the JMC	56
JMC source code overview	56
Creating a custom JRun interface	58
Hiding the JMC	58
Deploying applications outside the JRun directory structure	58
Using exit handlers	59
JRunExitHandler interface	59
Exit handler example	59
Exit codes	60
Using the JMC Custom Tag Library	61
Extracting the JMC custom tag library	62
Strategies for working with the JMC custom tags	63
Finding services, classes, and methods	63
Using the service and server attributes	63
Using the mbean attribute	64
Understanding offline properties	64
Using the errorId attribute	65
Using the type and id attributes	65
JMC custom tags reference	66
add	66
addOfflinePropertyValue	68
checkServer	68
getConfiguration	69
getOfflineProperty	70
getOfflinePropertyValues	71
getProperty	71
getServer	72
getServersOnHost	73
invoke	73
isRemoteServer	75
objects	75
parameter	76
removeAllOfflinePropertyValues	77
remove	77
setOfflineProperty	79
setProperty	79
status	80
JRun APIs	81
Using the JRun API Javadocs	82
JRun APIs overview	83
Command-line tools	86
Using the GetControlPort tool	86
Using the migration tool	87
Using Base64 encoder	87
Using the Web Server Configuration tool	87
Using the jrun command	88
Using the jrunsvc tool	88
Using the JSPC tool	89
Using XMLScript	89
Using Java2WSDL	89
Using WSDL2Java	90
JRun executables	91
JRun Services	93
Service architecture (JMX)	94
Creating services	96
Basic JRun services: extending ServiceMBean and ServiceAdapter	96
Service naming convention	96
Service composition: extending ServicePartitionMBean and ServicePartition	96
Creating services using jrun.xml	97
Creating services programmatically	98
Custom service example	99
Accessing JRun services	103
Best practices	103
JNDI	103
Service convenience methods	104
JMX	104
Adding JRun service security	105
Loading MBeans through MLETs	106
Editing XML Files	107
Editing XML files	108
Tools for editing XML files	109
Understanding the XML metadata classes	110
Using XML metadata	111
Strategies	112
Comments	112
Finding metadata classes	112
XML metadata example	113

Adobe 38000382 JRun Guide - Page 3

Contents, About the JRun SDK..2

Page 3 highlights