1     Foreword............................................................................................................................................... 3

2     JSPservletConfig............................................................................................................................. 3

2.1      Configuration............................................................................................................................... 3

2.2      Display............................................................................................................................................... 3

2.2.1      ID................................................................................................................................................... 4

2.2.2      Keystore........................................................................................................................................ 4

2.2.3      Password...................................................................................................................................... 5

2.2.4      CA certificate URL....................................................................................................................... 5

2.2.5      CRL certificate URL..................................................................................................................... 5

2.2.6      CA user.......................................................................................................................................... 5

2.2.7      CA password................................................................................................................................ 5

2.2.8      CRL user....................................................................................................................................... 5

2.2.9      CRL password.............................................................................................................................. 6

2.2.10     Trace.............................................................................................................................................. 6

2.2.11     Statistics........................................................................................................................................ 6

2.2.12     Resource expiration time........................................................................................................... 6

2.2.13     CRL scan period.......................................................................................................................... 6

2.2.14     Cache path.................................................................................................................................... 6

2.2.15     Log file.......................................................................................................................................... 6

2.2.16     Remote location property file.................................................................................................... 6

2.2.17     All permission policy file............................................................................................................ 7

2.2.18     Default policy file........................................................................................................................ 7

2.2.19     ServletLog name.......................................................................................................................... 7

2.2.20     ServletStat name.......................................................................................................................... 7

2.2.21     Web.xml directory....................................................................................................................... 7

2.2.22     JSPservlet URL............................................................................................................................ 7

2.3      Commands........................................................................................................................................ 8

2.3.1      Check............................................................................................................................................. 8

2.3.2      Generate..................................................................................................................................... 10

2.3.3      Set................................................................................................................................................ 14

2.4      Packaging...................................................................................................................................... 14

2.4.1      Source......................................................................................................................................... 14

2.4.2      Class............................................................................................................................................ 14

3     PublishConfig................................................................................................................................... 15

3.1      Configuration............................................................................................................................ 15

3.2      Display............................................................................................................................................. 15

3.2.1      Repository directory................................................................................................................. 16

3.2.2      Repository URL......................................................................................................................... 16

3.2.3      PageBoxURLs serialized file................................................................................................... 16

3.2.4      Max archive size........................................................................................................................ 16

3.2.5      Log file........................................................................................................................................ 16

3.2.6      Trace........................................................................................................................................... 16

3.2.7      Web.xml directory..................................................................................................................... 16

3.2.8      PublisherServer directory....................................................................................................... 16

3.3      Commands..................................................................................................................................... 17

3.3.1      Check........................................................................................................................................... 17

3.3.2      Generate..................................................................................................................................... 18

3.3.3      Set................................................................................................................................................ 19

3.4      Packaging...................................................................................................................................... 19

3.4.1      Source......................................................................................................................................... 19

3.4.2      Class............................................................................................................................................ 19

 

1        Foreword

The goal of Configurator is to assist the configuration of PageBox and PublisherServer.

From a remote location it allows to:

q      Check configuration parameters on the machines where PageBox and PublisherServer will be deployed

q      Generate PageBox and PublisherServer web.xml

q      Install PageBox and PublisherServer

 

It can be used to configure PageBox and PublisherServer either on an Intranet or on ASPs.

 

Though PageBox and PublisherServer have only few extensively documented parameters, we develop Configurator:

1.      To help users to create their first configuration

2.      Because some parameters are absolute paths likely to change for instance from an ASP to another

3.      To simplify the setting of PageBox constellations

 

Configurator is made of two servlets:

q      JSPservletConfig, responsible to configure PageBox

q      PublishConfig, responsible to configure PublisherServer

 

Configurator principle is to install the bootstrap servlets on target machines to set up PageBox and PublisherServer. For the moment it supports only application server (Tomcat and Resin) version.

2        JSPservletConfig

2.1       Configuration

JSPservletConfig has no initialization parameter. It can be configured in web.xml as below:

 

 

With Tomcat 3.1 or 3.2, it can simply be copied in the servlet directory and invoked through org.apache.tomcat.servlets.InvokerServlet with a URL http://myhostport/servlet/JSPservletConfig.

2.2       Display

When you call JSPservletConfig, the first time, you are displayed the form below with default values:

Figure 1: JSPservletConfig

2.2.1     ID

Unique JSPservlet identifier.

 

Web.xml initialization parameter for JSPservlet: ID.

Default value: none. Mandatory.

2.2.2     Keystore

keystore is the name of the key store in cachePath directory, for instance “keystore” but not “/mydir/keystore” or “mydir/keystore”.

 

If keystore is set, when JSPservletPkg downloads an archive, it tries

·        To download a certificate from the same location as the archive and named archive.cer. If it finds, it adds the certificate to cachePath/keystore, which has to be in Sun JKS format with an archive alias

·        To download a permission file from the same location as the archive and named archive.policy. This file should only contain permission entries. JSPservletPkg adds a keystore line, builds the appropriate grant line and stores it in cachePath/archive.policy in order to implement a sandbox with the permissions requested by the provider.

 

Web.xml initialization parameter for JSPservlet: keystore.

Default value: keystore.

2.2.3     Password

Password JSPservletPkg uses to access the keystore.

 

Web.xml initialization parameter for JSPservlet: keystorePassword.

Default value: keystorePassword.

2.2.4     CA certificate URL

When JSPservletPkg implements sandboxes, it processes signed archives and retrieve classes certificate chain. If CAURL is set, it connects to this URL and expects to retrieve a Certificate Authority certificate used in the classes certificate chain.

 

