Mercurial > hg > blitz_condensed
comparison docs/serviceui.html @ 0:3dc0c5604566
Initial checkin of blitz 2.0 fcs - no installer yet.
author | Dan Creswell <dan.creswell@gmail.com> |
---|---|
date | Sat, 21 Mar 2009 11:00:06 +0000 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:3dc0c5604566 |
---|---|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> | |
2 <html> | |
3 <head> | |
4 <title>ServiceUI Support</title> | |
5 <link rel="stylesheet" type="text/css" href="ssl.css" /> | |
6 </head> | |
7 <body> | |
8 <h1>ServiceUI Support</h1> | |
9 | |
10 <h3>JINI 2.0 vs JINI 2.1</h3> | |
11 | |
12 <p> | |
13 All the command line examples below are designed for use with JINI 2.1. To make these command-lines work with JINI 2.0 substitute <code>jsk-platform.jar</code> for <code>jsk-lib.jar</code> | |
14 </p> | |
15 <h2>Getting Started</h2> | |
16 | |
17 <p>Before you can configure and use the support for ServiceUI, you must download the ServiceUI v1.1 binaries (and source if you desire) from <a href="http://www.artima.com/jini/serviceui/CodeAccess.html">here</a> (note that you'll need a JINI.org login account).</p> | |
18 | |
19 <p>To use the example config files provided in the Blitz distribution, unpack the ServiceUI distribution and copy the serviceui-1.1.jar to <blitz_root>/thirdpartylib where <blitz_root> is the root directory in which you've installed the Blitz distribution.</p> | |
20 | |
21 <h2>Dashboard</h2> | |
22 | |
23 <h3>Configuration Changes</h3> | |
24 | |
25 <p>To use Dashboard as a ServiceUI, we must make additions to classpath and codebase, after which we must modify the initial attributes for the Blitz proxy.</p> | |
26 | |
27 <p>First we change the codebase in the start <code>.config</code> to add the Blitz ServiceUI <code>.jar</code>:</p> | |
28 | |
29 <pre> | |
30 private static codebase = ConfigUtil.concat(new Object[] { | |
31 "http://", ConfigUtil.getHostName(), ":", codebasePort, "/", | |
32 "blitz-dl.jar"}); | |
33 </pre> | |
34 | |
35 <p>to:</p> | |
36 | |
37 <pre> | |
38 private static codebase = ConfigUtil.concat(new Object[] { | |
39 "http://", ConfigUtil.getHostName(), ":", codebasePort, "/", | |
40 "blitz-dl.jar", " ", | |
41 "http://", ConfigUtil.getHostName(), ":", codebasePort, "/", | |
42 "blitzui.jar", " ", | |
43 "http://", ConfigUtil.getHostName(), ":", codebasePort, "/", | |
44 "backport-util-concurrent50.jar" // Or the JDK 1.4 version (remove the "50") | |
45 }); | |
46 </pre> | |
47 | |
48 <b>NOTE:</b> You will need to ensure the backport <code>.jar</code> is in the directory your codebase server distributes <code>.jar</code>s from. | |
49 | |
50 <p>Then we modify the classpath to add both the Blitz ServiceUI .jar and the ServiceUI library .jar:</p> | |
51 | |
52 <pre> | |
53 static classpath = ConfigUtil.concat(new Object[] { | |
54 jiniRoot, "jsk-lib.jar", | |
55 separator, jiniRoot, "sun-util.jar", separator, dbLib, | |
56 separator, blitzLib, "blitz.jar"}); | |
57 | |
58 </pre> | |
59 | |
60 <p>to:</p> | |
61 | |
62 <pre> | |
63 static classpath = ConfigUtil.concat(new Object[] { | |
64 jiniRoot, "jsk-lib.jar", | |
65 separator, jiniRoot, "sun-util.jar", separator, dbLib, | |
66 separator, blitzLib, "blitz.jar", | |
67 separator, blitzLib, "blitzui.jar", | |
68 separator, otherLib, "serviceui-1.1.jar"}); | |
69 </pre> | |
70 | |
71 <p>The initial registration attributes are set using the <code>initalAttrs</code> configuration variable in the <code>blitz.config</code> file - we must add some imports:</p> | |
72 | |
73 <pre> | |
74 import net.jini.core.entry.Entry; | |
75 import org.dancres.blitz.serviceui.DashboardUI; | |
76 </pre> | |
77 | |
78 <p>and the appropriate variable setting:</p> | |
79 | |
80 <pre> | |
81 initialAttrs = new Entry[] | |
82 {org.dancres.blitz.serviceui.DashboardUI.getUIDescriptor()}; | |
83 </pre> | |
84 | |
85 <h3>Configuration Examples</h3> | |
86 | |
87 <ul> | |
88 <li>Example start <a href="../config/serviceui-start21.config">config</a>.</li> | |
89 <li>Example blitz <a href="../config/blitz-ui.config">config</a>.</li> | |
90 </ul> | |
91 | |
92 <h3>Note!</h3> | |
93 | |
94 <p>For these changes to take effect, you must shutdown the Blitz instance if it's currently running, delete any log and state files (as specified by the <code>logDir</code> and <code>persistDir</code> variables) and then restart Blitz with the changes made as above.</p> | |
95 </body> | |
96 </html> |