Web.xml initialization parameter for JSPservlet: CAURL.

Default value: none.

2.2.5     CRL certificate URL

When JSPservletPkg implements sandboxes, it processes signed archives and retrieve classes certificates.

If CRLURL is set, it connects to this URL and expects to retrieve a Certificate Revocation List (CRL) used to check if a class certificate is revoked.

 

Web.xml initialization parameter for JSPservlet: CRLURL.

Default value: none.

2.2.6     CA user

Principal used to connect to the Directory server to retrieve CAURL.

 

Web.xml initialization parameter for JSPservlet: CALDAPuser.

Default value: none.

2.2.7     CA password

Password used to connect to the Directory server to retrieve CAURL.

 

Web.xml initialization parameter for JSPservlet: CALDAPpasswd.

Default value: none.

2.2.8     CRL user

Principal used to connect to the Directory server to retrieve CRLURL.

 

Web.xml initialization parameter for JSPservlet: CRLLDAPuser.

Default value: none.

2.2.9     CRL password

Password used to connect to the Directory server to retrieve CRLURL.

 

Web.xml initialization parameter for JSPservlet: CRLLDAPpasswd.

Default value: none.

2.2.10  Trace

Tells if JSPservlet must write diagnostic messages.

 

Web.xml initialization parameter for JSPservlet: toTrace.

Default value: set.

2.2.11  Statistics

Tells if JSPservlet must record statistics.

 

Web.xml initialization parameter for JSPservlet: toStat.

Default value: set.

2.2.12  Resource expiration time

You set this parameter to minimize the round trip number between the browser and the server.

JSPservlet sets the Expire header field of static content (content with an extension different of class). It computes the Expire as current_time + expiration.

expiration unit is second.

 

Web.xml initialization parameter for JSPservlet: expiration.

Default value: 30.

2.2.13  CRL scan period

Defines how often JSPservlet connect to check for CRL updates in seconds.

 

Web.xml initialization parameter for JSPservlet: CRLperiod.

Default value: 30.

2.2.14  Cache path

Location where presentation archives are locally stored after been retrieved from remote location.

 

Web.xml initialization parameter for JSPservlet: CachePath.

Default value: current path in JSPservletConfig context.

This default is a clue, not an appropriate value.

2.2.15  Log file

Tells where JSPservlet must write diagnostic messages.

 

Web.xml initialization parameter for JSPservlet: logFile.

Default value: Cache path + File.separator + JSPservlet.log.

 

If you set Cache path to a value different of current path and click on Check, then Log file is updated.

2.2.16  Remote location property file

Location of a property file containing presentation archive names and associated URLs.

 

Web.xml initialization parameter for JSPservlet: remoteLocations.

Default value: Cache path + File.separator + remoteLocation.properties.

 

If you set Cache path to a value different of current path and click on Check, then Remote location property file is updated.

2.2.17  All permission policy file

If it is set, allPermissionPolicy is the path to a policy file with syntax conforming to the Java 2 security specification. If defaultPolicy is also set it means:

1.      JSPservletPkg will implement sandboxes. So every archive will run with the permissions defined either in cachePath/archive.policy or in cachePath/java.policy where:

-        cachePath is the cachePath initialization parameter value

-        archive is the archive name without suffix

2.      The Java server itself will run with the permission described in allPermissionPolicy.

 

Web.xml initialization parameter for JSPservlet: allPermissionPolicy.

Default value: Cache path + File.separator + allPermission.policy.

2.2.18  Default policy file

If it is set, defaultPolicy is the path to a policy file with syntax conforming to the Java 2 security specification. If allPermissionPolicy is also set it means:

1.      JSPservletPkg will implement sandboxes. So every archive will run with the permissions defined either in cachePath/archive.policy or in cachePath/java.policy where:

-        cachePath is the cachePath initialization parameter value

-        archive is the archive name without suffix

If no policy applies to the archive, then defaultPolicy is used

2.      The Java server itself will run with the permission described in allPermissionPolicy.

 

Web.xml initialization parameter for JSPservlet: defaultPolicy.

Default value: Cache path + File.separator + default.policy.

2.2.19  ServletLog name

Sets the name JSPservlet log display will be called with (<servlet-mapping> tag in web.xml).

Default value: ServletLog.

2.2.20  ServletStat name

Sets the name JSPservlet statistic display will be called with (<servlet-mapping> tag in web.xml).

Default value: ServletStat.

2.2.21  Web.xml directory

Specifies the directory where JSPservlet will be installed.

Default value: Cache path + File.separator + WEB-INF.

 

This parameter is mandatory only for set command.

2.2.22  JSPservlet URL

Specifies the URL where JSPservlet will be downloaded from.

Default value: http://pagebox.net/tomcat.jar. It points the most recent version of JSPservlet, compiled for Tomcat 3. If your application server is Resin 1.1 or 1.2, change to http://pagebox.net/resin.jar.

 

This parameter is mandatory only for set command.

2.3       Commands

We recommend running the commands in the following order:

1.      Once you have set fields (the most important ones being ID and Cache path), check

2.      Once you have checked messages, generate to display the JSPservlet web.xml

3.      set to install JSPservlet on the target machine

2.3.1     Check

Checks if parameters are valid. After setting the ID and the Cache path, you are typically displayed this:

 

Figure 2: check

Messages are prefixed by:

q      Mandatory: a mandatory parameter was not set

q      Error: JSPservlet will not work with these parameters

q      Warning: JSPservlet can work with these parameters if you take the proposed action

2.3.2     Generate

Generate returns a web.xml file based on your JSPservletConfig form settings. For instance, with the parameters we set above: